godot/modules/chibi/cp_player_data.h
Rémi Verschelde d8223ffa75 Welcome in 2017, dear changelog reader!
That year should bring the long-awaited OpenGL ES 3.0 compatible renderer
with state-of-the-art rendering techniques tuned to work as low as middle
end handheld devices - without compromising with the possibilities given
for higher end desktop games of course. Great times ahead for the Godot
community and the gamers that will play our games!

(cherry picked from commit c7bc44d5ad)
2017-01-12 19:15:30 +01:00

583 lines
15 KiB
C++

/*************************************************************************/
/* cp_player_data.h */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* http://www.godotengine.org */
/*************************************************************************/
/* Copyright (c) 2007-2017 Juan Linietsky, Ariel Manzur. */
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/*************************************************************************/
#ifndef CP_PLAYER_DATA_H
#define CP_PLAYER_DATA_H
#include "cp_config.h"
#include "cp_song.h"
#include "cp_mixer.h"
#include "cp_tables.h"
/**CPPlayer Data
*@author Juan Linietsky
*/
/******************************
player_data.h
------------------------
The player and its data.
I hope you dont get sick reading this
********************************/
//Default pan values
class CPPlayer {
enum {
PAN_SURROUND=512,
PAN_RIGHT=255,
PAN_LEFT=0,
PAN_CENTER=128
};
CPSong *song;
CPMixer *mixer;
struct Filter_Control {
int32_t it_reso;
int32_t it_cutoff;
int32_t envelope_cutoff;
int32_t final_cutoff;
void process();
void set_filter_parameters(int *p_cutoff,uint8_t *p_reso);
};
//tells you if a channel is doing
//noteoff/notekill/notefade/etc
enum {
END_NOTE_NOTHING=0,
END_NOTE_OFF=1,
END_NOTE_FADE=2,
END_NOTE_KILL=4
};
//Tells you what should a channel restart
enum {
KICK_NOTHING,
KICK_NOTE,
KICK_NOTEOFF,
KICK_ENVELOPE
};
enum {
MAX_VOICES=256
};
struct Channel_Control;
struct Voice_Control {
struct Envelope_Control {
int pos_index;
int status;
int value;
bool sustain_looping;
bool looping;
bool terminated;
bool active;
bool kill;
};
Filter_Control filter;
uint16_t reverb_send;
uint16_t chorus_send;
CPInstrument* instrument_ptr;
CPSample* sample_ptr;
// Sample_Data *sample_data;
int32_t period;
int32_t sample_start_index; /* The starting byte index in the sample */
bool has_master_channel;
int master_channel_index;
int instruement_index;
int instrument_index;
int sample_index;
int8_t NNA_type;
int note_end_flags;
uint8_t sample; /* which instrument number */
int16_t output_volume; /* output volume (vol + sampcol + instvol) */
int8_t channel_volume; /* channel's "global" volume */
uint16_t fadeout_volume; /* fading volume rate */
int32_t total_volume; /* total volume of channel (before global mixings) */
uint8_t kick; /* if true = sample has to be restarted */
uint8_t note; /* the audible note (as heard, direct rep of period) */
int16_t panning; /* panning position */
uint8_t nna; /* New note action type + master/slave flags */
uint8_t volflg; /* volume envelope settings */
uint8_t panflg; /* panning envelope settings */
uint8_t pitflg; /* pitch envelope settings */
uint8_t keyoff; /* if true = fade out and stuff */
int16_t handle; /* which sample-handle */
int32_t start; /* The start byte index in the sample */
/* Below here is info NOT in MP_CONTROL!! */
//ENVPR venv;
//ENVPR penv;
//ENVPR cenv;
Envelope_Control volume_envelope_ctrl;
Envelope_Control panning_envelope_ctrl;
Envelope_Control pitch_envelope_ctrl;
uint16_t auto_vibrato_pos; /* autovibrato pos */
uint16_t auto_vibrato_sweep_pos; /* autovibrato sweep pos */
int16_t masterchn;
uint16_t masterperiod;
Channel_Control* master_channel; /* index of "master" effects channel */
void start_envelope(CPEnvelope *p_envelope,Envelope_Control *p_envelope_ctrl,Envelope_Control *p_from_env);
bool process_envelope(CPEnvelope *p_envelope,Envelope_Control *p_envelope_ctrl);
uint16_t display_volume;
Voice_Control() {
reset();
}
void reset();
void update_info_from_master_channel();
};
struct Channel_Control {
/* NOTE info */
uint8_t note; /* the audible note as heard, direct rep of period */
uint8_t real_note; /* the note that indexes the audible */
int32_t sample_start_index; /* The starting byte index in the sample */
uint8_t old_note;
uint8_t kick;
Filter_Control filter;
uint16_t reverb_send;
uint16_t chorus_send;
int note_end_flags;
/* INSTRUMENT INFO */
CPInstrument* instrument_ptr;
CPSample* sample_ptr;
uint8_t instrument_index;
uint8_t sample_index;
bool new_instrument;
/* SAMPLE SPECIFIC INFO */
int32_t base_speed; /* what finetune to use */
/* INSTRUMENT SPECIFIC INFO */
int8_t NNA_type;
int8_t duplicate_check_type;
int8_t duplicate_check_action;
bool volume_envelope_on;
bool panning_envelope_on;
bool pitch_envelope_on;
bool has_own_period;
bool row_has_note;
/* VOLUME COLUMN */
int16_t volume; /* amiga volume (0 t/m 64) to play the sample at */
int16_t aux_volume;
bool has_own_volume;
bool mute;
int16_t random_volume_variation; /* 0-100 - 100 has no effect */
/* VOLUME/PAN/PITCH MODIFIERS */
int8_t default_volume; // CHANNEL default volume (0-64)
int16_t channel_volume; // CHANNEL current volume //chanvol - current!
int16_t output_volume; /* output volume (vol + sampcol + instvol) //volume */
int16_t channel_global_volume;
uint16_t fadeout_volume; /* fading volume rate */
int32_t period; /* period to play the sample at */
/* PAN */
int16_t panning; /* panning position */
int16_t channel_panning;
int8_t sliding;
uint16_t aux_period; /* temporary period */
/* TIMING */
uint8_t note_delay; /* (used for note delay) */
/* Slave Voice Control */
Voice_Control *slave_voice; /* Audio Slave of current effects control channel */
struct Carry {
Voice_Control::Envelope_Control vol;
Voice_Control::Envelope_Control pan;
Voice_Control::Envelope_Control pitch;
bool maybe;
} carry;
uint8_t slave_voice_index; /* Audio Slave of current effects control channel */
uint8_t* row; /* row currently playing on this channel */
/* effect memory variables */
uint8_t current_command;
uint8_t current_parameter;
uint8_t current_volume_command;
uint8_t current_volume_parameter;
uint8_t volcol_volume_slide;
/* CPSample Offset */
int32_t lo_offset;
int32_t hi_offset;
/* Panbrello waveform */
uint8_t panbrello_type; /* current panbrello waveform */
uint8_t panbrello_position; /* current panbrello position */
int8_t panbrello_speed; /* "" speed */
uint8_t panbrello_depth; /* "" depth */
uint8_t panbrello_info;
/* Arpegio */
uint8_t arpegio_info;
/* CPPattern Loop */
int pattern_loop_position;
int8_t pattern_loop_count;
/* Vibrato */
bool doing_vibrato;
int8_t vibrato_position; /* current vibrato position */
uint8_t vibrato_speed; /* "" speed */
uint8_t vibrato_depth; /* "" depth */
uint8_t vibrato_type;
/* Tremor */
int8_t tremor_position;
uint8_t tremor_speed; /* s3m tremor ontime/offtime */
uint8_t tremor_depth;
uint8_t tremor_info;
/* Tremolo */
int8_t tremolo_position;
uint8_t tremolo_speed; /* s3m tremor ontime/offtime */
uint8_t tremolo_depth;
uint8_t tremolo_info;
uint8_t tremolo_type;
/* Retrig */
int8_t retrig_counter; /* retrig value (0 means don't retrig) */
uint8_t retrig_speed; /* last used retrig speed */
uint8_t retrig_volslide; /* last used retrig slide */
/* CPSample Offset */
int32_t sample_offset_hi; /* last used high order of sample offset */
uint16_t sample_offset; /* last used low order of sample-offset (effect 9) */
uint16_t sample_offset_fine; /* fine sample offset memory */
/* Portamento */
uint16_t slide_to_period; /* period to slide to (with effect 3 or 5) */
uint8_t portamento_speed;
/* Volume Slide */
uint8_t volume_slide_info;
/* Channel Volume Slide */
uint8_t channel_volume_slide_info;
/* Global Volume Slide */
uint8_t global_volume_slide_info;
/* Channel Pan Slide */
uint8_t channel_pan_slide_info;
/* Pitch Slide */
uint8_t pitch_slide_info;
/* Tempo Slide */
uint8_t tempo_slide_info;
/* S effects memory */
uint8_t current_S_effect;
uint8_t current_S_data;
/* Volume column memory */
uint8_t volume_column_effect_mem;
uint8_t volume_column_data_mem;
int64_t last_event_usecs;
bool reserved;
void reset();
Channel_Control() { channel_global_volume=255; last_event_usecs=-1; }
};
struct Control_Variables { // control variables (dynamic version) of initial variables
bool reached_end;
char play_mode;
bool filters;
int global_volume;
int speed;
int tempo;
int ticks_counter;
int pattern_delay_1;
int pattern_delay_2;
Channel_Control channel[CPPattern::WIDTH];
int max_voices;
int voices_used; /* reference value */
bool force_no_nna;
bool external_vibrato;
struct Position {
int current_order;
int current_pattern;
int current_row;
int force_next_order;
bool forbid_jump;
};
int32_t random_seed;
Position position;
Position previous_position;
};
Voice_Control voice[MAX_VOICES];
Control_Variables control;
/* VOICE SETUP */
void setup_voices();
/* MIXER SETUP */
void handle_tick();
void update_mixer();
/* NOTE / INSTRUMENT PROCESSING */
void process_new_note(int p_track,uint8_t p_note);
bool process_new_instrument(int p_track,uint8_t p_instrument);
bool process_note_and_instrument(int p_track,int p_note,int p_instrument);
/* EFFECT PROCESSING */
void do_effect_S(int p_track);
void do_panbrello(int p_track);
void do_global_volume_slide(int p_track);
void do_tremolo(int p_track);
void do_retrig(int p_track);
void do_pan_slide(int p_track);
void do_channel_volume_slide(int p_track);
void do_volume_slide(int p_track,int inf);
void do_pitch_slide_down(int p_track,uint8_t inf);
void do_pitch_slide_up(int p_track,uint8_t inf);
void do_tremor(int p_track);
void do_vibrato(int p_track,bool fine);
void do_pitch_slide_to_note(int p_track);
void run_effects(int p_track);
void run_volume_column_effects(int p_track);
void pre_process_effects();
void do_arpegio(int p_track);
uint64_t song_usecs;
/* NNA */
void process_NNAs();
/* MISC UTILS */
int find_empty_voice();
void process_volume_column(int p_track,uint8_t p_volume);
void process_note(int p_track,CPNote p_note);
/* CPTables */
static uint8_t auto_vibrato_table[128];
static uint8_t vibrato_table[32];
static int8_t panbrello_table[256];
static void callback_function(void *p_userdata);
public:
//Play modes
enum {
PLAY_NOTHING =0,
PLAY_PATTERN =1,
PLAY_SONG =2
};
int32_t get_frequency(int32_t period);
int32_t get_period(uint16_t note,int32_t p_c5freq);
int get_current_tempo() { return control.tempo; };
int get_current_speed() { return control.speed; };
int get_voices_used() { return control.voices_used;};
int get_voice_envelope_pos(int p_voice,CPEnvelope *p_envelope);
int get_voice_amount_limit() { return control.max_voices; };
void set_voice_amount_limit(int p_limit);
void set_reserved_voices(int p_amount);
int get_reserved_voices_amount();
bool is_voice_active(int p_voice);
int get_channel_voice(int p_channel);
const char* get_voice_sample_name(int p_voice);
const char* get_voice_instrument_name(int p_voice);
CPEnvelope* get_voice_envelope(int p_voice,CPInstrument::EnvelopeType p_env_type);
int get_voice_envelope_pos(int p_voice,CPInstrument::EnvelopeType p_env_type);
int get_voice_volume(int p_voice);
int get_voice_sample_index(int p_voice);
void set_virtual_channels(int p_amount);
int get_virtual_channels() { return control.max_voices; };
/* Play Info/Position */
bool is_playing() { return (control.play_mode>0); };
int get_play_mode() {return (control.play_mode);};
int get_current_order() { return control.position.current_order; };
int get_current_row() { return control.position.current_row; };
int get_current_pattern() { return control.position.current_pattern; };
void goto_next_order();
void goto_previous_order();
void process_tick();
CPMixer* get_mixer_ptr() {
return mixer;
}
void reset();
/* External player control - editor - */
void play_start_pattern(int p_pattern);
void play_start_song();
void play_start_song_from_order(int p_order);
void play_start_song_from_order_and_row(int p_order,int p_row);
void play_start(int p_pattern, int p_order, int p_row,bool p_lock=true);
void play_stop();
void play_note(int p_channel,CPNote note,bool p_reserve=false);
bool reached_end_of_song();
void set_force_no_nna(bool p_force);
void set_force_external_vibratos(bool p_force);
void set_filters_enabled(bool p_enable);
bool are_filters_enabled() { return control.filters; }
void set_channel_global_volume(int p_channel,int p_volume); //0-255
int get_channel_global_volume(int p_channel) const;
int64_t get_channel_last_note_time_usec(int p_channel) const;
CPSong *get_song() { return song; };
CPPlayer(CPMixer *p_mixer,CPSong *p_song);
~CPPlayer();
};
#endif