control_decode.hpp

Go to the documentation of this file.

#pragma once
 
#include <cstdint>
#include <optional>
#include <span>
 
namespace ts {

enum class ControlTarget {
    volume,
    expression,
    pan,
    modulation,
    damper,
    reverb_send,
    chorus_send,
    delay_send,
    bank,
    bend_range,
 
    // The part modify offsets. TVF resonance is absent because the engine never reads it.
    vibrato_rate,
    vibrato_depth,
    vibrato_delay,
    tvf_cutoff,
    env_attack,
    env_decay,
    env_release,
 
    velocity_depth,
    velocity_offset,
 
    channel_pressure,

    matrix_modulation_pitch,
    matrix_pressure_pitch,

    eq_low_frequency,
    eq_low_gain,
    eq_high_frequency,
    eq_high_gain,

    eq_enabled,
};

struct ControlUpdate {
    ControlTarget target = ControlTarget::volume;
    int channel = -1;
    int value = 0;
 
    [[nodiscard]] constexpr bool is_global() const noexcept { return channel < 0; }
};

[[nodiscard]] std::optional<ControlUpdate>
decode_control_change(int channel, int controller, int value) noexcept;

[[nodiscard]] std::optional<ControlUpdate> decode_gs_sysex(std::span<const std::uint8_t> bytes,
                                                           int port = 0) noexcept;

[[nodiscard]] bool gs_checksum_ok(std::span<const std::uint8_t> bytes) noexcept;

enum class XgMessage {
    none,
    system_on,
    all_parameter_reset,
    system_parameter,
    effect1,
    multi_part,
    drum_setup,
};

struct XgAddress {
    XgMessage kind = XgMessage::none;
    int high = 0;
    int mid = 0;
    int low = 0;
    int value = 0;
    int part = -1;
};

[[nodiscard]] XgAddress decode_xg_sysex(std::span<const std::uint8_t> bytes) noexcept;

[[nodiscard]] std::optional<ControlUpdate> decode_xg_multi_part(const XgAddress& address) noexcept;
 
} // namespace ts