Options for Premiere Pro

The options below are designed for Premiere Pro, they don't run with packages of other types.

PR


Options

timing_offset_ticks

Allows you to set the offset when applying the sequence Premiere Pro (.prproj) to a timeline track.

This option is very useful for applying transitions - because it allows you to apply a sequence by splitting it into two parts at the cursor position.

When you double-click on the element (if the option is disabled/enabled):

Timing Offset Double-Click

Thanks to the offset, our applied elements have shifted to the left and are positioned directly in the center of the cursor position, so we don't have to move the applied element every time.

note

This option also interacts when an element is applied by dragging (Drag & Drop).

However, the cursor position is now irrelevant, and the center point will be the starting point of the item being dragged. After applying the element, the cursor will also be moved to the center

Timing Offset DND

tip

If in your sequence (the source file for the application) if there are audio tracks, then for this option to work correctly, they must start from a single time point. This applies only to the starting point of time.

Timing Offset DND

Process for getting values for a parameter

To do this, open Dev Panel:

Open Dev Panel

Next, select 1 layer inside the sequence (we need the layer on the left).

As mentioned earlier: if there is audio track(s), it should not be longer than our layer. It should start at the same time, or later.

Timing Offset Select layer

Before deselect the layer, click the PR: getTimeOffset button in the Dev Panel.

Timing Offset Dev Panel Get Offsets

An option will appear in the terminal window with the value - this is a whole code to insert, but without the custom_argsconstruct. Copy the value from the terminal and paste it inside the custom_args construct for your element.

Timing Offset Dev Panel Terminal Value

If there are other values inside the custom_args construct, add a comma before adding the next one. Read more here.

Common code example
"Template": {
"preview": {
"SHR_1": {"enabled": true, "name": "Sequence 1", "options": false,
"custom_args": {"timing_offset_ticks": 84756672000}
}
}
}
Option (separately)
"timing_offset_ticks": 84756672000
Option (including the construction)
"custom_args": {
"timing_offset_ticks": 84756672000
}

duration_ticks

If you use sequences Premiere Pro (.prproj) in its own package, this parameter is important for the correct application of elements to the timeline track.

This parameter checks duration of sequence.

warning

Applying sequences by double-clicking that do not have this parameter may not work correctly.

Process for getting values for a parameter

To do this, open Dev Panel:

Open Dev Panel

Next, select all the elements on the one video track (we need the video track with the longest length, regardless of the number of elements on it).

Timing Offset Select layer

Without removing the selection from the layers, click the PR: getDuration button in DevPanel.

Timing Offset Dev Panel Get Offsets

An option will appear in the terminal window with the value - this is a whole code to insert, but without the custom_argsconstruct. Copy the value from the terminal and paste it inside the custom_args construct for your element.

Timing Offset Dev Panel Terminal Value

If there are other values inside the custom_args construct, add a comma before adding the next one. Read more here.

Common code example
"Template": {
"preview": {
"SHR_1": {"enabled": true, "name": "Sequence 1", "options": false,
"custom_args": {"duration_ticks": 127135008000}
}
}
}
Option (separately)
"duration_ticks": 127135008000
Option (including the construction)
"custom_args": {
"duration_ticks": 127135008000
}

tracks_used

If you use sequences Premiere Pro (.prproj) in its own package, this parameter is important for the correct application of elements to the timeline track.

This parameter checks and reserves the required number of tracks for our elements, thus avoiding substitutions of other elements on the timeline.

warning

Applying sequences by double-clicking that do not have this parameter may not work correctly.

The same applies to the sequences by means of a dragging (Drag and Drop), but in a smaller volume.

Specify the number of tracks occupied by elements in your sequence (for video and audio separately).

Tracks Used Sample

In the example above: clips on a sequence occupy 2 video tracks and 1 audio track.

note

We calculate:

  • Only tracks filled with elements.
  • Only the number of occupied tracks, not the elements themselves on them.

We should write it down like this: [number of video tracks, number of audio tracks]

In our example, this is: [2, 1]

Common code example
"Template": {
"preview": {
"SHR_1": {"enabled": true, "name": "Sequence 1", "options": false,
"custom_args": {"tracks_used": [2, 1]}
}
}
}
Option (separately)
"tracks_used": [2, 1]
Option (including the construction)
"custom_args": {
"tracks_used": [2, 1]
}