Pr Marker

Accessing a Particular Marker

In contrast to projects, project items, sequences and clips, markers are not represented as texts in Automation Blocks. Therefore, the only way to access a particular marker is by using the blocks in this section (specifically For Each Marker and Get Marker).

For Each Marker

This block iterates over all markers (or all markers of a particular type) in the given sequence or project item. The blocks you nest inside this block are called one time for each of those markers. During this execution, the respective marker is stored in the variable my marker.

sequence or project item

Here you can specify the sequence or project item whose markers you want to modify. You can also provide a clip here; if you do, the block uses the markers of the project item of that clip (which are also the markers that Premiere Pro shows on clips in the timeline).

type

With the type filter, you can limit the result to only markers of a particular type. The available types are the same as in Premiere Pro's Edit Marker Dialog:

• all markers
• comment marker
• chapter marker
• segmentation marker
• web link
• Flash Clue Point

Get Marker

marker number

The numbering of markers starts with 1 for the first marker. To figure out how many markers (or how many markers of a particular type) a sequence or project item has, you can use the Get Number of Markers Block. If you want to do something with each marker, the For Each Marker Block is the much faster and easier solution.

type

With the type filter you can limit the results to only the markers of a particular type. If you choose comment marker, for example, marker 1 is the first marker of type comment. The available types are the same as in Premiere Pro's Edit Marker Dialog:

• all markers
• comment marker
• chapter marker
• segmentation marker
• web link
• Flash Clue Point

sequence/project item

Here you can specify the sequence or project item whose markers you want to modify. You can also provide a clip here. If you do, the block uses the marker of the project item of that clip (which are also the markers that Premiere Pro shows on clips in the timeline).

use variables

Usually, you want to do several things with the same marker (like changing both its name and comment, or start and end time). Instead of creating one copy of this block each time you need to access the marker, it is better to use this block just one time and store the result in a variable. Then you can use the variable to perform all the changes on the marker.

This not only creates cleaner code, it also calculates much faster.

Get Number of Markers

This block returns the number of markers of the given sequence, project item or clip.

type

With the type filter you can limit the result to only markers of a particular type:

• all markers
• comment marker
• chapter marker
• segmentation marker
• web link
• Flash Clue Point

Create Marker

Creates a new marker in the given sequence, project item or clip at the given time.

Time

The time is given in seconds (see the blocks in Pr Time for converting between different time and timecode formats). For sequences, a time of 0 corresponds to the beginning of the sequence, and for clips and project items, a time of 0 corresponds to the beginning of the corresponding footage.

Save it in Variable

The block saves the created marker in the variable my marker. So, if you want to set marker properties like the name, comment, type, duration, color etc., you can use this variable with the Set Property of Marker Block.

Get Property of Marker

This block can retrieve any of the properties of a marker listed below. As a marker, you need to give a marker variable, as created with the For Each Marker Block, the Get Marker Block, or the Create Marker Block.

start time

The start time of the marker in seconds. For sequence markers, 0 is the beginning of the sequence, for project items and clips, 0 is the beginning of the corresponding footage.

end time

The end time of the marker in seconds. For sequence markers, 0 is the beginning of the sequence, for project items and clips, 0 is the beginning of the corresponding footage.

duration

The duration of the marker in seconds. If you set the duration, it will change the end time and keep the start time unchanged.

name

The name of the marker.

comments

The comments of the marker. In contrast to the marker name, this text can have multiple lines - you can use the multiline text block in the Text section for that.

type

The type of the marker. One of these texts:

• Comment
• Chapter
• Segmentation
• WebLink

color

The color of the marker. One of these texts:

• Green
• Red
• Purple
• Orange
• Yellow
• White
• Blue
• Cyan

color index

The color index - a number between 0 and 7, where 0 represents Green and 7represents Cyan. If you set this value, you can also give higher (or even negative) numbers, and Automation Blocks will then start to loop the colors. So 8is the same as 0, 9is the same as 1, etc.

web link URL

The web link URL (only for markers of type WebLink). If you set this value, the marker type is switched to WebLink automatically.

web link frame target

The web link frame target (only for markers of type WebLink). If you set this value, the marker type is switched to WebLink automatically.

guid (unique ID)

The unique identifier of the marker, created at the time of creation.

Set Property of Marker

This block can set all kinds of properties of a marker. For a detailed description of which properties can be set, read the documentation of the Get Property of Marker Block.

Delete Marker

This block deletes a single marker of the given sequence, project item or clip. Marker numbers start with 1 for the first marker.

type

If you choose a particular type of marker, the marker number only takes markers of this type into account. So, if you choose comment marker instead of all markers, 3 denotes the third comment marker, for example.

Delete All Markers

This block deletes all markers within the given sequence, project item or clip. You can also choose to only delete all markers of a particular type.