region.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2018-2022 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_REGION_H__
#define __AUDIO_REGION_H__
 
#include "dsp/automation_point.h"
#include "dsp/chord_object.h"
#include "dsp/midi_note.h"
#include "dsp/position.h"
#include "dsp/region_identifier.h"
#include "gui/backend/arranger_object.h"
#include "utils/yaml.h"
 
#include <glib/gi18n.h>
 
typedef struct Channel         Channel;
typedef struct Track           Track;
typedef struct MidiNote        MidiNote;
typedef struct TrackLane       TrackLane;
typedef struct RegionLinkGroup RegionLinkGroup;
typedef struct Stretcher       Stretcher;
typedef struct AudioClip       AudioClip;
 
#define REGION_MAGIC 93075327
#define IS_REGION(x) (((Region *) x)->magic == REGION_MAGIC)
#define IS_REGION_AND_NONNULL(x) (x && IS_REGION (x))
 
#define REGION_PRINTF_FILENAME "%s_%s.mid"
 
#define region_is_selected(r) arranger_object_is_selected ((ArrangerObject *) r)
 
enum class RegionMusicalMode
{
  REGION_MUSICAL_MODE_INHERIT,
  REGION_MUSICAL_MODE_OFF,
  REGION_MUSICAL_MODE_ON,
};
 
const char *
region_musical_mode_to_str (RegionMusicalMode mode);
 
typedef struct Region
{
  ArrangerObject base;
 
  RegionIdentifier id;
 
  char * name;
 
  char * escaped_name;
 
  GdkRGBA color;
 
  bool use_color;
 
  /* ==== MIDI REGION ==== */
 
  MidiNote ** midi_notes;
  int         num_midi_notes;
  size_t      midi_notes_size;
 
  MidiNote * unended_notes[12000];
  int        num_unended_notes;
 
  /* ==== MIDI REGION END ==== */
 
  /* ==== AUDIO REGION ==== */
 
  int pool_id;
 
  bool stretching;
 
  double before_length;
 
  double stretch_ratio;
 
  bool read_from_pool;
 
  float gain;
 
  AudioClip * clip;
 
#if 0
  sample_t *        frames;
  size_t            num_frames;
 
  sample_t *        ch_frames[16];
#endif
 
  RegionMusicalMode musical_mode;
 
  Position * split_points;
  int        num_split_points;
  size_t     split_points_size;
 
  /* ==== AUDIO REGION END ==== */
 
  /* ==== AUTOMATION REGION ==== */
 
  AutomationPoint ** aps;
  int                num_aps;
  size_t             aps_size;
 
  AutomationPoint * last_recorded_ap;
 
  /* ==== AUTOMATION REGION END ==== */
 
  /* ==== CHORD REGION ==== */
 
  ChordObject ** chord_objects;
  int            num_chord_objects;
  size_t         chord_objects_size;
 
  /* ==== CHORD REGION END ==== */
 
  int bounce;
 
  /* --- drawing caches --- */
 
  /* New region drawing needs to be cached in the
   * following situations:
   *
   * 1. when hidden part of the region is revealed
   *   (on x axis).
   *   TODO max 140% of the region should be
   *   cached (20% before and 20% after if before/
   *   after is not fully visible)
   * 2. when full rect (x/width) changes
   * 3. when a region marker is moved
   * 4. when the clip actually changes (use
   *   last-change timestamp on the clip or region)
   * 5. when fades change
   * 6. when region height changes (track/lane)
   */
 
  PangoLayout * layout;
 
  PangoLayout * chords_layout;
 
  /* these are used for caching */
  GdkRectangle last_main_full_rect;
 
  GdkRectangle last_main_draw_rect;
 
  /* these are used for caching */
  GdkRectangle last_lane_full_rect;
 
  GdkRectangle last_lane_draw_rect;
 
  gint64 last_clip_change;
 
  gint64 last_cache_time;
 
  ArrangerObject last_positions_obj;
 
  /* --- drawing caches end --- */
 
  TrackLane * owner_lane = nullptr;
 
  int magic;
} Region;
 
#define region_type_can_fade(rtype) (rtype == RegionType::REGION_TYPE_AUDIO)
 
void
region_init (
  Region *         region,
  const Position * start_pos,
  const Position * end_pos,
  unsigned int     track_name_hash,
  int              lane_pos,
  int              idx_inside_lane);
 
HOT NONNULL Region *
region_find (const RegionIdentifier * const id);
 
#if 0
static inline void
region_set_track_name_hash (
  Region *    self,
  unsigned int name_hash)
{
  self->id.track_name_hash = name_hash;
}
#endif
 
NONNULL void
region_print_to_str (const Region * self, char * buf, const size_t buf_size);
 
NONNULL void
region_print (const Region * region);
 
TrackLane *
region_get_lane (const Region * region);
 
RegionLinkGroup *
region_get_link_group (Region * self);
 
void
region_set_link_group (Region * region, int group_idx, bool update_identifier);
 
NONNULL bool
region_has_link_group (Region * region);
 
MidiNote *
region_find_midi_note (Region * r, MidiNote * _mn);
 
NONNULL HOT signed_frame_t
region_timeline_frames_to_local (
  const Region * const self,
  const signed_frame_t timeline_frames,
  const bool           normalize);
 
NONNULL void
region_get_frames_till_next_loop_or_end (
  const Region * const self,
  const signed_frame_t timeline_frames,
  signed_frame_t *     ret_frames,
  bool *               is_loop);
 
NONNULL void
region_set_lane (Region * self, TrackLane * lane);
 
void
region_gen_name (
  Region *          region,
  const char *      base_name,
  AutomationTrack * at,
  Track *           track);
 
NONNULL WARN_UNUSED_RESULT bool
region_stretch (Region * self, double ratio, GError ** error);
 
NONNULL void
region_update_identifier (Region * self);
 
NONNULL void
region_update_link_group (Region * self);
 
void
region_move_to_track (
  Region * region,
  Track *  track,
  int      lane_or_at_index,
  int      index);
 
CONST
static inline int
region_type_has_lane (const RegionType type)
{
  return type == RegionType::REGION_TYPE_MIDI
         || type == RegionType::REGION_TYPE_AUDIO;
}
 
void
region_set_automation_track (Region * region, AutomationTrack * at);
 
AutomationTrack *
region_get_automation_track (const Region * const region);
 
void
region_copy (Region * src, Region * dest);
 
NONNULL int
region_is_hit (
  const Region *       region,
  const signed_frame_t gframes,
  const bool           inclusive);
 
int
region_is_hit_by_range (
  const Region *       region,
  const signed_frame_t gframes_start,
  const signed_frame_t gframes_end,
  const bool           end_inclusive);
 
NONNULL_ARGS (3)
Region * region_at_position (
  const Track *           track,
  const AutomationTrack * at,
  const Position *        pos);
 
char *
region_generate_filename (Region * region);
 
void
region_get_type_as_string (RegionType type, char * buf);
 
bool
region_is_recording (Region * self);
 
bool
region_get_musical_mode (Region * self);
 
void
region_add_arranger_object (Region * self, ArrangerObject * obj, bool fire_events);
 
void
region_create_link_group_if_none (Region * region);
 
void
region_unlink (Region * region);
 
void
region_remove_all_children (Region * region);
 
void
region_copy_children (Region * dest, Region * src);
 
NONNULL bool
region_is_looped (const Region * const self);
 
ArrangerSelections *
region_get_arranger_selections (Region * self);
 
ArrangerWidget *
region_get_arranger_for_children (Region * self);
 
bool
region_validate (Region * self, bool is_project, double frames_per_tick);
 
void
region_disconnect (Region * self);
 
#endif // __AUDIO_REGION_H__