Duration Settings

Encoding.com permits frame-accurate editing of output material. These jobs can be chained to perform full assembly workflows.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <format> <!-- REQUIRED -->
        <output>[output]</output> <!-- REQUIRED -->
        <start>[StartTimecode]</start>
        <finish>[FinishTimecode]</finish>
        <duration>[Duration]</duration>
        <apply_timecode>[yes|no]</apply_timecode>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "addMedia",
        "format": {
            "output": "[output]",
            "start": "[StartTimecode]",
            "finish": "[FinishTimecode]",
            "duration": "[Duration]",
            "apply_timecode": "[yes|no]"
        }
    }
}

Parameter

Description

Allowed Value

Default

start

Time of source media that will be used as starting time of output media.

  • positive float number in seconds
  • timecode in format HH:MM:SS[:;]FF
    HH – hours
    MM – minutes
    SS – seconds
    FF – frames
    [:;] – : – non drop-frame, ; – drop-frame;

none

finish

Time of source media that will be used as finishing time of output media.

  • positive float number in seconds
  • timecode in format HH:MM:SS[:;]FF
    HH – hours
    MM – minutes
    SS – seconds
    FF – frames
    [:;] – : – non drop-frame, ; – drop-frame;

none

duration

Duration of resulting output media.

  • positive float number in seconds

none

apply_timecode

Use source media muxed timecode to calculate start and finish points.

yes, no

no

🚧

Note

If the <duration /> parameter is specified, the <finish /> parameter will be ignored.

🚧

Note regarding use of apply_timecode when using ad signal insertion (SCTE35)

Specifying<apply_timecode /> will apply timecode value conversion of the <start /> and <end /> parameters of <ad_break />/<cue_insert />.