Event Explicit

The Event_Explicit command will place an Event Label at an explicit frame number, or at the nearest frame to a specified time. You can specify either a Frame or a Time but not both.

Event_Explicit
/Event_Name= 
/Frame= 
/Time=
;

The command can be edited in a text editor or in a dialog form. To edit in the dialog pop up form either click on the Edit button in the pipeline workshop or double-click on the pipeline command. The dialog is shown below.

Example: Specify an event based on a metric

Here are two examples of creating explicit events based on metrics for frames and time.

This example will place an event at the frame metric TEST_FRAME

Event_Explicit
/Event_Name= TEST
/Frame= METRIC::PROCESSED::TEST_FRAME
! /Time=
;

This example will place an event at the time metric TEST_TIME

Event_Explicit
/Event_Name= TEST
/Frame= 
/Time=METRIC::PROCESSED::TEST_TIME
;

Example: Create events at the start and end of the trial:

Event_Explicit
/Event_Name= START
/Frame= 1
/Time=
;

EOF is now recognized as the last frame in the file, and the minus sign can be used.

Event_Explicit
/Event_Name= END
/Frame= EOF
/Time=
;

Example: Create an event 10 frames before the end of the trial:

EOF is now recognized as the last frame in the file, and the minus sign can be used.

Event_Explicit
/Event_Name= TEST
/Frame= EOF - 10
/Time=
;

Example: Create an event at multiple frames

Introduced in Version 6

Event_Explicit
/Event_Name= TEST
/Frame= LIST(1,5,10)
/Time=
;

This command will create three instances of the EVENT_LABEL TEST at frames 1, 5, and 10

Example: Create an event at one second intervals

! Determine the number of ranges ! For some files this might be 1 too many but it won't matter. Set_Pipeline_Parameter_From_For_Loop /PARAMETER_NAME=COUNT /PARAMETER_INDEX_START=1 /PARAMETER_INDEX_END=METRIC::TIME::TOTAL /PARAMETER_INDEX_STEP=1 ! /PARAMETER_INDEX_TYPE=INTEGER ; ! execute a For_Each loop For_Each /ITERATION_PARAMETER_NAME=INDEX ! /ITERATION_PARAMETER_COUNT_NAME= /ITEMS=::COUNT ; Event_Explicit /EVENT_NAME=TEST ! /FRAME= /TIME=::INDEX ; End_For_Each /ITERATION_PARAMETER_NAME=INDEX ;