mirror of
https://github.com/ZDoom/gzdoom.git
synced 2024-11-29 23:33:00 +00:00
769 lines
31 KiB
C
769 lines
31 KiB
C
/* _______ ____ __ ___ ___
|
|
* \ _ \ \ / \ / \ \ / / ' ' '
|
|
* | | \ \ | | || | \/ | . .
|
|
* | | | | | | || ||\ /| |
|
|
* | | | | | | || || \/ | | ' ' '
|
|
* | | | | | | || || | | . .
|
|
* | |_/ / \ \__// || | |
|
|
* /_______/ynamic \____/niversal /__\ /____\usic /| . . ibliotheque
|
|
* / \
|
|
* / . \
|
|
* dumb.h - The user header file for DUMB. / / \ \
|
|
* | < / \_
|
|
* Include this file in any of your files in | \/ /\ /
|
|
* which you wish to use the DUMB functions \_ / > /
|
|
* and variables. | \ / /
|
|
* | ' /
|
|
* Allegro users, you will probably want aldumb.h. \__/
|
|
*/
|
|
|
|
#ifndef DUMB_H
|
|
#define DUMB_H
|
|
|
|
|
|
#include <stdlib.h>
|
|
#include <stdio.h>
|
|
|
|
#if defined(_DEBUG) && defined(_MSC_VER)
|
|
#ifndef _CRTDBG_MAP_ALLOC
|
|
#define _CRTDBG_MAP_ALLOC
|
|
#endif
|
|
#include <crtdbg.h>
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
#define DUMB_MAJOR_VERSION 0
|
|
#define DUMB_MINOR_VERSION 9
|
|
#define DUMB_REVISION_VERSION 3
|
|
|
|
#define DUMB_VERSION (DUMB_MAJOR_VERSION*10000 + DUMB_MINOR_VERSION*100 + DUMB_REVISION_VERSION)
|
|
|
|
#define DUMB_VERSION_STR "0.9.3"
|
|
|
|
#define DUMB_NAME "DUMB v"DUMB_VERSION_STR
|
|
|
|
#define DUMB_YEAR 2005
|
|
#define DUMB_MONTH 8
|
|
#define DUMB_DAY 7
|
|
|
|
#define DUMB_YEAR_STR2 "05"
|
|
#define DUMB_YEAR_STR4 "2005"
|
|
#define DUMB_MONTH_STR1 "8"
|
|
#define DUMB_DAY_STR1 "7"
|
|
|
|
#if DUMB_MONTH < 10
|
|
#define DUMB_MONTH_STR2 "0"DUMB_MONTH_STR1
|
|
#else
|
|
#define DUMB_MONTH_STR2 DUMB_MONTH_STR1
|
|
#endif
|
|
|
|
#if DUMB_DAY < 10
|
|
#define DUMB_DAY_STR2 "0"DUMB_DAY_STR1
|
|
#else
|
|
#define DUMB_DAY_STR2 DUMB_DAY_STR1
|
|
#endif
|
|
|
|
|
|
/* WARNING: The month and day were inadvertently swapped in the v0.8 release.
|
|
* Please do not compare this constant against any date in 2002. In
|
|
* any case, DUMB_VERSION is probably more useful for this purpose.
|
|
*/
|
|
#define DUMB_DATE (DUMB_YEAR*10000 + DUMB_MONTH*100 + DUMB_DAY)
|
|
|
|
#define DUMB_DATE_STR DUMB_DAY_STR1"."DUMB_MONTH_STR1"."DUMB_YEAR_STR4
|
|
|
|
|
|
#undef MIN
|
|
#undef MAX
|
|
#undef MID
|
|
|
|
#define MIN(x,y) (((x) < (y)) ? (x) : (y))
|
|
#define MAX(x,y) (((x) > (y)) ? (x) : (y))
|
|
#define MID(x,y,z) MAX((x), MIN((y), (z)))
|
|
|
|
#undef ABS
|
|
#define ABS(x) (((x) >= 0) ? (x) : (-(x)))
|
|
|
|
|
|
#ifdef DEBUGMODE
|
|
|
|
#ifndef ASSERT
|
|
#include <assert.h>
|
|
#define ASSERT(n) assert(n)
|
|
#endif
|
|
#ifndef TRACE
|
|
// it would be nice if this did actually trace ...
|
|
#define TRACE 1 ? (void)0 : (void)printf
|
|
#endif
|
|
|
|
#else
|
|
|
|
#ifndef ASSERT
|
|
#define ASSERT(n)
|
|
#endif
|
|
#ifndef TRACE
|
|
#define TRACE 1 ? (void)0 : (void)printf
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
#define DUMB_ID(a,b,c,d) (((unsigned int)(a) << 24) | \
|
|
((unsigned int)(b) << 16) | \
|
|
((unsigned int)(c) << 8) | \
|
|
((unsigned int)(d) ))
|
|
|
|
|
|
#ifdef __DOS__
|
|
typedef long int32;
|
|
typedef unsigned long uint32;
|
|
typedef signed long sint32;
|
|
#else
|
|
typedef int int32;
|
|
typedef unsigned int uint32;
|
|
typedef signed int sint32;
|
|
#endif
|
|
|
|
#define CDECL
|
|
#ifndef LONG_LONG
|
|
#if defined __GNUC__ || defined __INTEL_COMPILER || defined __MWERKS__
|
|
#define LONG_LONG long long
|
|
#elif defined _MSC_VER || defined __WATCOMC__
|
|
#define LONG_LONG __int64
|
|
#undef CDECL
|
|
#define CDECL __cdecl
|
|
#elif defined __sgi
|
|
#define LONG_LONG long long
|
|
#else
|
|
#error 64-bit integer type unknown
|
|
#endif
|
|
#endif
|
|
|
|
#if __GNUC__ * 100 + __GNUC_MINOR__ >= 301 /* GCC 3.1+ */
|
|
#ifndef DUMB_DECLARE_DEPRECATED
|
|
#define DUMB_DECLARE_DEPRECATED
|
|
#endif
|
|
#define DUMB_DEPRECATED __attribute__((__deprecated__))
|
|
#else
|
|
#define DUMB_DEPRECATED
|
|
#endif
|
|
|
|
#define DUMBEXPORT CDECL
|
|
#define DUMBCALLBACK CDECL
|
|
|
|
/* Basic Sample Type. Normal range is -0x800000 to 0x7FFFFF. */
|
|
|
|
typedef int sample_t;
|
|
|
|
|
|
/* Library Clean-up Management */
|
|
|
|
int dumb_atexit(void (*proc)(void));
|
|
|
|
void dumb_exit(void);
|
|
|
|
|
|
/* File Input Functions */
|
|
|
|
typedef struct DUMBFILE_SYSTEM
|
|
{
|
|
void *(*open)(const char *filename);
|
|
int (*skip)(void *f, int32 n);
|
|
int (*getc)(void *f);
|
|
int32 (*getnc)(char *ptr, int32 n, void *f);
|
|
void (*close)(void *f);
|
|
}
|
|
DUMBFILE_SYSTEM;
|
|
|
|
typedef struct DUMBFILE DUMBFILE;
|
|
|
|
void DUMBEXPORT register_dumbfile_system(const DUMBFILE_SYSTEM *dfs);
|
|
|
|
DUMBFILE *DUMBEXPORT dumbfile_open(const char *filename);
|
|
DUMBFILE *DUMBEXPORT dumbfile_open_ex(void *file, const DUMBFILE_SYSTEM *dfs);
|
|
|
|
int32 DUMBEXPORT dumbfile_pos(DUMBFILE *f);
|
|
int DUMBEXPORT dumbfile_skip(DUMBFILE *f, int32 n);
|
|
|
|
int DUMBEXPORT dumbfile_getc(DUMBFILE *f);
|
|
|
|
int DUMBEXPORT dumbfile_igetw(DUMBFILE *f);
|
|
int DUMBEXPORT dumbfile_mgetw(DUMBFILE *f);
|
|
|
|
int32 DUMBEXPORT dumbfile_igetl(DUMBFILE *f);
|
|
int32 DUMBEXPORT dumbfile_mgetl(DUMBFILE *f);
|
|
|
|
uint32 DUMBEXPORT dumbfile_cgetul(DUMBFILE *f);
|
|
sint32 DUMBEXPORT dumbfile_cgetsl(DUMBFILE *f);
|
|
|
|
int32 DUMBEXPORT dumbfile_getnc(char *ptr, int32 n, DUMBFILE *f);
|
|
|
|
int DUMBEXPORT dumbfile_error(DUMBFILE *f);
|
|
int DUMBEXPORT dumbfile_close(DUMBFILE *f);
|
|
|
|
|
|
/* stdio File Input Module */
|
|
|
|
void DUMBEXPORT dumb_register_stdfiles(void);
|
|
|
|
DUMBFILE *DUMBEXPORT dumbfile_open_stdfile(FILE *p);
|
|
|
|
|
|
/* Memory File Input Module */
|
|
|
|
DUMBFILE *DUMBEXPORT dumbfile_open_memory(const char *data, int32 size);
|
|
|
|
|
|
/* DUH Management */
|
|
|
|
typedef struct DUH DUH;
|
|
|
|
#define DUH_SIGNATURE DUMB_ID('D','U','H','!')
|
|
|
|
void DUMBEXPORT unload_duh(DUH *duh);
|
|
|
|
DUH *DUMBEXPORT load_duh(const char *filename);
|
|
DUH *DUMBEXPORT read_duh(DUMBFILE *f);
|
|
|
|
int32 DUMBEXPORT duh_get_length(DUH *duh);
|
|
|
|
const char *DUMBEXPORT duh_get_tag(DUH *duh, const char *key);
|
|
|
|
|
|
/* Signal Rendering Functions */
|
|
|
|
typedef struct DUH_SIGRENDERER DUH_SIGRENDERER;
|
|
|
|
DUH_SIGRENDERER *DUMBEXPORT duh_start_sigrenderer(DUH *duh, int sig, int n_channels, int32 pos);
|
|
|
|
#ifdef DUMB_DECLARE_DEPRECATED
|
|
typedef void (*DUH_SIGRENDERER_CALLBACK)(void *data, sample_t **samples, int n_channels, int32 length);
|
|
/* This is deprecated, but is not marked as such because GCC tends to
|
|
* complain spuriously when the typedef is used later. See comments below.
|
|
*/
|
|
|
|
void duh_sigrenderer_set_callback(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
DUH_SIGRENDERER_CALLBACK callback, void *data
|
|
) DUMB_DEPRECATED;
|
|
/* The 'callback' argument's type has changed for const-correctness. See the
|
|
* DUH_SIGRENDERER_CALLBACK definition just above. Also note that the samples
|
|
* in the buffer are now 256 times as large; the normal range is -0x800000 to
|
|
* 0x7FFFFF. The function has been renamed partly because its functionality
|
|
* has changed slightly and partly so that its name is more meaningful. The
|
|
* new one is duh_sigrenderer_set_analyser_callback(), and the typedef for
|
|
* the function pointer has also changed, from DUH_SIGRENDERER_CALLBACK to
|
|
* DUH_SIGRENDERER_ANALYSER_CALLBACK. (If you wanted to use this callback to
|
|
* apply a DSP effect, don't worry; there is a better way of doing this. It
|
|
* is undocumented, so contact me and I shall try to help. Contact details
|
|
* are in readme.txt.)
|
|
*/
|
|
|
|
typedef void (*DUH_SIGRENDERER_ANALYSER_CALLBACK)(void *data, const sample_t *const *samples, int n_channels, int32 length);
|
|
/* This is deprecated, but is not marked as such because GCC tends to
|
|
* complain spuriously when the typedef is used later. See comments below.
|
|
*/
|
|
|
|
void duh_sigrenderer_set_analyser_callback(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
DUH_SIGRENDERER_ANALYSER_CALLBACK callback, void *data
|
|
) DUMB_DEPRECATED;
|
|
/* This is deprecated because the meaning of the 'samples' parameter in the
|
|
* callback needed to change. For stereo applications, the array used to be
|
|
* indexed with samples[channel][pos]. It is now indexed with
|
|
* samples[0][pos*2+channel]. Mono sample data are still indexed with
|
|
* samples[0][pos]. The array is still 2D because samples will probably only
|
|
* ever be interleaved in twos. In order to fix your code, adapt it to the
|
|
* new sample layout and then call
|
|
* duh_sigrenderer_set_sample_analyser_callback below instead of this
|
|
* function.
|
|
*/
|
|
#endif
|
|
|
|
typedef void (*DUH_SIGRENDERER_SAMPLE_ANALYSER_CALLBACK)(void *data, const sample_t *const *samples, int n_channels, int32 length);
|
|
|
|
void duh_sigrenderer_set_sample_analyser_callback(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
DUH_SIGRENDERER_SAMPLE_ANALYSER_CALLBACK callback, void *data
|
|
);
|
|
|
|
int DUMBEXPORT duh_sigrenderer_get_n_channels(DUH_SIGRENDERER *sigrenderer);
|
|
int32 DUMBEXPORT duh_sigrenderer_get_position(DUH_SIGRENDERER *sigrenderer);
|
|
|
|
void DUMBEXPORT duh_sigrenderer_set_sigparam(DUH_SIGRENDERER *sigrenderer, unsigned char id, int32 value);
|
|
|
|
#ifdef DUMB_DECLARE_DEPRECATED
|
|
int32 duh_sigrenderer_get_samples(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
float volume, float delta,
|
|
int32 size, sample_t **samples
|
|
) DUMB_DEPRECATED;
|
|
/* The sample format has changed, so if you were using this function,
|
|
* you should switch to duh_sigrenderer_generate_samples() and change
|
|
* how you interpret the samples array. See the comments for
|
|
* duh_sigrenderer_set_analyser_callback().
|
|
*/
|
|
#endif
|
|
|
|
int32 DUMBEXPORT duh_sigrenderer_generate_samples(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
double volume, double delta,
|
|
int32 size, sample_t **samples
|
|
);
|
|
|
|
void DUMBEXPORT duh_sigrenderer_get_current_sample(DUH_SIGRENDERER *sigrenderer, float volume, sample_t *samples);
|
|
|
|
void DUMBEXPORT duh_end_sigrenderer(DUH_SIGRENDERER *sigrenderer);
|
|
|
|
|
|
/* DUH Rendering Functions */
|
|
|
|
int32 DUMBEXPORT duh_render(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
int bits, int unsign,
|
|
float volume, float delta,
|
|
int32 size, void *sptr
|
|
);
|
|
|
|
#ifdef DUMB_DECLARE_DEPRECATED
|
|
|
|
int32 duh_render_signal(
|
|
DUH_SIGRENDERER *sigrenderer,
|
|
float volume, float delta,
|
|
int32 size, sample_t **samples
|
|
) DUMB_DEPRECATED;
|
|
/* Please use duh_sigrenderer_generate_samples(), and see the
|
|
* comments for the deprecated duh_sigrenderer_get_samples() too.
|
|
*/
|
|
|
|
typedef DUH_SIGRENDERER DUH_RENDERER DUMB_DEPRECATED;
|
|
/* Please use DUH_SIGRENDERER instead of DUH_RENDERER. */
|
|
|
|
DUH_SIGRENDERER *duh_start_renderer(DUH *duh, int n_channels, int32 pos) DUMB_DEPRECATED;
|
|
/* Please use duh_start_sigrenderer() instead. Pass 0 for 'sig'. */
|
|
|
|
int duh_renderer_get_n_channels(DUH_SIGRENDERER *dr) DUMB_DEPRECATED;
|
|
int32 duh_renderer_get_position(DUH_SIGRENDERER *dr) DUMB_DEPRECATED;
|
|
/* Please use the duh_sigrenderer_*() equivalents of these two functions. */
|
|
|
|
void duh_end_renderer(DUH_SIGRENDERER *dr) DUMB_DEPRECATED;
|
|
/* Please use duh_end_sigrenderer() instead. */
|
|
|
|
DUH_SIGRENDERER *duh_renderer_encapsulate_sigrenderer(DUH_SIGRENDERER *sigrenderer) DUMB_DEPRECATED;
|
|
DUH_SIGRENDERER *duh_renderer_get_sigrenderer(DUH_SIGRENDERER *dr) DUMB_DEPRECATED;
|
|
DUH_SIGRENDERER *duh_renderer_decompose_to_sigrenderer(DUH_SIGRENDERER *dr) DUMB_DEPRECATED;
|
|
/* These functions have become no-ops that just return the parameter.
|
|
* So, for instance, replace
|
|
* duh_renderer_encapsulate_sigrenderer(my_sigrenderer)
|
|
* with
|
|
* my_sigrenderer
|
|
*/
|
|
|
|
#endif
|
|
|
|
|
|
/* Impulse Tracker Support */
|
|
|
|
extern int dumb_it_max_to_mix;
|
|
|
|
typedef struct DUMB_IT_SIGDATA DUMB_IT_SIGDATA;
|
|
typedef struct DUMB_IT_SIGRENDERER DUMB_IT_SIGRENDERER;
|
|
|
|
DUMB_IT_SIGDATA *DUMBEXPORT duh_get_it_sigdata(DUH *duh);
|
|
DUH_SIGRENDERER *DUMBEXPORT duh_encapsulate_it_sigrenderer(DUMB_IT_SIGRENDERER *it_sigrenderer, int n_channels, int32 pos);
|
|
DUMB_IT_SIGRENDERER *DUMBEXPORT duh_get_it_sigrenderer(DUH_SIGRENDERER *sigrenderer);
|
|
|
|
int DUMBEXPORT dumb_it_trim_silent_patterns(DUH * duh);
|
|
|
|
typedef int (*dumb_scan_callback)(void *, int, int32);
|
|
int DUMBEXPORT dumb_it_scan_for_playable_orders(DUMB_IT_SIGDATA *sigdata, dumb_scan_callback callback, void * callback_data);
|
|
|
|
DUH_SIGRENDERER *DUMBEXPORT dumb_it_start_at_order(DUH *duh, int n_channels, int startorder);
|
|
|
|
void DUMBEXPORT dumb_it_set_resampling_quality(DUMB_IT_SIGRENDERER * sigrenderer, int quality);
|
|
|
|
void DUMBEXPORT dumb_it_set_ramp_style(DUMB_IT_SIGRENDERER * sigrenderer, int ramp_style);
|
|
|
|
void DUMBEXPORT dumb_it_set_loop_callback(DUMB_IT_SIGRENDERER *sigrenderer, int (DUMBCALLBACK *callback)(void *data), void *data);
|
|
void DUMBEXPORT dumb_it_set_xm_speed_zero_callback(DUMB_IT_SIGRENDERER *sigrenderer, int (DUMBCALLBACK *callback)(void *data), void *data);
|
|
void DUMBEXPORT dumb_it_set_midi_callback(DUMB_IT_SIGRENDERER *sigrenderer, int (DUMBCALLBACK *callback)(void *data, int channel, unsigned char midi_byte), void *data);
|
|
void DUMBEXPORT dumb_it_set_global_volume_zero_callback(DUMB_IT_SIGRENDERER *sigrenderer, int (DUMBCALLBACK *callback)(void *data), void *data);
|
|
|
|
int DUMBCALLBACK dumb_it_callback_terminate(void *data);
|
|
int DUMBCALLBACK dumb_it_callback_midi_block(void *data, int channel, unsigned char midi_byte);
|
|
|
|
DUH *DUMBEXPORT dumb_load_it(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_xm(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_s3m(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_stm(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_mod(const char *filename, int rstrict);
|
|
DUH *DUMBEXPORT dumb_load_ptm(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_669(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_psm(const char *filename, int subsong);
|
|
DUH *DUMBEXPORT dumb_load_old_psm(const char * filename);
|
|
DUH *DUMBEXPORT dumb_load_mtm(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_riff(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_asy(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_okt(const char *filename);
|
|
|
|
DUH *DUMBEXPORT dumb_read_it(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_xm(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_s3m(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_stm(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_mod(DUMBFILE *f, int rstrict);
|
|
DUH *DUMBEXPORT dumb_read_ptm(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_669(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_psm(DUMBFILE *f, int subsong);
|
|
DUH *DUMBEXPORT dumb_read_old_psm(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_mtm(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_riff(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_asy(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_okt(DUMBFILE *f);
|
|
|
|
DUH *DUMBEXPORT dumb_load_it_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_xm_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_s3m_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_stm_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_mod_quick(const char *filename, int rstrict);
|
|
DUH *DUMBEXPORT dumb_load_ptm_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_669_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_psm_quick(const char *filename, int subsong);
|
|
DUH *DUMBEXPORT dumb_load_old_psm_quick(const char * filename);
|
|
DUH *DUMBEXPORT dumb_load_mtm_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_riff_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_asy_quick(const char *filename);
|
|
DUH *DUMBEXPORT dumb_load_okt_quick(const char *filename);
|
|
|
|
DUH *DUMBEXPORT dumb_read_it_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_xm_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_s3m_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_stm_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_mod_quick(DUMBFILE *f, int rstrict);
|
|
DUH *DUMBEXPORT dumb_read_ptm_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_669_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_psm_quick(DUMBFILE *f, int subsong);
|
|
DUH *DUMBEXPORT dumb_read_old_psm_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_mtm_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_riff_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_asy_quick(DUMBFILE *f);
|
|
DUH *DUMBEXPORT dumb_read_okt_quick(DUMBFILE *f);
|
|
|
|
int32 DUMBEXPORT dumb_it_build_checkpoints(DUMB_IT_SIGDATA *sigdata, int startorder);
|
|
void DUMBEXPORT dumb_it_do_initial_runthrough(DUH *duh);
|
|
|
|
int DUMBEXPORT dumb_get_psm_subsong_count(DUMBFILE *f);
|
|
|
|
const unsigned char *DUMBEXPORT dumb_it_sd_get_song_message(DUMB_IT_SIGDATA *sd);
|
|
|
|
int DUMBEXPORT dumb_it_sd_get_n_orders(DUMB_IT_SIGDATA *sd);
|
|
int DUMBEXPORT dumb_it_sd_get_n_samples(DUMB_IT_SIGDATA *sd);
|
|
int DUMBEXPORT dumb_it_sd_get_n_instruments(DUMB_IT_SIGDATA *sd);
|
|
|
|
const unsigned char *DUMBEXPORT dumb_it_sd_get_sample_name(DUMB_IT_SIGDATA *sd, int i);
|
|
const unsigned char *DUMBEXPORT dumb_it_sd_get_sample_filename(DUMB_IT_SIGDATA *sd, int i);
|
|
const unsigned char *DUMBEXPORT dumb_it_sd_get_instrument_name(DUMB_IT_SIGDATA *sd, int i);
|
|
const unsigned char *DUMBEXPORT dumb_it_sd_get_instrument_filename(DUMB_IT_SIGDATA *sd, int i);
|
|
|
|
int DUMBEXPORT dumb_it_sd_get_initial_global_volume(DUMB_IT_SIGDATA *sd);
|
|
void DUMBEXPORT dumb_it_sd_set_initial_global_volume(DUMB_IT_SIGDATA *sd, int gv);
|
|
|
|
int DUMBEXPORT dumb_it_sd_get_mixing_volume(DUMB_IT_SIGDATA *sd);
|
|
void DUMBEXPORT dumb_it_sd_set_mixing_volume(DUMB_IT_SIGDATA *sd, int mv);
|
|
|
|
int DUMBEXPORT dumb_it_sd_get_initial_speed(DUMB_IT_SIGDATA *sd);
|
|
void DUMBEXPORT dumb_it_sd_set_initial_speed(DUMB_IT_SIGDATA *sd, int speed);
|
|
|
|
int DUMBEXPORT dumb_it_sd_get_initial_tempo(DUMB_IT_SIGDATA *sd);
|
|
void DUMBEXPORT dumb_it_sd_set_initial_tempo(DUMB_IT_SIGDATA *sd, int tempo);
|
|
|
|
int DUMBEXPORT dumb_it_sd_get_initial_channel_volume(DUMB_IT_SIGDATA *sd, int channel);
|
|
void DUMBEXPORT dumb_it_sd_set_initial_channel_volume(DUMB_IT_SIGDATA *sd, int channel, int volume);
|
|
|
|
int DUMBEXPORT dumb_it_sr_get_current_order(DUMB_IT_SIGRENDERER *sr);
|
|
int DUMBEXPORT dumb_it_sr_get_current_row(DUMB_IT_SIGRENDERER *sr);
|
|
|
|
int DUMBEXPORT dumb_it_sr_get_global_volume(DUMB_IT_SIGRENDERER *sr);
|
|
void DUMBEXPORT dumb_it_sr_set_global_volume(DUMB_IT_SIGRENDERER *sr, int gv);
|
|
|
|
int DUMBEXPORT dumb_it_sr_get_tempo(DUMB_IT_SIGRENDERER *sr);
|
|
void DUMBEXPORT dumb_it_sr_set_tempo(DUMB_IT_SIGRENDERER *sr, int tempo);
|
|
|
|
int DUMBEXPORT dumb_it_sr_get_speed(DUMB_IT_SIGRENDERER *sr);
|
|
void DUMBEXPORT dumb_it_sr_set_speed(DUMB_IT_SIGRENDERER *sr, int speed);
|
|
|
|
#define DUMB_IT_N_CHANNELS 64
|
|
#define DUMB_IT_N_NNA_CHANNELS 192
|
|
#define DUMB_IT_TOTAL_CHANNELS (DUMB_IT_N_CHANNELS + DUMB_IT_N_NNA_CHANNELS)
|
|
|
|
/* Channels passed to any of these functions are 0-based */
|
|
int DUMBEXPORT dumb_it_sr_get_channel_volume(DUMB_IT_SIGRENDERER *sr, int channel);
|
|
void DUMBEXPORT dumb_it_sr_set_channel_volume(DUMB_IT_SIGRENDERER *sr, int channel, int volume);
|
|
|
|
int DUMBEXPORT dumb_it_sr_get_channel_muted(DUMB_IT_SIGRENDERER *sr, int channel);
|
|
void DUMBEXPORT dumb_it_sr_set_channel_muted(DUMB_IT_SIGRENDERER *sr, int channel, int muted);
|
|
|
|
typedef struct DUMB_IT_CHANNEL_STATE DUMB_IT_CHANNEL_STATE;
|
|
|
|
struct DUMB_IT_CHANNEL_STATE
|
|
{
|
|
int channel; /* 0-based; meaningful for NNA channels */
|
|
int sample; /* 1-based; 0 if nothing playing, then other fields undef */
|
|
int freq; /* in Hz */
|
|
float volume; /* 1.0 maximum; affected by ALL factors, inc. mixing vol */
|
|
unsigned char pan; /* 0-64, 100 for surround */
|
|
signed char subpan; /* use (pan + subpan/256.0f) or ((pan<<8)+subpan) */
|
|
unsigned char filter_cutoff; /* 0-127 cutoff=127 AND resonance=0 */
|
|
unsigned char filter_subcutoff; /* 0-255 -> no filters (subcutoff */
|
|
unsigned char filter_resonance; /* 0-127 always 0 in this case) */
|
|
/* subcutoff only changes from zero if filter envelopes are in use. The
|
|
* calculation (filter_cutoff + filter_subcutoff/256.0f) gives a more
|
|
* accurate filter cutoff measurement as a float. It would often be more
|
|
* useful to use a scaled int such as ((cutoff<<8) + subcutoff).
|
|
*/
|
|
};
|
|
|
|
/* Values of 64 or more will access NNA channels here. */
|
|
void DUMBEXPORT dumb_it_sr_get_channel_state(DUMB_IT_SIGRENDERER *sr, int channel, DUMB_IT_CHANNEL_STATE *state);
|
|
|
|
|
|
/* Signal Design Helper Values */
|
|
|
|
/* Use pow(DUMB_SEMITONE_BASE, n) to get the 'delta' value to transpose up by
|
|
* n semitones. To transpose down, use negative n.
|
|
*/
|
|
#define DUMB_SEMITONE_BASE 1.059463094359295309843105314939748495817
|
|
|
|
/* Use pow(DUMB_QUARTERTONE_BASE, n) to get the 'delta' value to transpose up
|
|
* by n quartertones. To transpose down, use negative n.
|
|
*/
|
|
#define DUMB_QUARTERTONE_BASE 1.029302236643492074463779317738953977823
|
|
|
|
/* Use pow(DUMB_PITCH_BASE, n) to get the 'delta' value to transpose up by n
|
|
* units. In this case, 256 units represent one semitone; 3072 units
|
|
* represent one octave. These units are used by the sequence signal (SEQU).
|
|
*/
|
|
#define DUMB_PITCH_BASE 1.000225659305069791926712241547647863626
|
|
|
|
|
|
/* Signal Design Function Types */
|
|
|
|
typedef void sigdata_t;
|
|
typedef void sigrenderer_t;
|
|
|
|
typedef sigdata_t *(*DUH_LOAD_SIGDATA)(DUH *duh, DUMBFILE *file);
|
|
|
|
typedef sigrenderer_t *(*DUH_START_SIGRENDERER)(
|
|
DUH *duh,
|
|
sigdata_t *sigdata,
|
|
int n_channels,
|
|
int32 pos
|
|
);
|
|
|
|
typedef void (*DUH_SIGRENDERER_SET_SIGPARAM)(
|
|
sigrenderer_t *sigrenderer,
|
|
unsigned char id, int32 value
|
|
);
|
|
|
|
typedef int32 (*DUH_SIGRENDERER_GENERATE_SAMPLES)(
|
|
sigrenderer_t *sigrenderer,
|
|
double volume, double delta,
|
|
int32 size, sample_t **samples
|
|
);
|
|
|
|
typedef void (*DUH_SIGRENDERER_GET_CURRENT_SAMPLE)(
|
|
sigrenderer_t *sigrenderer,
|
|
double volume,
|
|
sample_t *samples
|
|
);
|
|
|
|
typedef void (*DUH_END_SIGRENDERER)(sigrenderer_t *sigrenderer);
|
|
|
|
typedef void (*DUH_UNLOAD_SIGDATA)(sigdata_t *sigdata);
|
|
|
|
|
|
/* Signal Design Function Registration */
|
|
|
|
typedef struct DUH_SIGTYPE_DESC
|
|
{
|
|
int32 type;
|
|
DUH_LOAD_SIGDATA load_sigdata;
|
|
DUH_START_SIGRENDERER start_sigrenderer;
|
|
DUH_SIGRENDERER_SET_SIGPARAM sigrenderer_set_sigparam;
|
|
DUH_SIGRENDERER_GENERATE_SAMPLES sigrenderer_generate_samples;
|
|
DUH_SIGRENDERER_GET_CURRENT_SAMPLE sigrenderer_get_current_sample;
|
|
DUH_END_SIGRENDERER end_sigrenderer;
|
|
DUH_UNLOAD_SIGDATA unload_sigdata;
|
|
}
|
|
DUH_SIGTYPE_DESC;
|
|
|
|
void DUMBEXPORT dumb_register_sigtype(DUH_SIGTYPE_DESC *desc);
|
|
|
|
|
|
// Decide where to put these functions; new heading?
|
|
|
|
sigdata_t *DUMBEXPORT duh_get_raw_sigdata(DUH *duh, int sig, int32 type);
|
|
|
|
DUH_SIGRENDERER *DUMBEXPORT duh_encapsulate_raw_sigrenderer(sigrenderer_t *vsigrenderer, DUH_SIGTYPE_DESC *desc, int n_channels, int32 pos);
|
|
sigrenderer_t *DUMBEXPORT duh_get_raw_sigrenderer(DUH_SIGRENDERER *sigrenderer, int32 type);
|
|
|
|
|
|
/* Standard Signal Types */
|
|
|
|
//void dumb_register_sigtype_sample(void);
|
|
|
|
|
|
/* Sample Buffer Allocation Helpers */
|
|
|
|
#ifdef DUMB_DECLARE_DEPRECATED
|
|
sample_t **create_sample_buffer(int n_channels, int32 length) DUMB_DEPRECATED;
|
|
/* DUMB has been changed to interleave stereo samples. Use
|
|
* allocate_sample_buffer() instead, and see the comments for
|
|
* duh_sigrenderer_set_analyser_callback().
|
|
*/
|
|
#endif
|
|
sample_t **DUMBEXPORT allocate_sample_buffer(int n_channels, int32 length);
|
|
void DUMBEXPORT destroy_sample_buffer(sample_t **samples);
|
|
|
|
|
|
/* Silencing Helper */
|
|
|
|
void DUMBEXPORT dumb_silence(sample_t *samples, int32 length);
|
|
|
|
|
|
/* Click Removal Helpers */
|
|
|
|
typedef struct DUMB_CLICK_REMOVER DUMB_CLICK_REMOVER;
|
|
|
|
DUMB_CLICK_REMOVER *DUMBEXPORT dumb_create_click_remover(void);
|
|
void DUMBEXPORT dumb_record_click(DUMB_CLICK_REMOVER *cr, int32 pos, sample_t step);
|
|
void DUMBEXPORT dumb_remove_clicks(DUMB_CLICK_REMOVER *cr, sample_t *samples, int32 length, int step, double halflife);
|
|
sample_t DUMBEXPORT dumb_click_remover_get_offset(DUMB_CLICK_REMOVER *cr);
|
|
void DUMBEXPORT dumb_destroy_click_remover(DUMB_CLICK_REMOVER *cr);
|
|
|
|
DUMB_CLICK_REMOVER **DUMBEXPORT dumb_create_click_remover_array(int n);
|
|
void DUMBEXPORT dumb_record_click_array(int n, DUMB_CLICK_REMOVER **cr, int32 pos, sample_t *step);
|
|
void DUMBEXPORT dumb_record_click_negative_array(int n, DUMB_CLICK_REMOVER **cr, int32 pos, sample_t *step);
|
|
void DUMBEXPORT dumb_remove_clicks_array(int n, DUMB_CLICK_REMOVER **cr, sample_t **samples, int32 length, double halflife);
|
|
void DUMBEXPORT dumb_click_remover_get_offset_array(int n, DUMB_CLICK_REMOVER **cr, sample_t *offset);
|
|
void DUMBEXPORT dumb_destroy_click_remover_array(int n, DUMB_CLICK_REMOVER **cr);
|
|
|
|
|
|
/* Resampling Helpers */
|
|
|
|
#define DUMB_RQ_ALIASING 0
|
|
#define DUMB_RQ_LINEAR 1
|
|
#define DUMB_RQ_CUBIC 2
|
|
#define DUMB_RQ_N_LEVELS 3
|
|
extern int dumb_resampling_quality;
|
|
|
|
typedef struct DUMB_RESAMPLER DUMB_RESAMPLER;
|
|
|
|
typedef struct DUMB_VOLUME_RAMP_INFO DUMB_VOLUME_RAMP_INFO;
|
|
|
|
typedef void (*DUMB_RESAMPLE_PICKUP)(DUMB_RESAMPLER *resampler, void *data);
|
|
|
|
#include "internal/blip_buf.h"
|
|
|
|
struct DUMB_RESAMPLER
|
|
{
|
|
void *src;
|
|
int32 pos;
|
|
int subpos;
|
|
int32 start, end;
|
|
int dir;
|
|
DUMB_RESAMPLE_PICKUP pickup;
|
|
void *pickup_data;
|
|
int quality;
|
|
/* Everything below this point is internal: do not use. */
|
|
union {
|
|
sample_t x24[3*2];
|
|
short x16[3*2];
|
|
signed char x8[3*2];
|
|
} x;
|
|
int overshot;
|
|
int last_clock;
|
|
int last_amp[2];
|
|
blip_t* blip_buffer[2];
|
|
};
|
|
|
|
struct DUMB_VOLUME_RAMP_INFO
|
|
{
|
|
float volume;
|
|
float delta;
|
|
float target;
|
|
float mix;
|
|
};
|
|
|
|
void dumb_reset_resampler(DUMB_RESAMPLER *resampler, sample_t *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
DUMB_RESAMPLER *dumb_start_resampler(sample_t *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
//int32 dumb_resample_1_1(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume, double delta);
|
|
int32 dumb_resample_1_2(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//int32 dumb_resample_2_1(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
int32 dumb_resample_2_2(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//void dumb_resample_get_current_sample_1_1(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume, sample_t *dst);
|
|
void dumb_resample_get_current_sample_1_2(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
//void dumb_resample_get_current_sample_2_1(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_resample_get_current_sample_2_2(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_end_resampler(DUMB_RESAMPLER *resampler);
|
|
|
|
void dumb_reset_resampler_16(DUMB_RESAMPLER *resampler, short *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
DUMB_RESAMPLER *dumb_start_resampler_16(short *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
//int32 dumb_resample_16_1_1(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume, double delta);
|
|
int32 dumb_resample_16_1_2(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//int32 dumb_resample_16_2_1(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
int32 dumb_resample_16_2_2(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//void dumb_resample_get_current_sample_16_1_1(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume, sample_t *dst);
|
|
void dumb_resample_get_current_sample_16_1_2(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
//void dumb_resample_get_current_sample_16_2_1(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_resample_get_current_sample_16_2_2(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_end_resampler_16(DUMB_RESAMPLER *resampler);
|
|
|
|
void dumb_reset_resampler_8(DUMB_RESAMPLER *resampler, signed char *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
DUMB_RESAMPLER *dumb_start_resampler_8(signed char *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
//int32 dumb_resample_8_1_1(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume, double delta);
|
|
int32 dumb_resample_8_1_2(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//int32 dumb_resample_8_2_1(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
int32 dumb_resample_8_2_2(DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//void dumb_resample_get_current_sample_8_1_1(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume, sample_t *dst);
|
|
void dumb_resample_get_current_sample_8_1_2(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
//void dumb_resample_get_current_sample_8_2_1(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_resample_get_current_sample_8_2_2(DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_end_resampler_8(DUMB_RESAMPLER *resampler);
|
|
|
|
void dumb_reset_resampler_n(int n, DUMB_RESAMPLER *resampler, void *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
DUMB_RESAMPLER *dumb_start_resampler_n(int n, void *src, int src_channels, int32 pos, int32 start, int32 end, int quality);
|
|
//int32 dumb_resample_n_1_1(int n, DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume, double delta);
|
|
int32 dumb_resample_n_1_2(int n, DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//int32 dumb_resample_n_2_1(int n, DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
int32 dumb_resample_n_2_2(int n, DUMB_RESAMPLER *resampler, sample_t *dst, int32 dst_size, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, double delta);
|
|
//void dumb_resample_get_current_sample_n_1_1(int n, DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume, sample_t *dst);
|
|
void dumb_resample_get_current_sample_n_1_2(int n, DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
//void dumb_resample_get_current_sample_n_2_1(int n, DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_resample_get_current_sample_n_2_2(int n, DUMB_RESAMPLER *resampler, DUMB_VOLUME_RAMP_INFO * volume_left, DUMB_VOLUME_RAMP_INFO * volume_right, sample_t *dst);
|
|
void dumb_end_resampler_n(int n, DUMB_RESAMPLER *resampler);
|
|
|
|
|
|
/* DUH Construction */
|
|
|
|
DUH *make_duh(
|
|
int32 length,
|
|
int n_tags,
|
|
const char *const tag[][2],
|
|
int n_signals,
|
|
DUH_SIGTYPE_DESC *desc[],
|
|
sigdata_t *sigdata[]
|
|
);
|
|
|
|
void DUMBEXPORT duh_set_length(DUH *duh, int32 length);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* DUMB_H */
|