MIDI機能/ファイルフォーマット のバックアップ(No.1)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• MIDI機能/ファイルフォーマット へ行く。
  • 1 (2022-11-06 (日) 21:46:49)

---

目次

主な特長
使用前の準備
GIMICをMIDIキーボードや他のMIDI音源と接続する
基本操作
演奏する
音色を作る
アルペジエーター
全体に関する機能を設定する
スタンダードMIDIファイルを再生する
MIDIインプリメンテーション

---

ファイルフォーマット

---

トラブルシューティング
変更履歴

gtb(GIMIC Timbre Bank)ファイルフォーマット概要 †

多バイト数値データは全てリトルエンディアン

全体構造 †

typedef struct {
    char		sig[8];	// "GMCTIMB" gimic timble parameter
    uint32_t	chunk_start_pos;	// チャンクデータのファイル内開始位置
    uint8_t		mb_fw_version[4];	// MAJOR, MINOR, YEAR, MONTH
    uint16_t	mb_type_tablerev;	// GIMIC_MOTHERBOARD_ID_TABLEREV
    uint16_t	soundmodule_tablerev;	// GIMIC_SOUNDMODULE_TABLEREV
    uint16_t	mb_type_id;	// GIMIC_MOTHERBOARD_ID_MB
    uint16_t	soundmodule_id;	// データ作成時のモジュール
    char		mb_serial_no[8];	// MBシリアル番号
} PatchFileHeader;

rptcチャンク †

rbnkチャンク †

typedef struct {
    uint32_t	chunk_type;	///< データのタイプ
    uint32_t	chunk_size;	///< データの中身のバイト数
    uint32_t	chunk_crc;	///< データの中身のCRC32
    uint8_t		chunk_data[];	///< データの中身
} PatchFileChunk;

Patchデータブロック(PatchTypeOPM_FM) †

OPM_FM_SlotPatch †

typedef struct OPM_FM_SlotPatch {
    SlotPatchCommon	common;
    uint8_t		dt1_mul;
    uint8_t		ks_ar;
    uint8_t		ame_d1r;
    uint8_t		dt2_d2r;
    uint8_t		d1l_rr;
} OPM_FM_SlotPatch;

typedef struct OPM_FM_Patch {
    PatchCommon		common_param;
    TonedSynthCommon	tone_param;
    OPM_FM_SlotPatch    slot[4];
    uint8_t			fl_con;
    uint8_t			slot_mask;
    uint8_t			ne_nfrq;		///< ne=trueの時はvoice7で発音する
    uint8_t			fastrelease[4];
    uint8_t			reserved[5];
} OPM_FM_Patch;

Patchデータブロック(PatchTypeOPN_FM) †

OPN_FM_SlotPatch †

typedef struct OPN_FM_SlotPatch {
    SlotPatchCommon	common;
    uint8_t		dt_mul;
    uint8_t		ks_ar;
    uint8_t		ame_ssgege_dr;
    uint8_t		ssgegn_sr;
    uint8_t		sl_rr;
} OPN_FM_SlotPatch;

typedef struct OPN_FM_Patch {
    PatchCommon		    common_param;
    TonedSynthCommon	tone_param;
    OPN_FM_SlotPatch	slot[4];
    uint8_t			    fb_con;
    uint8_t			    fr_slot_mask;
    // ch3専用パラメータ
    uint16_t		    ch3_slot_lfo_env_en;
    uint16_t		    ch3_fix_coarse_fine[4];
} OPN_FM_Patch;

Patchデータブロック(PatchTypeSSG_PSG) †

PatchTypeSSG_PSG †

typedef struct SsgParam {
    uint8_t			enable;			///< 0以外だとOn
    uint8_t			coarse_tune;	///< 周波数比またはノートナンバー Noiseでは不使用
    uint8_t			fine_tune;		///<
    uint8_t			fix_freq;		///< 0以外だと固定の周波数を書き込む
    uint8_t			start_time;		///< 1以上だとキーオン前に指定時間(ms)待つ
    uint8_t			gate_time;		///< 0以外だとキーオン後に指定時間(ms)で自動的にキーオフする
    uint8_t			invert_freq;	///< 周波数を反転させる
    uint8_t			enable_pitchmod;	///< LSBがSWLFO,次のビットがSWEnvのピッチへの入力有効
} SsgParam;

typedef struct SSG_PSG_Patch {
    PatchCommon		common_param;
    TonedSynthCommon	tone_param;
    SlotPatchCommon		slot;
    uint8_t			dummy;
    uint8_t			hwenv_wave;
    uint8_t			reserved[2];
    SsgParam		param[3];	// 0:Tone, 1:Noise, 2:Env
    uint8_t			reserved2[24];
} SSG_PSG_Patch;

Patchデータブロック(PatchTypeOPN_RHYTHM) †

OPN_RHYTHM_VoiceInfo †

typedef struct OPN_RHYTHM_VoiceInfo {
    int8_t			vol;
    int8_t			pan;
    uint8_t			oneshot;
    uint8_t			attackTime;
    int8_t			attackSlope;
    uint8_t			decayRate;
    int8_t			decaySlope;
    uint8_t			reserved;
} OPN_RHYTHM_VoiceInfo;

typedef struct OPN_RHYTHM_Patch {
    PatchCommon		common_param;
    TonedSynthCommon	tone_param;
    SlotPatchCommon		slot;
    uint8_t			dummy;
    OPN_RHYTHM_VoiceInfo	voice[6];
    uint8_t			reserved[4];
} OPN_RHYTHM_Patch;

Patchデータブロック(PatchTypeOPNA_ADPCM) †

OPNA_ADPCM_SampleInfo †

typedef struct OPNA_ADPCM_SampleInfo {
    uint8_t			loop_sampleNo;
    uint8_t			oneshot_baseKey;
    uint8_t			lowestKey;
    uint8_t			highestKey;
    uint16_t		fsample;
    int8_t			vol;
    int8_t			pan;
} OPNA_ADPCM_SampleInfo;

typedef struct OPNA_ADPCM_Patch {
    PatchCommon		common_param;
    TonedSynthCommon	tone_param;
    SlotPatchCommon		slot;
    uint8_t			reserved;
    OPNA_ADPCM_SampleInfo		samples[6];
    uint8_t			reserved2[4];
} OPNA_ADPCM_Patch;

Patchデータブロック(PatchTypeOPL3_FM) †

OPL3_FM_SlotPatch †

typedef struct OPL3_FM_SlotPatch {
    SlotPatchCommon	common;
    uint8_t		a_v_e_k_mul;
    uint8_t		ksl_ws;
    uint8_t		ar_dr;
    uint8_t		sr;
    uint8_t		sl_rr;
} OPL3_FM_SlotPatch;

typedef struct OPL3_FM_Patch {
    PatchCommon		common_param; ///< 2op,4opはcommon_param.patch_type で区別する
    TonedSynthCommon	tone_param;
    OPL3_FM_SlotPatch		slot[4];
    uint8_t			fb_cnt1;
    uint8_t			fb_cnt2;
    uint8_t			fastrelease[4];
    uint8_t			reserved[6];
} OPL3_FM_Patch;

Patchデータブロック(PatchTypeOPL3_RHYTHM) †

OPL3_RHYTHM_RYTParam †

typedef struct OPL3_RHYTHM_RYTParam {
    uint8_t		velo_sens;
    uint8_t		level;
    int8_t		tune;
    uint8_t		bend_dr;
    int8_t		bend_depth;
    int8_t		bend_slope;
    uint8_t		ar_dr;
    uint8_t		ws;
} OPL3_RHYTHM_RYTParam;

typedef struct OPL3_RHYTHM_Patch {
    PatchCommon		common_param;
    int8_t			bd_mul[2];
    uint8_t			bd_m_level;
    uint8_t			bd_m_ar_dr;
    uint8_t			bd_m_ws;
    uint8_t			bd_pan_fb_cnt;
    uint8_t			sd_pan_fb_cnt;
    uint8_t			tom_pan_fb_cnt;
    OPL3_RHYTHM_RYTParam		bd;
    OPL3_RHYTHM_RYTParam		sd;
    OPL3_RHYTHM_RYTParam		hh;
    OPL3_RHYTHM_RYTParam		tc;
    OPL3_RHYTHM_RYTParam		tom;
    uint8_t			reserved[60];
} OPL3_RHYTHM_Patch;

Patchデータブロック(PatchTypeSPC_PCM) †

typedef struct SPC_PCM_Patch {
    PatchCommon		common_param;
    TonedSynthCommon	tone_param;
    SlotPatchCommon		slot;
    uint8_t		srcn;
    uint32_t	rate;
    uint8_t		fixedKey_basekey;	// 1.7
    uint8_t		dr_ar;
    uint8_t		sl_sr1;
    uint8_t		echo_pmOn_noiseOn_sr2;	// 1.1.1.5
    uint8_t		pwmFilter_pwmOctave_pwmWave2_pwmWave1;	// 2.2.2.2
    uint8_t		polarity_pwmBlend;	// 2.6
    int8_t		pwmBlend_lfo_sens[SWLFO_NUM];
    int8_t		pwmBlend_env_sens[SWENV_NUM];
    int8_t		pwmFilter_lfo_sens[SWLFO_NUM];
    int8_t		pwmFilter_env_sens[SWENV_NUM];
    int8_t		pwmBlend_ksl_sens;
    int8_t		pwmFilter_ksl_sens;
    uint8_t		userWave[32];
} SPC_PCM_Patch;

Patchデータブロック(PatchTypeOPLL_FM) †

OPLL_FM_SlotPatch †

typedef struct OPLL_FM_SlotPatch {
    SlotPatchCommon	common;
    uint8_t		a_v_e_k_mul;
    uint8_t		ksl_ws;
    uint8_t		ar_dr;
    uint8_t		unused;
    uint8_t		sl_rr;
} OPLL_FM_SlotPatch;

typedef struct OPLL_FM_Patch {
    PatchCommon		common_param;
    TonedSynthCommon	tone_param;
    OPLL_FM_SlotPatch		slot[4];
    uint8_t			fb;
    uint8_t			inst_no;
    uint8_t			reserved[10];
} OPLL_FM_Patch;

Patchデータブロック(PatchTypeOPLL_RHYTHM) †

OPLL_RHYTHM_RYTParam †

typedef struct OPLL_RHYTHM_RYTParam {
    uint8_t		velo_sens;
    uint8_t		level;
    int8_t		tune;
    uint8_t		bend_dr;
    int8_t		bend_depth;
    int8_t		bend_slope;
    uint8_t		unused[2];
} OPLL_RHYTHM_RYTParam;

typedef struct OPLL_RHYTHM_Patch {
    PatchCommon		common_param;
    int8_t			bd_mul[2];
    uint8_t			bd_m_level;
    uint8_t			bd_m_ar_dr;
    uint8_t			bd_m_ws;
    uint8_t			bd_pan_fb_cnt;
    uint8_t			sd_pan_fb_cnt;
    uint8_t			tom_pan_fb_cnt;
    OPLL_RHYTHM_RYTParam		bd;
    OPLL_RHYTHM_RYTParam		sd;
    OPLL_RHYTHM_RYTParam		hh;
    OPLL_RHYTHM_RYTParam		tc;
    OPLL_RHYTHM_RYTParam		tom;
    uint8_t			reserved[60];
} OPLL_RHYTHM_Patch;

PatchCommon †

TonedSynthCommon †

LFOParam †

EnvelopeParam †

KeyScaleParam †

SlotPatchCommon †

typedef struct PatchCommon {
    uint8_t		patch_type;		///< 音源種別
    uint8_t		lk_nxp_format_version;	///< 1.変更不可 1.エクスポート不可 6.フォーマットバージョン(後方互換性用)
    char		name[14];		///< パッチ名
    uint32_t	original_clock;	///< 作成時のクロック周波数
} PatchCommon;

typedef struct TonedSynthCommon {
    int8_t			transpose;
    int8_t			tuning;
    int8_t			panpot;
    int8_t			panpot_ksl_sens;
    int8_t			pitch_lfo_sens[SWLFO_NUM];
    int8_t			pitch_env_sens[SWENV_NUM];
    Key&#83;caleParam	ksl;
    EnvelopeParam	sw_env[SWENV_NUM];
    LFOParam		sw_lfo[SWLFO_NUM];
    uint8_t			lfo_delay[SWLFO_NUM];
    int8_t			transpose2;		// OPL3で使用
    int8_t			tuning2;		// OPL3で使用
} TonedSynthCommon;

// LFOのパラメータ(4Byte)
typedef struct LFOParam {
    uint8_t midisync_wf_inputselect;		// 1.3.4
    uint8_t	keyonrst_inputdepth;	// 1.7
    uint8_t freq;
    uint8_t	fadein;
} LFOParam;

// ソフトエンベロープのパラメータ(12Byte)
typedef struct EnvelopeParam {
    uint8_t inputselect;
    int8_t	inputdepth;
    uint8_t	attack_time;
    uint8_t	attack_slope;
    uint8_t hold_time;
    uint8_t decay_time;
    uint8_t decay_release_slope;
    uint8_t sustain_level;
    uint8_t release_time;
    uint8_t release_level;
    int8_t	key_scaling;		// 最大時に1oct上がる毎にnote=60を基準に半分に
    int8_t	velocity_scaling;	// 80を基準として32上がる毎に倍に
} EnvelopeParam;

// キースケールのカーブ定義(4Byte)
typedef struct Key&#83;caleParam {
    int8_t	min_level;
    uint8_t	slope1_2;
    int8_t	center_key;
    int8_t	max_level;
} Key&#83;caleParam;

// スロット毎のパッチデータの共通部分
typedef struct SlotPatchCommon {
    uint8_t		velo_sens;
    uint8_t		tl;
    int8_t		lfo_sens[SWLFO_NUM];
    int8_t		env_sens[SWENV_NUM];
    int8_t		ksl_sens;
} SlotPatchCommon;

patch_type †