Step B: Set up the Event - AWS Elemental Live

This is version 2.18 of the AWS Elemental Live documentation. This is the latest version. For prior versions, see the Previous Versions section of AWS Elemental Live and AWS Elemental Statmux Documentation.

Step B: Set up the Event

Using the web interface, create or modify a non-running event as follows:

  1. In the Global Processors section, go to the Image Inserter field and click On. More fields appear; see the table below.

    
                        images/screenshot_swfImgInst_big.png
  2. Complete the fields as follows:

    Field Description
    Insertion Mode Choose SWF.
    Input

    The location and filename of the SWF file.

    For S3, use sse=true to enable S3 Server Side Encryption (SSE) and rrs=true to enable Reduced Redundancy Storage (RRS). Default values for RRS and SSE are false.

    Username Password

    If access to your local or mounted directory requires a username and password, click the lock icon next to the Input field to show the Username and Password fields.

    For S3, Enter the Access Key ID in the username field. Enter the Secret Access Key in the password field.

    Left

    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

    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 The start time for the overlay. Specify the start time in one of the formats discussed in detail below this table.
    Loop Input

    • Check to loop the motion overlay indefinitely.

    The motion overlay will run until the event ends. To stop the overlay earlier, see the section on modifying overlays on a running event, in Using the REST API for Motion Overlays.

    • Clear checkbox to run the motion overlay only once.

    Full Frame

    Expand the overlay to fit the video frame. In this case, make sure Left and Top are set to 0.

    If this field is checked and the motion overlay has a different aspect ratio to the underlying video, the motion overlay will be scaled until either:

    • The motion overlay fits in the length. The overlay will then be positioned with equal space on the left and right.

    • The motion overlay fits in the width. The overlay will then be positioned with equal space above and below.

    Note that the “Stretch to output” field in the Stream section does not affect the motion overlay; even if the video is stretched, the overlay is not stretched.

    Active

    Always check 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.

    SWF Arguments If you included ActionScript code in the SWF asset and if that code includes arguments, enter values for the arguments in simple JSON name/value format.
    Enable Rest Control Check 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). If Timecode Source field is System Clock or Local System Clock (AWS Elemental Live only): The timecode of each frame in the input is the system time at which the frame is decoded.

    The overlay start is compared to the output timecode (which is shared by all outputs). The source for the output timecode is specified for the entire event, in the Timecode Config > Source field. The output timecode is calculated as follows:

    • If Source is Embedded: The timecode is extracted from the timecode 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.

    • 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.

    • If Source is System Clock or Local System Clock (AWS Elemental Live only): 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.

    • 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.

    • If Source is External Reference Connector (AWS Elemental Live only): 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.

    Option 2: ISO 8601 UTC time with no dashes or colons. For example, 20160102T030405.678Z. In this case, the start time for every overlay will be the UTC time.

    Option 3: You can only use this while adding or modifying an overlay in a running event. Set this 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.