ext_port.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2019-2024 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#ifndef __AUDIO_EXT_PORT_H__
#define __AUDIO_EXT_PORT_H__
 
#include "zrythm-config.h"
 
#include "dsp/fader.h"
#include "plugins/plugin.h"
#include "utils/audio.h"
#include "utils/types.h"
#include "utils/yaml.h"
 
#include <gdk/gdk.h>
 
#ifdef HAVE_JACK
#  include "weak_libjack.h"
#endif
 
#ifdef HAVE_RTMIDI
#  include <rtmidi_c.h>
#endif
 
typedef struct WindowsMmeDevice  WindowsMmeDevice;
typedef struct HardwareProcessor HardwareProcessor;
 
#define EXT_PORT_SCHEMA_VERSION 1
 
#define EXT_PORTS_MAX 1024
 
#define ext_port_is_in_active_project(self) \
  (self->hw_processor \
   && hw_processor_is_in_active_project ((self)->hw_processor))
 
typedef enum ExtPortType
{
  EXT_PORT_TYPE_JACK,
  EXT_PORT_TYPE_ALSA,
  EXT_PORT_TYPE_WINDOWS_MME,
  EXT_PORT_TYPE_RTMIDI,
  EXT_PORT_TYPE_RTAUDIO,
} ExtPortType;
 
static const cyaml_strval_t ext_port_type_strings[] = {
  {"JACK",         EXT_PORT_TYPE_JACK       },
  { "ALSA",        EXT_PORT_TYPE_ALSA       },
  { "Windows MME", EXT_PORT_TYPE_WINDOWS_MME},
  { "RtMidi",      EXT_PORT_TYPE_RTMIDI     },
  { "RtAudio",     EXT_PORT_TYPE_RTAUDIO    },
};
 
typedef struct ExtPort
{
  int schema_version;
 
#ifdef HAVE_JACK
  jack_port_t * jport;
#else
  void * jport;
#endif
 
  char * full_name;
 
  char * short_name;
 
  char * alias1;
 
  char * alias2;
 
  int num_aliases;
 
#ifdef _WOE32
  WindowsMmeDevice * mme_dev;
#else
  void * mme_dev;
#endif
 
  unsigned int rtaudio_channel_idx;
 
  char * rtaudio_dev_name;
 
  unsigned int rtaudio_id;
 
  bool rtaudio_is_input;
  bool rtaudio_is_duplex;
 
#ifdef HAVE_RTAUDIO
  RtAudioDevice * rtaudio_dev;
#else
  void * rtaudio_dev;
#endif
 
  unsigned int rtmidi_id;
 
#ifdef HAVE_RTMIDI
  RtMidiDevice * rtmidi_dev;
#else
  void * rtmidi_dev;
#endif
 
  ExtPortType type;
 
  bool is_midi;
 
  int hw_processor_index;
 
  HardwareProcessor * hw_processor;
 
  bool active;
 
  bool pending_reconnect;
 
  Port * port;
} ExtPort;
 
COLD NONNULL_ARGS (1) void ext_port_init_loaded (
  ExtPort *           self,
  HardwareProcessor * hw_processor);
 
void
ext_port_print (ExtPort * self);
 
bool
ext_port_matches_backend (ExtPort * self);
 
MALLOC
NONNULL char *
ext_port_get_id (ExtPort * ext_port);
 
NONNULL bool
ext_ports_equal (const ExtPort * a, const ExtPort * b);
 
NONNULL char *
ext_port_get_friendly_name (ExtPort * self);
 
float *
ext_port_get_buffer (ExtPort * ext_port, nframes_t nframes);
 
void
ext_port_clear_buffer (ExtPort * ext_port, nframes_t nframes);
 
#if 0
void
ext_port_connect (
  ExtPort * ext_port,
  Port *    port,
  int       src);
#endif
 
#ifdef HAVE_JACK
ExtPort *
ext_port_new_from_jack_port (jack_port_t * jport);
#endif /* HAVE_JACK */
 
void
ext_port_disconnect (ExtPort * ext_port, Port * port, int src);
 
int
ext_port_activate (ExtPort * self, Port * port, bool activate);
 
bool
ext_port_get_enabled (ExtPort * self);
 
void
ext_ports_get (PortType type, PortFlow flow, bool hw, GPtrArray * ports);
 
ExtPort *
ext_port_clone (ExtPort * ext_port);
 
void
ext_ports_free (ExtPort ** ext_port, int size);
 
void
ext_port_free (ExtPort * ext_port);
 
#endif