audio_region.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2019-2022 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_AUDIO_REGION_H__
#define __AUDIO_AUDIO_REGION_H__
 
#include "dsp/position.h"
#include "dsp/region.h"
#include "utils/audio.h"
#include "utils/types.h"
 
typedef struct _RegionWidget RegionWidget;
typedef struct Channel       Channel;
typedef struct Track         Track;
typedef struct ZRegion       AudioRegion;
typedef struct AudioClip     AudioClip;
typedef struct StereoPorts   StereoPorts;
 
#if 0
#  define AUDIO_REGION_DEFAULT_FADE_MS 1
#endif
 
#define AUDIO_REGION_BUILTIN_FADE_FRAMES 10
 
ZRegion *
audio_region_new (
  const int              pool_id,
  const char *           filename,
  bool                   read_from_pool,
  const float *          frames,
  const unsigned_frame_t nframes,
  const char *           clip_name,
  const channels_t       channels,
  BitDepth               bit_depth,
  const Position *       start_pos,
  unsigned int           track_name_hash,
  int                    lane_pos,
  int                    idx_inside_lane,
  GError **              error);
 
#if 0
void
audio_region_init_frame_caches (
  AudioRegion * self,
  AudioClip *   clip);
 
void
audio_region_update_channel_caches (
  ZRegion *   self,
  AudioClip * clip);
#endif
 
AudioClip *
audio_region_get_clip (const ZRegion * self);
 
void
audio_region_set_clip_id (ZRegion * self, int clip_id);
 
WARN_UNUSED_RESULT bool
audio_region_replace_frames (
  ZRegion *        self,
  float *          frames,
  unsigned_frame_t start_frame,
  unsigned_frame_t num_frames,
  bool             duplicate_clip,
  GError **        error);
 
REALTIME
HOT NONNULL void
audio_region_fill_stereo_ports (
  ZRegion *                           self,
  const EngineProcessTimeInfo * const time_nfo,
  StereoPorts *                       stereo_ports);
 
float
audio_region_detect_bpm (ZRegion * self, GArray * candidates);
 
bool
audio_region_validate (ZRegion * self, double frames_per_tick);
 
bool
audio_region_fix_positions (ZRegion * self, double frames_per_tick);
 
void
audio_region_free_members (ZRegion * self);
 
#endif // __AUDIO_AUDIO_REGION_H__