exporter.h

// SPDX-FileCopyrightText: © 2018-2022 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_EXPORT_H__
#define __AUDIO_EXPORT_H__
 
#include "dsp/position.h"
#include "utils/audio.h"
 
#include <glib/gi18n.h>
 
typedef struct EngineState  EngineState;
typedef struct ProgressInfo ProgressInfo;
 
enum class ExportFormat
{
  EXPORT_FORMAT_AIFF,
  EXPORT_FORMAT_AU,
  EXPORT_FORMAT_CAF,
  EXPORT_FORMAT_FLAC,
  EXPORT_FORMAT_MP3,
  EXPORT_FORMAT_OGG_VORBIS,
  EXPORT_FORMAT_OGG_OPUS,
 
  EXPORT_FORMAT_RAW,
 
  EXPORT_FORMAT_WAV,
  EXPORT_FORMAT_W64,
 
  EXPORT_FORMAT_MIDI0,
 
  EXPORT_FORMAT_MIDI1,
};
 
const char *
export_format_to_pretty_str (ExportFormat format);
 
const char *
export_format_to_ext (ExportFormat format);
 
ExportFormat
export_format_from_pretty_str (const char * pretty_str);
 
enum class ExportTimeRange
{
  TIME_RANGE_LOOP,
  TIME_RANGE_SONG,
  TIME_RANGE_CUSTOM,
};
 
static const char * export_time_range_str[] = {
  "Loop",
  "Song",
  "Custom",
};
 
static inline const char *
export_time_range_to_str (ExportTimeRange export_time_range)
{
  return export_time_range_str[static_cast<int> (export_time_range)];
}
 
enum class ExportMode
{
  EXPORT_MODE_FULL,
 
  EXPORT_MODE_TRACKS,
 
  EXPORT_MODE_REGIONS,
};
 
static const char * export_mode_str[] = {
  "Full",
  "Tracks",
  "Regions",
};
 
static inline const char *
export_mode_to_str (ExportMode export_mode)
{
  return export_mode_str[static_cast<int> (export_mode)];
}
 
enum class BounceStep
{
  BOUNCE_STEP_BEFORE_INSERTS,
  BOUNCE_STEP_PRE_FADER,
  BOUNCE_STEP_POST_FADER,
};
 
static const char * bounce_step_str[] = {
  N_ ("Before inserts"),
  N_ ("Pre-fader"),
  N_ ("Post fader"),
};
 
static inline const char *
bounce_step_to_str (BounceStep bounce_step)
{
  return bounce_step_str[static_cast<int> (bounce_step)];
}
 
typedef struct ExportSettings
{
  ExportFormat format;
  char *       artist;
  char *       title;
  char *       genre;
 
  BitDepth        depth;
  ExportTimeRange time_range;
 
  ExportMode mode;
 
  bool disable_after_bounce;
 
  bool bounce_with_parents;
 
  BounceStep bounce_step;
 
  Position custom_start;
  Position custom_end;
 
  bool lanes_as_tracks;
 
  bool dither;
 
  char * file_uri;
 
  int num_files;
 
  ProgressInfo * progress_info;
} ExportSettings;
 
ExportSettings *
export_settings_new (void);
 
void
export_settings_set_bounce_defaults (
  ExportSettings * self,
  ExportFormat     format,
  const char *     filepath,
  const char *     bounce_name);
 
void
export_settings_print (const ExportSettings * self);
 
void
export_settings_free (ExportSettings * self);
 
NONNULL GPtrArray *
exporter_prepare_tracks_for_export (
  const ExportSettings * const settings,
  EngineState *                engine_state);
 
NONNULL_ARGS (1)
void exporter_post_export (
  const ExportSettings * const settings,
  GPtrArray *                  connections,
  EngineState *                engine_state);
 
void *
exporter_generic_export_thread (void * data);
 
void
exporter_generic_export_task_thread (
  GTask *        task,
  gpointer       source_obj,
  gpointer       task_data,
  GCancellable * cancellable);
 
void
exporter_create_audio_track_after_bounce (
  ExportSettings * settings,
  const Position * pos);
 
int
exporter_export (ExportSettings * info);
 
#endif