Changes to apply for porting Jamoma 0.4 modules to Jamoma 0.5¶
At the end of this page are replicated the changes to proceed between 0.5 beta and 0.5 release
- Change from the old jcom.gui abstraction to the new jcom.ui external. In the jcom.ui inspector set the following attributes:
- add attributes (has_mute, has_... etc.)
- bypass/freeze/mute/preview (for video)
- bypass/gain/mix/mute (for audio when necessary)
- set the "OSC Prefix for parameter name" attribute to audio or video, depending on your module (leave blank for control modules)
- and when needed, add the has_panel attribute, remove @inspector 1 to jcom.hub, and change /open_inspector in the jcom.oscroute below jcom.in to /panel/open
- font size of jcom.ui should be set to 11 pt. Verdana
- In the module's patch :
- Set font of UI objects that are to be part of the GUI to be 10 pt Verdana wherever possible.
- Add all UI obejcts to Presentation Mode (shift-cmd-p).
- Set patch to open in presentation mode.
- Delete pvars. We now prefer to connect number boxes directly to jcom.parameter/message.
- Delete the "max refresh" message if necessary
- In jcom.hub:
- Remove @size attributes from jcom.hub
- Remove the first argument (that coincides with the module's name). This is now handled automagically.
- In jcom.parameter/jcom.message/jcom.return change:
- From @range to @range/bounds
- From @clipmode to @range/clipmode
- From @repetitions to @repetitions/allow
- Change data types to the new names :
- msg_int -> integer
- msg_float -> decimal
- msg_toggle -> boolean
- msg_list -> array
- msg_symbol -> string
- msg_generic -> generic
- msg_none -> none
- important : if you do this replacement by an automated find/replace, avoid making it in javascript files, as msg_int, msg_float and msg_list have a special meaning for them, which is independant of Jamoma.
- If necessary, updates references to the generic embedded messages/parameters :
- ui/freeze -> view/freeze
- ui/refresh -> view/refresh
- module/viewInternals -> view/internals
- script -> view/script
- panel/open -> view/panel
- For panel, messages, object boxes, and whenever possible:
- In the inspector, set all colors to "Set to Named Default" by clicking on the @button in the leftmost column of the inspector (in some colour themes, certain objects can't be set to Named Default. If necessary, use another one in Options > Object Defaults, or leave it like that for now)
- Panels: Rounded corners generally set to 15 (in the help patches)
- For jsui.texttoggle buttons:
- Replace them by new Max 5 textbuttons (can act as buttons and toogles)
- Border :1
- Roundness : 8
- Font : Verdana 8
- Text align : center
- A couple of templates here : http://www.box.net/shared/5o2w32c08s
- re-generate documentation and preset files
Changes between 0.5 beta and 0.5 release¶
- Change data types to the new names :
- msg_int -> integer
- msg_float -> decimal
- msg_toggle -> boolean
- msg_list -> array
- msg_symbol -> string
- msg_generic -> generic
- msg_none -> none
- important : if you do this replacement by an automated find/replace, avoid making it in javascript files, as msg_int, msg_float and msg_list have a special meaning for them, which is independant of Jamoma.
- If necessary, updates references to the generic embedded messages/parameters :
- ui/freeze -> view/freeze
- ui/refresh -> view/refresh
- module/viewInternals -> view/internals
- script -> view/script
- panel/open -> view/panel
- re-generate documentation and preset files