View source for Tutorial Capture Output Sections with Artnet DMX and Network Grabbers

This tutorial applies to all different OS and MXWendler versions.

== About Grabber == 

The keystone engine offers so-called grabbers. These grabbers are placed on top of the compositing result and then grab the pixel data that they cover and convert it to data that is processed by external applications.

There are three different grabbers available:
:• DMX Grabber
:• Artnet Grabber
:• Network Grabber

The basic creation and usage of these grabbers is the same regardless of the different grabber type:
:• Create a grabber
:• Place a grabber
:• Edit grabber properties

{{#mpdftags: pagebreak}}
All grabbers share color correction and color damping as a common feature: 
:'''Color correction''' can emphasize or reduce certain color channels.
:'''Color damping''' slows color changing and thus reduces color flickering on output fixtures.
::'''Damp Up:''' Time needed (ms) for full close to full open per color channel
::'''Damp Down:''' Time needed (ms) for full open to full close per color channel
::'''Brightness:''' Color multiplier across RGB range
::'''Red Curve:''' Color multiplier across R range
::'''Green Curve:''' Color multiplier across G range
::'''Blue Curve:''' Color multiplier across B range

When e.g. 'Damp Up' is set to 1000 ms, a rendered output pixel must remain for at least one second to allow the grabber to follow fully. Thus a short flicker will be mostly ignored. This functionality helps to prevent flickering room illumination. By default, the 'Brightness' curve is flat and in the center the middle by default. Lowering the whole curve results in an overall lower output brightness, and lowering the middle part results in reduced brightness in the middle tones. The curve value range is from 0.0 to 2.0; these values will be multiplied onto the color value.

{{#mpdftags: pagebreak}}
== Creating a Grabber == 

'''Creating an Artnet Grabber'''


1. Go to the Keystone tab and from the Mapping View menu, open the Create menu. '''(A)'''

2. Choose 'Art-net Grabber' and click on 'Create'. '''(B)'''

3. Open the Art-Net Grabber menu from the Elements menu, and set the 'Grab Size', e.g. 8/8. '''(C)'''

The grabber will be placed at a default position in the keystone area. Grabbers are always rectangular in shape, therefore their shape can only be edited with the lower right pivot or the upper left pivot.

4. Unlock the grabber by double-clicking two times on the Element (until the Pivots become active). Move the grabber by dragging the base pivot. '''(D)'''

5. Change the grabber size by dragging the upper left or lower right pivot. '''(E)'''

''Tip: You can also select the base pivot by dragging a field across the whole grabber.''

[[File:Artnet_DMX_Network_1.png|728px]]
{{#mpdftags: pagebreak}}
== Using the Various Grabbers ==

====Using an Artnet Grabber====


1. Open DMX/Artnet in the IO Settings: '''(A)'''
:'''Menu: SETTINGS &rarr; IO DEVICES &rarr; DMX/ARTNET'''
2. Activate 'Open Artnet'. '''(B)'''

3. Type in the IP address of the system’s network interface you want to use. '''(C)'''

4. (optional) type in ports and subnets. '''(D)'''

5. (optional) type in descriptive names. '''(E)'''

Close the dialog, restart, open the keystone tab and create an Artnet Grabber as described above.

The Artnet Grabber will send the pixel data beginning from the bottom left pixel in RGBRGBRGB values 0...255. When an Artnet universe is full, the data will be written into the next Artnet universe.


[[File:Artnet_DMX_Network_3a.png|728px]]


{{#mpdftags: pagebreak}}
====Using a DMX Grabber====


1. Open DMX/Artnet in the IO Settings: '''(A)'''
:'''Menu: SETTINGS &rarr; IO DEVICES &rarr; DMX/ARTNET'''
2. Connect an Enttec DMX USB Pro to the computer. Activate Enttec DMX USB Pro in the DMX/Artnet settings. '''(B)'''

3. Confirm the dialog with OK and restart MXWENDLER. '''(C)'''


Open the Keystone Tab and create a DMX Grabber (same procedure as with the Artnet Grabber).


[[File:Artnet_DMX_Network_3b.png|728px]]


{{#mpdftags: pagebreak}}
4. From the Elements menu, open the DMX Grabber submenu and click on Define Fixture to reach the DMX Grabber window. '''(D)'''

'''&rarr; Define the fixture according to its properties:'''

5. The grabber pixel size is defined by 'Size in Pixels (X/Y)'. '''(E)'''

6. Grabbed pixel data will be written into the DMX array beginning at the 'DMX Start Channel' with the lower left pixel first. '''(F)'''

7. Pixels are always sent as RGB triplets, RGB values or RGB sums. Each pixel triplet will be preceded by 'DMX channels before RGB'... '''(G)'''

8. ...and continued with 'DMX channels after RGB'. '''(H)'''

Currently there is at maximum one DMX universe allowed with Enttec DMX Pro. Multiple grabbers can write into this universe with their offsets. For more universes Artnet Grabbers are available.


[[File:Artnet_DMX_Network_3.png|728px]]

<div class="noprint">
====Using a Network Grabber====

A Network Grabber can grab a section of the rendered output image and send it as a video stream to a connected client. <br>
Please note that Network Grabbers are not supported in Version 6 and higher.

Go to the Keystone Tab, create and place a Network Grabber as described before.

1. Select the Network Grabber '''(A)'''

2. Open the the Submenu 'Network' in the Keystone Tab. '''(B)'''

3. Click on 'Make SDP file'. '''(C)'''

4. Save this SDP file on a external storage medium (e.g. USB stick). '''(D)'''


Copy this SDP file to another machine. This machine must be connected via a 'TCP Network'. On the second machine, open the SDP file with e.g. VLC (videolan.org).


[[File:Artnet_DMX_Network_4.png|728px]]
</div>