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

;