====== Event Rename ======

To **Rename** an event label, you can use a pipeline command or you can select the event in the data tree using the right mouse button.

==== Interactive selection from the data tree: ====

{{:RenameEventDlg.jpg}}]
{{:RenameEventSmall.jpg}}
==== From the Edit Events Dialog ====

{{:EditEventsDlg.jpg}}
==== Pipeline command: ====

**Event_Rename**
/Event_Name= The name of the original event
/New_Event_Name= The name to be given to the **new event**
/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Sequence|Event_Sequence]]= Sequence of Events that defines the ranges
/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Exclude_Events|Exclude_Events]]= An inclusive Event that excludes the range
/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Instance|Event_Instance]]= The instance of the existing event to copy.
/[[Visual3D:Documentation:C3D_Signal_Types:EVENT_LABEL_Data_Type#Event_Instance|Range_Instance]]= The instance of the existing event to copy.
**;**
==== Event_Rename Dialog ====

{{:CopyEventLabelDlgEx1.jpg}}
==== Event Instance ====

Event_Instance=0 -> copy all instances of the Event

Event_Instance=n -> copy the nth instance of the Event

if n<1 count instances from the last Event; e.g. -1 = last instance

==== Range Instance ====

Range_Instance=0 -> use all instances of the Range

Range_Instance=n -> use the nth instance of the Range

if n<1 count instances from the last Range; e.g. -1 = last range

==== Example ====

In this example, the last event instance in the first range of the event sequence START+START is renamed.

{{:EventRenameExampleDlg.jpg}}
**Event_Rename**
/EVENT_NAME=TEST
/NEW_EVENT_NAME=NEWTEST
/EVENT_INSTANCE=-1
/RANGE_INSTANCE=1
/EVENT_SEQUENCE=START+START
! /EXCLUDE_EVENTS=
**;**