Video Pixel Mapper

Module dedicated to direct pixel mapping for led pixels screens. See Pixel Mapping for a complete tutorial.

This module sends direct ArtNet/sACN and use networks settings of the plot panel defined by the target plot number setting.

Each universe is limited to 512 channels so you with RGB pixels you can only have 170 pixels per universe. This module will send several ArtNet/sACN frames by incrementing the universe by each bloc of 512 channels.

For example if you have a 100 x 100 RGB led matrix (10000 RGB), Usine will send 10000 div 170 = 59 universes with 170 pixels each.

Settings

on

Activates or deactivates the module.

video in

Video input flow(s).

process time

Total time used for the calculation of the module.

show hide

Toggle visibility state of the pixel mapper window, visible/invisible.

show

Shows the pixel mapper window.

hide

Hides the pixel mapper window.

general settings

target plot

Sets the target plot for the pixel mapper. The pixel mapper will take the settings of the target plot (ArtNet IP address, sACN unicast IP etc.).

width

Width (in number of led pixels) if the mapper.

height

Height (in number of led pixels) if the mapper.

clear mapper

Clear the pixel mapper, deactivates all led pixels, resets all DMX channels.

image file name

Select the image to import to create special mapping based on a drawing. Image should be in black&white, white pixels will enabled, and black disabled.

drawing example

imported image

pixels general

num total pixels

Gives the total number of led pixels, calculated as width x height

num active pixels

Gives the number of active (enabled) led pixels.

pixel type override

Forces the pixel type to a global value. Normally, the pixel type is set individually for each pixel with pixel type option (see bellow).

mode multi universes

This option can be used to avoid conflicts when several pixels are sent to the same universe, same channel. When ON, all universes are sent at the same time after a filtering of conflicted pixels. The ArtNet-Sync is sent only once.

selection

• To select pixels, use the [shift] key.
• To unselect use [right-click].
• You can zoom in/out with [mouse-wheel].
• To enable a pixel use [ctrl+click]
• To enable and fill a pixel with the first available universe/channel use [alt+click]

enable selected

Enables selected pixels.

disable selected

Disables selected pixels.

DMX channels

Automatic DMX channels assignation. You have to select pixels you want to fill first.

start universe

Universe of the first pixel.

start index

Index in the universe of the first pixel in the range [0..512].

fill direction

Defines the fill direction.

pixel type

Determines how each color value is converted to ArtNet DMX.

• RGB 3 bytes : each color is converted into 3 DMX values R,G,B. Only 170 pixels can be sent per universe.
• BRG 3 bytes : each color is converted into 3 DMX values B,R,G. Only 170 pixels can be sent per universe.
• RGB- 4 bytes : each color is converted into 4 DMX values R,G,B,0. Only 128 colors can be sent per universe.
• -RGB 4 bytes : each color is converted into 4 DMX values 0,R,G,B. Only 128 pixels can be sent per universe.
• -BRG 4 bytes : each color is converted into 4 DMX values 0,B,R,G. Only 128 pixels can be sent per universe.
• BRG- 4 bytes : each color is converted into 4 DMX values B,R,G,0. Only 128 colors can be sent per universe.
• RBG 3 bytes : each color is converted into 3 DMX values R,B,G. Only 170 pixels can be sent per universe.
• BGR 3 bytes : each color is converted into 3 DMX values B,G,R. Only 170 pixels can be sent per universe.
• GBR 3 bytes : each color is converted into 3 DMX values G,B,R. Only 170 pixels can be sent per universe.
• GRB 3 bytes : each color is converted into 3 DMX values G,R,B. Only 170 pixels can be sent per universe.
• RGBW 4 bytes : each color is converted into 4 DMX values R,G,B,W. Only 128 pixels can be sent per universe. Algorithm WhitePart.
• WRGB 4 bytes : each color is converted into 4 DMX values W,R,G,B. Only 128 pixels can be sent per universe. Algorithm WhitePart.
• --W 3 bytes : each color is converted into 4 DMX values, 0,0,W. Only 170 pixels can be sent per universe. Algorithm GrayScale.
• ---W 4 bytes : each color is converted into 4 DMX values, 0,0,0,W. Only 128 pixels can be sent per universe. Algorithm GrayScale.
• W--- 4 bytes : each color is converted into 4 DMX values, W,0,0,0 followed by 3 values filled with 0. Only 128 pixels can be sent per universe. Algorithm GrayScale.
• W 1 bytes : each color is converted into 1 DMX value W. Only 512 pixels can be sent per universe. Algorithm GrayScale.
• WWWW 4 bytes : each color is converted into 4 DMX values W,W,W,W. Only 128 pixels can be sent per universe. Algorithm GrayScale.
• WWW 3 bytes : each color is converted into 3 DMX values W,W,W. Only 170 pixels can be sent per universe. Algorithm GrayScale.
• WW 2 bytes : each color is converted into 2 DMX values W,W,0,0. Only 256 pixels can be sent per universe. Algorithm GrayScale.
• GRBW 4 bytes : each color is converted into 4 DMX values G,R,B,W. Only 128 pixels can be sent per universe. Algorithm WhitePart.
• WGRB 4 bytes : each color is converted into 4 DMX values W,G,R,B. Only 128 pixels can be sent per universe. Algorithm WhitePart.
• RGBWW 5 bytes : each color is converted into 5 DMX values R,G,B,W,W. Only 102 pixels can be sent per universe. Algorithm WhitePart.
• WWRGB 5 bytes : each color is converted into 5 DMX values W,W,R,G,B. Only 102 pixels can be sent per universe. Algorithm WhitePart.
• RGBW x2 8 bytes : each color is converted into 8 DMX values R,G,B,W,R,G,B,W. Only 64 pixels can be sent per universe. Algorithm WhitePart.
• RGBW x4 16 bytes : each color is converted into 16 DMX values R,G,B,W,R,G,B,W,R,G,B,W,R,G,B,W. Only 16 pixels can be sent per universe. Algorithm WhitePart.
• RGB- x4 16 bytes : each color is converted into 16 DMX values R,G,B,0,R,G,B,0,R,G,B,0,R,G,B,0. Only 16 pixels can be sent per universe.
• RGBW MaxLuminance x4 16 bytes : each color is converted into 16 DMX values R,G,B,W,R,G,B,W,R,G,B,W,R,G,B,W. Only 16 pixels can be sent per universe. Algorithm MaxLuminance.
• RGBW MaxLuminance 4 bytes : each color is converted into 4 DMX values R,G,B,W. Only 128 pixels can be sent per universe. Algorithm MaxLuminance.
• WRGB MaxLuminance 4 bytes : each color is converted into 4 DMX values W,R,G,B. Only 128 pixels can be sent per universe. Algorithm MaxLuminance.

universe size

Size of the DMX universe, only DMX 512 available in Usine.

fill DMX channels

Fills the pixels DMX channels according the settings above. Once filled, on screen, each universe is drawn with a distinct color.

each universe is drawn with a distinct color

test

Various ArtNet/sACN tests for the selected pixels.

test selected

Sends a small chaser to the selected pixels.

abort test

Abort the current test selected operation.

all ON selected

Switches ON selected pixels.

all OFF selected

Switches OFF selected pixels.

image

Implantation map.

save image

Saves the pixel mapper window as hi-def image to be used as an implantation map.

selected pixel

Visible only if a pixel is selected. Gets or sets the DMX channel information of the pixel.

enabled

The pixel is enabled.

universe

Universe number of the pixel.

channel

DMX channel of the pixel.

index

Pixel in order in the universe. For example with a RGB pixel type it's a number in the range [0..169].

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.

hilited 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.

fit size

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.

Bitmaps

bitmap in

Background bitmap input.

bitmap out

Background bitmap output.

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 align

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

caption V 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.

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.

global

edition 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.

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.

snapshot 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/Snapshots/ or /Config/Snapshots.

on top

Determines the Z-order of the control

• normal: the Z-order is the control creation order
• on top: the control appears always on top of all other controls
• backward: 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.

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.

plain header

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

horizontal-scroller

show H scroller

Determines if the horizontal scroller is visible or not.

Example of horizontal scroller

h scroller height

Height of the scroller in pixels.

h scroller color

Scroller color.

h scroller opacity

Scroller opacity.

ID's

unique ID

Current private id for this control.

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.

info

show info

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

location

where

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.

is 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 IB

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

mouse

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 y

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

mouse x

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

touch pressure

Pressure value on touch-screens.

gesture

Gesture information's.

auto reset

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

vertical mouse

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

mouse over

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

mouse over

Sends 1 when the control is mouse overed.

selected

Sends 1 when the control is selected.

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.

position x

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

position y

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

heightpc

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

widthpc

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

iB top

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

iB left

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

iB width

Width in pixels in the interface-builder-panel.

iB height

Height in pixels in the interface-builder-panel.

rotation angle

Rotation angle of the control.

vertical

Rotates this control in vertical position.

zoom scale

Zoom scale of the control.

can zoom

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

resize grip enabled

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

minimized

Determines if the control is minimized or not.

floating x

Determines if the control is movable on X axis.

floating y

Determines if the control is movable on Y axis.

floating content parent x

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

floating content parent y

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

TpgControl_Button.floating content parent y

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-engine

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.

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.

Layouts

auto reorganize

Automatically reorganize positions of controls in the panel.

reorganize margin

Left margin used in reorganization, in pixels.

reorganize interspace

Interspace between controls used in reorganization, in pixels.

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.

fit standard size

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

snap to grid

In unlock mode, snap the control to a grid.

grid size

Grid size in pixels when snap to grid is ON.

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.

See also

• Tutorial : Le Pixel Mapping
• Light Color Array to ArtNet
• Video Pixel Mapper