Laser Player ILDA

ILDA file (*.ild, *.ilda) player module.

Settings

on

Activates or deactivates the module.

laser xyz

Frames points coordinates a 3D array (X,Y,Z) points. Can be modified by 3D modules.

laser colors

Array of colors for each point.

laser status

Array of status of the laser for each point: 0 for laser OFF and 1 for laser ON.

video out

Output of the ILDA player as video frames. Only if enable video out is on.

enable video out

Enables the video out calculation. Disable it if you don't need to limit CPU consumption.

dimmer

Output intensity.

speed

Sets the reading speed.

play loop

Plays the file in loop mode.

next frame

Jumps to the next frame, only when play-loop is OFF.

file number

File number combobox.

• -1: no file is selected.
• 0: the first file in the list is selected.
• 1: the second file in the list is selected
• etc.

number of files

Gives the number of files in the list.

pos

Sets or gets the current frame reading position.

number of frames

Gets the number of frames of the current file.

palette

Color palette used to draw the frames:

• pangolin (64 colors)
• standard (256 colors)

  See Annex below.

show list

Shows the files list.

next

Selects the next file in the list.

previous

Selects the previous file in the list.

next rand

Random selection of a file in the list.

short filename

Gives only the name of the file, without the path and extension.

long filename

Gives the full name of the file, included the path.

add file name

Set this value with a filename to add a new file in the list (this applies to the sampler, video player and Piano-Roll).

list comma text

Input to set the file list with a comma-text.

clear list

Clears the files list. When you press saverand or savename the recorded file is automatically added to the files list. With the clear list button you can clear the list directly.

clear last

Deletes the last element of the files list

saved in preset

Determines if parameters of this object are saved in the preset-panel.

fade preset

Parameters of the this object can cross faded when you recall a preset in the grid.

Other Settings

hint

Hint text displayed on mouse over.

background

background color

Background color of the control.

Blue background color example.

transparent

Determines if the background of the control is transparent or not.

Example, the first module is transparent.

remote highlight color

Background color when the control is modified by a remote (MIDI,OSC,etc.).

image file

Optional Filename of the background image.

Example on an panel-xy-pad.

image fit mode

Force the image file to adapt its displayed size to the size of the object.

• proportional: the image keeps its proportion ratio and is left aligned,
• scaled: the image is scaled to the object size,
• original: keeps the original size
• clipped: the image is clipped to the object size, and centered,
• scaled: the image is scaled to the object size taking into account the border-size of the control.

svg filename

Name of the svg file to draw in background.

svg fill color

Color used to fill the svg.

svg stroke color

Color used to draw the contour of the svg.

svg stroke width

Width of the stroke used to draw the contour.

svg margin

Margin used to draw the svg file.

svg keep aspect ratio

When the svg is stretched to the destination size, determines if it keeps its aspect ratio or is stretch to fit to the target rectangle.

border

show border

Displays or not the border of the control.

8 pixels border on an panel-xy-pad.

border width

Sets the border width of the control in pixel.

8 pixels border on an panel-xy-pad.

border color

Border color of the control.

a yellow border on an panel-xy-pad.

border OFF color

Border color when the control is OFF.

a black OFF border on a switch.

border ON color

Border color when the control is ON.

a white ON border on a switch.

round size

Thickness of rounded corners.

Example on a panel-shape.

don't draw selection border

Enables or disables the drawing of a border when the control is selected with the mouse.

caption

show caption

Displays or not the caption.

Example on a fader.

caption horizontal align

Caption alignment of the control, left, center or right.

caption vertical align

Vertical alignment of the caption, center, top or bottom.

Example on knob: Center, top and bottom.

Example on switch.

caption font size factor

Size multiplication factor applied to the caption font.

Example on switch.

caption font

Font name of the control caption.

Example with 3 different fonts on switch.

caption font color

Color of the caption font.

Example on switch.

caption font italic

Italic style for caption font.

Example on switch.

caption font bold

Bold style for caption font.

Example on switch.

caption font underline

Underline style for the caption font.

Example on switch.

frames

frames count

Number of frames in the background bitmap. See create your own knobs and faders.

frames alignment

Determines if the frames used in the background bitmap are aligned vertically or horizontally. See create your own knobs and faders.

global

mouse editing enabled

Determines if the control can be modified by the user. When OFF, the mouse interaction and modifications are disabled so the user can't change the value.

receive mouse info

When ON, the control receives mouse information (often called hit-test). This is useful when you want to detect mouse interactions on overlapping controls. Only the top control with receive mouse info ON will get the mouse events.

is visible

Sets or get the visibility of the control.

global color

Global color of the control. Usine will choose the best contrasted colors according the global color.

ignored in parent global color

When ON the global color of the control is not affected (is isolated) when the parent control global color changes.

design template name

Name of the snapshot (which contains the visual properties) loaded when the object is created. By default the snapshots files are located in /Resources/Templates/Design or /Config/Templates/Design.

z order

Determines the Z-order of the control

• normal: the Z-order is the control creation order
• front: the control appears always on top of all other controls
• back: the control appears always behind all other controls

Example with the first knob on top.

opacity

Opacity value of the control.

blur softness

Blur amount applied to the object.

Example of blur.

location

display location

Determines where the object is visible.

• invisible: the object is invisible.
• ctrl panel: in the control-panel.
• parent ctrl panel: in the control-panel of the parent patch if it exists.
• top ctrl panel : in the control-panel of the top parent patch (main patch) if it exists.
• container : in the container of the current patch.
• parent container : in the container of the parent patch of the current patch.
• top parent container: in the container of the top parent patch of the current patch.
• pop up window: visible in the popup.
• top header: visible in the top top-header-panel.
• toolbox: visible in the toolbox-panel.
• workspace: visible in the workspace-panel.
• additional container: visible in an additional container, identified by a number. See bellow.

additional container

Sets the control as an additional container so any other control can be placed into that container. The additional container is identified by a number.

a button inside a listbox

also visible in interface builder

When ON, will also be visible in the interface-builder-panel.

mouse tab settings

Settings related to mouse, touch screen and drag&drop.

mouse & gesture

mouse dwn

Gives the mouse state of the control:

• 1 if the mouse is pressed
• 0 otherwise.

mouse wheel

Gives the mouse wheel speed and direction, -1,-2,-3,...=forward, 1,2,3,...=backward.

mouse wheel enabled

Enables or disable the mouse wheel action.

dbl click

Sends a 1 value if the user has [dbl-clicked] on the control.

mouse active

Determines if the mouse is active on the control.

mouse x

Gives the mouse X position on the control in relative coordinates from 0=most-left to 1=most-right.

mouse y

Gives the mouse Y position on the control in relative coordinates form 0=top to 1=bottom.

bitmap

bitmap in

Background bitmap input.

bitmap out

Background bitmap output.

touch pressure

Pressure value on touch-screens.

gesture

Gesture information.

reset

auto reset

When ON, the value of the control is reset automatically on mouse up.

drag & drop

drag enabled

Enables the drag on this control.

allow drop

Enables or disables the drag&drop possibilities on this control.

drop file name

Name of the dropped file.

clear drop file name

Clears the latest dropped file name.

vertical mouse

When ON, move up-down to rotate a knob, left-right when OFF.

touch screen

touch hi precision

Mode of the precision factor. Can be disabled or for touch screen only or always (touch screen and mouse).

precision factor

Precision factor when the control is modified with a touch screen. Hi values for hi precision on touch screen.

mouse mode

Behavior of the control when it is modified with a touch screen.

circular mouse

When ON, the mouse wheel acts in circular mode.

keyboard arrows

keyboard arrows enabled

Determines if the control can be modified with the [arrow] keys of the keyboard.

focus & cursor

mouse over

Sends a 1 value when the control is hovered with the mouse.

mouse cursor

Determines the type of mouse cursor for the control.

• default
• none
• arrow
• cross
• beam
• size NESW
• size NS
• size NWSE
• size WE
• up arrow
• hour glass
• drag
• no drop
• H split
• V split
• multi drag
• SQL wait
• no
• app start
• help
• hand point
• size all

  selection

  selected

  Sends 1 when the control is selected.

remote tab settings

Settings related to remote control assignation and learn.

general

clear all learn

Clear all the remotes assignations.

remote active

Enables or disables the remotes assignations.

inverse

Inverse the values received during the learn.

quantize

Quantization applied when state or value changes.

• no quantization,
• cycle,
• Bar,
• beat,
• 1/8,
• 1/16.

active mode

Determines when the remote assignations are active.

• always
• if rack is ON
• if rack is selected
• if patch is ON
• if patch is selected

bind buses

clear bind bus

Clear the current bind assignation.

binding

Set or get the bind name assignation.

bind controls

bind ID

ID of the bind control.

bind caption

Caption of the bind control.

clear bind control

Clear the current bind control assignation.

MIDI

start midi learn

Click on this button and move your MIDI controller to assign it.

device name

Name of the device associated to the MIDI learn.

channel

MIDI channel used for the MIDI learn.

control num

MIDI Control message number (ie. Control Change, Note, etc) used for MIDI learn.

control type

MIDI message type used for the MIDI learn.

• None,
• NOTE OFF,
• NOTE ON,
• POLY AFTERTOUCH,
• CONTROL CHANGE,
• PROGRAM CHANGE,
• CHANNEL AFTER TOUCH,
• PITCH BEND.

midi mode

Choose between the 3 MIDI assignation modes in Usine.

• Absolute The controller sends a MIDI message with a value between 0 and 127 (typically rotary knob, fader). If you create a MIDIlearn NOTE ON on a switch, the value is set to 1 while the key is pressed and set to 0 when released. If you create a keylearn on a switch, the value is set to 1 while the key is pressed and set to 0 when released.
• Relative The controller sends a MIDI message with a positive value when you turn right and negative when left (typically endless knobs)
• Toggle The control toggles its minimum / maximum value each time it receives the learned code. Typically, if you want to assign a MIDI NOTE ON message, to an on/off parameter, for example, start playing a wave file while playing a MIDI keyboard note, you can toggle it on or off, when the same note is played again. On List box or integer faders, the Toggle mode increases the current value until the maximum is reached. Then restarts from the minimum value.

mackie mode

The control react as defined in the Mackie Control protocol. (when the control receives a MIDI message, the MIDI message is sent back to the controller to update its display/leds/fader position).

motorized

Only if you have motorized MIDI controllers connected. Force Usine to send MIDI messages to the connected remote devices and get a MIDI feedback.

soft take over

Soft Take Over if a control is moved on screen and it no longer matches the hardware control, the control will not update until the hardware control matches the onscreen value.

sysex

System exclusive chain used for MIDI learn.

Key

start key learn

Click on this button and press a key (or a key combination ie. [ALT+E]) on your keyboard to assign it.

key

Key used for the key learn. Can be a key combination like [ALT+E], etc.

key mode

Determines how the Key learn affect the control, absolute or toggle.

shortcut

Key code value of the key learn.(ex: A=65)

mapping

mapping curve

Curve type used for the mapping, log or exp, power curve, linear.

mapping curve coeff

Mapping curve coefficient.

mapping range max

Maximum range of the assignation.

mapping range min

Minimum range of the assignation.

OSC

start OSC learn

Click on this button and use a control of your OSC device to assign it.

OSC message

OSC message used for the OSC-learn.

OSC mode

Choose here between 2 modes, real OSC values received or force the values into the [0..1] range.

OSC tag order

This option is utilized to choose which tag to use when receiving multiple values simultaneously like in an XY values.

timecode

time code OFF

Time code learn, used to switch off a switch control.

time code ON

Time code learn, used to trig an action or to switch on a switch control.

VCA

vca

Name(s) of sources VCA's. One control can be controlled by several VCA at the same time so the VCA values are multiplied together.
To enter several names use comma separated string like VCA1,VCA2,VCA3.
See use-vca for more info.

clusters

cluster name

Name(s) of the owner cluster(s). One control can be in many clusters at the same time, but be aware that you could have conflicts (different value sent at the same time).
To enter several names use comma separated string like CLUSTER1,CLUSTER2,CLUSTER3.
See use-clusters for more info.

DMX

DMX universe

Universe number assigned for remote.

DMX channel

Channel number assigned for remote.

size tab settings

settings related to size and position of controls.

orientation

rotation angle

Rotation angle of the control.

is vertical

Rotates this control in vertical position.

zoom

zoom scale

Zoom scale of the control.

can zoom

Determines is the control can be zoomed with the wheel mouse.

Size & positions

top

Top position of the control in pixels.

left

Left position of the control in pixels.

height

Height of the control in pixels.

width

Width of the control in pixels.

percent

position percent x

Horizontal position in % [0..1] relative to the parent panel.

position percent y

Vertical position in % [0..1] relative to the parent panel.

height percent

Height in % [0..1] relative to the parent panel.

width percent

Width in % [0..1] relative to the parent panel.

resize grip

resize grip enabled

Determines if the control can be resized with the resize grip.

Interface Builder position

interface builder top

Top position in pixels in the interface-builder-panel.

interface builder left

Left position in pixels in the interface-builder-panel.

interface builder width

Width in pixels in the interface-builder-panel.

interface builder height

Height in pixels in the interface-builder-panel.

floating panel

floating x

Determines if the control is movable on X axis.

floating y

Determines if the control is movable on Y axis.

floating constrain to parent x

When ON the control stays inside the parent on X axis.

floating constrain to parent y

When ON the control stays inside the parent on Y axis.

resizable panel

resizable left

Determines if the control can be resized on its left hand.

resizable right

Determines if the control can be resized on its right hand.

resizable top

Determines if the control can be resized on its top hand.

resizable bottom

Determines if the control can be resized on its bottom hand.

physics

physics enabled

Enables physics-engine in this panel.

physics speed

The physics speed of the control in physics-engine.

init with random speed

When ON, the physics-engine starts with a random speed for each child controls.

same masses

When ON, all controls have the same masses in the physics-engine.

ignored in physical engine

The position control is not affected by the physics-engine.

friction

Friction factor in the physics-engine.

elasticity

Energy conservation coefficient on collision.

gravity x

Gravity factor on the X axis.

gravity y

Gravity factor on the Y axis.

reset pos x

Position of the object when the physics engine is reset on X axis.

reset pos y

Position of the object when the physics engine is reset on Y axis.

reset positions

Process to reset the position of the control in the physics-engine.

angular speed

Angular speed of the control in the physical engine.

collide

Sends a 1 value when the control collides with another control or a border.

collide info

Gives information about the collide state in the physics-engine.

• 1001: top of the parent,
• 1002: right side of the parent,
• 1003: left side of the parent,
• 1004: bottom of the parent.

speed x

Speed vector value on the X axis in the physics-engine.

speed y

Speed vector value on the Y axis in the physics-engine.

minimize

minimized

Determines if the control is minimized or not.

reorganization

auto reorganize

Automatically reorganize positions of controls in the panel.

reorganize margin

Left margin used in reorganization, in pixels.

reorganize interspace H

Horizontal interspace between controls used in reorganization, in pixels.

reorganize interspace V

Vertical interspace between controls used in reorganization, in pixels.

auto resize options

auto resize

Resizes panels automatically when child controls are moved or resized. Switch it OFF if you use floating panels inside.

auto resize margin

Margin in pixel used for the auto resize option.

force reorganize

Forces the reorganization of controls in the panel.

fit standard size

Adjust the panel width to a multiple of the default rack width.

align to grid

snap to grid

In unlock mode, snap the control to a grid.

grid size

Grid size in pixels when snap to grid is ON.

curve tab settings

Settings related to automation curve recording and playback.

curve

auto record on click

When ON, the automation recording starts automatically when click on the control.

delete curve

Deletes the automation curve.

is playing record

Sends 1 value when the control is playing a recorded automation curve.

header toolbar

show toolbar

Displays the toolbar with its icons.

Example ON and OFF

toolbar size factor

Height of the toolbar % of the global height.

Example toolbar size on a panel.

header

show header

Displays or not the header on the panel.

Example on sequenced-lines.

header height

Height of the header in pixels.

header color

Background color of the header.

solid header color

Determines if the header is drawn as a plain bar (HH5 style) or as small bar in the upper left corner.

plain ON

plain OFF

Common Settings

info

show manual

Opens the web browser to display information or help about the selected object, if it exists.

For more details about information/help creation, see create-help-file.

description

Description of the module for internal help purposes only. The description is not displayed in the interface.

ID's

visible only in god mode, see setup-panel-tab-expert.

unique ID

Current private ID for this control used to identify the object.

preset ID

Current private preset ID for this control used for presets.

recreate ID

If you experience difficulties in Polyphonic mode, try to recreate new id(s) with this button.

repair ID s

Each Patch shared on the local network uses its own ID (identification number). If you experience issues of Patches that don't send information to the good target, this button will rebuild all these id's.

Object Remote Address

absolute

Absolute remote address. see objects-address.

local

Local to the current patch remote address. see objects-address.

user addr

User defined remote address. see objects-address.

See also

• Setup tab Laser
• Tutorial : Laser Engine
• Device Output Laser
• Laser Modules
• Laser Spline to Laser
• Laser Player ILDA
• Laser Video to Laser

Annexe

Standard Color Palette

0		0	0	0	Black/blanked (fixed)
1		255	255	255	White (fixed)
2		255	0	0	Red (fixed)
3		255	255	0	Yellow (fixed)
4		0	255	0	Green (fixed)
5		0	255	255	Cyan (fixed)
6		0	0	255	Blue (fixed)
7		255	0	255	Magenta (fixed)
8		255	128	128	Light red
9		255	140	128
10		255	151	128
11		255	163	128
12		255	174	128
13		255	186	128
14		255	197	128
15		255	209	128
16		255	220	128
17		255	232	128
18		255	243	128
19		255	255	128	Light yellow
20		243	255	128
21		232	255	128
22		220	255	128
23		209	255	128
24		197	255	128
25		186	255	128
26		174	255	128
27		163	255	128
28		151	255	128
29		140	255	128
30		128	255	128	Light green
31		128	255	140
32		128	255	151
33		128	255	163
34		128	255	174
35		128	255	186
36		128	255	197
37		128	255	209
38		128	255	220
39		128	255	232
40		128	255	243
41		128	255	255	Light cyan
42		128	243	255
43		128	232	255
44		128	220	255
45		128	209	255
46		128	197	255
47		128	186	255
48		128	174	255
49		128	163	255
50		128	151	255
51		128	140	255
52		128	128	255	Light blue
53		140	128	255
54		151	128	255
55		163	128	255
56		174	128	255
57		186	128	255
58		197	128	255
59		209	128	255
60		220	128	255
61		232	128	255
62		243	128	255
63		255	128	255	Light magenta
64		255	128	243
65		255	128	232
66		255	128	220
67		255	128	209
68		255	128	197
69		255	128	186
70		255	128	174
71		255	128	163
72		255	128	151
73		255	128	140
74		255	0	0	Red (cycleable)
75		255	23	0
76		255	46	0
77		255	70	0
78		255	93	0
79		255	116	0
80		255	139	0
81		255	162	0
82		255	185	0
83		255	209	0
84		255	232	0
85		255	255	0	Yellow (cycleable)
86		232	255	0
87		209	255	0
88		185	255	0
89		162	255	0
90		139	255	0
91		116	255	0
92		93	255	0
93		70	255	0
94		46	255	0
95		23	255	0
96		0	255	0	Green (cycleable)
97		0	255	23
98		0	255	46
99		0	255	70
100		0	255	93
101		0	255	116
102		0	255	139
103		0	255	162
104		0	255	185
105		0	255	209
106		0	255	232
107		0	255	255	Cyan (cycleable)
108		0	232	255
109		0	209	255
110		0	185	255
111		0	162	255
112		0	139	255
113		0	116	255
114		0	93	255
115		0	70	255
116		0	46	255
117		0	23	255
118		0	0	255	Blue (cycleable)
119		23	0	255
120		46	0	255
121		70	0	255
122		93	0	255
123		116	0	255
124		139	0	255
125		162	0	255
126		185	0	255
127		209	0	255
128		232	0	255
129		255	0	255	Magenta (cycleable)
130		255	0	232
131		255	0	209
132		255	0	185
133		255	0	162
134		255	0	139
135		255	0	116
136		255	0	93
137		255	0	70
138		255	0	46
139		255	0	23
140		128	0	0	Dark red
141		128	12	0
142		128	23	0
143		128	35	0
144		128	47	0
145		128	58	0
146		128	70	0
147		128	81	0
148		128	93	0
149		128	105	0
150		128	116	0
151		128	128	0	Dark yellow
152		116	128	0
153		105	128	0
154		93	128	0
155		81	128	0
156		70	128	0
157		58	128	0
158		47	128	0
159		35	128	0
160		23	128	0
161		12	128	0
162		0	128	0	Dark green
163		0	128	12
164		0	128	23
165		0	128	35
166		0	128	47
167		0	128	58
168		0	128	70
169		0	128	81
170		0	128	93
171		0	128	105
172		0	128	116
173		0	128	128	Dark cyan
174		0	116	128
175		0	105	128
176		0	93	128
177		0	81	128
178		0	70	128
179		0	58	128
180		0	47	128
181		0	35	128
182		0	23	128
183		0	12	128
184		0	0	128	Dark blue
185		12	0	128
186		23	0	128
187		35	0	128
188		47	0	128
189		58	0	128
190		70	0	128
191		81	0	128
192		93	0	128
193		105	0	128
194		116	0	128
195		128	0	128	Dark magenta
196		128	0	116
197		128	0	105
198		128	0	93
199		128	0	81
200		128	0	70
201		128	0	58
202		128	0	47
203		128	0	35
204		128	0	23
205		128	0	12
206		255	192	192	Very light red
207		255	64	64	Light-medium red
208		192	0	0	Medium-dark red
209		64	0	0	Very dark red
210		255	255	192	Very light yellow
211		255	255	64	Light-medium yellow
212		192	192	0	Medium-dark yellow
213		64	64	0	Very dark yellow
214		192	255	192	Very light green
215		64	255	64	Light-medium green
216		0	192	0	Medium-dark green
217		0	64	0	Very dark green
218		192	255	255	Very light cyan
219		64	255	255	Light-medium cyan
220		0	192	192	Medium-dark cyan
221		0	64	64	Very dark cyan
222		192	192	255	Very light blue
223		64	64	255	Light-medium blue
224		0	0	192	Medium-dark blue
225		0	0	64	Very dark blue
226		255	192	255	Very light magenta
227		255	64	255	Light-medium magenta
228		192	0	192	Medium-dark magenta
229		64	0	64	Very dark magenta
230		255	96	96	Medium skin tone
231		255	255	255	White (cycleable)
232		245	245	245
233		235	235	235
234		224	224	224	Very light gray (7/8 intensity)
235		213	213	213
236		203	203	203
237		192	192	192	Light gray (3/4 intensity)
238		181	181	181
239		171	171	171
240		160	160	160	Medium-light gray (5/8 int.)
241		149	149	149
242		139	139	139
243		128	128	128	Medium gray (1/2 intensity)
244		117	117	117
245		107	107	107
246		96	96	96	Medium-dark gray (3/8 int.)
247		85	85	85
248		75	75	75
249		64	64	64	Dark gray (1/4 intensity)
250		53	53	53
251		43	43	43
252		32	32	32	Very dark gray (1/8 intensity)
253		21	21	21
254		11	11	11
255		0	0	0	Black (cycleable/changeable)