set_event_mark()

Adds the supplied event to the requested event group. This can be used to i.e. conveniently manipulate a set of notes simultaniously with one single call using the helper function by_marks(). The latter acts as placeholder for all event IDs of that group.

Function Prototype

set_event_mark(??event-id??, ??group-id??)

Arguments

Argument Name	Data Type	Description
`??event-id??`	Event ID Number	Event to be assigned to the group. [required]
`??group-id??`	Event Group ID Number	Event group where the event shall be added to. You should pass one of the built-in constant variables `$MARK_1` to `$MARK_28` for this argument to select one of the 28 available groups. [required]

Return Value

None.

Examples


on note
  if ($EVENT_NOTE < 36)
    set_event_mark($EVENT_ID, $MARK_1)
    note_off(by_marks($MARK_2))
  else
    set_event_mark($EVENT_ID, $MARK_2)
    note_off(by_marks($MARK_1))
  end if
end on