Tool Preferences

[Johann]

– get or set an optional renoise.Document.DocumentNode object, which will be
– used as set of persistant “options” or preferences for your tool.
– by default nil. when set, the assigned document object will be automatically
– loaded and saved by Renoise, in order to retain the tools state.
– the preference xml file is saved/loaded within the tool bundle as
– “com.example.your_tool.xrnx/preferences.xml”.

print("prefs created: " … renoise.tool().preferences.command_preset[1].value)

renoise.tool().preferences
→ [renoise.Document.DocumentNode object or nil]

well, if that is always nil at startup of the script, how do I get the preferences loaded then? because if I create a document and assign it, then I just have the document I assigned. that gets saved as preferences.xml fine, but at the next startup renoise.tool().preferences is still nil… I surely am missing something, but what?

I have read all in the API I could and any occurance of “preferences” in the whole trunk, but I couldn’t find any example, no tool that uses it… help?

oops sorry, wrong forum.

[taktik]

Please have a look at the XRNX example tool that can be found in the ScriptingStarterpack.zip at https://code.google.com/p/xrnx/ or browse the code online here: https://code.google.com/p/xrnx/source/browse/trunk#trunk/Tools/

This hopefully will give you something to start with, dig deeper.

A more real-life like scenario: com.renoise.TempoTap.xrnx at https://code.google.com/p/xrnx/source/browse/trunk#trunk/Tools/

[Johann]

thanks!!! a real life example is all I needed yay.

google search was surprisingly unhelpful (no matter at what point in the tree I searched, that is all I got?)