Jump to content


Photo

✒ Lua Api Changes For 2.8 & How To Upgrade Tools


  • Please log in to reply
10 replies to this topic

#1 taktik

taktik

    Renoise Developer

  • Admins
  • PipPipPipPipPipPipPipPipPipPipPipPipPipPipPipPip
  • 15040 posts
  • Gender:Male
  • Location:Berlin, Germany
  • Interests:füße waschen

Posted 10 December 2011 - 20:56

Lua API changes:

Expandable Code



Lua API additions:

Expandable Code



Updated documentation files:

Renoise 2.8 comes with the updated API reference. You will find it it in the "Scripting Tool & Editor"'s "Resource Scripts" node.
A pretty HTML API reference is available too: https://xrnx.googlec...rterPack280.zip


How to upgrade your Tools to Renoise 2.8 (API_VERSION 3):

Renoise will try to automatically upgrade old tools when possible. It does so by checking if any of the changed or removed API functions (see list above) are present. If they are present, the tool can't be auto-upgraded and will be disabled.

The auto-upgrader can't deeply check how the API is used by your script. It only does a raw text search, so even if upgrading succeeded there is a chance your tool might still not work. Even when upgrading succeeded, please do test all your tools in Renoise 2.8 and provide new versions to your users.

A few tips on how to get your tools ready for Renoise 2.8:

  • First open the manifest.xml file of your tool and set <ApiVersion> to 3 (Renoise 2.7's <ApiVersion> was 2)
  • remove the <AutoUpgraded> node from the manifest XML (if it was autoupgraded)
  • Check/search for any of the changed API function listed above and fix/replace them
  • Open Renoise and check if your tool was disabled by Renoise. This will happen when auto-upgrading failed. You can enable it again in the "Tool Browser".
  • Test the tool, verify the changes you've made to the Lua file

  • Ledger, Conner_Bw, Syflom and 4 others like this

#2 mxb

mxb

    Big Super GrandMasta Member

  • Normal Members
  • PipPipPipPipPipPipPipPipPipPipPip
  • 703 posts
  • Gender:Male

Posted 10 December 2011 - 21:14

Looks good! :)

I especially like the addition of API access to instrument envelopes.

ReSynth3 is definitely on the cards.
  • dblue likes this
Is a footer a sweater for feet?

#3 vV

vV

    God's or Borg's Chief and Ruler of All Species

  • Moderator
  • PipPipPipPipPipPipPipPipPipPipPipPipPipPipPipPip
  • 16855 posts
  • Gender:Male
  • Location:Netherlands

Posted 10 December 2011 - 21:44

Looks good! :)

I especially like the addition of API access to instrument envelopes.

ReSynth3 is definitely on the cards.


If you were an Alpha tester, we could have enjoyed ReSynth3 today :ph34r:
  • Djeroek, KRIX and KMaki like this
Vv....


cpu Intel Core i7-4820K @3.70GHz
chipset Intel X79 chipset
mem 32 Gb 2400Mhz
os Win 7 64-bit SP1, DirectX 11
audio ESI ESP1010e - > Driver rev:2.0.6.0
video nVidia Geforce GTX780 - > Driver rev:335.23


Renoise Official Manual

#4 joule

joule

    Guruh Motha Fakka is Levitating and Knows Everything About Renoise Member

  • Normal Members
  • PipPipPipPipPipPipPipPipPipPipPipPipPip
  • 1314 posts
  • Gender:Not Telling
  • Location:Sweden
  • Interests:music, philosophy, engineering

Posted 11 December 2011 - 02:14

Thanks a lot for awesome updates. The DSP improvements will open up lots of new possibilities, given this means that the dsp name string (or something) corresponds to .available_devices.

EDIT: Confirmed. I love you :)

Edited by joule, 11 December 2011 - 02:58.


#5 hiheelhottie

hiheelhottie

    Member

  • Normal Members
  • PipPip
  • 36 posts

Posted 11 December 2011 - 08:01

Apologies if this is painfully obvious, but how do I see the lua api changes from within the scripting terminal and editor window. I only see the 2.7 api inside of 2.8. http://code.google.com/p/xrnx/ seems to only have a 2.7 starter pack.

Btw,the aliases are great.

#6 hiheelhottie

hiheelhottie

    Member

  • Normal Members
  • PipPip
  • 36 posts

Posted 11 December 2011 - 08:12

Embarassing, the 2.8 api seems to be packaged right in Resource Scripts. My bad.

Apologies if this is painfully obvious, but how do I see the lua api changes from within the scripting terminal and editor window. I only see the 2.7 api inside of 2.8. http://code.google.com/p/xrnx/ seems to only have a 2.7 starter pack.

Btw,the aliases are great.



#7 esaruoho

esaruoho

    Guruh Motha Fakka is Levitating and Knows Everything About Renoise Member

  • Normal Members
  • PipPipPipPipPipPipPipPipPipPipPipPipPip
  • 2521 posts
  • Gender:Male
  • Location:Kontula, Helsinki, Finland
  • Interests:// Free Energy // Cymatics // Sound visualization // Sustainable energy production // Apple devices // Tesla Motors //

Posted 11 December 2011 - 11:05

Embarassing, the 2.8 api seems to be packaged right in Resource Scripts. My bad.


do you have a Windows/Linux path for that?
OSX is Renoise_Reg_Intel64.app/Contents/Resources/Scripts/Documentation/*

Edited by esaruoho, 11 December 2011 - 11:30.

| lackluster Website | lackluster on bandcamp | lackluster on facebooklackluster on soundcloud | esaruoho on twitter |

esaruoho@gmail.comesaruoho on reddit | esaruoho on ello | 

| OS X 10.11 El Capitan | Mac Book Pro 2.66 GHz Intel Core 2 Duo / 8GB 1067 MHz DDR3 |

| Latent Impulse Tracker/Scream Tracker 3/Schism Tracker <-> Renoise fanatic |

More API functions, please! ;)

#8 taktik

taktik

    Renoise Developer

  • Admins
  • PipPipPipPipPipPipPipPipPipPipPipPipPipPipPipPip
  • 15040 posts
  • Gender:Male
  • Location:Berlin, Germany
  • Interests:füße waschen

Posted 11 December 2011 - 11:29

XRNX repository is now up to date as well. And the XRNX started pack contains a pretty HTML API reference as well: https://xrnx.googlec...rterPack280.zip

#9 esaruoho

esaruoho

    Guruh Motha Fakka is Levitating and Knows Everything About Renoise Member

  • Normal Members
  • PipPipPipPipPipPipPipPipPipPipPipPipPip
  • 2521 posts
  • Gender:Male
  • Location:Kontula, Helsinki, Finland
  • Interests:// Free Energy // Cymatics // Sound visualization // Sustainable energy production // Apple devices // Tesla Motors //

Posted 11 December 2011 - 11:34

Lua API additions:


missing from this list is:
renoise.song().instruments[].samples[].autofade, _observable

| lackluster Website | lackluster on bandcamp | lackluster on facebooklackluster on soundcloud | esaruoho on twitter |

esaruoho@gmail.comesaruoho on reddit | esaruoho on ello | 

| OS X 10.11 El Capitan | Mac Book Pro 2.66 GHz Intel Core 2 Duo / 8GB 1067 MHz DDR3 |

| Latent Impulse Tracker/Scream Tracker 3/Schism Tracker <-> Renoise fanatic |

More API functions, please! ;)

#10 KURTZ

KURTZ

    Guruh Motha Fakka is Levitating and Knows Everything About Renoise Member

  • Normal Members
  • PipPipPipPipPipPipPipPipPipPipPipPipPip
  • 1046 posts
  • Gender:Male
  • Location:Poitiers (France)
  • Interests:bunnies

Posted 11 December 2011 - 15:08

ReSynth3 is definitely on the cards.


Will it be possible to code a basic arpeggiator / transgater within resynth, based on point-based volume envelopes (for the transgater) and pitch envelopes (for the arp itself) ?

.
KURTZ

 

¤ cpu intel core i5 3.20Ghz | ram 8gb | nvidia geforce gtx 970 | hd1.2 tb | os win10 64bits | midi maudio oxygen 49 master keyboard
¤ kurtz/lapiNIC's french blog
¤ renoise france - communauté francophone des utilisateurs de renoise

 


#11 Djeroek

Djeroek

    Probably More God or Borg Than Human Member

  • Normal Members
  • PipPipPipPipPipPipPipPipPipPipPipPipPipPipPip
  • 6633 posts
  • Gender:Male
  • Location:Borneo

Posted 11 December 2011 - 15:18

Will it be possible to code a basic arpeggiator / transgater within resynth, based on point-based volume envelopes (for the transgater) and pitch envelopes (for the arp itself) ?


That make a good standalone tool, besides dblue's automation envelopes from note's script, there is no script dealing with generating envelopes!