DISTRHO
/
DPF
mirror of https://github.com/DISTRHO/DPF
1
0
Fork 0
Code Releases 0 Activity
Browse Source

Initial implementation of travesty, pure C interface to vst3 

Signed-off-by: falkTX <falktx@falktx.com>
pull/292/head
falkTX 4 years ago
parent
242e0d2788
commit
880349a3b9
Signed by: falkTX <falktx@falktx.com> GPG Key ID: CDBAA37ABC74FBA0
11 changed files with 1159 additions and 0 deletions
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. +9
    -0
      distrho/src/travesty/README.txt
  2. +23
    -0
      distrho/src/travesty/align_pop.h
  3. +37
    -0
      distrho/src/travesty/align_push.h
  4. +270
    -0
      distrho/src/travesty/audio_processor.h
  5. +153
    -0
      distrho/src/travesty/base.h
  6. +41
    -0
      distrho/src/travesty/bstream.h
  7. +117
    -0
      distrho/src/travesty/component.h
  8. +113
    -0
      distrho/src/travesty/edit_controller.h
  9. +164
    -0
      distrho/src/travesty/events.h
  10. +115
    -0
      distrho/src/travesty/factory.h
  11. +117
    -0
      distrho/src/travesty/view.h

+ 9
- 0
distrho/src/travesty/README.txt View File

@@ -0,0 +1,9 @@
This folder contains a pure C interface to Steinberg VST3 SDK, codenamed "travesty".
Name is a play on words from morphing "vestige" (the good old free VST2 reverse-engineered header file) and "three".

The main target is to be able to create VST3-compatible plugins without a bloated SDK.
Everything that is required for plugins fits in a few small header files.
Also, being able to build VST3-compatible plugins in pure C code, something not possible with the original SDK.

Please note this project is still a work in progress.
Use at your own risk, and please report any issues to https://github.com/DISTRHO/DPF/.

+ 23
- 0
distrho/src/travesty/align_pop.h View File

@@ -0,0 +1,23 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#if defined(__APPLE__) || defined(_WIN32)
# pragma pack(pop)
#endif

#if defined(__APPLE__)
# pragma GCC diagnostic pop
#endif

+ 37
- 0
distrho/src/travesty/align_push.h View File

@@ -0,0 +1,37 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#if defined(__APPLE__)

# pragma GCC diagnostic push
# pragma GCC diagnostic ignored "-Wunknown-warning-option"
# pragma GCC diagnostic ignored "-Wpragma-pack"
# if defined(__LP64__) || defined(_LP64)
# pragma pack(push, 16)
# else
# pragma pack(push, 1)
# endif

#elif defined(_WIN32)

# pragma pack(push)
# if defined(_WIN64) || defined(_M_ARM64)
# pragma pack(16)
# else
# pragma pack(8)
# endif

#endif

+ 270
- 0
distrho/src/travesty/audio_processor.h View File

@@ -0,0 +1,270 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"
#include "events.h"

#include "align_push.h"

/**
* speakers
*/

typedef uint64_t v3_speaker_arrangement;

enum {
V3_SPEAKER_L = 1,
V3_SPEAKER_R = 1 << 1
};

/**
* process setup
*/

enum v3_process_mode {
V3_REALTIME,
V3_PREFETCH,
V3_OFFLINE
};

inline static const char *
v3_process_mode_str(int32_t d)
{
switch (d) {
case V3_REALTIME: return "V3_REALTIME";
case V3_PREFETCH: return "V3_PREFETCH";
case V3_OFFLINE: return "V3_OFFLINE";
default: return "[unknown]";
}
}

enum {
V3_SAMPLE_32,
V3_SAMPLE_64
};

inline static const char *
v3_sample_size_str(int32_t d)
{
switch (d) {
case V3_SAMPLE_32: return "V3_SAMPLE_32";
case V3_SAMPLE_64: return "V3_SAMPLE_64";
default: return "[unknown]";
}
}

struct v3_process_setup {
int32_t process_mode;
int32_t symbolic_sample_size;
int32_t max_block_size;
double sample_rate;
};

/**
* param changes
*/

struct v3_param_value_queue {
struct v3_funknown;

V3_API v3_param_id (*get_param_id)(void *self);
V3_API int32_t (*get_point_count)(void *self);

V3_API v3_result (*get_point)
(void *self, int32_t idx, int32_t *sample_offset, double *value);
V3_API v3_result (*add_point)
(void *self, int32_t sample_offset, double value, int32_t *idx);
};

static const v3_tuid v3_param_value_queue_iid =
V3_ID(0x01263A18, 0xED074F6F, 0x98C9D356, 0x4686F9BA);

struct v3_param_changes {
struct v3_funknown;

V3_API int32_t (*get_param_count)(void *self);

V3_API struct v3_param_value_queue **(*get_param_data)
(void *self, int32_t idx);

V3_API struct v3_param_value_queue **(*add_param_data)
(void *self, v3_param_id *id, int32_t *index);
};

static const v3_tuid v3_param_changes_iid =
V3_ID(0xA4779663, 0x0BB64A56, 0xB44384A8, 0x466FEB9D);

/**
* process context
*/

struct v3_frame_rate {
uint32_t fps;
uint32_t flags;
};

struct v3_chord {
uint8_t key_note;
uint8_t root_note;

int16_t chord_mask;
};

enum {
V3_PROCESS_CTX_PLAYING = 1 << 1,
V3_PROCESS_CTX_CYCLE_ACTIVE = 1 << 2,
V3_PROCESS_CTX_RECORDING = 1 << 3,

V3_PROCESS_CTX_SYSTEM_TIME_VALID = 1 << 8,
V3_PROCESS_CTX_CONT_TIME_VALID = 1 << 17,
V3_PROCESS_CTX_PROJECT_TIME_VALID = 1 << 9,

V3_PROCESS_CTX_BAR_POSITION_VALID = 1 << 11,
V3_PROCESS_CTX_CYCLE_VALID = 1 << 12,

V3_PROCESS_CTX_TEMPO_VALID = 1 << 10,
V3_PROCESS_CTX_TIME_SIG_VALID = 1 << 13,
V3_PROCESS_CTX_CHORD_VALID = 1 << 18,

V3_PROCESS_CTX_SMPTE_VALID = 1 << 14,

V3_PROCESS_CTX_NEXT_CLOCK_VALID = 1 << 15
};

struct v3_process_context {
uint32_t state;

double sample_rate;
int64_t project_time_in_samples; // with loop

int64_t system_time_ns;
int64_t continuous_time_in_samples; // without loop? unclear

double project_time_quarters;
double bar_position_quarters;
double cycle_start_quarters;
double cycle_end_quarters;

double bpm;

int32_t time_sig_numerator;
int32_t time_sig_denom;

struct v3_chord chord;

int32_t smpte_offset_subframes;
struct v3_frame_rate frame_rate;

int32_t samples_to_next_clock;
};

/**
* process context requirements
*/

enum {
V3_PROCESS_CTX_NEED_SYSTEM_TIME = 1 << 0,
V3_PROCESS_CTX_NEED_CONTINUOUS_TIME = 1 << 1,
V3_PROCESS_CTX_NEED_PROJECT_TIME = 1 << 2,
V3_PROCESS_CTX_NEED_BAR_POSITION = 1 << 3,
V3_PROCESS_CTX_NEED_CYCLE = 1 << 4,
V3_PROCESS_CTX_NEED_NEXT_CLOCK = 1 << 5,
V3_PROCESS_CTX_NEED_TEMPO = 1 << 6,
V3_PROCESS_CTX_NEED_TIME_SIG = 1 << 7,
V3_PROCESS_CTX_NEED_CHORD = 1 << 8,
V3_PROCESS_CTX_NEED_FRAME_RATE = 1 << 9,
V3_PROCESS_CTX_NEED_TRANSPORT_STATE = 1 << 10
};

struct v3_process_context_requirements {
struct v3_funknown;

V3_API uint32_t (*get_process_context_requirements)(void *self);
};

static const v3_tuid v3_process_context_requirements_iid =
V3_ID(0x2A654303, 0xEF764E3D, 0x95B5FE83, 0x730EF6D0);

/**
* process data and context
*/

struct v3_audio_bus_buffers {
int32_t num_channels;
uint64_t channel_silence_bitset;

union {
float **channel_buffers_32;
double **channel_buffers_64;
};
};

struct v3_process_data {
int32_t process_mode;
int32_t symbolic_sample_size;

int32_t nframes;

int32_t num_input_buses;
int32_t num_output_buses;

struct v3_audio_bus_buffers *inputs;
struct v3_audio_bus_buffers *outputs;

struct v3_param_changes **input_params;
struct v3_param_changes **output_params;

struct v3_event_list **input_events;
struct v3_event_list **output_events;

struct v3_process_context *ctx;
};

/**
* audio processor
*/

struct v3_audio_processor {
struct v3_funknown;

V3_API v3_result (*set_bus_arrangements)
(void *self, v3_speaker_arrangement *inputs, int32_t num_inputs,
v3_speaker_arrangement *outputs, int32_t num_outputs);
V3_API v3_result (*get_bus_arrangement)
(void *self, int32_t bus_direction, int32_t idx, v3_speaker_arrangement *);

V3_API v3_result (*can_process_sample_size)
(void *self, int32_t symbolic_sample_size);

V3_API uint32_t (*get_latency_samples)(void *self);

V3_API v3_result (*setup_processing)
(void *self, struct v3_process_setup *);
V3_API v3_result (*set_processing)
(void *self, v3_bool state);

V3_API v3_result (*process)
(void *self, struct v3_process_data *);

V3_API uint32_t (*get_tail_samples)(void *self);
};

static const v3_tuid v3_audio_processor_iid =
V3_ID(0x42043F99, 0xB7DA453C, 0xA569E79D, 0x9AAEC33D);

#include "align_pop.h"

+ 153
- 0
distrho/src/travesty/base.h View File

@@ -0,0 +1,153 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include <stdint.h>
#include <string.h>

/**
* various types
*/

typedef int32_t v3_result;

typedef int16_t v3_str_128[128];
typedef uint8_t v3_bool;

typedef uint32_t v3_param_id;


/**
* low-level ABI nonsense
*/

typedef uint8_t v3_tuid[16];

inline static int
v3_tuid_match(const v3_tuid a, const v3_tuid b)
{
return !memcmp(a, b, sizeof(v3_tuid));
}

#if defined(_WIN32)
# define V3_COM_COMPAT 1
# define V3_API __stdcall
#else
# define V3_COM_COMPAT 0
# define V3_API
#endif

#if V3_COM_COMPAT
enum {
V3_NO_INTERFACE = 0x80004002L,
V3_OK = 0,
V3_TRUE = 0,
V3_FALSE = 1,
V3_INVALID_ARG = 0x80070057L,
V3_NOT_IMPLEMENTED = 0x80004001L,
V3_INTERNAL_ERR = 0x80004005L,
V3_NOT_INITIALISED = 0x8000FFFFL,
V3_NOMEM = 0x8007000EL
};

# define V3_ID(a, b, c, d) { \
((a) & 0x000000FF), \
((a) & 0x0000FF00) >> 8, \
((a) & 0x00FF0000) >> 16, \
((a) & 0xFF000000) >> 24, \
\
((b) & 0x00FF0000) >> 16, \
((b) & 0xFF000000) >> 24, \
((b) & 0x000000FF), \
((b) & 0x0000FF00) >> 8, \
\
((c) & 0xFF000000) >> 24, \
((c) & 0x00FF0000) >> 16, \
((c) & 0x0000FF00) >> 8, \
((c) & 0x000000FF), \
\
((d) & 0xFF000000) >> 24, \
((d) & 0x00FF0000) >> 16, \
((d) & 0x0000FF00) >> 8, \
((d) & 0x000000FF), \
}

#else // V3_COM_COMPAT
enum {
V3_NO_INTERFACE = -1,
V3_OK,
V3_TRUE = V3_OK,
V3_FALSE,
V3_INVALID_ARG,
V3_NOT_IMPLEMENTED,
V3_INTERNAL_ERR,
V3_NOT_INITIALISED,
V3_NOMEM
};

# define V3_ID(a, b, c, d) { \
((a) & 0xFF000000) >> 24, \
((a) & 0x00FF0000) >> 16, \
((a) & 0x0000FF00) >> 8, \
((a) & 0x000000FF), \
\
((b) & 0xFF000000) >> 24, \
((b) & 0x00FF0000) >> 16, \
((b) & 0x0000FF00) >> 8, \
((b) & 0x000000FF), \
\
((c) & 0xFF000000) >> 24, \
((c) & 0x00FF0000) >> 16, \
((c) & 0x0000FF00) >> 8, \
((c) & 0x000000FF), \
\
((d) & 0xFF000000) >> 24, \
((d) & 0x00FF0000) >> 16, \
((d) & 0x0000FF00) >> 8, \
((d) & 0x000000FF), \
}
#endif // V3_COM_COMPAT

/**
* funknown
*/

struct v3_funknown {
V3_API v3_result (*query_interface)
(void *self, const v3_tuid iid, void **obj);

V3_API uint32_t (*ref)(void *self);
V3_API uint32_t (*unref)(void *self);
};

static const v3_tuid v3_funknown_iid =
V3_ID(0x00000000, 0x00000000, 0xC0000000, 0x00000046);

/**
* plugin base
*/

struct v3_plugin_base {
struct v3_funknown;

V3_API v3_result (*initialise)
(void *self, struct v3_funknown *context);
V3_API v3_result (*terminate)(void *self);
};

static const v3_tuid v3_plugin_base_iid =
V3_ID(0x22888DDB, 0x156E45AE, 0x8358B348, 0x08190625);

+ 41
- 0
distrho/src/travesty/bstream.h View File

@@ -0,0 +1,41 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"

enum v3_seek_mode {
V3_SEEK_SET = 0,
V3_SEEK_CUR,
V3_SEEK_END
};

struct v3_bstream {
struct v3_funknown;

V3_API v3_result (*read)
(void *self, void *buffer, int32_t num_bytes, int32_t *bytes_read);
V3_API v3_result (*write)
(void *self, void *buffer, int32_t num_bytes, int32_t *bytes_written);
V3_API v3_result (*seek)
(void *self, int64_t pos, int32_t seek_mode, int64_t *result);
V3_API v3_result (*tell)
(void *self, int64_t *pos);
};

static const v3_tuid v3_bstream_iid =
V3_ID(0xC3BF6EA2, 0x30994752, 0x9B6BF990, 0x1EE33E9B);

+ 117
- 0
distrho/src/travesty/component.h View File

@@ -0,0 +1,117 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"
#include "bstream.h"

#include "align_push.h"

/**
* buses
*/

enum v3_media_types {
V3_AUDIO = 0,
V3_EVENT
};

inline static const char *
v3_media_type_str(int32_t type)
{
switch (type) {
case V3_AUDIO: return "V3_AUDIO";
case V3_EVENT: return "V3_EVENT";
default: return "[unknown]";
}
}

enum v3_bus_direction {
V3_INPUT = 0,
V3_OUTPUT
};

inline static const char *
v3_bus_direction_str(int32_t d)
{
switch (d) {
case V3_INPUT: return "V3_INPUT";
case V3_OUTPUT: return "V3_OUTPUT";
default: return "[unknown]";
}
}

enum v3_bus_types {
V3_MAIN = 0,
V3_AUX
};

enum v3_bus_flags {
V3_DEFAULT_ACTIVE = 1,
V3_IS_CONTROL_VOLTAGE = 1 << 1
};

struct v3_bus_info {
int32_t media_type;
int32_t direction;
int32_t channel_count;

v3_str_128 bus_name;
int32_t bus_type;
uint32_t flags;
};

/**
* component
*/

struct v3_routing_info;

struct v3_component {
struct v3_plugin_base;

V3_API v3_result (*get_controller_class_id)
(void *self, v3_tuid class_id);

V3_API v3_result (*set_io_mode)
(void *self, int32_t io_mode);

V3_API int32_t (*get_bus_count)
(void *self, int32_t media_type, int32_t bus_direction);
V3_API v3_result (*get_bus_info)
(void *self, int32_t media_type, int32_t bus_direction,
int32_t bus_idx, struct v3_bus_info *bus_info);
V3_API v3_result (*get_routing_info)
(void *self, struct v3_routing_info *input,
struct v3_routing_info *output);
V3_API v3_result (*activate_bus)
(void *self, int32_t media_type, int32_t bus_direction,
int32_t bus_idx, v3_bool state);

V3_API v3_result (*set_active)
(void *self, v3_bool state);

V3_API v3_result (*set_state)
(void *self, struct v3_bstream **);
V3_API v3_result (*get_state)
(void *self, struct v3_bstream **);
};

static const v3_tuid v3_component_iid =
V3_ID(0xE831FF31, 0xF2D54301, 0x928EBBEE, 0x25697802);

#include "align_pop.h"

+ 113
- 0
distrho/src/travesty/edit_controller.h View File

@@ -0,0 +1,113 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"
#include "bstream.h"
#include "view.h"

#include "align_push.h"

/**
* component handler
*/

struct v3_component_handler {
struct v3_funknown;

V3_API v3_result (*begin_edit)
(void *self, v3_param_id);
V3_API v3_result (*perform_edit)
(void *self, v3_param_id, double value_normalised);
V3_API v3_result (*end_edit)
(void *self, v3_param_id);

V3_API v3_result (*restart_component)
(void *self, int32_t flags);
};

static const v3_tuid v3_component_handler_iid =
V3_ID(0x93A0BEA3, 0x0BD045DB, 0x8E890B0C, 0xC1E46AC6);

/**
* edit controller
*/

enum {
V3_PARAM_CAN_AUTOMATE = 1,
V3_PARAM_READ_ONLY = 1 << 1,
V3_PARAM_WRAP_AROUND = 1 << 2,
V3_PARAM_IS_LIST = 1 << 3,
V3_PARAM_IS_HIDDEN = 1 << 4,
V3_PARAM_PROGRAM_CHANGE = 1 << 15,
V3_PARAM_IS_BYPASS = 1 << 16
};

struct v3_param_info {
v3_param_id param_id;

v3_str_128 title;
v3_str_128 short_title;
v3_str_128 units;

int32_t step_count;

double default_normalised_value;

int32_t unit_id;
int32_t flags;
};

struct v3_edit_controller {
struct v3_plugin_base;

V3_API v3_result (*set_component_state)
(void *self, struct v3_bstream *);
V3_API v3_result (*set_state)
(void *self, struct v3_bstream *);
V3_API v3_result (*get_state)
(void *self, struct v3_bstream *);

V3_API int32_t (*get_parameter_count)(void *self);
V3_API v3_result (*get_param_info)
(void *self, int32_t param_idx, struct v3_param_info *);

V3_API v3_result (*get_param_string_for_value)
(void *self, v3_param_id, double normalised, v3_str_128 output);
V3_API v3_result (*get_param_value_for_string)
(void *self, v3_param_id, int16_t *input, double *output);

V3_API double (*normalised_param_to_plain)
(void *self, v3_param_id, double normalised);
V3_API double (*plain_param_to_normalised)
(void *self, v3_param_id, double normalised);

V3_API double (*get_param_normalised)(void *self, v3_param_id);
V3_API v3_result (*set_param_normalised)
(void *self, v3_param_id, double normalised);

V3_API v3_result (*set_component_handler)
(void *self, struct v3_component_handler **);

V3_API struct v3_plug_view **(*create_view)
(void *self, const char *name);
};

static const v3_tuid v3_edit_controller_iid =
V3_ID(0xDCD7BBE3, 0x7742448D, 0xA874AACC, 0x979C759E);

#include "align_pop.h"

+ 164
- 0
distrho/src/travesty/events.h View File

@@ -0,0 +1,164 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"

#include "align_push.h"

/**
* note events
*
* i know there's others, but we don't need them right now. whatever.
* handle them later.
*/

struct v3_event_note_on {
int16_t channel;
int16_t pitch; // MIDI note number

float tuning;
float velocity;

int32_t length;
int32_t note_id;
};

struct v3_event_note_off {
int16_t channel;
int16_t pitch; // MIDI note number

float velocity;

int32_t note_id;
float tuning;
};

struct v3_event_data {
uint32_t size;
uint32_t type;

const uint8_t *bytes;
};

struct v3_event_poly_pressure {
int16_t channel;
int16_t pitch;

float pressure;
int32_t note_id;
};

struct v3_event_chord {
int16_t root;
int16_t bass_note;
int16_t mask;

uint16_t text_len;
const int16_t *text;
};

struct v3_event_scale {
int16_t root;
int16_t mask;

uint16_t text_len;
const int16_t *text;
};

struct v3_event_legacy_midi_cc_out {
uint8_t cc_number;

int8_t channel;
int8_t value;
int8_t value2;
};

struct v3_event_note_expression_value {
uint32_t type_id;
int32_t note_id;
double value;
};

struct v3_event_note_expression_text {
int32_t note_id;

uint32_t text_len;
const int16_t *text;
};

/**
* event
*/

enum v3_event_flags {
V3_EVENT_IS_LIVE = 1
};

enum v3_event_type {
V3_EVENT_NOTE_ON = 0,
V3_EVENT_NOTE_OFF = 1,
V3_EVENT_DATA = 2,
V3_EVENT_POLY_PRESSURE = 3,
V3_EVENT_NOTE_EXP_VALUE = 4,
V3_EVENT_NOTE_EXP_TEXT = 5,
V3_EVENT_CHORD = 6,
V3_EVENT_SCALE = 7,

V3_EVENT_LEGACY_MIDI_CC_OUT = 65535
};

struct v3_event {
int32_t bus_index;
int32_t sample_offset;

double ppq_position;
uint16_t flags;

uint16_t type;

union {
struct v3_event_note_on note_on;
struct v3_event_note_off note_off;
struct v3_event_data data;
struct v3_event_poly_pressure poly_pressure;
struct v3_event_chord chord;
struct v3_event_scale scale;
struct v3_event_legacy_midi_cc_out midi_cc_out;
struct v3_event_note_expression_value note_exp_value;
struct v3_event_note_expression_text note_exp_text;
};
};

/**
* event list
*/

struct v3_event_list {
struct v3_funknown;

V3_API uint32_t (*get_event_count)(void *self);
V3_API v3_result (*get_event)
(void *self, int32_t idx, struct v3_event *);
V3_API v3_result (*add_event)
(void *self, struct v3_event *);
};

static const v3_tuid v3_event_list_iid =
V3_ID(0x3A2C4214, 0x346349FE, 0xB2C4F397, 0xB9695A44);

#include "align_pop.h"

+ 115
- 0
distrho/src/travesty/factory.h View File

@@ -0,0 +1,115 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"

/**
* plugin factory v1
*/

struct v3_factory_info {
char vendor[64];
char url[256];
char email[128];
int32_t flags;
};

struct v3_class_info {
v3_tuid class_id;
int32_t cardinality; // set to 0x7FFFFFFF
char category[32];
char name[64];
};

struct v3_plugin_factory {
struct v3_funknown;

V3_API v3_result (*get_factory_info)
(void *self, struct v3_factory_info *);

V3_API int32_t (*num_classes)(void *self);

V3_API v3_result (*get_class_info)
(void *self, int32_t idx, struct v3_class_info *);

V3_API v3_result (*create_instance)
(void *self, const char *class_id, const char *_iid, void **instance);
};

static const v3_tuid v3_plugin_factory_iid =
V3_ID(0x7A4D811C, 0x52114A1F, 0xAED9D2EE, 0x0B43BF9F);

/**
* plugin factory v2
*/

struct v3_class_info_2 {
v3_tuid class_id;
int32_t cardinality; // set to 0x7FFFFFFF
char category[32];
char name[64];

uint32_t class_flags;
char sub_categories[128];
char vendor[64];
char version[64];
char sdk_version[64];
};

struct v3_plugin_factory_2 {
struct v3_plugin_factory;

V3_API v3_result (*get_class_info_2)
(void *self, int32_t idx, struct v3_class_info_2 *);
};

static const v3_tuid v3_plugin_factory_2_iid =
V3_ID(0x0007B650, 0xF24B4C0B, 0xA464EDB9, 0xF00B2ABB);

/**
* plugin factory v3
* (we got it right this time I swear)
*
* same as above, but "unicode" (really just utf-16, thanks microsoft!)
*/

struct v3_class_info_3 {
v3_tuid class_id;
int32_t cardinality; // set to 0x7FFFFFFF
char category[32];
int16_t name[64];

uint32_t class_flags;
char sub_categories[128];
int16_t vendor[64];
int16_t version[64];
int16_t sdk_version[64];
};

struct v3_plugin_factory_3 {
struct v3_plugin_factory;

V3_API v3_result (*get_class_info_utf16)
(void *self, int32_t idx, struct v3_class_info_3 *);

V3_API v3_result (*set_host_context)
(void *self, struct v3_funknown *host);
};

static const v3_tuid v3_plugin_factory_3_iid =
V3_ID(0x4555A2AB, 0xC1234E57, 0x9B122910, 0x36878931);

+ 117
- 0
distrho/src/travesty/view.h View File

@@ -0,0 +1,117 @@
/*
* travesty, pure C interface to steinberg VST3 SDK
* Copyright (C) 2021 Filipe Coelho <falktx@falktx.com>
*
* Permission to use, copy, modify, and/or distribute this software for any purpose with
* or without fee is hereby granted, provided that the above copyright notice and this
* permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
* TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
* NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
* IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "base.h"

/**
* base IPlugFrame stuff
*/

struct v3_view_rect {
int32_t left;
int32_t top;
int32_t right;
int32_t bottom;
};

#define V3_VIEW_PLATFORM_TYPE_HWND "HWND"
#define V3_VIEW_PLATFORM_TYPE_NSVIEW "NSView"
#define V3_VIEW_PLATFORM_TYPE_X11 "X11EmbedWindowID"

#if defined(__APPLE__)
# define V3_VIEW_PLATFORM_TYPE_NATIVE V3_VIEW_PLATFORM_TYPE_NSVIEW
#elif defined(_WIN32)
# define V3_VIEW_PLATFORM_TYPE_NATIVE V3_VIEW_PLATFORM_TYPE_HWND
#else
# define V3_VIEW_PLATFORM_TYPE_NATIVE V3_VIEW_PLATFORM_TYPE_X11
#endif

struct v3_plug_frame;

struct v3_plug_view {
struct v3_funknown;

V3_API v3_result (*is_platform_type_supported)
(void *self, const char *platform_type);

V3_API v3_result (*attached)
(void *self, void *parent, const char *platform_type);
V3_API v3_result (*removed)(void *self);

V3_API v3_result (*on_wheel)(void *self, float distance);
V3_API v3_result (*on_key_down)
(void *self, int16_t key_char, int16_t key_code, int16_t modifiers);
V3_API v3_result (*on_key_up)
(void *self, int16_t key_char, int16_t key_code, int16_t modifiers);

V3_API v3_result (*get_size)
(void *self, struct v3_view_rect *);
V3_API v3_result (*set_size)
(void *self, struct v3_view_rect *);

V3_API v3_result (*on_focus)
(void *self, v3_bool state);

V3_API v3_result (*set_frame)
(void *self, struct v3_plug_frame *);
V3_API v3_result (*can_resize)(void *self);
V3_API v3_result (*check_size_constraint)
(void *self, struct v3_view_rect *);
};

static const v3_tuid v3_plug_view_iid =
V3_ID(0x5BC32507, 0xD06049EA, 0xA6151B52, 0x2B755B29);

struct v3_plug_frame {
struct v3_funknown;

V3_API v3_result (*resize_view)
(void *self, struct v3_plug_view *, struct v3_view_rect *);
};

static const v3_tuid v3_plug_frame_iid =
V3_ID(0x367FAF01, 0xAFA94693, 0x8D4DA2A0, 0xED0882A3);

/**
* steinberg content scaling support
* (same IID/iface as presonus view scaling)
*/

struct v3_plug_view_content_scale_steinberg {
struct v3_funknown;

V3_API v3_result (*set_content_scale_factor)
(void *self, float factor);
};

static const v3_tuid v3_plug_view_content_scale_steinberg_iid =
V3_ID(0x65ED9690, 0x8AC44525, 0x8AADEF7A, 0x72EA703F);

/**
* support for querying the view to find what control is underneath the mouse
*/

struct v3_plug_view_param_finder {
struct v3_funknown;

V3_API v3_result (*find_parameter)
(void *self, int32_t x, int32_t y, v3_param_id *);
};

static const v3_tuid v3_plug_view_param_finder_iid =
V3_ID(0x0F618302, 0x215D4587, 0xA512073C, 0x77B9D383);

Write Preview
Loading…
Cancel
Save