CITP

  Previous  Next

 

 

Introduction

CITP [abbr., Controller Interface Transport Protocol] is a communication protocol often used between media servers, lighting consoles, and visualizers.
The main reasons for using CITP are:

SDMX

Browsing

Streaming media between devices

To display preview images [Thumbnails]

 

 

Usage

Overview

MADRIX 5 supports

CITP version 1.0 with MSEX 1.0 and MSEX 1.1
[Features of higher versions are not supported.]

 

As a media server, MADRIX 5 is sending CITP data and making information available to other devices. For example, MADRIX 5 will not show Thumbnails from other devices.

 

CITP is used between at least two devices [or possibly more].
If you want to use CITP, you need a second device [hardware or software] to actually see the result. You will usually not see the result in MADRIX 5, but mainly on the other device [e.g., a lighting console or visualizer].

Your second device needs to support CITP. Otherwise, the connection will not work.
Moreover, not every product might support all of the features the CITP protocol has to offer. Please refer to the user manual of your other devices to learn more about the features available to you.

 

In MADRIX 5, you can use CITP

to show preview images [Thumbnails]

to stream media [Streaming]

to use it as visualizer to show a stream from another CITP server [Stream Visualizer]

 

Supported File Formats

Supported file formats for Thumbnails are: RGB8, JPEG

Supported file formats for Streaming are: RGB8, JPEG

 

[In case of MSEX 1.0, the RGB8 format of thumbnails and streams is delivered in BGR byte order as specified by the CITP specifications.]

 

Thumbnails

Showing Thumbnails is a useful feature, when you are using a lighting desk to control MADRIX 5 remotely [for example via »Art-Net Remote]. You may not have direct access to the PC that runs the MADRIX 5 Software and thus would like to preview the effects and visuals that you preconfigured.

MADRIX 5 generates Thumbnails for every Storage Place [Learn more »Storages]. On the graphical user interface of MADRIX 5, you have access to a total of 256 x 256 Storage Places. When you hover over a Storage Place with your mouse cursor, you will see the preview image [Thumbnail].
 

You can use CITP to display those preview images [Thumbnails] directly on your lighting desk.

Please make sure that MADRIX 5 has created these Thumbnails. Thumbnails are created when leaving [or re-selecting] a Storage Place. If no preview image has been generated for a Storage Place, you will only see a black image for this Storage Place on your console when using CITP.

Important Note: When using CITP 1.0 with MSEX version 1.0 or MSEX version 1.1, you will only be able to use up to 255 Storages and up to 255 Storage Places due to a restriction in the MSEX 1.0 and MSEX 1.1 specifications.

 

Streaming

Overview

While Thumbnails provide a static preview of MADRIX Effects, you may use Streaming to directly preview the Main Output [Preview Output]. MADRIX 5 features three live preview windows to show your effects. The Main Output [Preview Output] will show the visuals that are sent to your LEDs. Learn more »3 Previews

You can use CITP to stream, i.e. display, the Main Output [Preview Output] directly on your lighting desk. It will not look like a static image, but like a fluent video.

Behavior

MADRIX 5 acts as a CITP server in this case. A CITP server is not expected to deliver different sizes [pixel resolutions], but may provide different formats of the same stream in different MSEX versions.

Based on the current size of the virtual LED matrix of MADRIX 5, the requested resolution will be delivered:
- Is a client [or multiple clients] requesting an edge length that is larger than the current Matrix Size, the content will be upscaled by MADRIX 5 and delivered over CITP in this way.
- Are the requested edge lengths smaller than the current Matrix Size, the current size is kept and delivered.
- When receiving requests from multiple CITP clients, the largest requested edge length will be delivered. [The CITP protocol specifications expect clients to be able to downscale content.]

Limitations

Not every product may support this feature.

Regarding the supported RGB8 file format, a maximum of 21,823 pixels can be streamed.

Regarding the supported JPEG file format, there is a maximum of pixels that can be streamed, but it cannot be defined exactly as it depends on the compression rate and thus the image contents.

The maximum frame rate for Streaming via CITP in MADRIX 5 is 10 FPS by default.
[The default frame rate is sufficient for operators and usage in combination with consoles.]
[If you want to capture Streaming with a higher frame rate, you can adjust this frame rate to the Main Mix FPS as described below.]

 

Visualizer

In addition, you can use MADRIX 5 as a visualizer to show the media stream of another CITP server. Instead of streaming the Main Output of MADRIX 5 to another CITP device, MADRIX 5 can receive a stream from another CITP server and show it in MADRIX 5 using the SCE Capture effect.

 

 

Network Settings

Devices, that should communicate with each other via CITP, should be configured to be in the same network!
Learn more »Tips [Microsoft Windows / Networks / USB]

The network protocol of CITP does not have any special restrictions.

 

 

Configuration Of MADRIX 5 As Server

Go to the menu Preferences > Options... > Devices Network
[Keyboard shortcut: Ctrl+Alt+0 > Devices Network]

Activating CITP 

Activate Enable Server in the section Capture - CITP
[The checkbox will change from gray to green.]

Choose your network card from the drop-down list. Make sure to select the correct network adapter that will be used for CITP!
[The IP address and Subnet mask label should help you select the correct adapter. It is not necessary to change any of these networks settings.]
[Please note: A loopback adapter is also available. Learn more »Loopback Adapater [127.0.0.1]]

No further steps are required to configure MADRIX 5 as CITP server.
 

Use Main Mixer FPS - Removes the 10 FPS limit for Streaming and couples the frame rate to the frame rate of the Main Mixer of MADRIX 5. The Main Mixing FPS is 50 FPS by default.
Learn more »Performance

 

 

Configuration Of MADRIX 5 As Visualizer

Go to the menu Preferences > Options... > Devices Network
[Keyboard shortcut: Ctrl+Alt+0 > Devices Network]

Activating CITP 

Activate Enable Visualizer (SCE Capture) in the section Capture - CITP
[The checkbox will change from gray to green.]

Choose your network card from the drop-down list. Make sure to select the correct network adapter that will be used for CITP!
[The IP address and Subnet mask label should help you select the correct adapter. It is not necessary to change any of these networks settings.]
[Please note: A loopback adapter is also available. Learn more »Loopback Adapater [127.0.0.1]]

Click OK to close the window.

Now, choose an empty Storage Place on the user interface of MADRIX 5 and set it up as effect SCE Capture

In SCE Capture, make sure to connect the CITP server via

 

 

Configuration Of Other Devices

Once CITP is enabled in MADRIX 5, your lighting console [or any other second device] should be able to find MADRIX 5 in the network.

In order to enable CITP for the device that you want to connect to MADRIX 5, please consult the user manual of the other device.

 

MADRIX 5.7.
[Ctrl & +/-] = Zoom In/Out | [Ctrl & 0] = 100%
 Previous   Next

 


Enable automatic translation | Activer la traduction automatique |