Templates Panel

Reading time ~16 minutes

The Templates panel provides means for creating and customizing engine templates:

The engine templates, individually configured for each Cinegy Capture engine service, as well as for the global PCS storage are listed here. The template type (Archive or Standalone), validity information and video format is displayed for each of the configured templates.

Note	Please note that validity information is not displayed for the Cinegy PCS templates.

To create a new local template, select the required service on the "Templates" panel. To create a new global template in the global Cinegy PCS storage, click "Global". Press the Add button, the Template Editor will be launched. The configuration groups and parameters to be set up depend on the template type chosen: Standalone or Archive.

Note	You can create as many engine templates for each engine service as you need to meet your capturing requirements.

Global PCS Storage

The global Cinegy PCS template storage serves as a centralized database where preconfigured Standalone and Archive templates are held and can be easily accessed.

Important

Refer to the Cinegy Process Coordination Service Manual to learn about the Cinegy PCS installation and database configuration.

Press the Global_storage_settings button to launch the Cinegy PCS configuration form:

In the dialog box that appears, specify the machine name running the Cinegy PCS service and press "OK". The templates from the specified Cinegy PCS storage will be listed in the "Global" section:

Global_templates_storage

Standalone Templates

When the "Standalone" template type is selected, the Template Editor looks as follows:

General Settings

Here, specify the following parameters for your recording session:

Name – the name of the engine template being created/edited.
Clip name – the name of the clip(s) to be created during the recording session.
Tape name – the tape name to be created during the recording session.

Filename pattern – the name of the output file(s).

For "Clip name", "Tape name" and "Filename pattern" you can use the following macros to apply naming automation:

Macro

Meaning

Generates random alphanumeric tape ID.

Note	The %A macro is only available for the "Tape name" field.

The specified clip name. The unsafe characters are replaced with the "-" symbol.

Note	The %C macro is not available for the "Clip name" field.

The recording session start date.

The recording session start time.

The ordinal number of the file when the recording session is set up to be split into several files.

The ingest operator.

The TV format.

The engine number.

Note	The %E macro is only available for the "Filename pattern" field.

Generates unique GUID for the recorded resource.

Note	The %G macro is only available for the "Filename pattern" field.

The engine label.

Note	The %L macro is only available for the "Filename pattern" field.

So far the % symbol is entered in the text field, the list of available macros is displayed in a tooltip:

Override existing file(s) – with this option enabled, existing files having the same names will be replaced with the ones being captured during the recording session.
Clip auto-split – the frequency of a new clip creation during the recording session. Use this option during continuous capture sessions to avoid creating huge files, splitting them into smaller ones instead.
BITC (Burnt-in Timecode) enabled – select this option to overlay the timecode onto the output during the recording session.

Timecode Analyzer Settings

This parameters group allows you to specify values for analyzing timecodes received from the timecode normalizer, both in frames. Minimum values of 2 and 3 frames respectively are used by default. Maximum values are 18 and 19 frames respectively.

If inconsistency between timecodes is less than the "Maximum inconsistency" value and the number of inconsistent timecodes is less than the specified "Minimum consistency" value, the TC break is ignored and the capture session continues.

Here is an example where the TC can be restored: 1 2 3 4 x x 7 8 x 10 11 12 13 14 15…

In this example, timecodes are inconsistent between frames 4 - 7 and 8 - 10. In both cases, maximum inconsistency does not exceed 3 frames (7–4=3 and 10–8=2) and the number of consistent timecodes does not exceed 2. As a result, this timecode inconsistency is ignored and the capture session continues with no TC break; the consistent timecodes are generated.

Timecode is based on 24-hour time format meaning that it runs from 00:00:00:00 to 23:59:59:24 for PAL and from 00;00;00;00 to 23;59;59;29 for NTSC, that is, from midnight to one frame before midnight. For consistent timecode assurance, a target file is automatically split at one frame before midnight. But if you understand the risks caused by inconsistent timecode and want to get a whole file, use the "Do not split at midnight" option.

Events

Here you can add events to currently scheduled recording which are controllable via the secondary events through Cinegy Event Manager:

add_event_button

Press the "Add" button to add a new secondary event; the following dialog box appears:

Secondary_prep_event_adding

Here, define the following parameters:

Event preset – select the event preset created via Cinegy Capture Manager to be applied.
Type – select the type of event initialization, which determines whether the event occurs before or after the capture task.
Offset – define the time delay in seconds between the secondary event and the corresponding recording session start.

Having configured all the options, press the "OK" button for the secondary event to be added.

Edit_event_button

To modify an event, select it from the list and use the "Edit" button.

Delete_event_button

To remove unnecessary event, select it from the list and use the "Delete" button.

Coding Scheme Settings in Standalone Mode

The "Standalone" template type means that media files will be created only on the hard disks with no registration in MAM systems. Any number of output streams, formats and files can be supported in standalone mode. All the encoder parameters should be set individually for each encoder and wrapper.

Video Format

The "Video Format" field indicates the Cinegy Capture engine video format. When creating a new template or editing an existing one, the current video format can be changed by choosing the desired one from the drop-down list. The compatible codecs and wrappers will become available for the newly selected video format.

If the chosen format differs from the input TV format, the following dialog appears asking you to confirm your decision:

Note	Please note that NTSC 720x486 TV format is only supported in Standalone template configuration.

Important

For the list of supported TV formats refer to the Cinegy Capture System Recommendations.

Audio

Audio channel mapping allows you to mute or map available input audio channels into the output location, depending on the desired configuration. To start configuring audio mapping for a template, select either "Stereo" or "Mono" from the "Audio" drop-down list and press the "Configure" button:

The following dialog will be opened:

To map or unmap an audio channel, select or deselect the checkbox next to it. The deselected channels will not be mapped during recording session.

add_input_audio_channel

Press this button to add a new audio channel.

remove_audio_channel

Press this button to remove the selected channel.

Important

Please note that it is recommended to add the same number of channels configured via your engine service Audio Settings; otherwise, the template you are configuring will be invalid. The corresponding error message can be seen when hovering the mouse pointer over the invalid template: "Audio mapping has configured audio channel(s) that are not present in the engine configuration".

Media Encoders

Add_template

Press the "Add" button to add new video, audio and data encoders to be used by the current template for the recording session. The list with all compatible encoders will appear:

Media_Codecs_Add_Encoder

In the corresponding sections select the required video, audio and data encoders. To select several encoders within each section, click them holding the Ctrl key down or use Shift+ click to select a group of consecutive items.

Note	The list of available encoders may vary depending on the selected template video format. The audio and data encoders are only available when audio and data streams are properly configured via Cinegy Capture Manager for your engine service.

After you have selected the required encoders and pressed "OK", they will be represented in a table view as shown below:

Setup_link

Some encoders have additional settings. Press "Setup" next to the corresponding one or simply double-click its name to specify the required parameters.

Important

Refer to the Codec Settings paragraph for details on encoder configuration.

clear_selected_encoders

Pressing this button will remove all encoders from the list. You will be asked to confirm your decision with the following message:

confirm_encoders_deletion

remove_engine

Press this button next to the corresponding encoder to remove it from the list. Alternatively, select the unnecessary encoder and hit the Del key to delete it.

Watermark Imprinting

Watermark imprinting puts the desired information electronically on captured output media files that are saved in the Cinegy Capture output folder.

You can specify the file path to the overlay image for all video encoders at once by pressing the Add_overlay_to_all_button button in the media encoders caption; the following dialog box appears:

Overlay_settings_all_dialog

Press the Select_path_to_overlay button to choose the file path to the folder where overlay images in PNG format with transparency are stored. Once the "Add watermark on this encoder" checkbox is selected, the overlay will be applied to all video encoders in the list and the Select_overlay_button icon will appear next to the names of all video encoders.

To apply the overlay image to a specific encoder, press the Add_overlay_button button next to the necessary encoder. In the appearing dialog box with overlay settings for a specific encoder define the file path to the image and select the "Add watermark on this encoder" checkbox:

Overlay_settings_dialog

The overlay is applied to the selected video encoder only, which is indicated by the Select_overlay_button icon.

Note	The dimensions of the overlay image should be the same as the video format used on the current engine.

Wrappers / Outputs

Add_template

Press the "Add" button to add wrappers to be used for output by the current template for the recording session. The list of all available wrappers will appear:

Media_Codecs_Add_Wrapper

Here, select the required wrapper(s) from the list with the Ctrl key pressed or Shift+ click an item to select all the items between the last selected wrapper and the clicked one.

After you have selected the required wrappers and pressed "OK", they will be represented in a table view as shown below:

All wrappers are displayed in red until they are properly configured; do the following:

Select the required wrapper from the list.
Some wrappers have additional settings; press next to the corresponding wrapper or simply double-click its name to specify required parameters.

Important
Refer to the Wrapper Settings paragraph for details on video encoders configuration.
Select desired codecs from the lists of compatible video/audio/data encoders that have previously been added to the "Media Codecs" list:
Press the button to specify the output location. In the "Add Output" window that appears, press the button and browse for the desired location:

Any individual output location can be marked as "critical", meaning that failure of this output should cause the recording session to abort. Set the "Critical output" option to mark the required location as a critical output. Alternatively, this can be done directly from the "Output" panel by checking the "Critical" option.

Note
It is possible to add several output locations for each wrapper.

Note
It is possible to define a mapped drive as the output location.

Note
When the use of network storage with limited access is expected, you should first manually configure the Capture Agent service to run under a user with sufficient access rights.

Multiple wrappers with individually configured connected codec(s) can be added to each template as follows:

Edit_link2

Press "Edit" next to the corresponding output location to change it, if needed. You can also edit the output location by double-clicking the output name.

remove_engine

Press this button next to the corresponding wrapper / output location to remove it from the list. Alternatively, select the unnecessary wrapper / output and hit the Del key to delete it. You will be prompted to confirm your decision.

clear_selected_encoders

Press this button to clear all the selected wrappers / output locations from the list.

Archive Templates

Caution

Archive mode is only available with the Cinegy Archive Service installed and running along with running and properly configured Cinegy Capture Archive Adapter.

Select the "Archive" option from the "Template type" drop-down list:

Note	Please note that changing the template type causes reset of your coding scheme settings.

When the "Archive" template type is selected, the Template Editor looks as follows:

General Settings

"General settings" configuration of an Archive template is similar to that of a Standalone template except for the following parameters:

Roll name – the name of the Roll(s) to be created during the recording session;

Note	Enter the "%" symbol in the corresponding text field to open a tooltip with a list of available macros. The unique GUID is automatically generated and always added to the name of the output file(s).

Media group – the media group to be used for the recording session (selected from the drop-down list).

Important
Refer to the Media Groups paragraph in the Cinegy Archive Manager Manual to learn about media groups, their configuration and management.

Note	"Timecode analyzer settings" are identical for both standalone and archive template types.

Metadata Settings

In the "Metadata" parameters group specify the necessary ingest metadata in the corresponding fields.

Note	The list of metadata fields depends on your database settings.

Coding Scheme Settings in Archive Mode

Here, define the Roll creation rules for your capture session choosing the appropriate parameter from the "Integration mode" drop-down list:

One roll – all captured clips will be recorded into a single Roll.
One roll per day – all clips captured on a particular day will be recorded into a single Roll.
One roll per session – all clips captured during a particular capture session will be recorded into a single Roll.
One roll per TC sector – each timecode segment of the particular capture session will be recorded into a separate Roll. Each timecode break will cause a new Roll creation.

Note	If a macro is specified for the Roll name within the "General Settings" configuration group, the corresponding Roll creation rule is applied, regardless of integration mode defined.

Define the audio type to be used for encoding audio streams. All the available audio allocations in Cinegy Desktop can be configured here. Choose between stereo and mono from the "Audio" drop-down list:

Clips will have mono or stereo audio tracks depending on the audio type used for capturing. Press the "Configure" button next to the defined audio type. The "Audio Mapping" configuration dialog appears:

Here, the needed number of audio allocation channels can be configured independently, regardless of the audio channels number configured for your engine service. For each audio channel it is possible to define its type or disable it by selecting "Not in use" option.

Similarly, in mono audio mode it is possible to set the channels to be captured and to define the type they will be captured to or disable it by selecting "Not in use" option:

Mono channels will be grouped accordingly:

Having specified the audio channel types for your capture session, press "OK" to apply the changes.

Note	Separate sets of encoders are available for mono and stereo audio types.

Note	The Material Exchange Format (MXF) wrapper is available only for mono audio encoding type.

Multiple quality levels can be captured concurrently in one session. The typical qualities are:

High
Medium
Low
Web

Select the desired media quality, choose the required video and audio encoders, and define their configuration.

Having chosen the quality, select the "Critical target" checkbox to set both video and audio as critical outputs for the recording session. In case of video or audio failure, the whole recording session fails as well.

Important

Refer to the Available Qualities article in the Cinegy Desktop Manual for detailed information on quality levels used for capturing.

Important

Refer to the Codec and Wrapper Settings article for details on encoders configuration.

Go to the "Additional outputs" tab to define additional output formats supported in your template:

Note	The outputs configuration is similar to that one described in the Coding Scheme Settings in Standalone Mode paragraph.

Note	Archive outputs are captured into target folders and registered in the Cinegy Archive database, while additional outputs are written as standalone files (with no Cinegy Archive registration).

Additional output configuration allows you to preserve the configured archive media quality for the file wrapper. To select the required quality, use the drop-down list of compatible video/audio/data encoders:

The selected quality will be created for the media ingested into the additional output location.

Note	Please note that only qualities configured via the "Archive" tab are available for selection. An attempt to remove the selected quality via the "Archive" tab causes a warning message display.

OK_cancel_button

Having specified all the necessary capture session parameters, press the "OK" button to finish the template creation process. To close the Template Editor without changes, press the "Cancel" button.

Templates Management

Exporting and Importing

export_button

Use the "Export template" button to save the selected template in the *.TSchema or *.xml file formats. The following dialog box appears, asking you to define the location where your template will be stored:

Save_as_dialog

It is also possible to import several templates at once.

Import_button

Use the "Import template" button to load the previously saved template in the *.TSchema or *.xml file formats to the currently selected Capture service. The following dialog box appears asking you to select the file to be imported:

Open_template_dialog

Copying

To copy a template within the same or to another engine service, use the "Copy to" context menu command. Similarly preconfigured templates from the global Cinegy PCS storage can be copied to the engine service(s). The engine templates can also be copied to the global Cinegy PCS storage:

Alternatively, use simple drag-and-drop, holding the Ctrl key down or common key combinations Ctrl+C to copy and Ctrl+V to paste the copied template.

It is also possible to copy multiple templates at a time.

Moving

To move a template to another engine service or to the global Cinegy PCS storage, use simple drag-and-drop. Alternatively, use common Ctrl+X and Ctrl+V key combinations.

Editing

edit_template_button

You can edit any selected template by pressing the "Edit template" button or using the "Edit" context menu command:

Edit_button

Deleting

remove_template_button

You can remove any selected template (or several templates) by pressing the "Remove" button or by selecting the "Delete" command from the context menu:

Delete_button

Alternatively, select the template and hit the Delete key.

You will be prompted to confirm deletion.

Renaming

In order to rename a template, select it and press the F2 key or simply double-click it on the Templates panel, then enter a new name in the corresponding field.

Selecting Template for Recording Session

To select a template that will be used for the recording session, right-click the needed template and choose "Select" command from the context menu:

select_template_for_recording_session

Once the template is selected, its name is displayed in bold.

The Cinegy PCS templates can be selected for the recording session for the engine service by using the "Select for" command from the context menu:

set_current_template_button

Note	This option is available for the Cinegy PCS templates using the same input video format as defined for the engine service.

Setting Default Template

It is possible to set the default template, which will be selected in the Capture Control application on its first start.

The first and only valid template configured for the engine automatically becomes a default one.

Note	This option is not available for the Cinegy PCS templates.

To set a default template, right-click the required template and select the "Set as default" command from the context menu:

set_current_template_button

current_identifier

The star icon next to the template name identifies the current default template.

Validation

All templates of the engine services are automatically checked for validity and have a subsequent indication ("Valid" or "Invalid"):

Template_valid_invalid

Hover the mouse pointer over the "Invalid" indicator to display the tooltip describing a problem.

In some specific cases, previously created valid Archive templates may appear as "Invalid". A dedicated message is displayed when hovering a mouse pointer over the invalid template:

edition_mode_