@make_all_events_tab()  
 @make_all_events_tab(start:float)
 @make_all_events_tab(start:float, stop:float)
 @make_all_events_tab(start:num, is_start_beat:bool, stop:num, is_stop_beat:bool)

See also Score Introspection

[@always_next_event_except_sil_pos]   @bach_score   @current_event   @event_label_position   @make_all_events_tab   @make_bpm_map   @make_bpm_tab   @make_duration_map   @make_duration_tab   @make_label_bpm   @make_label_duration   @make_label_pitches   @make_label_pos   @make_pitch_tab   @make_score_map   [@next_event_except_sil_pos]   [@next_event_with_sil_pos]   [@next_sil_pos]   @optional_attributes    @performance_data    @score_duration    @score_tempi   @specified_duration   


The function @make_all_events_tab() returns a description of the musical score in the form of a TAB (vector). Each entry of this TAB is itself a 10-element vector describing a single musical event.

Description of a musical event

The elements within each entry are ordered as follows:

Index Description
0 Position (onset) of the event in beats
1 Type of event, represented as an integer:
0 = Silence,
1 = Note,
2 = Chord,
3 = Trill,
4 = Multi,
5 = Event (abstract event introduced by the keyword EVENT),
6 = Section (a special kind of Event)
2 Duration of the event in beats
3 Tempo at the event position, specified in seconds per beat (SPB). For instance, a tempo of 1 equals 60 BPM, while 0.5 corresponds to 120 BPM.
4 List of pitches specified by the event
5 Label associated with the event
6 Rank (index) of the event in the sequence of musical events. An implicit silence event with rank 0 begins every score and serves as an anchor for actions preceding the first explicitly defined event.
7 Boolean: true if the event is an abstract event marking the start of a section; otherwise, false.
8 Boolean: true if the event is an implicit silence inserted to fill a gap between two events; otherwise, false.
9 Boolean: true if the event is an implicit silence inserted to fill a gap between an event and a section; otherwise, false.

Arguments of @make_all_events_tab()

The function arguments allow selecting a specific portion of the score to describe. Depending on the arguments provided, the behavior is as follows:

  • @make_all_events_tab()
    Returns a description of the entire score.

  • @make_all_events_tab(start)
    Returns the description from the specified start beat position (included) to the end of the score.

  • @make_all_events_tab(start, stop)
    Returns the description from the specified beat position start (included) to the beat position stop (excluded).

  • @make_all_events_tab(start, is_start_beat, stop, is_stop_beat)
    This last form is particularly useful since multiple events may share the same beat position (e.g., events with zero duration:

    • start and stop can be specified either as beat positions or as indices in the musical event sequence.
    • is_start_beat and is_stop_beat are booleans: set to true if the corresponding position (start or stop) is expressed in beats, and false if it is an event index.
    • The position or index start is always included, while stop is excluded from the returned result.