11/* Game music emulator library C interface (also usable from C++) */
22
3- /* Game_Music_Emu 0.6.3 */
3+ /* Game_Music_Emu 0.6.4 */
44#ifndef GME_H
55#define GME_H
66
77#ifdef __cplusplus
88 extern "C" {
99#endif
1010
11- #define GME_VERSION 0x000603 /* 1 byte major, 1 byte minor, 1 byte patch-level */
11+ #define GME_VERSION 0x000604 /* 1 byte major, 1 byte minor, 1 byte patch-level */
1212
1313/* Error string returned by library functions, or NULL if no error (success) */
1414typedef const char * gme_err_t ;
@@ -57,6 +57,11 @@ BLARGG_EXPORT void gme_delete( Music_Emu* );
5757Fade time can be changed while track is playing. */
5858BLARGG_EXPORT void gme_set_fade ( Music_Emu * , int start_msec );
5959
60+ /** See gme_set_fade.
61+ * @since 0.6.4
62+ */
63+ BLARGG_EXPORT void gme_set_fade_msecs ( Music_Emu * , int start_msec , int length_msecs );
64+
6065/**
6166 * If do_autoload_limit is nonzero, then automatically load track length
6267 * metadata (if present) and terminate playback once the track length has been
@@ -67,12 +72,13 @@ BLARGG_EXPORT void gme_set_fade( Music_Emu*, int start_msec );
6772 *
6873 * By default, playback limits are loaded and applied.
6974 *
70- * @since 0.6.2
75+ * @since 0.6.3
7176 */
7277BLARGG_EXPORT void gme_set_autoload_playback_limit ( Music_Emu * , int do_autoload_limit );
7378
7479/** See gme_set_autoload_playback_limit.
75- * @since 0.6.2
80+ * (This was actually added in 0.6.3, but wasn't exported because of a typo.)
81+ * @since 0.6.4
7682 */
7783BLARGG_EXPORT int gme_autoload_playback_limit ( Music_Emu const * );
7884
@@ -123,13 +129,16 @@ struct gme_info_t
123129 int length ; /* total length, if file specifies it */
124130 int intro_length ; /* length of song up to looping section */
125131 int loop_length ; /* length of looping section */
126-
132+
127133 /* Length if available, otherwise intro_length+loop_length*2 if available,
128134 otherwise a default of 150000 (2.5 minutes). */
129135 int play_length ;
130-
131- int i4 ,i5 ,i6 ,i7 ,i8 ,i9 ,i10 ,i11 ,i12 ,i13 ,i14 ,i15 ; /* reserved */
132-
136+
137+ /* fade length in milliseconds; -1 if unknown */
138+ int fade_length ;
139+
140+ int i5 ,i6 ,i7 ,i8 ,i9 ,i10 ,i11 ,i12 ,i13 ,i14 ,i15 ; /* reserved */
141+
133142 /* empty string ("") if not available */
134143 const char * system ;
135144 const char * game ;
@@ -138,7 +147,7 @@ struct gme_info_t
138147 const char * copyright ;
139148 const char * comment ;
140149 const char * dumper ;
141-
150+
142151 const char * s7 ,* s8 ,* s9 ,* s10 ,* s11 ,* s12 ,* s13 ,* s14 ,* s15 ; /* reserved */
143152};
144153
@@ -170,13 +179,17 @@ BLARGG_EXPORT void gme_mute_voice( Music_Emu*, int index, int mute );
170179voices, 0 unmutes them all, 0x01 mutes just the first voice, etc. */
171180BLARGG_EXPORT void gme_mute_voices ( Music_Emu * , int muting_mask );
172181
182+ /* Disable/Enable echo effect for SPC files */
183+ /* Available since 0.6.4 */
184+ BLARGG_EXPORT void gme_disable_echo ( Music_Emu * , int disable );
185+
173186/* Frequency equalizer parameters (see gme.txt) */
174187/* Implementers: If modified, also adjust Music_Emu::make_equalizer as needed */
175188typedef struct gme_equalizer_t
176189{
177190 double treble ; /* -50.0 = muffled, 0 = flat, +5.0 = extra-crisp */
178191 double bass ; /* 1 = full bass, 90 = average, 16000 = almost no bass */
179-
192+
180193 double d2 ,d3 ,d4 ,d5 ,d6 ,d7 ,d8 ,d9 ; /* reserved */
181194} gme_equalizer_t ;
182195
@@ -224,7 +237,7 @@ BLARGG_EXPORT int gme_type_multitrack( gme_type_t );
224237
225238/* whether the pcm output retrieved by gme_play() will have all 8 voices rendered to their
226239 * individual stereo channel or (if false) these voices get mixed into one single stereo channel
227- * @since 0.6.2 */
240+ * @since 0.6.3 */
228241BLARGG_EXPORT int gme_multi_channel ( Music_Emu const * );
229242
230243/******** Advanced file loading ********/
@@ -248,7 +261,7 @@ BLARGG_EXPORT gme_type_t gme_identify_extension( const char path_or_extension []
248261 * Get typical file extension for a given music type. This is not a replacement
249262 * for a file content identification library (but see gme_identify_header).
250263 *
251- * @since 0.6.2
264+ * @since 0.6.3
252265 */
253266BLARGG_EXPORT const char * gme_type_extension ( gme_type_t music_type );
254267
@@ -263,7 +276,7 @@ BLARGG_EXPORT Music_Emu* gme_new_emu( gme_type_t, int sample_rate );
263276/* Create new multichannel emulator and set sample rate. Returns NULL if out of memory.
264277 * If you only need track information, pass gme_info_only for sample_rate.
265278 * (see gme_multi_channel for more information on multichannel support)
266- * @since 0.6.2
279+ * @since 0.6.3
267280 */
268281BLARGG_EXPORT Music_Emu * gme_new_emu_multi_channel ( gme_type_t , int sample_rate );
269282
@@ -273,6 +286,17 @@ BLARGG_EXPORT gme_err_t gme_load_file( Music_Emu*, const char path [] );
273286/* Load music file from memory into emulator. Makes a copy of data passed. */
274287BLARGG_EXPORT gme_err_t gme_load_data ( Music_Emu * , void const * data , long size );
275288
289+ /* Load multiple single-track music files from memory into emulator.
290+ * @since 0.6.4
291+ */
292+ BLARGG_EXPORT gme_err_t gme_load_tracks ( Music_Emu * me ,
293+ void const * data , long * sizes , int count );
294+
295+ /* Return the fixed track count of an emu file type
296+ * @since 0.6.4
297+ */
298+ BLARGG_EXPORT int gme_fixed_track_count ( gme_type_t );
299+
276300/* Load music file using custom data reader function that will be called to
277301read file data. Most emulators load the entire file in one read call. */
278302typedef gme_err_t (* gme_reader_t )( void * your_data , void * out , int count );
0 commit comments