====== 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.

<code>
Event_Explicit
/Event_Name= 
/Frame= 
/Time=
;
</code>

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.

{{:ExplicitEventDlg.jpg}}

=== 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

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

This example will place an event at the time metric TEST_TIME

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

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

<code>
Event_Explicit
/Event_Name= START
/Frame= 1
/Time=
;
</code>

[[Visual3D:Documentation:Definitions:EOF_(End_of_File)|EOF]] is now recognized as the last frame in the file, and the minus sign can be used.

<code>
Event_Explicit
/Event_Name= END
/Frame= EOF
/Time=
;
</code>

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

[[Visual3D:Documentation:Definitions:EOF_(End_of_File)|EOF]] is now recognized as the last frame in the file, and the minus sign can be used.

<code>
Event_Explicit
/Event_Name= TEST
/Frame= EOF - 10
/Time=
;
</code>

=== Example: Create an event at multiple frames ===

Introduced in Version 6
\\


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

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
**;**