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
! /RANGE_INSTANCE= 0	The number of instances of the event to label
! /EVENT_SEQUENCE=	The event sequence that the new event should occur between
! /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_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.

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

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

Range_Instance = 2 → the 2nd instance of the Range will be used

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

Range_Instance = -1 → the last instance of the Range will be used

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.

HAS-Motion Software Documentation

Table of Contents