midi_note.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2018-2023 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_MIDI_NOTE_H__
#define __AUDIO_MIDI_NOTE_H__
 
#include <stdint.h>
 
#include "dsp/midi_region.h"
#include "dsp/position.h"
#include "dsp/velocity.h"
#include "gui/backend/arranger_object.h"
 
typedef struct _MidiNoteWidget     MidiNoteWidget;
typedef struct Channel             Channel;
typedef struct Track               Track;
typedef struct MidiEvents          MidiEvents;
typedef struct Position            Position;
typedef struct Velocity            Velocity;
typedef enum PianoRollNoteNotation PianoRollNoteNotation;
 
#define MIDI_NOTE_SCHEMA_VERSION 1
 
#define MIDI_NOTE_MAGIC 3588791
#define IS_MIDI_NOTE(tr) \
  ((MidiNote *) tr \
   && ((MidiNote *) tr)->magic == MIDI_NOTE_MAGIC)
 
#define midi_note_is_selected(r) \
  arranger_object_is_selected ((ArrangerObject *) r)
 
typedef struct MidiNote
{
  ArrangerObject base;
 
  int schema_version;
 
  Velocity * vel;
 
  uint8_t val;
 
  uint8_t cache_val;
 
  int muted;
 
  int currently_listened;
 
  uint8_t last_listened_val;
 
  int pos;
 
  int magic;
 
  PangoLayout * layout;
} MidiNote;
 
static const cyaml_schema_field_t midi_note_fields_schema[] = {
  YAML_FIELD_MAPPING_EMBEDDED (
    MidiNote,
    base,
    arranger_object_fields_schema),
  YAML_FIELD_INT (MidiNote, schema_version),
  YAML_FIELD_MAPPING_PTR (MidiNote, vel, velocity_fields_schema),
  YAML_FIELD_UINT (MidiNote, val),
  YAML_FIELD_INT (MidiNote, muted),
  YAML_FIELD_INT (MidiNote, pos),
  CYAML_FIELD_END
};
 
static const cyaml_schema_value_t midi_note_schema = {
  /* allow nullable for mn_r1 in
   * ArrangerSelectionsAction */
  YAML_VALUE_PTR_NULLABLE (MidiNote, midi_note_fields_schema),
};
 
void
midi_note_get_global_start_pos (
  MidiNote * self,
  Position * pos);
 
MidiNote *
midi_note_new (
  RegionIdentifier * region_id,
  Position *         start_pos,
  Position *         end_pos,
  uint8_t            val,
  uint8_t            vel);
 
void
midi_note_set_region_and_index (
  MidiNote * self,
  ZRegion *  region,
  int        idx);
 
void
midi_note_set_cache_val (MidiNote * self, const uint8_t val);
 
NONNULL PURE int
midi_note_is_equal (MidiNote * src, MidiNote * dest);
 
void
midi_note_get_val_as_string (
  const MidiNote *      self,
  char *                buf,
  PianoRollNoteNotation notation,
  const int             use_markup);
 
void
midi_note_print (MidiNote * mn);
 
void
midi_note_listen (MidiNote * mn, bool listen);
 
void
midi_note_shift_pitch (MidiNote * self, const int delta);
 
int
midi_note_hit (MidiNote * self, const signed_frame_t gframes);
 
void
midi_note_notes_to_events (
  MidiNote **  midi_notes,
  int          num_notes,
  Position *   pos,
  MidiEvents * events);
 
void
midi_note_set_val (MidiNote * midi_note, const uint8_t val);
 
ZRegion *
midi_note_get_region (MidiNote * self);
 
#endif // __AUDIO_MIDI_NOTE_H__