drum_kit_table.hpp

Go to the documentation of this file.

#pragma once
 
#include "tabulasonora/patch_directory.hpp"
#include "tabulasonora/rom_image.hpp"
 
#include <array>
#include <cstdint>
#include <optional>
#include <string>
#include <vector>
 
namespace ts {

struct DrumKey {
    int tone = 0;
    int level = 0;
    int pitch = 0;
    int group = 0;
    int pan = 0;
    bool receives_note_off = false;

    bool receives_note_on = true;
};

class DrumKitTable {
public:
    static constexpr int kit_stride = 0x50C;

    static constexpr int key_count = 128;

    static constexpr int map_row_count = 6;

    static constexpr std::int64_t kit_index_offset = 0x19F21B0;

    explicit DrumKitTable(const RomImage& rom);

    [[nodiscard]] int kit_count() const noexcept { return kit_count_; }

    [[nodiscard]] static std::optional<int> row_for_map(ToneMap map) noexcept;

    [[nodiscard]] int map_row(int internal_bank) const noexcept;

    [[nodiscard]] std::optional<int> kit_for_program(int program, int row = 0) const noexcept;

    [[nodiscard]] std::string kit_name(int kit) const;

    [[nodiscard]] DrumKey key(int note, int kit = 0) const;

    [[nodiscard]] static double coarse_pitch_ratio(int pitch) noexcept;

    [[nodiscard]] static constexpr double level_gain(int level) noexcept
    {
        return (level / 127.0) * (level / 127.0);
    }
 
private:
    // Plane offsets within a kit record.
    static constexpr int tone_plane = 0x000; // 128 x u16
    static constexpr int level_plane = 0x100;
    static constexpr int pitch_plane = 0x180;
    static constexpr int group_plane = 0x200;
    static constexpr int pan_plane = 0x280;
    // 0x300 reverb depth, 0x380 chorus depth, 0x400 delay depth — per key, and not yet wired.
    static constexpr int receive_plane = 0x480;
    static constexpr int name_plane = 0x500;
    static constexpr int name_length = 12;
 
    std::int64_t kit_base_ = 0;
    std::vector<std::uint8_t> bank_row_;
    std::vector<std::uint8_t> program_map_;
    std::array<std::uint16_t, 256> kit_index_{};
    std::vector<std::uint8_t> kits_;
    int kit_count_ = 0;
};
 
} // namespace ts