Fields for a PNG asset
| Field on web interface | Tag in the XML | Type | Description |
|---|---|---|---|
| Insertion Mode | <insertion_mode> | String | Choose png. |
| Input | <uri> | String |
The path and file name of the PNG files. Provide the path and file name of the first PNG file in the series. All files in the series must have the same number of digits in the numerical part of the file name. For example, if the files are stored on
/mnt/storage/motion_logos/ and the files are named
logo_hi_001 to logo_hi_357, enter
When using Amazon S3, you can optionally append the path as follows:
Default values for RRS and SSE are
|
| Username Password | <username> <password> |
If access to your local or mounted directory requires a user name and password, click the lock icon next to the Input field to show the Username and Password fields. For Amazon S3, enter the access key ID in the username field. Enter the secret access key in the password field. |
|
| Left | <image_x> | Integer |
Placement of the left edge of the motion overlay relative to the left edge of the video frame, in pixels. 0 is the left edge of the frame. Take note of the width of the motion overlay and make sure that the position of the left edge of the motion overlay does not cause the right edge to be cropped. |
| Top | <image_y> | Integer |
Placement of the top edge of the motion overlay relative to the top edge of the video frame, in pixels. 0 is the top edge of the frame. Default 0. Take note of the height of the motion overlay and make sure that the position of the top edge of the motion overlay does not cause the bottom edge to be cropped. |
| ActionTime | <action_time> | String | The start time for the motion overlay. Specify the start time in one of the formats discussed in detail below this table. |
| Numerator Denominator | framerate_numerator framerate_denominator |
Integer | On the web interface, enter the frame rate as a
numerator over a denominator. For example, 29.97 fps
is a numerator of 30000 and a denominator of 1001.
Enter numbers that give a frame rate ratio between 1
and 120. When using the REST API, enter the numerator and denominator separately. |
| Loop Input | <loop_input> | Boolean |
• Select to loop the motion overlay indefinitely. The motion overlay will run until the event ends. To stop the motion overlay earlier, see Step C: Manage the motion overlay on a running event . • Clear the check box to run the motion overlay only once. |
| Full Frame | <full_frame> | Boolean |
Expand the motion overlay to fit the video frame. In this case, make sure Left and Top are set to 0. If this field is selected and the motion overlay has a different aspect ratio to the underlying video, the motion overlay will be scaled until one of the following applies:
Note that the Stretch to output field in the Stream section does not affect the motion overlay; even if the video is stretched, the motion overlay is not stretched. |
| Active | <active> | Boolean |
Always select this box when initially setting up the motion overlay. After the initial setup, the value of this tag can be changed via the REST API to manage the content and behavior of the motion overlay. |
| Enable REST Control | <enable_rest> | Boolean | Select this field only if you plan to manage motion overlays via the REST API, after this initial setup via the web interface. Typically, you will want this tag to be true. |
Action time formats
Option 1: Timecode format (HH:MM:SS:FF).
The value to enter for HH:MM:SS:FF depends on the method used to calculate the output timecode. This method is specified in the Timecode Configuration > Source field. Identify the source method set for your event, then set the action time to match the timecode of the frame where you want the action to occur.
-
If Source is Embedded: The output timecode is extracted from the timecode that is carried with the input media. That timecode becomes the output timecode for the first transcoded frame. Then the output timecode counts up with each successive frame in the entire output. For example, 10:24:25:20, 10:24:25:21, and so on.
-
If Source is Start at 0: The output timecode for the first frame is 00:00:00:00 and then the output timecode counts up with each successive frame in the entire output. For example, 00:00:00;01: 00;00:00:02, and so on.
-
If Source is System Clock or Local System Clock: The output timecode for the first frame is the system time at which the frame is decoded. Then the output timecode counts up with each successive frame in the entire output. For example, if the first frame is decoded at 09:45:51, then that timecode is 09:45:51:01. The timecode for the next frame is 09:45:51:02, and so on.
-
If Source is Specified Start: The output timecode for the first frame is the time you specified when you selected this option as the timecode source. Then the output timecode counts up with each successive frame in the entire output. For example, if you set the time to 15:30;00, then the timecode for the first frame is 15;30:00:01, and so on.
-
If Source is External Reference Connector: The timecode is extracted from external LTC source. That timecode becomes the output timecode for the first transcoded frame. Then the output timecode counts up with each successive frame in the entire output. For example, the timecode for the first frame is 20:03:19:01, then 20:03:19:01, and so on.
Option 2: ISO 8601 UTC time with no dashes or colons. For example, 20160102T030405.678Z. In this case, the start time for every motion overlay will be the UTC time.
Option 3: You can only use
this option while adding or modifying a motion overlay in a
running event. Set the action_time tag to an empty
string to set the start time to “now”. With this option, the
start time is never exact. You cannot use this option when
creating an event or modifying a non-running event.
