The secondary events panel is located at the bottom of the application and has a table view with the following columns:

command_table
  • Offset – defines the time offset from the item start/end (depending on the value defined in the "From" field);

    Note
    Specify the offset value to be able to edit the "Device" and "Command" fields.
  • From – defines whether offset is calculated from the beginning or from the end of the current item;

  • Absolute – defines the time when the event will be sent to the device (is set automatically depending on the offset value and iten start time);

    Note
    The "Absolute" value is not editable.
  • Name – defines the name of the secondary event;

  • Description – specifies the event description;

  • Device – defines the device that will receive the event;

  • Command – defines the command;

  • Option1…3 – defines the command options;

  • ID – defines the secondary event ID which is logged into the as-run log for every event raised.

Setting Offset

There are two ways to set the offset:

  • You can enter it manually into the offset field (in hours:minutes:seconds:frames). The offset value can be positive or negative value.

  • It can be calculated automatically. To do this, select the "Find the event offset…​" context menu command.

CommandOffset-1

The "Cinegy clip viewer" window appears:

CommandOffset-2

text 2B displayed insted

Find the desired frame and press the arrow button. The offset will be automatically calculated and recorded into the offset field of the secondary events table. To cancel the operation, hit the Esc key.

A secondary event with incorrectly specified offset time will not be fired. In this case, proper color indication is used for convenience. A secondary event will not be fired if positive offset time reaches the next playlist item. In this case, the "Absolut" field will be highlighted in red.

Note
Please note, a secondary event may also fail to fire at the end of the item with zero offset; similar color indication will be used in this case. It is recommended to fire the event at least several frames before the item end.
Secondary_event_offset_1.png

If a negative value is used for offset time and it is out of the previous item boundaries (for example, the timecode value is before the previous item Start), the time in the "Absolute" field will be displayed in red and the event will not be fired.

Secondary_event_offset_2.png

Favorites

Selected events can be added to the list of frequently used events (Favorites) from the right-click menu: "Add to the Favorites". The following dialog appears:

Favorites_Add

Specify a more meaningful name of the Favorite event or leave the default one. You can add an event to the root of Favorites, or organize it into a separate group. To create a new group of events, press the "New Group" button:

Favorites_Group

Enter the name of your custom group and specify the group where it will be located.

Having specified the name and the location of your Favorite event, press "OK". The event with its parameters will be added to the list of Favorite events.

To edit and organize your Favorite events, use the "Edit Favorites" context menu command. The following window will appear:

Favorites_Edit

In this editor, you can edit and delete events as well as add new groups and events.

To add a new group here, select the new group location folder, press the "New Group" button and enter the group name. When no folder is selected, the new group will be created in the root catalog.

You can organize elements by selecting them and dragging-and-dropping them to the desired position or folder.

To add a new Favorite event, press the "New Item" button and manually fill in all necessary fields for the secondary event in the following form:

Favorites_New_item

Similarly, you can edit the existing Favorite event by pressing the "Edit" button and changing the required field value:

Favorites_Edit_command

Having made all necessary changes, press "OK" to close the editor window and apply the changes.

To insert a stored Favorite event into the events table, simply select the event you need from the right-click menu > "Insert from the Favorites". The event with its options will be added to the events table.

Favorites_Insert
Note
The "Insert All" command is available within a group of Favorites events to insert all group items at once.

Secondary events can be also applied via the "Add events from Favorites" command from playlist item right-click menu. This allows applying secondary events to multiple selected playlist items.

Add_events_from_Favorites

Predefined Commands

The following group of context menu commands of the secondary events panel allows you to add and set up the secondary events parameters:

predefined%20commands

Logotype Managing

Cinegy Air allows you to add a logotype to one or several channels simultaneously, i.e. HD and SD playouts may have their own logos. It can be done via the "Cinegy Basic Overlay Editor" as it is described below.

Show

Use the "Basic Overlay" > "Show…​" command to show a logotype on the screen over the top of the currently broadcast item content. When you select the "Show…​" command, the "Cinegy Basic Overlay Editor" dialog appears:

open_logo

This dialog consists of two parts: "Edit Basic Overlay", where you can define the logo settings, and "Preview", where you can preview the selected logotype.

The "TV Format" list contains all video formats supported by the Cinegy system.

Note
You can assign the different logos for each TV format separately.

Use the "Align" pull-down list to specify the logo location on the screen.

If you need to use video instead of a static image as your logotype, you can define whether it will be played back in loop or not. To do it, click the cell of the corresponding TV format in the "Loop" column and tick off or remove the selection of the checkbox.

Note
By default, the loop playback is enabled.

To specify the fade-in time of the logotype on the screen, set the time value in the "Fade" column by pressing the up/down arrow button or entering the desired value via the keyboard. The fade must be between 0.0 and 10.0 sec.

Click the cell of the corresponding TV format in the "File" column and press the "…​" button to browse the folder where graphic files (with any of the following extensions: *.tga; *.bmp; *.tif; *.jpg; *.png; *.gif; *.psd) or video files (in any media file format supported by Cinegy) are stored.

Having selected the file for the logo and specified its parameters, press the "OK" button to apply the settings. The "Show" command will be added to the command table.

To change the parameters for the selected channel logotype, you can also use the "Properties…​" command from the right-click menu.

An example with the Cinegy logo imprinted in the upper right corner is shown below.

show_logo_screen

Hide

To hide the logo, use the "Basic Overlay" > "Hide" command from the context menu. The corresponding command will be added to the secondary events panel.

logo_hide_table

Offset Time

It is also possible to define the offset time for showing/hiding your logotype. To do this, double-click the cell in the "Offset" column for the desired playlist item and enter the offset value using the keyboard. If the item duration value is higher than the offset time defined, your logotype will not be shown/hidden according to your settings and the absolute time value will be displayed in blue.

Note
In control mode, the "Offset" and "Absolute" values are read-only for the items being played back.

Cinegy Titler

Cinegy Titler is a new software option for channel branding and live graphics. It is hardware independent and can run even in any virtual environment with no physical video board.

Show

Use this command to add the CG templates, previously created via the Cinegy Titler application.

Important
Refer to the Creating a New Titler Scene article within the Cinegy Titler Manual for detailed information on how to create CG templates.

Select the layer for the CG scene. The "Logo" layer is a topmost layer; all other layers are displayed in a numerical order.

Cinegy_Titler_show

The "CG Browser" dialog will appear:

Cinegy_Type_Template_Editor
Important
Refer to the Cinegy Air Configurator article to learn how to select the corresponding playout mode and set up the Cinegy Titler repository directory.

In the "Information" group, the basic CG template data, such as its name, duration and TV format are displayed. The number of missing media files (if any) is displayed in the "Missing Media" string.

The "Override CG Root with CG Repository folder" option is used for previewing templates with embedded media items that were moved between locations.

Important
For detailed information about CG repository, refer to the Cinegy CG Root Folder paragraph in the Cinegy Playout Manual.

In the "Repository" field, you will see the list of available CG templates of the corresponding TV format. Choose the CG template you want to add; its preview will be displayed in the "Preview" window. You can view any frame of the template by dragging the time slider or using the playback buttons.

First frame button Last frame button

The "arrow" buttons jump to the first and last frame respectively.

Play button Pause

The "Play/Pause" button toggles playback mode.

The "Template parameters" table shows the CG template variables. You can edit the value of each variable by double-clicking in the "Value" field.

If you want to save a template with new parameters as a separate template, press the "Save as new template" button and specify the location for the new template.

Having set up all the necessary parameters, press "OK".

Hide

Use this command to stop the specified CG scene layer display.

Cinegy_Type_hide
Cinegy_Type_in_playlist

When adding an item or loading a playlist that contains a Cinegy Titler template missing in its configured repository, the following notification will be displayed:

Ignore_Type_templates

Press the "Ignore All" button to disable error messages about missing Cinegy Titler templates during the current insertion operation.

Cinegy Type

The Cinegy Type secondary events configuration procedure is similar to that of Cinegy Titler, except the "Exit Loop" command described below.

Exit Loop

The "Exit Loop" command is used to trigger the CG scene to leave the loop and play to its end.

Cinegy_Type_hide

Cinegy Capture

The Cinegy Capture secondary event is used to control recording tasks.

Capture_secondary_event
Note
Please note that for recording tasks to be carried out, Cinegy Capture Engine service should be configured and started. Also Engine templates should be created for this Cinegy Capture Engine.
Important
Refer to the Cinegy Capture documentation for detailed description of setup and work with Cinegy Capture modules.

The Cinegy Capture secondary event can be used to record the broadcast. For this, Cinegy Air output should be set up and Cinegy Capture service should be configured to receive this as an incoming stream. Then, using the secondary commands described below, you can control the recording session.

Start Recording

This command is used to start the recording session. Having selected this command, you will see the following dialog:

Capture_start

Here define the server name where the Cinegy Capture Engine is launched, and specify the Engine service number that will be used for stream recording. After that press the "Validate and get templates" button:

Capture_start_validated

If connection with Cinegy Capture Engine is successfully validated (status changes to "Ready"), the list of templates becomes available. Select the corresponding template and press "Ok" to finish the secondary event creation.

Stop Recording

To stop the Cinegy Capture recording job, use the "Stop Recording…​" command. The following dialog appears:

Capture_stop

Specify the server name and Cinegy Capture Engine service number, then press the "Validate" button to establish connection. When connection is successfully validated, press "Ok" button to finish creating the secondary event.

Split Clip

The "Split Clip…​" command is used to force a new clip creation during the recording session at a time defined as a secondary event start.

Having selected this command, you will see the following dialog:

Capture_split

Specify the server name and Cinegy Capture Engine service number, then press the "Validate" button to establish connection. When connection is successfully validated, press "Ok" button to finish creating the secondary event.

Secondary Recording

secondary_recording

Secondary recording options allow to control the MPEG recorder output device.

Record On

Use this command to define the recording parameters and turn the recording on. Select the "Record on…" command; the following dialog box appears:

Predefined_commands_record-on

Here define the path to the file that will be recorded and enter the recorder ID via the keyboard.

Record Off

Use the "Record off…" command to turn off the recorder; the following dialog box appears:

Predefined_commands_record-off

In the "Name" field, enter the name of the recorder to be turned off.

The virtual device "RECORDER" is added as a secondary event. The command format is as follows:

Device Command Option1 Option2 Comment

RECORDER

ON

<output_file_name>

<recorder_id>

Start recording

RECORDER

OFF

-

<recorder_id>

Stop recording

Predefined_commands_record-on_playlist

It starts or stops the recording into an MPEG file by the recorder referenced by Option2 (<recorder_id>).

The "Record on…​" / "Record off…​" operations performance is represented in the secondary events table shown above.

Audio Ducking

Use this command to enable/disable audio ducking (playback of audio file with defined volume level reduction of all other audio channels) as a secondary event.

First you need to specify the audio matrix source file that defines the ducking matrix to apply. This can be done via the Cinegy Air Configurator.

Important
The "Audio Ducking" option is available only if a valid path for audio matrix presets is defined in Cinegy Air Configurator. Please, refer to the Cinegy Air Configurator article to learn how to define the audio matrix presets location.

The ducking matrices can be configured by editing the source XML file according to your needs.

Important
Refer to the Audio Profile Editor to get more information on creating and editing audio profiles.

After specifying the audio matrix file the "Ducking" command will be available for adding as a secondary event. Select the "Audio Ducking" > "Start Time…​" context menu command:

Ducking_start

A common "Open" dialog appears:

ducking_open

Here select a secondary audio file to be used for ducking, a required ducking preset from the corresponding pull-down list and press the "Open" button.

Note
The automatic half a second fade in and fade out of the main program audio are added before and after the ducking event correspondingly.

The corresponding SHOW command will be added for the *AUDIO device on the secondary events panel.

ducking_ext_commands

To turn ducking off, use the "Audio Ducking" > "Stop" context menu command.

Event Service

The secondary events syntax is described in detail in the Secondary Events Syntax article within the Cinegy Event Manager Manual.

HTTP Calls

Cinegy Air can natively generate HTTP calls to control other Cinegy Air instances, or any 3rd party devices supporting REST protocol.

Note
Please note: sending HTTP command is supported by Cinegy Playout and does not require Cinegy Event Service.

The syntax is as follows:

Device: HTTP

Command: request method (GET/POST)

Op1: URL

Op2: request body (for POST)

Op3: optional HTTP headers, separated by /r/n. The last header should not have /r/n.

Important
Refer to the HTTP API documentation of the Cinegy products for details.

Stream Switcher Control

It is possible to establish control over RTP stream sources switching via the Cinegy Air control application by means of secondary events.

The setup procedure consists of three stages requiring specific application configurations. Each stage is described further in this article in detail.

1. Cinegy Stream Switcher Configuration

Install and configure Cinegy Stream Switcher tool for automatic switching of RTP stream sources in redundant configuration as described in the Cinegy Stream Switcher manual.

Note
Cinegy Stream Switcher is used for the Cinegy Air configuration, where RTP streams from two playout servers are monitored.

2. Local Cinegy Event Manager Configuration

Install the local Cinegy Event Manager. After the installation is completed, configure the Cinegy Route device.

3. Cinegy Air Configuration

The final setup stage contains the description of the Cinegy Air control application configuration.

To implement Cinegy Stream Switcher control, select the needed playlist item and use the "Edit Favorites…​" context menu command from the secondary events panel. In the configuration window that appears, press the "New Item…​" button. In the following "Event properties" window specify the corresponding parameters:

  • Name – specify the name for the event;

  • Offset – define the time offset from the item start/end (depending on the value defined in the "From" field);

  • Device – specify the STREAM_SWITCHER as the device that will receive the event;

  • Command – enter a command name via the keyboard. The supported device commands description is given in the table below.

Command Name Action Taken

START

Causes a stopped channel to start. If already started, no action.

STOP

Causes a started channel to stop. If already stopped, no action.

MAIN

Triggers a change to the MAIN IP source. If already MAIN, no action.

BACKUP

Triggers a change to the BACKUP IP source. If already BACKUP, no action.

CHANGE

Loads the settings as contained in the OP3 parameter passed in.

  • Option1…3 – define the command options. An overview of the command options is represented in the table below.

Command Options Action Taken

OP1

The name or IP address of the Stream Switcher Server to address. If empty, the plug-in default parameter is used.

OP2

The channel name or channel zero-based numerical index to address. If empty, the plug-in default parameter is used.

OP3

Contains XML profile data to apply to the channel as replacement settings.

Note
This option is used by CHANGE command only.
  • Description – provide the event description;

  • ID – define the secondary event ID which is logged into the as-run log for every event raised.

Having defined all the event parameters, press "OK" to close the configuration window and apply the changes.