====== Event Between ======
This pipeline command creates a new event label between two existing events in the c3d file (e.g. between the first and last event).
\\
==== Pipeline Command ====
Range_Instance=0 -> create the event in all instances of the Event_Sequence\\
Range_Instance=n -> create the event in the nth instance of the Event_Sequence\\
if n<0 count instances from last Event_Sequence; e.g. -1 = last instance\\
\\

|**Event_Between**                                                                                      |                                                                                                 |   
|/NEW_EVENT_NAME=                                                                                       |Name of the resulting Event to be generated by this command                                      |                                                         
|! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Range_Instance|RANGE_INSTANCE]]= 0  |The number of instances of the event to label                                                    |
|! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|EVENT_SEQUENCE]]=    |The event sequence that the new event should occur between                                       |
|! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Exclude_Events|EXCLUDE_EVENT]]=     |Skips an event sequence if it contains one of the events listed in this parameter (ex. BAD,BAD). |
|! /FRAME_OFFSET= 0                                                                                     |Frame Offset from the first event of the event sequence.                                         |
|! /TIME_OFFSET=                                                                                        |Time Offset from the first event of the event sequence.                                          |
|! /PERCENT_OFFSET=                                                                                     |Percent Offset from the first event of the event sequence.                                       |
|**;**                                                                                                  |                                                                                                 |
\\

**Range Instance Examples:**
Range_Instance=0 -> create the event in all instances of the Event_Sequence\\
Range_Instance=n -> create the event in the nth instance of the Event_Sequence\\
if n<0 count instances from last Event_Sequence; e.g. -1 = last instance\\

**Note**: Only one of the parameters **FRAME_OFFSET**, **TIME_OFFSET**, and **PERCENT_OFFSET** are used when the command is executed.\\
By default /FRAME_OFFSET= 0\\
In order to specify a TIME_OFFSET or PERCENT_OFFSET, you must set the FRAME_OFFSET to empty.\\
For example, a percent offset of 50 percent between RON and ROFF would be:\\
  Event_Between
  /NEW_EVENT_NAME=
  ! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Range_Instance|RANGE_INSTANCE]]= 0
  ! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|EVENT_SEQUENCE]]=RON+ROFF
  ! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Exclude_Events|EXCLUDE_EVENT]]=
  /FRAME_OFFSET=
  /TIME_OFFSET=
  /PERCENT_OFFSET= 50
  **;**
\\
==== Dialog ====
The following dialog appears when the **Event_Between** command has been added to the pipeline and the user double-clicks with the Left Mouse Button on the command.\\
{{:Event_Between.jpg}}
\\
==== Event_Between_Examples ====

For Example:

If a dynamic trial has two pre-existing events **LHS** and **LTO** . In the following examples a new event called **BTWN** will be created.

{{:Event_Between_Graph.jpg}}\\

\\


=== Range_Instance = 0 ===
{{ :Event_Between_InstanceZero.jpg?400}}
\\
Range_Instance= 0 -> all instances of the Event_Sequence will be used\\
Frame_Offset= 10 -> the new event will be created 10 frames after the first event\\
  Event_Between
  /NEW_EVENT_NAME=BTWN
  !/RANGE_INSTANCE=0
  /EVENT_SEQUENCE=LHS+LTO
  !/EXCLUDE_EVENT=
  /FRAME_OFFSET=10
  !/TIME_OFFSET=
  !/PERCENT_OFFSET=
  ;
\\

\\
\\
\\

\\
=== Range_Instance= 2 ===
{{ :Event_Between_InstanceTwo.jpg?400}}
\\
**Range_Instance = 2 ->** the 2nd instance of the Range will be used\\
{{ :Event_Between_InstanceTwoGraph.jpg?400}}

  Event_Between
  /NEW_EVENT_NAME= BTWN
  !/RANGE_INSTANCE=2
  /EVENT_SEQUENCE=LHS+LTO
  !/EXCLUDE_EVENT=
  /FRAME_OFFSET=10
  !/TIME_OFFSET=
  !/PERCENT_OFFSET=
  ;

\\



\\

\\

\\

\\
\\
\\
=== Range_Instance= -1 ===
{{ :Event_Between_InstanceNegOne.jpg?400}}
\\
**Range_Instance = -1 ->** the last instance of the Range will be used\\
{{ :Event_Between_InstanceTwoGraph.jpg}}
  Event_Between
  /NEW_EVENT_NAME= BTWN
  !/RANGE_INSTANCE=-1
  /EVENT_SEQUENCE=LHS+LTO
  !/EXCLUDE_EVENT=
  /FRAME_OFFSET=10
  !/TIME_OFFSET=
  !/PERCENT_OFFSET=
  ;

Note that this is exactly the same result as the example above because for this example signal the last instance = the second instance.