====== Event Between ======

\\


==== Event_Between ====

Create an Event within an event sequence (e.g. between the first and last event.
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=
! /[[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]]=
! /[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Exclude_Events|EXCLUDE_EVENT]]=
! /FRAME_OFFSET= 0
! /TIME_OFFSET=
! /PERCENT_OFFSET=
**;**
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
**;**
\\
{{: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 ===

\\


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
|<code>\\ Event_Between\\ /NEW_EVENT_NAME= BTWN\\ ! /RANGE_INSTANCE=0\\ /EVENT_SEQUENCE=LHS+LTO\\ ! /EXCLUDE_EVENT=\\ /FRAME_OFFSET=10\\ ! /TIME_OFFSET=\\ ! /PERCENT_OFFSET=\\ ;\\ </code>  |  {{:Event_Between_InstanceZero.jpg}}\\ |

\\


|  {{:Event_Between_InstanceZeroGraph.jpg}}\\   |

=== Range_Instance= 2 ===

\\
**Range_Instance = 2 ->** the 2nd instance of the Range will be used\\


|<code>\\ Event_Between\\ /NEW_EVENT_NAME= BTWN\\ ! /RANGE_INSTANCE=2\\ /EVENT_SEQUENCE=LHS+LTO\\ ! /EXCLUDE_EVENT=\\ /FRAME_OFFSET=10\\ ! /TIME_OFFSET=\\ ! /PERCENT_OFFSET= ;\\ </code>  |  {{:Event_Between_InstanceTwo.jpg}}\\ |

\\


|  {{:Event_Between_InstanceTwoGraph.jpg}}\\   |

=== Range_Instance= -1 ===

\\
**Range_Instance = -1 ->** the last instance of the Range will be used\\


|<code>\\ Event_Between\\ /NEW_EVENT_NAME= BTWN\\ ! /RANGE_INSTANCE=-1\\ /EVENT_SEQUENCE=LHS+LTO\\ ! /EXCLUDE_EVENT=\\ /FRAME_OFFSET=10\\ ! /TIME_OFFSET=\\ ! /PERCENT_OFFSET= ;\\ ;\\ </code>  |  {{:Event_Between_InstanceNegOne.jpg}}\\ |

Note that this is exactly the same result as the example above because for this example signal the last instance = the second instance.
|  {{:Event_Between_InstanceTwoGraph.jpg}}\\   |