{"diffoscope-json-version": 1, "source1": "/srv/reproducible-results/rbuild-debian/r-b-build.YdgdwPvz/b1/allegro5_5.2.9.1+dfsg-2_arm64.changes", "source2": "/srv/reproducible-results/rbuild-debian/r-b-build.YdgdwPvz/b2/allegro5_5.2.9.1+dfsg-2_arm64.changes", "unified_diff": null, "details": [{"source1": "Files", "source2": "Files", "unified_diff": "@@ -1,9 +1,9 @@\n \n- 07765c13bb315a6f89460df85338936c 1402480 doc optional allegro5-doc_5.2.9.1+dfsg-2_all.deb\n+ 1dbdc9bb58612e5838707c4338f42e6c 1394376 doc optional allegro5-doc_5.2.9.1+dfsg-2_all.deb\n 6b00acf5f9eee09980ae3253a40edfc8 18612 libdevel optional liballegro-acodec5-dev_5.2.9.1+dfsg-2_arm64.deb\n edb760eb4d4de71446910b1db7e7520c 61904 debug optional liballegro-acodec5.2t64-dbgsym_5.2.9.1+dfsg-2_arm64.deb\n ed1646f7ef04d546ad16fe409e8d88a7 36540 libs optional liballegro-acodec5.2t64_5.2.9.1+dfsg-2_arm64.deb\n 487239f6fd08d199d31715ab1d1e644a 21416 libdevel optional liballegro-audio5-dev_5.2.9.1+dfsg-2_arm64.deb\n 5b9d9c6676fe5102f6055d7b751e714d 106764 debug optional liballegro-audio5.2t64-dbgsym_5.2.9.1+dfsg-2_arm64.deb\n c9beb6da55609180fc76853d8b2d2d5a 56272 libs optional liballegro-audio5.2t64_5.2.9.1+dfsg-2_arm64.deb\n 9f846c7116745f5fec3095fc8a1bb437 19656 libdevel optional liballegro-dialog5-dev_5.2.9.1+dfsg-2_arm64.deb\n"}, {"source1": "allegro5-doc_5.2.9.1+dfsg-2_all.deb", "source2": "allegro5-doc_5.2.9.1+dfsg-2_all.deb", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -1,3 +1,3 @@\n -rw-r--r-- 0 0 0 4 2024-05-03 10:28:35.000000 debian-binary\n--rw-r--r-- 0 0 0 31568 2024-05-03 10:28:35.000000 control.tar.xz\n--rw-r--r-- 0 0 0 1370720 2024-05-03 10:28:35.000000 data.tar.xz\n+-rw-r--r-- 0 0 0 31556 2024-05-03 10:28:35.000000 control.tar.xz\n+-rw-r--r-- 0 0 0 1362628 2024-05-03 10:28:35.000000 data.tar.xz\n"}, {"source1": "control.tar.xz", "source2": "control.tar.xz", "unified_diff": null, "details": [{"source1": "control.tar", "source2": "control.tar", "unified_diff": null, "details": [{"source1": "./control", "source2": "./control", "unified_diff": "@@ -1,13 +1,13 @@\n Package: allegro5-doc\n Source: allegro5\n Version: 2:5.2.9.1+dfsg-2\n Architecture: all\n Maintainer: Debian Games Team These functions are declared in the following header file. Link with\n allegro_acodec. This function registers all the known audio file type handlers for al_load_sample, al_save_sample, al_load_audio_stream,\n@@ -221,25 +220,27 @@\n Returns true if the acodec addon is initialized, otherwise returns\n false. Since: 5.2.6 Returns the (compiled) version of the addon, in the same format as al_get_allegro_version. If you want to play large audio files (e.g.\u00a0background music) without\n loading the whole file at once you can use al_play_audio_stream (after\n calling al_reserve_samples).\n This will load and play an An ALLEGRO_SAMPLE_ID represents a sample being played via al_play_sample. It can be used to\n later stop the sample with al_stop_sample. The underlying\n@@ -571,16 +570,15 @@\n href=\"audio.html#al_lock_sample_id\">al_lock_sample_id. Examples: Install the audio subsystem. Returns true on success, false on failure. Note: most users will call ex_audio_devices.c\n Uninstalls the audio subsystem. See also: al_install_audio Examples: Returns true if al_install_audio was called\n previously and returned successfully. Reserves a number of sample instances, attaching them to the default\n mixer. If no default mixer is set when this function is called, then it\n will create one and attach it to the default voice. If no default voice\n has been set, it, too, will be created. Plays a sample on one of the sample instances created by al_reserve_samples. Returns\n true on success, false on failure. Playback may fail because all the\n reserved sample instances are currently used. Stop the sample started by al_play_sample. See also: al_stop_samples Stop all samples started by al_play_sample. See also: al_stop_sample Examples: Locks a ALLEGRO_SAMPLE_ID,\n returning the underlying ALLEGRO_SAMPLE_INSTANCE.\n This allows you to adjust the various properties of the instance (such\n@@ -770,16 +760,15 @@\n Examples: Unlocks a ALLEGRO_SAMPLE_ID, allowing\n future calls to al_play_sample\n to reuse it if possible. Note that after the id is unlocked, the \n Examples: Loads and plays an audio file, streaming from disk as it is needed.\n This API can only play one audio stream at a time. This requires a\n default mixer to be set, which is typically done via al_reserve_samples, but can\n@@ -830,16 +818,15 @@\n \n Examples: Loads and plays an audio file from ALLEGRO_FILE stream, streaming it is\n needed. This API can only play one audio stream at a time. This requires\n a default mixer to be set, which is typically done via Since: 5.2.8 Unstable\n API: New API. An ALLEGRO_SAMPLE object stores the data necessary for playing\n pre-defined digital audio. It holds a user-specified PCM data buffer and\n information about its format (data length, depth, frequency, channel\n configuration). You can have the same ALLEGRO_SAMPLE playing multiple\n@@ -888,18 +874,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L21\">ex_acodec_multi.c Create a sample data structure from the supplied buffer. If\n Loads a few different audio file formats based on their\n extension. Note that this stores the entire file in memory at once, which may be\n time consuming. To read the file as it is needed, use ex_acodec_multi.c\n Loads an audio file from an ALLEGRO_FILE stream into an ALLEGRO_SAMPLE. The file type is\n determined by the passed \u2018ident\u2019 parameter, which is a file name\n@@ -985,16 +966,15 @@\n file formats by default. You must use the allegro_acodec addon, or\n register your own format handler. See also: al_register_sample_loader_f,\n al_init_acodec_addon Writes a sample into a file. Currently, wav is the only supported\n format, and the extension must be \u201c.wav\u201d. Returns true on success, false on error.al_init_acodec_addon
\n-\n+\n \n al_is_acodec_addon_initialized
\n-\n+\n \n al_get_allegro_acodec_version
\n-\n+\n+\n ALLEGRO_AUDIO_STREAM
. Note that\n the basic API only supports one such audio stream playing at once.ALLEGRO_SAMPLE_ID
\n-typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;\n-typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;
\n
\n al_install_audio
\n-\n+\n \n \n
\n al_uninstall_audio
\n-\n+\n \n al_is_audio_installed
\n-\n+\n \n al_reserve_samples
\n-\n+\n \n al_play_sample
\n bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed,\n- ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id)\n-bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed,\n- ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id)
al_stop_sample
\n-\n+\n \n al_stop_samples
\n-\n+\n \n \n
\n al_lock_sample_id
\n-ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)\n-ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
\n
\n al_unlock_sample_id
\n-void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)\n-void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
\n
\n al_play_audio_stream
\n-ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)\n-ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)
\n
\n al_play_audio_stream_f
\n-ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)\n-ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)
\n
\n Samples
\n ALLEGRO_SAMPLE
\n-\n+\n \n al_create_sample
\n ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples,\n unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n- ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf)\n-ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples,\n- unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n- ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf)
free_buf
is true then the buffer will be freed with al_free when the sample data structure is\n destroyed. For portability (especially Windows), the buffer should have\n@@ -929,16 +912,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L83\">ex_acodec_multi.c\n al_load_sample
\n-ALLEGRO_SAMPLE *al_load_sample(const char *filename)\n-ALLEGRO_SAMPLE *al_load_sample(const char *filename)
al_load_sample_f
\n-ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)\n-ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)
al_save_sample
\n-bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)\n-bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)
\n@@ -1003,16 +983,15 @@\n register your own format handler.
See also: al_save_sample_f,\n al_register_sample_saver,\n al_init_acodec_addon
\nbool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)\n-bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)
Writes a sample into a ALLEGRO_FILE filestream. Currently,\n wav is the only supported format, and the extension must be \u201c.wav\u201d.
\nReturns true on success, false on error. The file remains open\n@@ -1022,16 +1001,15 @@\n file formats by default. You must use the allegro_acodec addon, or\n register your own format handler.
\n \nSee also: al_save_sample, al_register_sample_saver_f,\n al_init_acodec_addon
\nFree the sample data structure. If it was created with the\n free_buf
parameter set to true, then the buffer will be\n freed with al_free.
This function will stop any sample instances which may be playing the\n@@ -1047,66 +1025,61 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L86\">ex_acodec_multi.c\n
ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)\n-ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)
Return the channel configuration of the sample.
\nSee also: ALLEGRO_CHANNEL_CONF, al_get_sample_depth, al_get_sample_frequency,\n al_get_sample_length, al_get_sample_data
\nALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)\n-ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)
Return the audio depth of the sample.
\nSee also: ALLEGRO_AUDIO_DEPTH, al_get_sample_channels, al_get_sample_frequency,\n al_get_sample_length, al_get_sample_data
\nunsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)\n-unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)
Return the frequency (in Hz) of the sample.
\nSee also: al_get_sample_channels, al_get_sample_depth, al_get_sample_length, al_get_sample_data
\nunsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)\n-unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)
Return the length of the sample in sample values.
\nSee also: al_get_sample_channels, al_get_sample_depth, al_get_sample_frequency,\n al_get_sample_data
\nvoid *al_get_sample_data(const ALLEGRO_SAMPLE *spl)\n-void *al_get_sample_data(const ALLEGRO_SAMPLE *spl)
Return a pointer to the raw sample data.
\nSee also: al_get_sample_channels, al_get_sample_depth, al_set_default_mixer.
\ntypedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;\n-typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;
An ALLEGRO_SAMPLE_INSTANCE object represents a playable instance of a\n predefined sound effect. It holds information about how the effect\n should be played: These playback parameters consist of the looping mode,\n loop start/end points, playing position, speed, gain, pan and the\n@@ -1234,16 +1206,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L22\">ex_acodec_multi.c\n
ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)\n-ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)
Creates a sample instance, using the supplied sample data. The\n instance must be attached to a mixer (or voice) in order to actually\n produce output.
\nThe argument may be NULL. You can then set the sample data later with\n@@ -1256,16 +1227,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L83\">ex_acodec_multi.c\n
void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
Detaches the sample instance from anything it may be attached to and\n frees it (the sample data, i.e.\u00a0its ALLEGRO_SAMPLE, is not\n freed!).
\nSee also: ex_acodec_multi.c\n
bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
Play the sample instance. Returns true on success, false on\n failure.
\nSee also: al_stop_sample_instance
\n@@ -1295,16 +1264,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L107\">ex_acodec_multi.c\nbool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
Stop an sample instance playing.
\nSee also: al_play_sample_instance
\nExamples:
\n@@ -1315,17 +1283,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_kcm_direct.c#L88\">ex_kcm_direct.c\nALLEGRO_CHANNEL_CONF al_get_sample_instance_channels(\n- const ALLEGRO_SAMPLE_INSTANCE *spl)\n-ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels(\n- const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the channel configuration of the sample instance\u2019s sample\n data.
\nSee also: ALLEGRO_CHANNEL_CONF.
\n@@ -1333,45 +1299,42 @@\nALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the audio depth of the sample instance\u2019s sample data.
\nSee also: ALLEGRO_AUDIO_DEPTH.
\nExamples:
\nunsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the frequency (in Hz) of the sample instance\u2019s sample\n data.
\nExamples:
\nunsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the length of the sample instance in sample values. This\n property may differ from the length of the instance\u2019s sample data.
\nSee also: al_set_sample_instance_length,\n@@ -1383,17 +1346,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_props.cpp#L196\">ex_audio_props.cpp\n
bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl,\n- unsigned int val)\n-bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl,\n- unsigned int val)
Set the length of the sample instance in sample values. This can be\n used to play only parts of the underlying sample. Be careful not to\n exceed the actual length of the sample data, though.
\nReturn true on success, false on failure. Will fail if the sample\n@@ -1403,33 +1364,30 @@\n
Examples:
\nunsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl)
Get the playback position of a sample instance.
\nSee also: al_set_sample_instance_position
\nExamples:
\nbool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl,\n- unsigned int val)\n-bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl,\n- unsigned int val)
Set the playback position of a sample instance.
\nReturns true on success, false on failure.
\nSee also: al_get_sample_instance_position
\n@@ -1437,25 +1395,23 @@\n \nfloat al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the relative playback speed of the sample instance.
\nSee also: al_set_sample_instance_speed
\nbool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n-bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
Set the relative playback speed of the sample instance. 1.0 means\n normal speed.
\nReturn true on success, false on failure. Will fail if the sample\n instance is attached directly to a voice.
\n@@ -1465,30 +1421,28 @@\n \nfloat al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the playback gain of the sample instance.
\nSee also: al_set_sample_instance_gain
\nExamples:
\nbool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n-bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
Set the playback gain of the sample instance.
\nReturns true on success, false on failure. Will fail if the sample\n instance is attached directly to a voice.
\nSee also: ex_mixer_chain.c\n
float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)
Get the pan value of the sample instance.
\nSee also: al_set_sample_instance_pan.
\nbool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n-bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
Set the pan value on a sample instance. A value of -1.0 means to play\n the sample only through the left speaker; +1.0 means only through the\n right speaker; 0.0 means the sample is centre balanced. A special value\n ALLEGRO_AUDIO_PAN_NONE\n@@ -1537,16 +1489,15 @@\n
\nfloat al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the length of the sample instance in seconds, assuming a\n playback speed of 1.0.
\nSee also: al_get_sample_instance_length
\n@@ -1557,29 +1508,26 @@\nALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return the playback mode of the sample instance.
\nSee also: ALLEGRO_PLAYMODE,\n al_set_sample_instance_playmode
\nbool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_PLAYMODE val)\n-bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_PLAYMODE val)
Set the playback mode of the sample instance.
\nReturns true on success, false on failure.
\nSee also: ALLEGRO_PLAYMODE,\n ex_mixer_chain.c\n
bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return true if the sample instance is in the playing state. This may\n be true even if the instance is not attached to anything.
\nSee also: al_set_sample_instance_playing
\nExamples:
\nbool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)\n-bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)
Change whether the sample instance is playing.
\nThe instance does not need to be attached to anything (since:\n 5.1.8).
\nReturns true on success, false on failure.
\n@@ -1627,29 +1573,27 @@\nbool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)
Return whether the sample instance is attached to something.
\nSee also: al_attach_sample_instance_to_mixer,\n al_attach_sample_instance_to_voice,\n al_detach_sample_instance
\nbool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
Detach the sample instance from whatever it\u2019s attached to, if\n anything.
\nReturns true on success.
\nSee also: al_get_sample_instance_attached
\nExamples:
\nALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)\n-ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)
Return the sample data that the sample instance plays.
\nNote this returns a pointer to an internal structure, not\n the ALLEGRO_SAMPLE that you may\n have passed to al_set_sample.\n@@ -1685,16 +1628,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L109\">ex_acodec_multi.c\n
bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)\n-bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)
Change the sample data that a sample instance plays. This can be\n quite an involved process.
\nFirst, the sample is stopped if it is not already.
\nNext, if data is NULL, the sample is detached from its parent (if\n@@ -1716,16 +1658,15 @@\n
bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix)\n-bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix)
Set the matrix used to mix the channels coming from this instance\n into the mixer it is attached to. Normally Allegro derives the values of\n this matrix from the gain and pan settings, as well as the channel\n configurations of this instance and the mixer it is attached to, but\n@@ -1755,16 +1696,15 @@\n
Examples:
\ntypedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;\n-typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;
An ALLEGRO_AUDIO_STREAM object is used to stream generated audio to\n the sound device, in real-time. This is done by reading from a buffer,\n which is split into a number of fragments. Whenever a fragment has\n finished playing, the user can refill it with new data.
\n@@ -1810,18 +1750,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L79\">ex_stream_file.c\nALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count,\n unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n- ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count,\n- unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n- ALLEGRO_CHANNEL_CONF chan_conf)
Creates an ALLEGRO_AUDIO_STREAM. The\n stream will be set to play by default. It will feed audio data from a\n buffer, which is split into a number of fragments.
\n@@ -1877,17 +1814,15 @@\nALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename,\n- size_t buffer_count, unsigned int samples)\n-ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename,\n- size_t buffer_count, unsigned int samples)
Loads an audio file from disk as it is needed.
\nUnlike regular streams, the one returned by this function need not be\n fed by the user; the library will automatically read more of the file as\n it is needed. The stream will contain buffer_count buffers with\n@@ -1913,17 +1848,15 @@\n
ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident,\n- size_t buffer_count, unsigned int samples)\n-ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident,\n- size_t buffer_count, unsigned int samples)
Loads an audio file from ALLEGRO_FILE stream as it is\n needed.
\nUnlike regular streams, the one returned by this function need not be\n@@ -1945,16 +1878,15 @@\n register your own format handler.
\n \nSee also: al_load_audio_stream, al_register_audio_stream_loader_f,\n al_init_acodec_addon
\nvoid al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
Destroy an audio stream which was created with al_create_audio_stream or\n al_load_audio_stream.
\n\n@@ -1972,17 +1904,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L124\">ex_stream_file.c\n\nex_resample_test.c \n \nal_get_audio_stream_event_source
\n\n+ ALLEGRO_AUDIO_STREAM *stream)\n \nALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source(\n- ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source(\n- ALLEGRO_AUDIO_STREAM *stream)
Retrieve the associated event source.
\nSee al_get_audio_stream_fragment\n for a description of the ex_saw.c\n
ex_stream_file.c \nex_resample_test.c \n \nal_drain_audio_stream
\n-\n+\n \nvoid al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
You should call this to finalise an audio stream that you will no\n longer be feeding, to wait for all pending buffers to finish playing.\n The stream\u2019s playing state will change to false.
\nSee also: ex_saw.c\n
ex_resample_test.c \nex_record.c \n \nal_rewind_audio_stream
\n-\n+\n \nbool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
Set the streaming file playing position to the beginning. Returns\n true on success. Currently this can only be called on streams created\n with al_load_audio_stream,\n al_play_audio_stream, Examples:
\n\n
\n- ex_stream_seek.c
\nal_get_audio_stream_frequency
\n-\n+\n \nunsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)
Return the stream frequency (in Hz).
\nal_get_audio_stream_channels
\n\n+ const ALLEGRO_AUDIO_STREAM *stream)\n \nALLEGRO_CHANNEL_CONF al_get_audio_stream_channels(\n- const ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels(\n- const ALLEGRO_AUDIO_STREAM *stream)
Return the stream channel configuration.
\nSee also: ALLEGRO_CHANNEL_CONF.
\nal_get_audio_stream_depth
\n\n+ const ALLEGRO_AUDIO_STREAM *stream)\n \nALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth(\n- const ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth(\n- const ALLEGRO_AUDIO_STREAM *stream)
Return the stream audio depth.
\nSee also: ALLEGRO_AUDIO_DEPTH.
\nal_get_audio_stream_length
\n-\n+\n \nunsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)
Return the stream length in samples.
\nExamples:
\n\n
\n- ex_stream_seek.c
\nal_get_audio_stream_speed
\n-\n+\n \nfloat al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)\n-float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)
Return the relative playback speed of the stream.
\nSee also: al_set_audio_stream_speed.
\nal_set_audio_stream_speed
\n-\n+\n \nbool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)\n-bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)
Set the relative playback speed of the stream. 1.0 means normal\n speed.
\nReturn true on success, false on failure. Will fail if the audio\n stream is attached directly to a voice.
\nSee also: al_get_audio_stream_speed.
\nal_get_audio_stream_gain
\n-\n+\n \nfloat al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)\n-float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)
Return the playback gain of the stream.
\nSee also: al_set_audio_stream_gain.
\nExamples:
\n\n
\n- ex_audio_chain.cpp
\nal_set_audio_stream_gain
\n-\n+\n \nbool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)\n-bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)
Set the playback gain of the stream.
\nReturns true on success, false on failure. Will fail if the audio\n stream is attached directly to a voice.
\nSee also: \n
\nex_synth.cpp \nex_audio_chain.cpp \n \nal_get_audio_stream_pan
\n-\n+\n \nfloat al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)\n-float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)
Get the pan value of the stream.
\nSee also: al_set_audio_stream_pan.
\nal_set_audio_stream_pan
\n-\n+\n \nbool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)\n-bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)
Set the pan value on an audio stream. A value of -1.0 means to play\n the stream only through the left speaker; +1.0 means only through the\n right speaker; 0.0 means the sample is centre balanced. A special value\n ALLEGRO_AUDIO_PAN_NONE\n@@ -2159,16 +2075,15 @@\n href=\"audio.html#allegro_audio_pan_none\">ALLEGRO_AUDIO_PAN_NONE
Examples:
\n\n
\n- ex_synth.cpp
\nal_get_audio_stream_playing
\n-\n+\n \nbool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)\n-bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)
Return true if the stream is playing.
\nSee also: al_set_audio_stream_playing.
\nExamples:
\n@@ -2177,16 +2092,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_record.c#L274\">ex_record.c\nex_stream_seek.c \nex_audio_chain.cpp \n \nal_set_audio_stream_playing
\n-\n+\n \nbool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)\n-bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)
Change whether the stream is playing.
\nReturns true on success, false on failure.
\nSee also: al_get_audio_stream_playing
\n@@ -2197,29 +2111,25 @@\nex_record.c \nex_stream_seek.c \n \nal_get_audio_stream_playmode
\n\n+ const ALLEGRO_AUDIO_STREAM *stream)\n \nALLEGRO_PLAYMODE al_get_audio_stream_playmode(\n- const ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_PLAYMODE al_get_audio_stream_playmode(\n- const ALLEGRO_AUDIO_STREAM *stream)
Return the playback mode of the stream.
\nSee also: ALLEGRO_PLAYMODE,\n al_set_audio_stream_playmode.
\nal_set_audio_stream_playmode
\n\n+ ALLEGRO_PLAYMODE val)\n \nbool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream,\n- ALLEGRO_PLAYMODE val)\n-bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream,\n- ALLEGRO_PLAYMODE val)
Set the playback mode of the stream.
\nReturns true on success, false on failure.
\nSee also: ALLEGRO_PLAYMODE,\n ex_stream_file.c\n
ex_mixer_pp.c \nex_stream_seek.c \n \nal_get_audio_stream_attached
\n-\n+\n \nbool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)\n-bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)
Return whether the stream is attached to something.
\nSee also: al_attach_audio_stream_to_mixer,\n al_attach_audio_stream_to_voice,\n al_detach_audio_stream.
\nal_detach_audio_stream
\n-\n+\n \nbool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
Detach the stream from whatever it\u2019s attached to, if anything.
\nSee also: al_attach_audio_stream_to_mixer,\n Examples:
\n\n
\n- ex_audio_chain.cpp
\nal_get_audio_stream_played_samples
\n-\n+\n \nuint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)\n-uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)
Get the number of samples consumed by the parent since the audio\n stream was started.
\nSince: 5.1.8
\nal_get_audio_stream_fragment
\n-\n+\n \nvoid *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)\n-void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)
When using Allegro\u2019s audio streaming, you will use this function to\n continuously provide new sample data to a stream.
\nIf the stream is ready for new data, the function will return the\n address of an internal buffer to be filled with audio data. The length\n@@ -2318,16 +2224,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L39\">ex_saw.c\n
ex_resample_test.c \nex_synth.cpp \n \nal_set_audio_stream_fragment
\n-\n+\n \nbool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)\n-bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)
This function needs to be called for every successful call of al_get_audio_stream_fragment\n to indicate that the buffer (pointed to by
\n@@ -2340,43 +2245,39 @@\nval
) is filled\n with new data.ex_resample_test.c \nex_synth.cpp \n \nal_get_audio_stream_fragments
\n-\n+\n \nunsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)
Returns the number of fragments this stream uses. This is the same\n value as passed to al_create_audio_stream when\n a new stream is created.
\nSee also: al_get_available_audio_stream_fragments
\nal_get_available_audio_stream_fragments
\n\n+ const ALLEGRO_AUDIO_STREAM *stream)\n \nunsigned int al_get_available_audio_stream_fragments(\n- const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_available_audio_stream_fragments(\n- const ALLEGRO_AUDIO_STREAM *stream)
Returns the number of available fragments in the stream, that is,\n fragments which are not currently filled with data for playback.
\nSee also: al_get_audio_stream_fragment,\n al_get_audio_stream_fragments
\nal_seek_audio_stream_secs
\n-\n+\n \nbool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)\n-bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)
Set the streaming file playing position to time. Returns true on\n success. Currently this can only be called on streams created with al_load_audio_stream, al_play_audio_stream, Examples:
\n\n
\n- ex_stream_seek.c
\nal_get_audio_stream_position_secs
\n-\n+\n \ndouble al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)\n-double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)
Return the position of the stream in seconds. Currently this can only\n be called on streams created with al_load_audio_stream, al_play_audio_stream, Examples:
\n\n
\n- ex_stream_seek.c
\nal_get_audio_stream_length_secs
\n-\n+\n \ndouble al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)\n-double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)
Return the length of the stream in seconds, if known. Otherwise\n returns zero.
\nCurrently this can only be called on streams created with al_load_audio_stream, \n
ex_stream_seek.c \n \nal_set_audio_stream_loop_secs
\n\n+ double start, double end)\n \nbool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream,\n- double start, double end)\n-bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream,\n- double start, double end)
Sets the loop points for the stream in seconds. Currently this can\n only be called on streams created with al_load_audio_stream, al_play_audio_stream, \n
Unstable\n API: New API.
\n
bool al_register_sample_loader(const char *ext,\n- ALLEGRO_SAMPLE *(*loader)(const char *filename))\n-bool al_register_sample_loader(const char *ext,\n- ALLEGRO_SAMPLE *(*loader)(const char *filename))
Register a handler for al_load_sample. The given function\n will be used to handle the loading of sample files with the given\n extension.
\n@@ -2488,17 +2383,15 @@\n unregistering an entry that doesn\u2019t exist.\nSee also: al_register_sample_loader_f,\n al_register_sample_saver
\nbool al_register_sample_loader_f(const char *ext,\n- ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp))\n-bool al_register_sample_loader_f(const char *ext,\n- ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp))
Register a handler for al_load_sample_f. The given\n function will be used to handle the loading of sample files with the\n given extension.
\n@@ -2508,17 +2401,15 @@\n entry.\nReturns true on success, false on error. Returns false if\n unregistering an entry that doesn\u2019t exist.
\nSee also: al_register_sample_loader
\nbool al_register_sample_saver(const char *ext,\n- bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl))\n-bool al_register_sample_saver(const char *ext,\n- bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl))
Register a handler for al_save_sample. The given function\n will be used to handle the saving of sample files with the given\n extension.
\n@@ -2530,17 +2421,15 @@\n unregistering an entry that doesn\u2019t exist.\nSee also: al_register_sample_saver_f,\n al_register_sample_loader
\nbool al_register_sample_saver_f(const char *ext,\n- bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl))\n-bool al_register_sample_saver_f(const char *ext,\n- bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl))
Register a handler for al_save_sample_f. The given\n function will be used to handle the saving of sample files with the\n given extension.
\n@@ -2553,18 +2442,15 @@\nSee also: al_register_sample_saver
\nbool al_register_audio_stream_loader(const char *ext,\n ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename,\n- size_t buffer_count, unsigned int samples))\n-bool al_register_audio_stream_loader(const char *ext,\n- ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename,\n- size_t buffer_count, unsigned int samples))
Register a handler for al_load_audio_stream and al_play_audio_stream. The\n given function will be used to open streams from files with the given\n@@ -2578,18 +2464,15 @@\n
See also: al_register_audio_stream_loader_f
\nbool al_register_audio_stream_loader_f(const char *ext,\n ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp,\n- size_t buffer_count, unsigned int samples))\n-bool al_register_audio_stream_loader_f(const char *ext,\n- ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp,\n- size_t buffer_count, unsigned int samples))
Register a handler for al_load_audio_stream_f and\n al_play_audio_stream_f.\n The given function will be used to open streams from files with the\n@@ -2602,17 +2485,15 @@\n unregistering an entry that doesn\u2019t exist.
\nSee also: al_register_audio_stream_loader
\nbool al_register_sample_identifier(const char *ext,\n- bool (*identifier)(ALLEGRO_FILE* fp))\n-bool al_register_sample_identifier(const char *ext,\n- bool (*identifier)(ALLEGRO_FILE* fp))
Register an identify handler for al_identify_sample. The given\n function will be used to detect files for the given extension. It will\n be called with a single argument of type Returns true on success, false on error. Returns false if\n unregistering an entry that doesn\u2019t exist.
\nSince: 5.2.8
\nSee also: al_identify_bitmap
\nchar const *al_identify_sample(char const *filename)\n-char const *al_identify_sample(char const *filename)
char const *al_identify_sample(char const *filename)
\n \n This works exactly as al_identify_sample_f but you\n specify the filename of the file for which to detect the type and not a\n file handle. The extension, if any, of the passed filename is not taken\n@@ -2646,16 +2526,15 @@\n
Since: 5.2.8
\nSee also: al_init_acodec_addon, al_identify_sample_f, al_register_sample_identifier
\nchar const *al_identify_sample_f(ALLEGRO_FILE *fp)\n-char const *al_identify_sample_f(ALLEGRO_FILE *fp)
char const *al_identify_sample_f(ALLEGRO_FILE *fp)
\n \n Tries to guess the audio file type of the open ALLEGRO_FILE by\n reading the first few bytes. By default Allegro cannot recognize any\n file types, but calling al_init_acodec_addon will\n@@ -2677,16 +2556,15 @@\n add a small amount of latency. However, for most applications that small\n overhead will not adversely affect performance.
\nRecording is supported by the ALSA, AudioQueue, DirectSound8, and\n PulseAudio drivers. Enumerating or choosing other recording devices is\n not yet supported.
\ntypedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER;\n-typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER;
typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER;
\n \n An opaque datatype that represents a recording device.
\nSince: 5.1.1
\n\n\nUnstable\n@@ -2697,16 +2575,15 @@\n
\nex_record_name.c \nex_record.c \n \nALLEGRO_AUDIO_RECORDER_EVENT
\n\n+class=\"sourceCode c\">typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT;\n-typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT;
typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT;
\n \nStructure that holds the audio recorder event data. Every event type\n will contain:
\n\n
\n- .source: pointer to the audio recorder
\n@@ -2730,18 +2607,15 @@\n- ex_record.c
\nal_create_audio_recorder
\n\n+ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n \nALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count,\n unsigned int samples, unsigned int frequency,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count,\n- unsigned int samples, unsigned int frequency,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
Creates an audio recorder using the system\u2019s default recording\n device. (So if the returned device does not work, try updating the\n system\u2019s default recording device.)
\nAllegro will internally buffer several seconds of captured audio with\n@@ -2778,16 +2652,15 @@\n
ex_record_name.c \nex_record.c \n \nal_start_audio_recorder
\n\n+class=\"sourceCode c\">bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n-bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
\n \nBegin recording into the fragment buffer. Once a complete fragment\n has been captured (as specified in al_create_audio_recorder),\n an ex_record_name.c\n
ex_record.c \n \nal_stop_audio_recorder
\n\n+class=\"sourceCode c\">void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n-void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
\n \nStop capturing audio data. Note that the audio recorder is still\n active and consuming resources, so if you are finished recording you\n should destroy it with al_destroy_audio_recorder.
\n@@ -2825,30 +2697,28 @@\n\n\nUnstable\n API: The API may need a slight redesign.
\nal_is_audio_recorder_recording
\n\n+class=\"sourceCode c\">bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r)\n-bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r)
bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r)
\n \nReturns true if the audio recorder is currently capturing data and\n generating events.
\nSince: 5.1.1
\n\n\nUnstable\n API: The API may need a slight redesign.
\nal_get_audio_recorder_event
\n\n+class=\"sourceCode c\">ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event)\n-ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event)
ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event)
\n \nReturns the event as an ALLEGRO_AUDIO_RECORDER_EVENT.
\nSince: 5.1.1
\n\n@@ -2861,16 +2731,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_record_name.c#L131\">ex_record_name.c\nex_record.c \n \nal_get_audio_recorder_event_source
\n\n+class=\"sourceCode c\">ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r)\n-ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r)
ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r)
\n \nReturns the event source for the recorder that generates the various\n recording events.
\nSince: 5.1.1
\n\n@@ -2882,16 +2751,15 @@\nex_record_name.c \nex_record.c \n \nal_destroy_audio_recorder
\n\n+class=\"sourceCode c\">void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n-void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
\n \nDestroys the audio recorder and frees all resources associated with\n it. It is safe to destroy a recorder that is recording.
\nYou may receive events after the recorder has been destroyed. They\n must be ignored, as the fragment buffer will no longer be valid.
\n@@ -2906,74 +2774,69 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_record_name.c#L215\">ex_record_name.c\nex_record.c \n \nAudio devices
\nALLEGRO_AUDIO_DEVICE
\n\n+class=\"sourceCode c\">typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE;\n-typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE;
typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE;
\n \nAn opaque datatype that represents an audio device.
\nExamples:
\n\n
\n- ex_audio_devices.c
\nal_get_num_audio_output_devices
\n \n+class=\"sourceCode c\">int al_get_num_audio_output_devices()
\n \nGet the number of available audio output devices on the system.
\nSince: 5.2.8
\nreturn -1 for unsupported drivers.
\nExamples:
\n\n
\n- ex_audio_devices.c
\nal_get_audio_output_device
\n\n+class=\"sourceCode c\">const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index)\n-const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index)
const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index)
\n \nGet the output audio device of the specified index.
\nSince: 5.2.8
\nExamples:
\n\n
\n- ex_audio_devices.c
\nal_get_audio_device_name
\n\n+class=\"sourceCode c\">const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device)\n-const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device)
const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device)
\n \nGet the user friendly display name of the device.
\nSince: 5.2.8
\nExamples:
\n\n
\n- ex_audio_devices.c
\nVoices
\nALLEGRO_VOICE
\n \n+class=\"sourceCode c\">typedef struct ALLEGRO_VOICE ALLEGRO_VOICE;
\n \nA voice represents an audio device on the system, which may be a real\n device, or an abstract device provided by the operating system. To play\n back audio, you would attach a mixer, sample instance or audio stream to\n a voice.
\n@@ -2988,17 +2851,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L24\">ex_acodec_multi.c\nex_kcm_direct.c \n \nal_create_voice
\n\n+ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n \nALLEGRO_VOICE *al_create_voice(unsigned int freq,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_VOICE *al_create_voice(unsigned int freq,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
Creates a voice structure and allocates a voice from the digital\n sound driver. The passed frequency (in Hz), sample format and channel\n configuration are used as a hint to what kind of data will be sent to\n the voice. However, the underlying sound driver is free to use\n@@ -3021,16 +2882,15 @@\n
ex_acodec_multi.c \nex_kcm_direct.c \n \nal_destroy_voice
\n \n+class=\"sourceCode c\">void al_destroy_voice(ALLEGRO_VOICE *voice)
\n \nDestroys the voice and deallocates it from the digital driver. Does\n nothing if the voice is NULL.
\nSee also: al_create_voice
\n@@ -3041,16 +2901,15 @@\nex_acodec_multi.c \nex_kcm_direct.c \n \nal_detach_voice
\n \n+class=\"sourceCode c\">void al_detach_voice(ALLEGRO_VOICE *voice)
\n \nDetaches the mixer, sample instance or audio stream from the\n voice.
\nSee also: al_attach_mixer_to_voice,\n@@ -3058,17 +2917,15 @@\n href=\"audio.html#al_attach_sample_instance_to_voice\">al_attach_sample_instance_to_voice,\n al_attach_audio_stream_to_voice
\nal_attach_audio_stream_to_voice
\n\n+ ALLEGRO_VOICE *voice)\n \nbool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream,\n- ALLEGRO_VOICE *voice)\n-bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream,\n- ALLEGRO_VOICE *voice)
Attaches an audio stream to a voice. The same rules as al_attach_sample_instance_to_voice\n apply. This may fail if the driver can\u2019t create a voice with the buffer\n count and buffer size the stream uses.
\n@@ -3086,16 +2943,15 @@\nex_stream_file.c \nex_audio_chain.cpp \n \nal_attach_mixer_to_voice
\n\n+class=\"sourceCode c\">bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice)\n-bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice)
bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice)
\n \nAttaches a mixer to a voice. It must have the same frequency and\n channel configuration, but the depth may be different.
\nReturns true on success, false on failure.
\nSee also: al_detach_voice,\n@@ -3110,17 +2966,15 @@\n
ex_mixer_chain.c \n \nal_attach_sample_instance_to_voice
\n\n+ ALLEGRO_VOICE *voice)\n \nbool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_VOICE *voice)\n-bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_VOICE *voice)
Attaches a sample instance to a voice, and allows it to play. The\n instance\u2019s gain and loop mode will be ignored, and it must have the same\n frequency, channel configuration and depth (including signed-ness) as\n the voice. This function may fail if the selected driver doesn\u2019t support\n@@ -3136,59 +2990,54 @@\n
ex_kcm_direct.c \nex_audio_chain.cpp \n \nal_get_voice_frequency
\n\n+class=\"sourceCode c\">unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice)\n-unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice)
unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice)
\n \nReturn the frequency of the voice (in Hz), e.g.\u00a044100.
\nal_get_voice_channels
\n\n+class=\"sourceCode c\">ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice)\n-ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice)
ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice)
\n \nReturn the channel configuration of the voice.
\nSee also: ALLEGRO_CHANNEL_CONF.
\nal_get_voice_depth
\n\n+class=\"sourceCode c\">ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice)\n-ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice)
ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice)
\n \nReturn the audio depth of the voice.
\nSee also: ALLEGRO_AUDIO_DEPTH.
\nal_get_voice_playing
\n\n+class=\"sourceCode c\">bool al_get_voice_playing(const ALLEGRO_VOICE *voice)\n-bool al_get_voice_playing(const ALLEGRO_VOICE *voice)
bool al_get_voice_playing(const ALLEGRO_VOICE *voice)
\n \nReturn true if the voice is currently playing.
\nSee also: al_set_voice_playing
\nExamples:
\n\n
\n- ex_audio_chain.cpp
\nal_set_voice_playing
\n\n+class=\"sourceCode c\">bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val)\n-bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val)
bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val)
\n \nChange whether a voice is playing or not. This can only work if the\n voice has a non-streaming object attached to it, e.g.\u00a0a sample instance.\n On success the voice\u2019s current sample position is reset.
\nReturns true on success, false on failure.
\n@@ -3197,56 +3046,52 @@\nExamples:
\n\n
\n- ex_audio_chain.cpp
\nal_get_voice_position
\n\n+class=\"sourceCode c\">unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice)\n-unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice)
unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice)
\n \nWhen the voice has a non-streaming object attached to it, e.g.\u00a0a\n sample, returns the voice\u2019s current sample position. Otherwise, returns\n zero.
\nSee also: al_set_voice_position.
\nal_set_voice_position
\n\n+class=\"sourceCode c\">bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val)\n-bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val)
bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val)
\n \nSet the voice position. This can only work if the voice has a\n non-streaming object attached to it, e.g.\u00a0a sample instance.
\nReturns true on success, false on failure.
\nSee also: al_get_voice_position.
\nal_voice_has_attachments
\n\n+class=\"sourceCode c\">bool al_voice_has_attachments(const ALLEGRO_VOICE* voice)\n-bool al_voice_has_attachments(const ALLEGRO_VOICE* voice)
bool al_voice_has_attachments(const ALLEGRO_VOICE* voice)
\n \nReturns true if the voice has something attached to it.
\nSee also: al_attach_mixer_to_voice,\n al_attach_sample_instance_to_voice,\n al_attach_audio_stream_to_voice
\nSince: 5.2.9
\nMixers
\nALLEGRO_MIXER
\n \n+class=\"sourceCode c\">typedef struct ALLEGRO_MIXER ALLEGRO_MIXER;
\n \nA mixer mixes together attached streams into a single buffer. In the\n process, it converts channel configurations, sample frequencies and\n audio depths of the attached sample instances and audio streams\n accordingly. You can control the quality of this conversion using\n@@ -3263,31 +3108,28 @@\n
ex_acodec_multi.c \nex_mixer_chain.c \n \nALLEGRO_MIXER_QUALITY
\n \n+class=\"sourceCode c\">enum ALLEGRO_MIXER_QUALITY
\n \n\n
\n- ALLEGRO_MIXER_QUALITY_POINT - point sampling
\n- ALLEGRO_MIXER_QUALITY_LINEAR - linear interpolation
\n- ALLEGRO_MIXER_QUALITY_CUBIC - cubic interpolation (since: 5.0.8,\n 5.1.4)
\nal_create_mixer
\n\n+ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n \nALLEGRO_MIXER *al_create_mixer(unsigned int freq,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_MIXER *al_create_mixer(unsigned int freq,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
Creates a mixer to attach sample instances, audio streams, or other\n mixers to. It will mix into a buffer at the requested frequency (in Hz)\n and channel count.
\nThe only supported audio depths are ALLEGRO_AUDIO_DEPTH_FLOAT32 and\n@@ -3309,16 +3151,15 @@\n
ex_acodec_multi.c \nex_mixer_chain.c \n \nal_destroy_mixer
\n \n+class=\"sourceCode c\">void al_destroy_mixer(ALLEGRO_MIXER *mixer)
\n \nDestroys the mixer.
\nSee also: al_create_mixer
\nExamples:
\n@@ -3328,16 +3169,15 @@\nex_acodec_multi.c \nex_mixer_chain.c \n \nal_get_default_mixer
\n \n+class=\"sourceCode c\">ALLEGRO_MIXER *al_get_default_mixer(void)
\n \nReturn the default mixer, or NULL if one has not been set. Although\n different configurations of mixers and voices can be used, in most cases\n a single mixer attached to a voice is what you want. The default mixer\n is used by al_play_sample.
\n@@ -3353,16 +3193,15 @@\nex_audio_props.cpp \nex_resample_test.c \n \nal_set_default_mixer
\n \n+class=\"sourceCode c\">bool al_set_default_mixer(ALLEGRO_MIXER *mixer)
\n \nSets the default mixer. All samples started with al_play_sample will be stopped and\n all sample instances returned by al_lock_sample_id will be\n@@ -3373,16 +3212,15 @@\n
See also: al_reserve_samples, al_play_sample, al_get_default_mixer, al_restore_default_mixer
\nal_restore_default_mixer
\n \n+class=\"sourceCode c\">bool al_restore_default_mixer(void)
\n \nRestores Allegro\u2019s default mixer and attaches it to the default\n voice. If the default mixer hasn\u2019t been created before, it will be\n created. If the default voice hasn\u2019t been set via al_set_default_voice or\n@@ -3394,40 +3232,37 @@\n
Returns true on success, false on error.
\nSee also: al_get_default_mixer, al_set_default_mixer, al_reserve_samples.
\nal_get_default_voice
\n \n+class=\"sourceCode c\">ALLEGRO_VOICE *al_get_default_voice(void)
\n \nReturns the default voice or NULL if there is none.
\nSince: 5.1.13
\nSee also: al_get_default_mixer
\nal_set_default_voice
\n \n+class=\"sourceCode c\">void al_set_default_voice(ALLEGRO_VOICE *voice)
\n \nYou can call this before calling al_restore_default_mixer to provide\n the voice which should be used. Any previous voice will be destroyed.\n You can also pass NULL to destroy the current default voice.
\nSince: 5.1.13
\nSee also: al_get_default_mixer
\nal_attach_mixer_to_mixer
\n\n+class=\"sourceCode c\">bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer)\n-bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer)
bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer)
\n \nAttaches the mixer passed as the first argument onto the mixer passed\n as the second argument. The first mixer (that is going to be attached)\n must not already be attached to anything. Both mixers must use the same\n frequency, audio depth and channel configuration.
\n@@ -3442,17 +3277,15 @@\nex_audio_chain.cpp \n \nal_attach_sample_instance_to_mixer
\n\n+ ALLEGRO_MIXER *mixer)\n \nbool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_MIXER *mixer)\n-bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_MIXER *mixer)
Attach a sample instance to a mixer. The instance must not already be\n attached to anything.
\nReturns true on success, false on failure.
\nSee also: ex_mixer_chain.c\n
ex_acodec.c \n \nal_attach_audio_stream_to_mixer
\n\n+class=\"sourceCode c\">bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer)\n-bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer)
bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer)
\n \nAttach an audio stream to a mixer. The stream must not already be\n attached to anything.
\nReturns true on success, false on failure.
\nSee also: ex_stream_file.c\n
ex_resample_test.c \n \nal_get_mixer_frequency
\n\n+class=\"sourceCode c\">unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer)\n-unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer)
unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer)
\n \nReturn the mixer frequency (in Hz).
\nSee also: al_set_mixer_frequency
\nal_set_mixer_frequency
\n\n+class=\"sourceCode c\">bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val)\n-bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val)
bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val)
\n \nSet the mixer frequency (in Hz). This will only work if the mixer is\n not attached to anything.
\nReturns true on success, false on failure.
\nSee also: al_get_mixer_frequency
\nal_get_mixer_channels
\n\n+class=\"sourceCode c\">ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer)\n-ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer)
ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer)
\n \nReturn the mixer channel configuration.
\nSee also: ALLEGRO_CHANNEL_CONF.
\nExamples:
\n\n
\n- ex_synth.cpp
\nal_get_mixer_depth
\n\n+class=\"sourceCode c\">ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer)\n-ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer)
ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer)
\n \nReturn the mixer audio depth.
\nSee also: ALLEGRO_AUDIO_DEPTH.
\nExamples:
\n\n
\n- ex_synth.cpp
\nal_get_mixer_gain
\n\n+class=\"sourceCode c\">float al_get_mixer_gain(const ALLEGRO_MIXER *mixer)\n-float al_get_mixer_gain(const ALLEGRO_MIXER *mixer)
float al_get_mixer_gain(const ALLEGRO_MIXER *mixer)
\n \nReturn the mixer gain (amplification factor). The default is 1.0.
\nSince: 5.0.6, 5.1.0
\nSee also: al_set_mixer_gain.
\nExamples:
\n\n
\n- ex_audio_chain.cpp
\nal_set_mixer_gain
\n\n+class=\"sourceCode c\">bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain)\n-bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain)
bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain)
\n \nSet the mixer gain (amplification factor).
\nReturns true on success, false on failure.
\nSince: 5.0.6, 5.1.0
\nSee also: ex_audio_props.cpp\n
ex_audio_chain.cpp \n \nal_get_mixer_quality
\n\n+class=\"sourceCode c\">ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer)\n-ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer)
ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer)
\n \nReturn the mixer quality.
\nSee also: ALLEGRO_MIXER_QUALITY, al_set_mixer_quality
\nal_set_mixer_quality
\n\n+class=\"sourceCode c\">bool al_set_mixer_quality(ALLEGRO_MIXER *mixer, ALLEGRO_MIXER_QUALITY new_quality)\n-bool al_set_mixer_quality(ALLEGRO_MIXER *mixer, ALLEGRO_MIXER_QUALITY new_quality)
bool al_set_mixer_quality(ALLEGRO_MIXER *mixer, ALLEGRO_MIXER_QUALITY new_quality)
\n \nSet the mixer quality. This can only succeed if the mixer does not\n have anything attached to it.
\nReturns true on success, false on failure.
\nSee also: ALLEGRO_MIXER_QUALITY, al_get_mixer_quality
\nal_get_mixer_playing
\n\n+class=\"sourceCode c\">bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer)\n-bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer)
bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer)
\n \nReturn true if the mixer is playing.
\nSee also: al_set_mixer_playing.
\nExamples:
\n\n
\n- ex_audio_chain.cpp
\nal_set_mixer_playing
\n\n+class=\"sourceCode c\">bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val)\n-bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val)
bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val)
\n \nChange whether the mixer is playing.
\nReturns true on success, false on failure.
\nSee also: al_get_mixer_playing.
\nExamples:
\n\n
\n- ex_audio_chain.cpp
\nal_get_mixer_attached
\n\n+class=\"sourceCode c\">bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer)\n-bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer)
bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer)
\n \nReturn true if the mixer is attached to something.
\nSee also: al_mixer_has_attachments,\n al_attach_audio_stream_to_mixer,\n al_attach_mixer_to_mixer,\n al_detach_mixer
\nal_mixer_has_attachments
\n\n+class=\"sourceCode c\">bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer)\n-bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer)
bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer)
\n \nReturns true if the mixer has something attached to it.
\nSee also: al_get_mixer_attached, al_attach_sample_instance_to_mixer,\n@@ -3662,16 +3482,15 @@\n href=\"audio.html#al_attach_audio_stream_to_mixer\">al_attach_audio_stream_to_mixer,\n al_attach_mixer_to_mixer,\n al_detach_mixer
\nSince: 5.2.9
\nal_detach_mixer
\n \n+class=\"sourceCode c\">bool al_detach_mixer(ALLEGRO_MIXER *mixer)
\n \nDetach the mixer from whatever it is attached to, if anything.
\nSee also: al_attach_mixer_to_mixer.
\nExamples:
\n@@ -3680,18 +3499,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_chain.cpp#L460\">ex_audio_chain.cpp\n \nal_set_mixer_postprocess_callback
\n\n+ void *pp_callback_userdata)\n \nbool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer,\n void (*pp_callback)(void *buf, unsigned int samples, void *data),\n- void *pp_callback_userdata)\n-bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer,\n- void (*pp_callback)(void *buf, unsigned int samples, void *data),\n- void *pp_callback_userdata)
Sets a post-processing filter function that\u2019s called after the\n attached streams have been mixed. The buffer\u2019s format will be whatever\n the mixer was created with. The sample count and user-data pointer is\n also passed.
\n@@ -3707,16 +3523,15 @@\n href=\"https://github.com/liballeg/allegro5/blob/master/examples/ex_synth.cpp#L500\">ex_synth.cpp\nex_mixer_pp.c \n \nMiscelaneous
\nALLEGRO_AUDIO_DEPTH
\n \n+class=\"sourceCode c\">enum ALLEGRO_AUDIO_DEPTH
\n \nSample depth and type as well as signedness. Mixers only use 32-bit\n signed float (-1..+1), or 16-bit signed integers. Signedness is\n determined by an \u201cunsigned\u201d bit-flag applied to the depth value.
\n\n@@ -3739,16 +3554,15 @@\n
\n- ex_stream_file.c
\n- ex_acodec_multi.c
\nALLEGRO_AUDIO_PAN_NONE
\n \n+class=\"sourceCode c\">#define ALLEGRO_AUDIO_PAN_NONE (-1000.0f)
\n \nA special value for the pan property of sample instances and audio\n streams. Use this value to disable panning on sample instances and audio\n streams, and play them without attentuation implied by panning\n support.
\n@@ -3762,16 +3576,15 @@\nExamples:
\n\n
\n- ex_audio_props.cpp
\nALLEGRO_CHANNEL_CONF
\n \n+class=\"sourceCode c\">enum ALLEGRO_CHANNEL_CONF
\n \nSpeaker configuration (mono, stereo, 2.1, etc).
\n\n
\n- ALLEGRO_CHANNEL_CONF_1
\n- ALLEGRO_CHANNEL_CONF_2
\n@@ -3788,16 +3601,15 @@\n- ex_stream_file.c
\n- ex_acodec_multi.c
\nALLEGRO_PLAYMODE
\n \n+class=\"sourceCode c\">enum ALLEGRO_PLAYMODE
\n \nSample and stream playback mode.
\n\n
\n- ALLEGRO_PLAYMODE_ONCE - the sample/stream is played from start to\n finish an then it stops.
\n@@ -3819,16 +3631,15 @@\n- ex_kcm_direct.c
\n- ex_mixer_chain.c
\nALLEGRO_AUDIO_EVENT_TYPE
\n \n+class=\"sourceCode c\">enum ALLEGRO_AUDIO_EVENT_TYPE
\n \nEvents sent by al_get_audio_stream_event_source\n or al_get_audio_recorder_event_source.
\n@@ -3851,57 +3662,52 @@\nSince: 5.1.1
\n\n\nUnstable\n API: The API may need a slight redesign.
\nal_get_allegro_audio_version
\n \n+class=\"sourceCode c\">uint32_t al_get_allegro_audio_version(void)
\n \nReturns the (compiled) version of the addon, in the same format as al_get_allegro_version.
\nal_get_audio_depth_size
\n\n+class=\"sourceCode c\">size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth)\n-size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth)
size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth)
\n \nReturn the size of a sample, in bytes, for the given format. The\n format is one of the values listed under ALLEGRO_AUDIO_DEPTH.
\nExamples:
\n\n
\n- ex_synth.cpp
\nal_get_channel_count
\n\n+class=\"sourceCode c\">size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf)\n-size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf)
size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf)
\n \nReturn the number of channels for the given channel configuration,\n which is one of the values listed under ALLEGRO_CHANNEL_CONF.
\nExamples:
\n\n
\n- ex_acodec.c
\nal_fill_silence
\n\n+ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n \nvoid al_fill_silence(void *buf, unsigned int samples,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-void al_fill_silence(void *buf, unsigned int samples,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
Fill a buffer with silence, for the given format and channel\n configuration. The buffer must have enough space for the given number of\n samples, and be properly aligned.
\nSince: 5.1.8
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -228,54 +228,49 @@\n samples, you can use the _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bD that al_play_sample returns.\n If you want to play large audio files (e.g.\u00a0background music) without loading\n the whole file at once you can use _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm (after calling\n _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs). This will load and play an ALLEGRO_AUDIO_STREAM. Note that\n the basic API only supports one such audio stream playing at once.\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_S\bSA\bAM\bMP\bPL\bLE\bE_\b_I\bID\bD *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;\n-typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n An ALLEGRO_SAMPLE_ID represents a sample being played via _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be. It\n can be used to later stop the sample with _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be. The underlying\n ALLEGRO_SAMPLE_INSTANCE can be extracted using _\ba_\bl_\b__\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_i\bin\bns\bst\bta\bal\bll\bl_\b_a\bau\bud\bdi\bio\bo *\b**\b**\b**\b**\b*\n bool al_install_audio(void)\n-bool al_install_audio(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Install the audio subsystem.\n Returns true on success, false on failure.\n Note: most users will call _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs and\n _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn after this.\n See also: _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs, _\ba_\bl_\b__\bu_\bn_\bi_\bn_\bs_\bt_\ba_\bl_\bl_\b__\ba_\bu_\bd_\bi_\bo, _\ba_\bl_\b__\bi_\bs_\b__\ba_\bu_\bd_\bi_\bo_\b__\bi_\bn_\bs_\bt_\ba_\bl_\bl_\be_\bd,\n _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bd_\be_\bv_\bi_\bc_\be_\bs_\b._\bc\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_u\bun\bni\bin\bns\bst\bta\bal\bll\bl_\b_a\bau\bud\bdi\bio\bo *\b**\b**\b**\b**\b*\n void al_uninstall_audio(void)\n-void al_uninstall_audio(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Uninstalls the audio subsystem.\n See also: _\ba_\bl_\b__\bi_\bn_\bs_\bt_\ba_\bl_\bl_\b__\ba_\bu_\bd_\bi_\bo\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_i\bis\bs_\b_a\bau\bud\bdi\bio\bo_\b_i\bin\bns\bst\bta\bal\bll\ble\bed\bd *\b**\b**\b**\b**\b*\n bool al_is_audio_installed(void)\n-bool al_is_audio_installed(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns true if _\ba_\bl_\b__\bi_\bn_\bs_\bt_\ba_\bl_\bl_\b__\ba_\bu_\bd_\bi_\bo was called previously and returned\n successfully.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\bes\bse\ber\brv\bve\be_\b_s\bsa\bam\bmp\bpl\ble\bes\bs *\b**\b**\b**\b**\b*\n bool al_reserve_samples(int reserve_samples)\n-bool al_reserve_samples(int reserve_samples)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Reserves a number of sample instances, attaching them to the default mixer. If\n no default mixer is set when this function is called, then it will create one\n and attach it to the default voice. If no default voice has been set, it, too,\n will be created.\n If you call this function a second time with a smaller number of samples, then\n the excess internal sample instances will be destroyed causing some sounds to\n@@ -292,16 +287,14 @@\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_p\bpl\bla\bay\by_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed,\n ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id)\n-bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed,\n- ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Plays a sample on one of the sample instances created by _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs.\n Returns true on success, false on failure. Playback may fail because all the\n reserved sample instances are currently used.\n Parameters:\n * gain - relative volume at which the sample is played; 1.0 is normal.\n * pan - 0.0 is centred, -1.0 is left, 1.0 is right, or\n@@ -317,33 +310,30 @@\n _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bD, _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs, _\ba_\bl_\b__\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd.\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bst\bto\bop\bp_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id)\n-void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Stop the sample started by _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be.\n See also: _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bst\bto\bop\bp_\b_s\bsa\bam\bmp\bpl\ble\bes\bs *\b**\b**\b**\b**\b*\n void al_stop_samples(void)\n-void al_stop_samples(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Stop all samples started by _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be.\n See also: _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_l\blo\boc\bck\bk_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bid\bd *\b**\b**\b**\b**\b*\n ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)\n-ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Locks a _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bD, returning the underlying _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bN_\bS_\bT_\bA_\bN_\bC_\bE.\n This allows you to adjust the various properties of the instance (such as\n volume, pan, etc) while the sound is playing.\n This function will return NULL if the sound corresponding to the id is no\n longer playing.\n While locked, ALLEGRO_SAMPLE_ID will be unavailable to additional calls to\n@@ -353,28 +343,26 @@\n See also: _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\bu_\bn_\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd\n Since: 5.2.3\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: New API.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_u\bun\bnl\blo\boc\bck\bk_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bid\bd *\b**\b**\b**\b**\b*\n void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)\n-void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Unlocks a _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bD, allowing future calls to _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be to reuse\n it if possible. Note that after the id is unlocked, the _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bN_\bS_\bT_\bA_\bN_\bC_\bE\n that was previously returned by _\ba_\bl_\b__\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd will possibly be playing a\n different sound, so you should only use it after locking the id again.\n See also: _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd\n Since: 5.2.3\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: New API.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_p\bpl\bla\bay\by_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)\n-ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Loads and plays an audio file, streaming from disk as it is needed. This API\n can only play one audio stream at a time. This requires a default mixer to be\n set, which is typically done via _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs, but can also be done via\n _\ba_\bl_\b__\bs_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br.\n Returns the stream on success, NULL on failure. You must not destroy the\n returned stream, it will be automatically destroyed when the addon is shut\n@@ -386,16 +374,14 @@\n Since: 5.2.8\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: New API.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_p\bpl\bla\bay\by_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bf *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char\n *ident)\n-ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char\n-*ident)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Loads and plays an audio file from _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bF_\bI_\bL_\bE stream, streaming it is needed.\n This API can only play one audio stream at a time. This requires a default\n mixer to be set, which is typically done via _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs, but can also\n be done via _\ba_\bl_\b__\bs_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br.\n The file type is determined by the passed \u2018ident\u2019 parameter, which is a file\n name extension including the leading dot.\n@@ -409,32 +395,28 @@\n register your own format handler.\n See also: _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf\n Since: 5.2.8\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: New API.\n *\b**\b**\b**\b**\b**\b* S\bSa\bam\bmp\bpl\ble\bes\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_S\bSA\bAM\bMP\bPL\bLE\bE *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE;\n-typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n An ALLEGRO_SAMPLE object stores the data necessary for playing pre-defined\n digital audio. It holds a user-specified PCM data buffer and information about\n its format (data length, depth, frequency, channel configuration). You can have\n the same ALLEGRO_SAMPLE playing multiple times simultaneously.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bN_\bS_\bT_\bA_\bN_\bC_\bE\n Examples:\n * _\be_\bx_\b__\bg_\bl_\be_\bx_\bt_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_c\bcr\bre\bea\bat\bte\be_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples,\n unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf)\n-ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples,\n- unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n- ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Create a sample data structure from the supplied buffer. If free_buf is true\n then the buffer will be freed with _\ba_\bl_\b__\bf_\br_\be_\be when the sample data structure is\n destroyed. For portability (especially Windows), the buffer should have been\n allocated with _\ba_\bl_\b__\bm_\ba_\bl_\bl_\bo_\bc. Otherwise you should free the sample data yourself.\n A sample that is referred to by the samples parameter refers to a sequence\n channel intensities. E.g. if you\u2019re making a stereo sample with the samples set\n@@ -450,15 +432,14 @@\n See also: _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\bs_\ba_\bm_\bp_\bl_\be, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_l\blo\boa\bad\bd_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n ALLEGRO_SAMPLE *al_load_sample(const char *filename)\n-ALLEGRO_SAMPLE *al_load_sample(const char *filename)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Loads a few different audio file formats based on their extension.\n Note that this stores the entire file in memory at once, which may be time\n consuming. To read the file as it is needed, use _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm or\n _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm.\n Returns the sample on success, NULL on failure.\n N\bNo\bot\bte\be:\b: the allegro_audio library does not support any audio file\n@@ -467,15 +448,14 @@\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\bo_\ba_\bd_\be_\br, _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_l\blo\boa\bad\bd_\b_s\bsa\bam\bmp\bpl\ble\be_\b_f\bf *\b**\b**\b**\b**\b*\n ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)\n-ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Loads an audio file from an _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bF_\bI_\bL_\bE stream into an _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE. The\n file type is determined by the passed \u2018ident\u2019 parameter, which is a file name\n extension including the leading dot.\n Note that this stores the entire file in memory at once, which may be time\n consuming. To read the file as it is needed, use _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf or\n _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf.\n@@ -483,78 +463,70 @@\n afterwards.\n N\bNo\bot\bte\be:\b: the allegro_audio library does not support any audio file\n formats by default. You must use the allegro_acodec addon, or\n register your own format handler.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\bo_\ba_\bd_\be_\br_\b__\bf, _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bsa\bav\bve\be_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)\n-bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Writes a sample into a file. Currently, wav is the only supported format, and\n the extension must be \u201c.wav\u201d.\n Returns true on success, false on error.\n N\bNo\bot\bte\be:\b: the allegro_audio library does not support any audio file\n formats by default. You must use the allegro_acodec addon, or\n register your own format handler.\n See also: _\ba_\bl_\b__\bs_\ba_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf, _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bs_\ba_\bv_\be_\br, _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bsa\bav\bve\be_\b_s\bsa\bam\bmp\bpl\ble\be_\b_f\bf *\b**\b**\b**\b**\b*\n bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)\n-bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Writes a sample into a _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bF_\bI_\bL_\bE filestream. Currently, wav is the only\n supported format, and the extension must be \u201c.wav\u201d.\n Returns true on success, false on error. The file remains open afterwards.\n N\bNo\bot\bte\be:\b: the allegro_audio library does not support any audio file\n formats by default. You must use the allegro_acodec addon, or\n register your own format handler.\n See also: _\ba_\bl_\b__\bs_\ba_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bs_\ba_\bv_\be_\br_\b__\bf, _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bes\bst\btr\bro\boy\by_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n void al_destroy_sample(ALLEGRO_SAMPLE *spl)\n-void al_destroy_sample(ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Free the sample data structure. If it was created with the free_buf parameter\n set to true, then the buffer will be freed with _\ba_\bl_\b__\bf_\br_\be_\be.\n This function will stop any sample instances which may be playing the buffer\n referenced by the _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE.\n See also: _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be, _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_c\bch\bha\ban\bnn\bne\bel\bls\bs *\b**\b**\b**\b**\b*\n ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)\n-ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the channel configuration of the sample.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\be_\bp_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by,\n _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\be_\bn_\bg_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\ba_\bt_\ba\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_d\bde\bep\bpt\bth\bh *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)\n-ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the audio depth of the sample.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bc_\bh_\ba_\bn_\bn_\be_\bl_\bs, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by,\n _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\be_\bn_\bg_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\ba_\bt_\ba\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_f\bfr\bre\beq\bqu\bue\ben\bnc\bcy\by *\b**\b**\b**\b**\b*\n unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)\n-unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the frequency (in Hz) of the sample.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bc_\bh_\ba_\bn_\bn_\be_\bl_\bs, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\be_\bp_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\be_\bn_\bg_\bt_\bh,\n _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\ba_\bt_\ba\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_l\ble\ben\bng\bgt\bth\bh *\b**\b**\b**\b**\b*\n unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)\n-unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the length of the sample in sample values.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bc_\bh_\ba_\bn_\bn_\be_\bl_\bs, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\be_\bp_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by,\n _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\ba_\bt_\ba\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_d\bda\bat\bta\ba *\b**\b**\b**\b**\b*\n void *al_get_sample_data(const ALLEGRO_SAMPLE *spl)\n-void *al_get_sample_data(const ALLEGRO_SAMPLE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return a pointer to the raw sample data.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bc_\bh_\ba_\bn_\bn_\be_\bl_\bs, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\be_\bp_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by,\n _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\be_\bn_\bg_\bt_\bh\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bt_\bi_\bm_\be_\br_\b._\bc\n *\b**\b**\b**\b**\b**\b* A\bAd\bdv\bva\ban\bnc\bce\bed\bd A\bAu\bud\bdi\bio\bo *\b**\b**\b**\b**\b**\b*\n@@ -628,15 +600,14 @@\n al_play_sample is called, it\u2019ll use one of these internal sample instances that\n is not currently playing to play the requested sample. All of these sample\n instances will be attached to the default mixer, which can be changed via\n _\ba_\bl_\b__\bs_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br.\n *\b**\b**\b**\b**\b**\b* S\bSa\bam\bmp\bpl\ble\be i\bin\bns\bst\bta\ban\bnc\bce\bes\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_S\bSA\bAM\bMP\bPL\bLE\bE_\b_I\bIN\bNS\bST\bTA\bAN\bNC\bCE\bE *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;\n-typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n An ALLEGRO_SAMPLE_INSTANCE object represents a playable instance of a\n predefined sound effect. It holds information about how the effect should be\n played: These playback parameters consist of the looping mode, loop start/end\n points, playing position, speed, gain, pan and the playmode. Whether a sample\n instance is currently playing or paused is also one of its properties.\n An instance uses the data from an _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE object. Multiple instances may\n@@ -647,178 +618,155 @@\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_c\bcr\bre\bea\bat\bte\be_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be *\b**\b**\b**\b**\b*\n ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)\n-ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Creates a sample instance, using the supplied sample data. The instance must be\n attached to a mixer (or voice) in order to actually produce output.\n The argument may be NULL. You can then set the sample data later with\n _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be.\n See also: _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bes\bst\btr\bro\boy\by_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be *\b**\b**\b**\b**\b*\n void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Detaches the sample instance from anything it may be attached to and frees it\n (the sample data, i.e.\u00a0its ALLEGRO_SAMPLE, is n\bno\bot\bt freed!).\n See also: _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_p\bpl\bla\bay\by_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be *\b**\b**\b**\b**\b*\n bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Play the sample instance. Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bs_\bt_\bo_\bp_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bst\bto\bop\bp_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be *\b**\b**\b**\b**\b*\n bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Stop an sample instance playing.\n See also: _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_c\bch\bha\ban\bnn\bne\bel\bls\bs *\b**\b**\b**\b**\b*\n ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels(\n const ALLEGRO_SAMPLE_INSTANCE *spl)\n-ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels(\n- const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the channel configuration of the sample instance\u2019s sample data.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF.\n Examples:\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_d\bde\bep\bpt\bth\bh *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE\n *spl)\n-ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE\n-*spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the audio depth of the sample instance\u2019s sample data.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH.\n Examples:\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_f\bfr\bre\beq\bqu\bue\ben\bnc\bcy\by *\b**\b**\b**\b**\b*\n unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE\n *spl)\n-unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE\n-*spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the frequency (in Hz) of the sample instance\u2019s sample data.\n Examples:\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_l\ble\ben\bng\bgt\bth\bh *\b**\b**\b**\b**\b*\n unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the length of the sample instance in sample values. This property may\n differ from the length of the instance\u2019s sample data.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bl_\be_\bn_\bg_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bi_\bm_\be\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_l\ble\ben\bng\bgt\bth\bh *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl,\n unsigned int val)\n-bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl,\n- unsigned int val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the length of the sample instance in sample values. This can be used to\n play only parts of the underlying sample. Be careful not to exceed the actual\n length of the sample data, though.\n Return true on success, false on failure. Will fail if the sample instance is\n currently playing.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bl_\be_\bn_\bg_\bt_\bh\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpo\bos\bsi\bit\bti\bio\bon\bn *\b**\b**\b**\b**\b*\n unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE\n *spl)\n-unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE\n-*spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the playback position of a sample instance.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\bo_\bs_\bi_\bt_\bi_\bo_\bn\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpo\bos\bsi\bit\bti\bio\bon\bn *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl,\n unsigned int val)\n-bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl,\n- unsigned int val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the playback position of a sample instance.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\bo_\bs_\bi_\bt_\bi_\bo_\bn\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_s\bsp\bpe\bee\bed\bd *\b**\b**\b**\b**\b*\n float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the relative playback speed of the sample instance.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bs_\bp_\be_\be_\bd\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_s\bsp\bpe\bee\bed\bd *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n-bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the relative playback speed of the sample instance. 1.0 means normal speed.\n Return true on success, false on failure. Will fail if the sample instance is\n attached directly to a voice.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bs_\bp_\be_\be_\bd\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_g\bga\bai\bin\bn *\b**\b**\b**\b**\b*\n float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the playback gain of the sample instance.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bg_\ba_\bi_\bn\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_g\bga\bai\bin\bn *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n-bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the playback gain of the sample instance.\n Returns true on success, false on failure. Will fail if the sample instance is\n attached directly to a voice.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bg_\ba_\bi_\bn\n Examples:\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpa\ban\bn *\b**\b**\b**\b**\b*\n float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the pan value of the sample instance.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\ba_\bn.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpa\ban\bn *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n-bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the pan value on a sample instance. A value of -1.0 means to play the\n sample only through the left speaker; +1.0 means only through the right\n speaker; 0.0 means the sample is centre balanced. A special value\n _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bP_\bA_\bN_\b__\bN_\bO_\bN_\bE disables panning and plays the sample at its original\n level. This will be louder than a pan value of 0.0.\n Note: panning samples with more than two channels doesn\u2019t work yet.\n@@ -826,99 +774,88 @@\n attached directly to a voice.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\ba_\bn, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bP_\bA_\bN_\b__\bN_\bO_\bN_\bE\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_t\bti\bim\bme\be *\b**\b**\b**\b**\b*\n float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the length of the sample instance in seconds, assuming a playback speed\n of 1.0.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bl_\be_\bn_\bg_\bt_\bh\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpl\bla\bay\bym\bmo\bod\bde\be *\b**\b**\b**\b**\b*\n ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE\n *spl)\n-ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE\n-*spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the playback mode of the sample instance.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bP_\bL_\bA_\bY_\bM_\bO_\bD_\bE, _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\bl_\ba_\by_\bm_\bo_\bd_\be\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpl\bla\bay\bym\bmo\bod\bde\be *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl,\n ALLEGRO_PLAYMODE val)\n-bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_PLAYMODE val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the playback mode of the sample instance.\n Returns true on success, false on failure.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bP_\bL_\bA_\bY_\bM_\bO_\bD_\bE, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\bl_\ba_\by_\bm_\bo_\bd_\be\n Examples:\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return true if the sample instance is in the playing state. This may be true\n even if the instance is not attached to anything.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)\n-bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Change whether the sample instance is playing.\n The instance does not need to be attached to anything (since: 5.1.8).\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_a\bat\btt\bta\bac\bch\bhe\bed\bd *\b**\b**\b**\b**\b*\n bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return whether the sample instance is attached to something.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br,\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bet\bta\bac\bch\bh_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be *\b**\b**\b**\b**\b*\n bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n-bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Detach the sample instance from whatever it\u2019s attached to, if anything.\n Returns true on success.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br,\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\ba_\bt_\bt_\ba_\bc_\bh_\be_\bd\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)\n-ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the sample data that the sample instance plays.\n Note this returns a pointer to an internal structure, n\bno\bot\bt the _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE\n that you may have passed to _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be. However, the sample buffer of the\n returned ALLEGRO_SAMPLE will be the same as the one that was used to create the\n sample (passed to _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\bs_\ba_\bm_\bp_\bl_\be). You can use _\ba_\bl_\b__\bg_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bd_\ba_\bt_\ba on the\n return value to retrieve and compare it.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)\n-bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Change the sample data that a sample instance plays. This can be quite an\n involved process.\n First, the sample is stopped if it is not already.\n Next, if data is NULL, the sample is detached from its parent (if any).\n If data is not NULL, the sample may be detached and reattached to its parent\n (if any). This is not necessary if the old sample data and new sample data have\n@@ -932,16 +869,14 @@\n Examples:\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_c\bch\bha\ban\bnn\bne\bel\bl_\b_m\bma\bat\btr\bri\bix\bx *\b**\b**\b**\b**\b*\n bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const\n float *matrix)\n-bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const\n-float *matrix)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the matrix used to mix the channels coming from this instance into the\n mixer it is attached to. Normally Allegro derives the values of this matrix\n from the gain and pan settings, as well as the channel configurations of this\n instance and the mixer it is attached to, but this allows you override that\n default value. Note that if you do set gain or pan of this instance or the\n mixer it is attached to, you\u2019ll need to call this function again.\n@@ -963,15 +898,14 @@\n Since: 5.2.3\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: New API.\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n *\b**\b**\b**\b**\b**\b* A\bAu\bud\bdi\bio\bo s\bst\btr\bre\bea\bam\bms\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_S\bST\bTR\bRE\bEA\bAM\bM *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;\n-typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n An ALLEGRO_AUDIO_STREAM object is used to stream generated audio to the sound\n device, in real-time. This is done by reading from a buffer, which is split\n into a number of fragments. Whenever a fragment has finished playing, the user\n can refill it with new data.\n As with _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE_\b__\bI_\bN_\bS_\bT_\bA_\bN_\bC_\bE objects, streams store information necessary\n for playback, so you may not play the same stream multiple times\n@@ -997,17 +931,14 @@\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_c\bcr\bre\bea\bat\bte\be_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count,\n unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count,\n- unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,\n- ALLEGRO_CHANNEL_CONF chan_conf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Creates an _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bS_\bT_\bR_\bE_\bA_\bM. The stream will be set to play by default. It\n will feed audio data from a buffer, which is split into a number of fragments.\n Parameters:\n * fragment_count - How many fragments to use for the audio stream. Usually\n only two fragments are required - splitting the audio buffer in two\n halves. But it means that the only time when new data can be supplied is\n@@ -1043,16 +974,14 @@\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_l\blo\boa\bad\bd_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename,\n size_t buffer_count, unsigned int samples)\n-ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename,\n- size_t buffer_count, unsigned int samples)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Loads an audio file from disk as it is needed.\n Unlike regular streams, the one returned by this function need not be fed by\n the user; the library will automatically read more of the file as it is needed.\n The stream will contain b\bbu\buf\bff\bfe\ber\br_\b_c\bco\bou\bun\bnt\bt buffers with s\bsa\bam\bmp\bpl\ble\bes\bs samples.\n The audio stream will start in the playing state. It should be attached to a\n voice or mixer to generate any output. See _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bS_\bT_\bR_\bE_\bA_\bM for more\n@@ -1067,17 +996,14 @@\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bp_\bp_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_l\blo\boa\bad\bd_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bf *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char\n *ident,\n size_t buffer_count, unsigned int samples)\n-ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char\n-*ident,\n- size_t buffer_count, unsigned int samples)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Loads an audio file from _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bF_\bI_\bL_\bE stream as it is needed.\n Unlike regular streams, the one returned by this function need not be fed by\n the user; the library will automatically read more of the file as it is needed.\n The stream will contain b\bbu\buf\bff\bfe\ber\br_\b_c\bco\bou\bun\bnt\bt buffers with s\bsa\bam\bmp\bpl\ble\bes\bs samples.\n The file type is determined by the passed \u2018ident\u2019 parameter, which is a file\n name extension including the leading dot.\n@@ -1090,209 +1016,182 @@\n N\bNo\bot\bte\be:\b: the allegro_audio library does not support any audio file\n formats by default. You must use the allegro_acodec addon, or\n register your own format handler.\n See also: _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bl_\bo_\ba_\bd_\be_\br_\b__\bf,\n _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bes\bst\btr\bro\boy\by_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Destroy an audio stream which was created with _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm or\n _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm.\n N\bNo\bot\bte\be:\b: If the stream is still attached to a mixer or voice,\n _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm is automatically called on it first.\n See also: _\ba_\bl_\b__\bd_\br_\ba_\bi_\bn_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm.\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_e\bev\bve\ben\bnt\bt_\b_s\bso\bou\bur\brc\bce\be *\b**\b**\b**\b**\b*\n ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source(\n ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source(\n- ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Retrieve the associated event source.\n See _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt for a description of the\n _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bE_\bV_\bE_\bN_\bT_\b__\bA_\bU_\bD_\bI_\bO_\b__\bS_\bT_\bR_\bE_\bA_\bM_\b__\bF_\bR_\bA_\bG_\bM_\bE_\bN_\bT event that audio streams emit.\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bdr\bra\bai\bin\bn_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n You should call this to finalise an audio stream that you will no longer be\n feeding, to wait for all pending buffers to finish playing. The stream\u2019s\n playing state will change to false.\n See also: _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\bew\bwi\bin\bnd\bd_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the streaming file playing position to the beginning. Returns true on\n success. Currently this can only be called on streams created with\n _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf or\n _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf.\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bfr\bre\beq\bqu\bue\ben\bnc\bcy\by *\b**\b**\b**\b**\b*\n unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the stream frequency (in Hz).\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_c\bch\bha\ban\bnn\bne\bel\bls\bs *\b**\b**\b**\b**\b*\n ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels(\n const ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels(\n- const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the stream channel configuration.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_d\bde\bep\bpt\bth\bh *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth(\n const ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth(\n- const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the stream audio depth.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_l\ble\ben\bng\bgt\bth\bh *\b**\b**\b**\b**\b*\n unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the stream length in samples.\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_s\bsp\bpe\bee\bed\bd *\b**\b**\b**\b**\b*\n float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)\n-float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the relative playback speed of the stream.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\bp_\be_\be_\bd.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_s\bsp\bpe\bee\bed\bd *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)\n-bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the relative playback speed of the stream. 1.0 means normal speed.\n Return true on success, false on failure. Will fail if the audio stream is\n attached directly to a voice.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\bp_\be_\be_\bd.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_g\bga\bai\bin\bn *\b**\b**\b**\b**\b*\n float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)\n-float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the playback gain of the stream.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bg_\ba_\bi_\bn.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_g\bga\bai\bin\bn *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)\n-bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the playback gain of the stream.\n Returns true on success, false on failure. Will fail if the audio stream is\n attached directly to a voice.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bg_\ba_\bi_\bn.\n Examples:\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpa\ban\bn *\b**\b**\b**\b**\b*\n float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)\n-float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the pan value of the stream.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\ba_\bn.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpa\ban\bn *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)\n-bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the pan value on an audio stream. A value of -1.0 means to play the stream\n only through the left speaker; +1.0 means only through the right speaker; 0.0\n means the sample is centre balanced. A special value _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bP_\bA_\bN_\b__\bN_\bO_\bN_\bE\n disables panning and plays the stream at its original level. This will be\n louder than a pan value of 0.0.\n Returns true on success, false on failure. Will fail if the audio stream is\n attached directly to a voice.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\ba_\bn, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bP_\bA_\bN_\b__\bN_\bO_\bN_\bE\n Examples:\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)\n-bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return true if the stream is playing.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)\n-bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Change whether the stream is playing.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bi_\bm_\bp_\bl_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpl\bla\bay\bym\bmo\bod\bde\be *\b**\b**\b**\b**\b*\n ALLEGRO_PLAYMODE al_get_audio_stream_playmode(\n const ALLEGRO_AUDIO_STREAM *stream)\n-ALLEGRO_PLAYMODE al_get_audio_stream_playmode(\n- const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the playback mode of the stream.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bP_\bL_\bA_\bY_\bM_\bO_\bD_\bE, _\ba_\bl_\b__\bs_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\bl_\ba_\by_\bm_\bo_\bd_\be.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpl\bla\bay\bym\bmo\bod\bde\be *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream,\n ALLEGRO_PLAYMODE val)\n-bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream,\n- ALLEGRO_PLAYMODE val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the playback mode of the stream.\n Returns true on success, false on failure.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bP_\bL_\bA_\bY_\bM_\bO_\bD_\bE, _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\bl_\ba_\by_\bm_\bo_\bd_\be.\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bp_\bp_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_a\bat\btt\bta\bac\bch\bhe\bed\bd *\b**\b**\b**\b**\b*\n bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)\n-bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return whether the stream is attached to something.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be,\n _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bet\bta\bac\bch\bh_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm *\b**\b**\b**\b**\b*\n bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n-bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Detach the stream from whatever it\u2019s attached to, if anything.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be,\n _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\ba_\bt_\bt_\ba_\bc_\bh_\be_\bd.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpl\bla\bay\bye\bed\bd_\b_s\bsa\bam\bmp\bpl\ble\bes\bs *\b**\b**\b**\b**\b*\n uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)\n-uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the number of samples consumed by the parent since the audio stream was\n started.\n Since: 5.1.8\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bfr\bra\bag\bgm\bme\ben\bnt\bt *\b**\b**\b**\b**\b*\n void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)\n-void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n When using Allegro\u2019s audio streaming, you will use this function to\n continuously provide new sample data to a stream.\n If the stream is ready for new data, the function will return the address of an\n internal buffer to be filled with audio data. The length and format of the\n buffer are specified with _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm or can be queried with the\n various functions described here. Once the buffer is filled, you must signal\n@@ -1308,75 +1207,66 @@\n _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bd_\be_\bp_\bt_\bh, _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bl_\be_\bn_\bg_\bt_\bh\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bfr\bra\bag\bgm\bme\ben\bnt\bt *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)\n-bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n This function needs to be called for every successful call of\n _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt to indicate that the buffer (pointed to by val) is\n filled with new data.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bfr\bra\bag\bgm\bme\ben\bnt\bts\bs *\b**\b**\b**\b**\b*\n unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns the number of fragments this stream uses. This is the same value as\n passed to _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm when a new stream is created.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bv_\ba_\bi_\bl_\ba_\bb_\bl_\be_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt_\bs\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bav\bva\bai\bil\bla\bab\bbl\ble\be_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_f\bfr\bra\bag\bgm\bme\ben\bnt\bts\bs *\b**\b**\b**\b**\b*\n unsigned int al_get_available_audio_stream_fragments(\n const ALLEGRO_AUDIO_STREAM *stream)\n-unsigned int al_get_available_audio_stream_fragments(\n- const ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns the number of available fragments in the stream, that is, fragments\n which are not currently filled with data for playback.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt, _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt_\bs\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bee\bek\bk_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_s\bse\bec\bcs\bs *\b**\b**\b**\b**\b*\n bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)\n-bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the streaming file playing position to time. Returns true on success.\n Currently this can only be called on streams created with _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm,\n _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf or _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\bo_\bs_\bi_\bt_\bi_\bo_\bn_\b__\bs_\be_\bc_\bs, _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bl_\be_\bn_\bg_\bt_\bh_\b__\bs_\be_\bc_\bs\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_p\bpo\bos\bsi\bit\bti\bio\bon\bn_\b_s\bse\bec\bcs\bs *\b**\b**\b**\b**\b*\n double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)\n-double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the position of the stream in seconds. Currently this can only be called\n on streams created with _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm,\n _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf or _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bl_\be_\bn_\bg_\bt_\bh_\b__\bs_\be_\bc_\bs\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_l\ble\ben\bng\bgt\bth\bh_\b_s\bse\bec\bcs\bs *\b**\b**\b**\b**\b*\n double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)\n-double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the length of the stream in seconds, if known. Otherwise returns zero.\n Currently this can only be called on streams created with _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm,\n _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf or _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bp_\bo_\bs_\bi_\bt_\bi_\bo_\bn_\b__\bs_\be_\bc_\bs\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_l\blo\boo\bop\bp_\b_s\bse\bec\bcs\bs *\b**\b**\b**\b**\b*\n bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream,\n double start, double end)\n-bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream,\n- double start, double end)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Sets the loop points for the stream in seconds. Currently this can only be\n called on streams created with _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm, _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm,\n _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf or _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf.\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bs_\be_\be_\bk_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_c\bch\bha\ban\bnn\bne\bel\bl_\b_m\bma\bat\btr\bri\bix\bx *\b**\b**\b**\b**\b*\n@@ -1384,105 +1274,89 @@\n Like _\ba_\bl_\b__\bs_\be_\bt_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bc_\bh_\ba_\bn_\bn_\be_\bl_\b__\bm_\ba_\bt_\br_\bi_\bx but for streams.\n Since: 5.2.3\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: New API.\n *\b**\b**\b**\b**\b**\b* A\bAd\bdv\bva\ban\bnc\bce\bed\bd a\bau\bud\bdi\bio\bo f\bfi\bil\ble\be I\bI/\b/O\bO *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_s\bsa\bam\bmp\bpl\ble\be_\b_l\blo\boa\bad\bde\ber\br *\b**\b**\b**\b**\b*\n bool al_register_sample_loader(const char *ext,\n ALLEGRO_SAMPLE *(*loader)(const char *filename))\n-bool al_register_sample_loader(const char *ext,\n- ALLEGRO_SAMPLE *(*loader)(const char *filename))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register a handler for _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\bs_\ba_\bm_\bp_\bl_\be. The given function will be used to\n handle the loading of sample files with the given extension.\n The extension should include the leading dot (\u2018.\u2019) character. It will be\n matched case-insensitively.\n The loader argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\bo_\ba_\bd_\be_\br_\b__\bf, _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bs_\ba_\bv_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_s\bsa\bam\bmp\bpl\ble\be_\b_l\blo\boa\bad\bde\ber\br_\b_f\bf *\b**\b**\b**\b**\b*\n bool al_register_sample_loader_f(const char *ext,\n ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp))\n-bool al_register_sample_loader_f(const char *ext,\n- ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register a handler for _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf. The given function will be used to\n handle the loading of sample files with the given extension.\n The extension should include the leading dot (\u2018.\u2019) character. It will be\n matched case-insensitively.\n The loader argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\bo_\ba_\bd_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_s\bsa\bam\bmp\bpl\ble\be_\b_s\bsa\bav\bve\ber\br *\b**\b**\b**\b**\b*\n bool al_register_sample_saver(const char *ext,\n bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl))\n-bool al_register_sample_saver(const char *ext,\n- bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register a handler for _\ba_\bl_\b__\bs_\ba_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be. The given function will be used to\n handle the saving of sample files with the given extension.\n The extension should include the leading dot (\u2018.\u2019) character. It will be\n matched case-insensitively.\n The saver argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bs_\ba_\bv_\be_\br_\b__\bf, _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bl_\bo_\ba_\bd_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_s\bsa\bam\bmp\bpl\ble\be_\b_s\bsa\bav\bve\ber\br_\b_f\bf *\b**\b**\b**\b**\b*\n bool al_register_sample_saver_f(const char *ext,\n bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl))\n-bool al_register_sample_saver_f(const char *ext,\n- bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register a handler for _\ba_\bl_\b__\bs_\ba_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf. The given function will be used to\n handle the saving of sample files with the given extension.\n The extension should include the leading dot (\u2018.\u2019) character. It will be\n matched case-insensitively.\n The saver argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bs_\ba_\bv_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_l\blo\boa\bad\bde\ber\br *\b**\b**\b**\b**\b*\n bool al_register_audio_stream_loader(const char *ext,\n ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename,\n size_t buffer_count, unsigned int samples))\n-bool al_register_audio_stream_loader(const char *ext,\n- ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename,\n- size_t buffer_count, unsigned int samples))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register a handler for _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm and _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm. The given\n function will be used to open streams from files with the given extension.\n The extension should include the leading dot (\u2018.\u2019) character. It will be\n matched case-insensitively.\n The stream_loader argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bl_\bo_\ba_\bd_\be_\br_\b__\bf\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_l\blo\boa\bad\bde\ber\br_\b_f\bf *\b**\b**\b**\b**\b*\n bool al_register_audio_stream_loader_f(const char *ext,\n ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp,\n size_t buffer_count, unsigned int samples))\n-bool al_register_audio_stream_loader_f(const char *ext,\n- ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp,\n- size_t buffer_count, unsigned int samples))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register a handler for _\ba_\bl_\b__\bl_\bo_\ba_\bd_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf and _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf. The\n given function will be used to open streams from files with the given\n extension.\n The extension should include the leading dot (\u2018.\u2019) character. It will be\n matched case-insensitively.\n The stream_loader argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n See also: _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bl_\bo_\ba_\bd_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\beg\bgi\bis\bst\bte\ber\br_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bid\bde\ben\bnt\bti\bif\bfi\bie\ber\br *\b**\b**\b**\b**\b*\n bool al_register_sample_identifier(const char *ext,\n bool (*identifier)(ALLEGRO_FILE* fp))\n-bool al_register_sample_identifier(const char *ext,\n- bool (*identifier)(ALLEGRO_FILE* fp))\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Register an identify handler for _\ba_\bl_\b__\bi_\bd_\be_\bn_\bt_\bi_\bf_\by_\b__\bs_\ba_\bm_\bp_\bl_\be. The given function will be\n used to detect files for the given extension. It will be called with a single\n argument of type _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bF_\bI_\bL_\bE which is a file handle opened for reading and\n located at the first byte of the file. The handler should try to read as few\n bytes as possible to safely determine if the given file contents correspond to\n the type with the extension and return true in that case, false otherwise. The\n@@ -1493,25 +1367,23 @@\n The identifier argument may be NULL to unregister an entry.\n Returns true on success, false on error. Returns false if unregistering an\n entry that doesn\u2019t exist.\n Since: 5.2.8\n See also: _\ba_\bl_\b__\bi_\bd_\be_\bn_\bt_\bi_\bf_\by_\b__\bb_\bi_\bt_\bm_\ba_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_i\bid\bde\ben\bnt\bti\bif\bfy\by_\b_s\bsa\bam\bmp\bpl\ble\be *\b**\b**\b**\b**\b*\n char const *al_identify_sample(char const *filename)\n-char const *al_identify_sample(char const *filename)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n This works exactly as _\ba_\bl_\b__\bi_\bd_\be_\bn_\bt_\bi_\bf_\by_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf but you specify the filename of the\n file for which to detect the type and not a file handle. The extension, if any,\n of the passed filename is not taken into account - only the file contents.\n Since: 5.2.8\n See also: _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn, _\ba_\bl_\b__\bi_\bd_\be_\bn_\bt_\bi_\bf_\by_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bf,\n _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd_\be_\bn_\bt_\bi_\bf_\bi_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_i\bid\bde\ben\bnt\bti\bif\bfy\by_\b_s\bsa\bam\bmp\bpl\ble\be_\b_f\bf *\b**\b**\b**\b**\b*\n char const *al_identify_sample_f(ALLEGRO_FILE *fp)\n-char const *al_identify_sample_f(ALLEGRO_FILE *fp)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Tries to guess the audio file type of the open ALLEGRO_FILE by reading the\n first few bytes. By default Allegro cannot recognize any file types, but\n calling _\ba_\bl_\b__\bi_\bn_\bi_\bt_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\ba_\bd_\bd_\bo_\bn will add detection of the types it can read. You\n can also use _\ba_\bl_\b__\br_\be_\bg_\bi_\bs_\bt_\be_\br_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd_\be_\bn_\bt_\bi_\bf_\bi_\be_\br to add identification for custom\n file types.\n Returns a pointer to a static string with a file extension for the type,\n@@ -1526,25 +1398,23 @@\n specific implementation details with its own buffering, it will add a small\n amount of latency. However, for most applications that small overhead will not\n adversely affect performance.\n Recording is supported by the ALSA, AudioQueue, DirectSound8, and PulseAudio\n drivers. Enumerating or choosing other recording devices is not yet supported.\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_R\bRE\bEC\bCO\bOR\bRD\bDE\bER\bR *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER;\n-typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n An opaque datatype that represents a recording device.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_R\bRE\bEC\bCO\bOR\bRD\bDE\bER\bR_\b_E\bEV\bVE\bEN\bNT\bT *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT;\n-typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Structure that holds the audio recorder event data. Every event type will\n contain:\n * .source: pointer to the audio recorder\n The following will be available depending on the event type:\n * .buffer: pointer to buffer containing the audio samples\n * .samples: number of samples (not bytes) that are available\n@@ -1554,17 +1424,14 @@\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_c\bcr\bre\bea\bat\bte\be_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count,\n unsigned int samples, unsigned int frequency,\n ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count,\n- unsigned int samples, unsigned int frequency,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Creates an audio recorder using the system\u2019s default recording device. (So if\n the returned device does not work, try updating the system\u2019s default recording\n device.)\n Allegro will internally buffer several seconds of captured audio with minimal\n latency. (XXX: These settings need to be exposed via config or API calls.)\n Audio will be copied out of that private buffer into a fragment buffer of the\n@@ -1588,133 +1455,119 @@\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bst\bta\bar\brt\bt_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br *\b**\b**\b**\b**\b*\n bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n-bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Begin recording into the fragment buffer. Once a complete fragment has been\n captured (as specified in _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\ba_\bu_\bd_\bi_\bo_\b__\br_\be_\bc_\bo_\br_\bd_\be_\br), an\n _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bE_\bV_\bE_\bN_\bT_\b__\bA_\bU_\bD_\bI_\bO_\b__\bR_\bE_\bC_\bO_\bR_\bD_\bE_\bR_\b__\bF_\bR_\bA_\bG_\bM_\bE_\bN_\bT event will be triggered.\n Returns true if it was able to begin recording.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bst\bto\bop\bp_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br *\b**\b**\b**\b**\b*\n void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n-void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Stop capturing audio data. Note that the audio recorder is still active and\n consuming resources, so if you are finished recording you should destroy it\n with _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\ba_\bu_\bd_\bi_\bo_\b__\br_\be_\bc_\bo_\br_\bd_\be_\br.\n You may still receive a few events after you call this function as the device\n flushes the buffer.\n If you restart the recorder, it will begin recording at the beginning of the\n next fragment buffer.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_i\bis\bs_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br_\b_r\bre\bec\bco\bor\brd\bdi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r)\n-bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns true if the audio recorder is currently capturing data and generating\n events.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br_\b_e\bev\bve\ben\bnt\bt *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event)\n-ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns the event as an _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bR_\bE_\bC_\bO_\bR_\bD_\bE_\bR_\b__\bE_\bV_\bE_\bN_\bT.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br_\b_e\bev\bve\ben\bnt\bt_\b_s\bso\bou\bur\brc\bce\be *\b**\b**\b**\b**\b*\n ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER\n *r)\n-ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER\n-*r)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns the event source for the recorder that generates the various recording\n events.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bes\bst\btr\bro\boy\by_\b_a\bau\bud\bdi\bio\bo_\b_r\bre\bec\bco\bor\brd\bde\ber\br *\b**\b**\b**\b**\b*\n void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n-void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Destroys the audio recorder and frees all resources associated with it. It is\n safe to destroy a recorder that is recording.\n You may receive events after the recorder has been destroyed. They must be\n ignored, as the fragment buffer will no longer be valid.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n Examples:\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b__\bn_\ba_\bm_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bc_\bo_\br_\bd_\b._\bc\n *\b**\b**\b**\b**\b**\b* A\bAu\bud\bdi\bio\bo d\bde\bev\bvi\bic\bce\bes\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_D\bDE\bEV\bVI\bIC\bCE\bE *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE;\n-typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n An opaque datatype that represents an audio device.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bd_\be_\bv_\bi_\bc_\be_\bs_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_n\bnu\bum\bm_\b_a\bau\bud\bdi\bio\bo_\b_o\bou\but\btp\bpu\but\bt_\b_d\bde\bev\bvi\bic\bce\bes\bs *\b**\b**\b**\b**\b*\n int al_get_num_audio_output_devices()\n-int al_get_num_audio_output_devices()\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the number of available audio output devices on the system.\n Since: 5.2.8\n return -1 for unsupported drivers.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bd_\be_\bv_\bi_\bc_\be_\bs_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_o\bou\but\btp\bpu\but\bt_\b_d\bde\bev\bvi\bic\bce\be *\b**\b**\b**\b**\b*\n const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index)\n-const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the output audio device of the specified index.\n Since: 5.2.8\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bd_\be_\bv_\bi_\bc_\be_\bs_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_d\bde\bev\bvi\bic\bce\be_\b_n\bna\bam\bme\be *\b**\b**\b**\b**\b*\n const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device)\n-const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Get the user friendly display name of the device.\n Since: 5.2.8\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bd_\be_\bv_\bi_\bc_\be_\bs_\b._\bc\n *\b**\b**\b**\b**\b**\b* V\bVo\boi\bic\bce\bes\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_V\bVO\bOI\bIC\bCE\bE *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_VOICE ALLEGRO_VOICE;\n-typedef struct ALLEGRO_VOICE ALLEGRO_VOICE;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n A voice represents an audio device on the system, which may be a real device,\n or an abstract device provided by the operating system. To play back audio, you\n would attach a mixer, sample instance or audio stream to a voice.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bM_\bI_\bX_\bE_\bR, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bS_\bA_\bM_\bP_\bL_\bE, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bS_\bT_\bR_\bE_\bA_\bM\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_c\bcr\bre\bea\bat\bte\be_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n ALLEGRO_VOICE *al_create_voice(unsigned int freq,\n ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_VOICE *al_create_voice(unsigned int freq,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Creates a voice structure and allocates a voice from the digital sound driver.\n The passed frequency (in Hz), sample format and channel configuration are used\n as a hint to what kind of data will be sent to the voice. However, the\n underlying sound driver is free to use non-matching values. For example, it may\n be the native format of the sound hardware.\n If a mixer is attached to the voice, the mixer will handle the conversion of\n@@ -1727,35 +1580,31 @@\n See also: _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\bv_\bo_\bi_\bc_\be\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bes\bst\btr\bro\boy\by_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n void al_destroy_voice(ALLEGRO_VOICE *voice)\n-void al_destroy_voice(ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Destroys the voice and deallocates it from the digital driver. Does nothing if\n the voice is NULL.\n See also: _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\bv_\bo_\bi_\bc_\be\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bet\bta\bac\bch\bh_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n void al_detach_voice(ALLEGRO_VOICE *voice)\n-void al_detach_voice(ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Detaches the mixer, sample instance or audio stream from the voice.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be,\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be\n *\b**\b**\b**\b**\b* a\bal\bl_\b_a\bat\btt\bta\bac\bch\bh_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_t\bto\bo_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream,\n ALLEGRO_VOICE *voice)\n-bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream,\n- ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Attaches an audio stream to a voice. The same rules as\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be apply. This may fail if the driver can\u2019t\n create a voice with the buffer count and buffer size the stream uses.\n An audio stream attached directly to a voice has a number of limitations: The\n audio stream plays immediately and cannot be stopped. The stream position,\n speed, gain and panning cannot be changed. At this time, we don\u2019t recommend\n@@ -1763,29 +1612,26 @@\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\bv_\bo_\bi_\bc_\be_\b__\bh_\ba_\bs_\b__\ba_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt_\bs\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_a\bat\btt\bta\bac\bch\bh_\b_m\bmi\bix\bxe\ber\br_\b_t\bto\bo_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice)\n-bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Attaches a mixer to a voice. It must have the same frequency and channel\n configuration, but the depth may be different.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\bv_\bo_\bi_\bc_\be_\b__\bh_\ba_\bs_\b__\ba_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt_\bs\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_a\bat\btt\bta\bac\bch\bh_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_t\bto\bo_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,\n ALLEGRO_VOICE *voice)\n-bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Attaches a sample instance to a voice, and allows it to play. The instance\u2019s\n gain and loop mode will be ignored, and it must have the same frequency,\n channel configuration and depth (including signed-ness) as the voice. This\n function may fail if the selected driver doesn\u2019t support preloading sample\n data.\n At this time, we don\u2019t recommend attaching sample instances directly to voices.\n@@ -1793,75 +1639,66 @@\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\bv_\bo_\bi_\bc_\be_\b__\bh_\ba_\bs_\b__\ba_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt_\bs\n Examples:\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_f\bfr\bre\beq\bqu\bue\ben\bnc\bcy\by *\b**\b**\b**\b**\b*\n unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice)\n-unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the frequency of the voice (in Hz), e.g.\u00a044100.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_c\bch\bha\ban\bnn\bne\bel\bls\bs *\b**\b**\b**\b**\b*\n ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice)\n-ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the channel configuration of the voice.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_d\bde\bep\bpt\bth\bh *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice)\n-ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the audio depth of the voice.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_get_voice_playing(const ALLEGRO_VOICE *voice)\n-bool al_get_voice_playing(const ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return true if the voice is currently playing.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bv_\bo_\bi_\bc_\be_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val)\n-bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Change whether a voice is playing or not. This can only work if the voice has a\n non-streaming object attached to it, e.g.\u00a0a sample instance. On success the\n voice\u2019s current sample position is reset.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bv_\bo_\bi_\bc_\be_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_p\bpo\bos\bsi\bit\bti\bio\bon\bn *\b**\b**\b**\b**\b*\n unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice)\n-unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n When the voice has a non-streaming object attached to it, e.g.\u00a0a sample,\n returns the voice\u2019s current sample position. Otherwise, returns zero.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bv_\bo_\bi_\bc_\be_\b__\bp_\bo_\bs_\bi_\bt_\bi_\bo_\bn.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_v\bvo\boi\bic\bce\be_\b_p\bpo\bos\bsi\bit\bti\bio\bon\bn *\b**\b**\b**\b**\b*\n bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val)\n-bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the voice position. This can only work if the voice has a non-streaming\n object attached to it, e.g.\u00a0a sample instance.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bv_\bo_\bi_\bc_\be_\b__\bp_\bo_\bs_\bi_\bt_\bi_\bo_\bn.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_v\bvo\boi\bic\bce\be_\b_h\bha\bas\bs_\b_a\bat\btt\bta\bac\bch\bhm\bme\ben\bnt\bts\bs *\b**\b**\b**\b**\b*\n bool al_voice_has_attachments(const ALLEGRO_VOICE* voice)\n-bool al_voice_has_attachments(const ALLEGRO_VOICE* voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns true if the voice has something attached to it.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be,\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be\n Since: 5.2.9\n *\b**\b**\b**\b**\b**\b* M\bMi\bix\bxe\ber\brs\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_M\bMI\bIX\bXE\bER\bR *\b**\b**\b**\b**\b*\n typedef struct ALLEGRO_MIXER ALLEGRO_MIXER;\n-typedef struct ALLEGRO_MIXER ALLEGRO_MIXER;\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n A mixer mixes together attached streams into a single buffer. In the process,\n it converts channel configurations, sample frequencies and audio depths of the\n attached sample instances and audio streams accordingly. You can control the\n quality of this conversion using ALLEGRO_MIXER_QUALITY.\n When going from mono to stereo (and above), the mixer reduces the volume of\n both channels by sqrt(2). When going from stereo (and above) to mono, the mixer\n@@ -1869,24 +1706,21 @@\n to the center channel (if present).\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_M\bMI\bIX\bXE\bER\bR_\b_Q\bQU\bUA\bAL\bLI\bIT\bTY\bY *\b**\b**\b**\b**\b*\n enum ALLEGRO_MIXER_QUALITY\n-enum ALLEGRO_MIXER_QUALITY\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n * ALLEGRO_MIXER_QUALITY_POINT - point sampling\n * ALLEGRO_MIXER_QUALITY_LINEAR - linear interpolation\n * ALLEGRO_MIXER_QUALITY_CUBIC - cubic interpolation (since: 5.0.8, 5.1.4)\n *\b**\b**\b**\b**\b* a\bal\bl_\b_c\bcr\bre\bea\bat\bte\be_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n ALLEGRO_MIXER *al_create_mixer(unsigned int freq,\n ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-ALLEGRO_MIXER *al_create_mixer(unsigned int freq,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Creates a mixer to attach sample instances, audio streams, or other mixers to.\n It will mix into a buffer at the requested frequency (in Hz) and channel count.\n The only supported audio depths are ALLEGRO_AUDIO_DEPTH_FLOAT32 and\n ALLEGRO_AUDIO_DEPTH_INT16 (not yet complete).\n To actually produce any output, the mixer will have to be attached to a voice\n using _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br_\b__\bt_\bo_\b__\bv_\bo_\bi_\bc_\be.\n@@ -1896,241 +1730,212 @@\n See also: _\ba_\bl_\b__\bd_\be_\bs_\bt_\br_\bo_\by_\b__\bm_\bi_\bx_\be_\br, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH, _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bes\bst\btr\bro\boy\by_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n void al_destroy_mixer(ALLEGRO_MIXER *mixer)\n-void al_destroy_mixer(ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Destroys the mixer.\n See also: _\ba_\bl_\b__\bc_\br_\be_\ba_\bt_\be_\b__\bm_\bi_\bx_\be_\br\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n ALLEGRO_MIXER *al_get_default_mixer(void)\n-ALLEGRO_MIXER *al_get_default_mixer(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the default mixer, or NULL if one has not been set. Although different\n configurations of mixers and voices can be used, in most cases a single mixer\n attached to a voice is what you want. The default mixer is used by\n _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be.\n See also: _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs, _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\bs_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br,\n _\ba_\bl_\b__\br_\be_\bs_\bt_\bo_\br_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n bool al_set_default_mixer(ALLEGRO_MIXER *mixer)\n-bool al_set_default_mixer(ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Sets the default mixer. All samples started with _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be will be stopped\n and all sample instances returned by _\ba_\bl_\b__\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd will be invalidated. If\n you are using your own mixer, this should be called before _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs.\n Returns true on success, false on error.\n See also: _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs, _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be, _\ba_\bl_\b__\bg_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br,\n _\ba_\bl_\b__\br_\be_\bs_\bt_\bo_\br_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_r\bre\bes\bst\bto\bor\bre\be_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n bool al_restore_default_mixer(void)\n-bool al_restore_default_mixer(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Restores Allegro\u2019s default mixer and attaches it to the default voice. If the\n default mixer hasn\u2019t been created before, it will be created. If the default\n voice hasn\u2019t been set via _\ba_\bl_\b__\bs_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bv_\bo_\bi_\bc_\be or created before, it will also\n be created. All samples started with _\ba_\bl_\b__\bp_\bl_\ba_\by_\b__\bs_\ba_\bm_\bp_\bl_\be will be stopped and all\n sample instances returned by _\ba_\bl_\b__\bl_\bo_\bc_\bk_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bd will be invalidated.\n Returns true on success, false on error.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\bs_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\br_\be_\bs_\be_\br_\bv_\be_\b__\bs_\ba_\bm_\bp_\bl_\be_\bs.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n ALLEGRO_VOICE *al_get_default_voice(void)\n-ALLEGRO_VOICE *al_get_default_voice(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns the default voice or NULL if there is none.\n Since: 5.1.13\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_d\bde\bef\bfa\bau\bul\blt\bt_\b_v\bvo\boi\bic\bce\be *\b**\b**\b**\b**\b*\n void al_set_default_voice(ALLEGRO_VOICE *voice)\n-void al_set_default_voice(ALLEGRO_VOICE *voice)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n You can call this before calling al_restore_default_mixer to provide the voice\n which should be used. Any previous voice will be destroyed. You can also pass\n NULL to destroy the current default voice.\n Since: 5.1.13\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bm_\bi_\bx_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_a\bat\btt\bta\bac\bch\bh_\b_m\bmi\bix\bxe\ber\br_\b_t\bto\bo_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer)\n-bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Attaches the mixer passed as the first argument onto the mixer passed as the\n second argument. The first mixer (that is going to be attached) must not\n already be attached to anything. Both mixers must use the same frequency, audio\n depth and channel configuration.\n Returns true on success, false on error.\n It is invalid to attach a mixer to itself.\n See also: _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br.\n Examples:\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_a\bat\btt\bta\bac\bch\bh_\b_s\bsa\bam\bmp\bpl\ble\be_\b_i\bin\bns\bst\bta\ban\bnc\bce\be_\b_t\bto\bo_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl,\n ALLEGRO_MIXER *mixer)\n-bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl,\n- ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Attach a sample instance to a mixer. The instance must not already be attached\n to anything.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be.\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_a\bat\btt\bta\bac\bch\bh_\b_a\bau\bud\bdi\bio\bo_\b_s\bst\btr\bre\bea\bam\bm_\b_t\bto\bo_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream,\n ALLEGRO_MIXER *mixer)\n-bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream,\n-ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Attach an audio stream to a mixer. The stream must not already be attached to\n anything.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm.\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_f\bfr\bre\beq\bqu\bue\ben\bnc\bcy\by *\b**\b**\b**\b**\b*\n unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer)\n-unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the mixer frequency (in Hz).\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_f\bfr\bre\beq\bqu\bue\ben\bnc\bcy\by *\b**\b**\b**\b**\b*\n bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val)\n-bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the mixer frequency (in Hz). This will only work if the mixer is not\n attached to anything.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_c\bch\bha\ban\bnn\bne\bel\bls\bs *\b**\b**\b**\b**\b*\n ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer)\n-ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the mixer channel configuration.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF.\n Examples:\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_d\bde\bep\bpt\bth\bh *\b**\b**\b**\b**\b*\n ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer)\n-ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the mixer audio depth.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH.\n Examples:\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_g\bga\bai\bin\bn *\b**\b**\b**\b**\b*\n float al_get_mixer_gain(const ALLEGRO_MIXER *mixer)\n-float al_get_mixer_gain(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the mixer gain (amplification factor). The default is 1.0.\n Since: 5.0.6, 5.1.0\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bg_\ba_\bi_\bn.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_g\bga\bai\bin\bn *\b**\b**\b**\b**\b*\n bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain)\n-bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the mixer gain (amplification factor).\n Returns true on success, false on failure.\n Since: 5.0.6, 5.1.0\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bg_\ba_\bi_\bn\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_q\bqu\bua\bal\bli\bit\bty\by *\b**\b**\b**\b**\b*\n ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer)\n-ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the mixer quality.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bM_\bI_\bX_\bE_\bR_\b__\bQ_\bU_\bA_\bL_\bI_\bT_\bY, _\ba_\bl_\b__\bs_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bq_\bu_\ba_\bl_\bi_\bt_\by\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_q\bqu\bua\bal\bli\bit\bty\by *\b**\b**\b**\b**\b*\n bool al_set_mixer_quality(ALLEGRO_MIXER *mixer, ALLEGRO_MIXER_QUALITY\n new_quality)\n-bool al_set_mixer_quality(ALLEGRO_MIXER *mixer, ALLEGRO_MIXER_QUALITY\n-new_quality)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Set the mixer quality. This can only succeed if the mixer does not have\n anything attached to it.\n Returns true on success, false on failure.\n See also: _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bM_\bI_\bX_\bE_\bR_\b__\bQ_\bU_\bA_\bL_\bI_\bT_\bY, _\ba_\bl_\b__\bg_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bq_\bu_\ba_\bl_\bi_\bt_\by\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer)\n-bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return true if the mixer is playing.\n See also: _\ba_\bl_\b__\bs_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_p\bpl\bla\bay\byi\bin\bng\bg *\b**\b**\b**\b**\b*\n bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val)\n-bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Change whether the mixer is playing.\n Returns true on success, false on failure.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\bp_\bl_\ba_\by_\bi_\bn_\bg.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_a\bat\btt\bta\bac\bch\bhe\bed\bd *\b**\b**\b**\b**\b*\n bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer)\n-bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return true if the mixer is attached to something.\n See also: _\ba_\bl_\b__\bm_\bi_\bx_\be_\br_\b__\bh_\ba_\bs_\b__\ba_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt_\bs, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br,\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br\n *\b**\b**\b**\b**\b* a\bal\bl_\b_m\bmi\bix\bxe\ber\br_\b_h\bha\bas\bs_\b_a\bat\btt\bta\bac\bch\bhm\bme\ben\bnt\bts\bs *\b**\b**\b**\b**\b*\n bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer)\n-bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns true if the mixer has something attached to it.\n See also: _\ba_\bl_\b__\bg_\be_\bt_\b__\bm_\bi_\bx_\be_\br_\b__\ba_\bt_\bt_\ba_\bc_\bh_\be_\bd, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\ba_\bm_\bp_\bl_\be_\b__\bi_\bn_\bs_\bt_\ba_\bn_\bc_\be_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br,\n _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br, _\ba_\bl_\b__\bd_\be_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br\n Since: 5.2.9\n *\b**\b**\b**\b**\b* a\bal\bl_\b_d\bde\bet\bta\bac\bch\bh_\b_m\bmi\bix\bxe\ber\br *\b**\b**\b**\b**\b*\n bool al_detach_mixer(ALLEGRO_MIXER *mixer)\n-bool al_detach_mixer(ALLEGRO_MIXER *mixer)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Detach the mixer from whatever it is attached to, if anything.\n See also: _\ba_\bl_\b__\ba_\bt_\bt_\ba_\bc_\bh_\b__\bm_\bi_\bx_\be_\br_\b__\bt_\bo_\b__\bm_\bi_\bx_\be_\br.\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_s\bse\bet\bt_\b_m\bmi\bix\bxe\ber\br_\b_p\bpo\bos\bst\btp\bpr\bro\boc\bce\bes\bss\bs_\b_c\bca\bal\bll\blb\bba\bac\bck\bk *\b**\b**\b**\b**\b*\n bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer,\n void (*pp_callback)(void *buf, unsigned int samples, void *data),\n void *pp_callback_userdata)\n-bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer,\n- void (*pp_callback)(void *buf, unsigned int samples, void *data),\n- void *pp_callback_userdata)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Sets a post-processing filter function that\u2019s called after the attached streams\n have been mixed. The buffer\u2019s format will be whatever the mixer was created\n with. The sample count and user-data pointer is also passed.\n N\bNo\bot\bte\be:\b: The callback is called from a dedicated audio thread.\n Examples:\n * _\be_\bx_\b__\br_\be_\bs_\ba_\bm_\bp_\bl_\be_\b__\bt_\be_\bs_\bt_\b._\bc\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bp_\bp_\b._\bc\n *\b**\b**\b**\b**\b**\b* M\bMi\bis\bsc\bce\bel\bla\ban\bne\beo\bou\bus\bs *\b**\b**\b**\b**\b**\b*\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_D\bDE\bEP\bPT\bTH\bH *\b**\b**\b**\b**\b*\n enum ALLEGRO_AUDIO_DEPTH\n-enum ALLEGRO_AUDIO_DEPTH\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Sample depth and type as well as signedness. Mixers only use 32-bit signed\n float (-1..+1), or 16-bit signed integers. Signedness is determined by an\n \u201cunsigned\u201d bit-flag applied to the depth value.\n * ALLEGRO_AUDIO_DEPTH_INT8\n * ALLEGRO_AUDIO_DEPTH_INT16\n * ALLEGRO_AUDIO_DEPTH_INT24\n@@ -2142,30 +1947,28 @@\n * ALLEGRO_AUDIO_DEPTH_UINT24\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_P\bPA\bAN\bN_\b_N\bNO\bON\bNE\bE *\b**\b**\b**\b**\b*\n #define ALLEGRO_AUDIO_PAN_NONE (-1000.0f)\n-#define ALLEGRO_AUDIO_PAN_NONE (-1000.0f)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n A special value for the pan property of sample instances and audio streams. Use\n this value to disable panning on sample instances and audio streams, and play\n them without attentuation implied by panning support.\n ALLEGRO_AUDIO_PAN_NONE is different from a pan value of 0.0 (centered) because,\n when panning is enabled, we try to maintain a constant sound power level as a\n sample is panned from left to right. A sound coming out of one speaker should\n sound as loud as it does when split over two speakers. As a consequence, a\n sample with pan value 0.0 will be 3 dB softer than the original level.\n (Please correct us if this is wrong.)\n Examples:\n * _\be_\bx_\b__\ba_\bu_\bd_\bi_\bo_\b__\bp_\br_\bo_\bp_\bs_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_C\bCH\bHA\bAN\bNN\bNE\bEL\bL_\b_C\bCO\bON\bNF\bF *\b**\b**\b**\b**\b*\n enum ALLEGRO_CHANNEL_CONF\n-enum ALLEGRO_CHANNEL_CONF\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Speaker configuration (mono, stereo, 2.1, etc).\n * ALLEGRO_CHANNEL_CONF_1\n * ALLEGRO_CHANNEL_CONF_2\n * ALLEGRO_CHANNEL_CONF_3\n * ALLEGRO_CHANNEL_CONF_4\n * ALLEGRO_CHANNEL_CONF_5_1\n@@ -2173,15 +1976,14 @@\n * ALLEGRO_CHANNEL_CONF_7_1\n Examples:\n * _\be_\bx_\b__\bs_\ba_\bw_\b._\bc\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b__\bm_\bu_\bl_\bt_\bi_\b._\bc\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_P\bPL\bLA\bAY\bYM\bMO\bOD\bDE\bE *\b**\b**\b**\b**\b*\n enum ALLEGRO_PLAYMODE\n-enum ALLEGRO_PLAYMODE\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Sample and stream playback mode.\n * ALLEGRO_PLAYMODE_ONCE - the sample/stream is played from start to finish\n an then it stops.\n * ALLEGRO_PLAYMODE_LOOP - the sample/stream is played from start to finish\n (or between the two loop points). When it reaches the end, it restarts\n from the beginning.\n@@ -2194,15 +1996,14 @@\n for streams.\n Examples:\n * _\be_\bx_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\bi_\bl_\be_\b._\bc\n * _\be_\bx_\b__\bk_\bc_\bm_\b__\bd_\bi_\br_\be_\bc_\bt_\b._\bc\n * _\be_\bx_\b__\bm_\bi_\bx_\be_\br_\b__\bc_\bh_\ba_\bi_\bn_\b._\bc\n *\b**\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_A\bAU\bUD\bDI\bIO\bO_\b_E\bEV\bVE\bEN\bNT\bT_\b_T\bTY\bYP\bPE\bE *\b**\b**\b**\b**\b*\n enum ALLEGRO_AUDIO_EVENT_TYPE\n-enum ALLEGRO_AUDIO_EVENT_TYPE\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Events sent by _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\be_\bv_\be_\bn_\bt_\b__\bs_\bo_\bu_\br_\bc_\be or\n _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\br_\be_\bc_\bo_\br_\bd_\be_\br_\b__\be_\bv_\be_\bn_\bt_\b__\bs_\bo_\bu_\br_\bc_\be.\n *\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_E\bEV\bVE\bEN\bNT\bT_\b_A\bAU\bUD\bDI\bIO\bO_\b_S\bST\bTR\bRE\bEA\bAM\bM_\b_F\bFR\bRA\bAG\bGM\bME\bEN\bNT\bT *\b**\b**\b**\b*\n Sent when a stream fragment is ready to be filled in. See\n _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\bs_\bt_\br_\be_\ba_\bm_\b__\bf_\br_\ba_\bg_\bm_\be_\bn_\bt.\n *\b**\b**\b**\b* A\bAL\bLL\bLE\bEG\bGR\bRO\bO_\b_E\bEV\bVE\bEN\bNT\bT_\b_A\bAU\bUD\bDI\bIO\bO_\b_S\bST\bTR\bRE\bEA\bAM\bM_\b_F\bFI\bIN\bNI\bIS\bSH\bHE\bED\bD *\b**\b**\b**\b*\n@@ -2212,38 +2013,33 @@\n to _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bR_\bE_\bC_\bO_\bR_\bD_\bE_\bR_\b__\bE_\bV_\bE_\bN_\bT via _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bu_\bd_\bi_\bo_\b__\br_\be_\bc_\bo_\br_\bd_\be_\br_\b__\be_\bv_\be_\bn_\bt.\n You must always check the values for the buffer and samples as they are not\n guaranteed to be exactly what was originally specified.\n Since: 5.1.1\n _\bU\bU_\bn\bn_\bs\bs_\bt\bt_\ba\ba_\bb\bb_\bl\bl_\be\be_\b _\bA\bA_\bP\bP_\bI\bI:\b: The API may need a slight redesign.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bal\bll\ble\beg\bgr\bro\bo_\b_a\bau\bud\bdi\bio\bo_\b_v\bve\ber\brs\bsi\bio\bon\bn *\b**\b**\b**\b**\b*\n uint32_t al_get_allegro_audio_version(void)\n-uint32_t al_get_allegro_audio_version(void)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Returns the (compiled) version of the addon, in the same format as\n _\ba_\bl_\b__\bg_\be_\bt_\b__\ba_\bl_\bl_\be_\bg_\br_\bo_\b__\bv_\be_\br_\bs_\bi_\bo_\bn.\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_a\bau\bud\bdi\bio\bo_\b_d\bde\bep\bpt\bth\bh_\b_s\bsi\biz\bze\be *\b**\b**\b**\b**\b*\n size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth)\n-size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the size of a sample, in bytes, for the given format. The format is one\n of the values listed under _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bA_\bU_\bD_\bI_\bO_\b__\bD_\bE_\bP_\bT_\bH.\n Examples:\n * _\be_\bx_\b__\bs_\by_\bn_\bt_\bh_\b._\bc_\bp_\bp\n *\b**\b**\b**\b**\b* a\bal\bl_\b_g\bge\bet\bt_\b_c\bch\bha\ban\bnn\bne\bel\bl_\b_c\bco\bou\bun\bnt\bt *\b**\b**\b**\b**\b*\n size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf)\n-size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Return the number of channels for the given channel configuration, which is one\n of the values listed under _\bA_\bL_\bL_\bE_\bG_\bR_\bO_\b__\bC_\bH_\bA_\bN_\bN_\bE_\bL_\b__\bC_\bO_\bN_\bF.\n Examples:\n * _\be_\bx_\b__\ba_\bc_\bo_\bd_\be_\bc_\b._\bc\n *\b**\b**\b**\b**\b* a\bal\bl_\b_f\bfi\bil\bll\bl_\b_s\bsi\bil\ble\ben\bnc\bce\be *\b**\b**\b**\b**\b*\n void al_fill_silence(void *buf, unsigned int samples,\n ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n-void al_fill_silence(void *buf, unsigned int samples,\n- ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)\n _\bS_\bo_\bu_\br_\bc_\be_\b _\bC_\bo_\bd_\be\n Fill a buffer with silence, for the given format and channel configuration. The\n buffer must have enough space for the given number of samples, and be properly\n aligned.\n Since: 5.1.8\n Allegro version 5.2.9 - Last updated: 2024-05-03 10:28:35 UTC\n"}]}, {"source1": "./usr/share/doc/allegro5-doc/refman/color.html", "source2": "./usr/share/doc/allegro5-doc/refman/color.html", "unified_diff": "@@ -263,16 +263,15 @@\n between the three color channels into account as well. In general, most\n monitors nowadays try to be close to the sRGB specification. And so if\n in an Allegro game you display something with coloral_map_rgb_f(0.5, 0.5, 0,5)
\nthen it will appear at about half brightness (even though the actual\n brightness output of the monitor will be less than half).
\nal_color_cmyk
\n-\n+\n \nALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k)\n-ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k)
Return an ALLEGRO_COLOR\n structure from CMYK values (cyan, magenta, yellow, black).
\nSee also: al_color_cmyk_to_rgb, Examples:
\n\n
\n- ex_color.cpp
\nal_color_cmyk_to_rgb
\n\n+ float key, float *red, float *green, float *blue)\n \nvoid al_color_cmyk_to_rgb(float cyan, float magenta, float yellow,\n- float key, float *red, float *green, float *blue)\n-void al_color_cmyk_to_rgb(float cyan, float magenta, float yellow,\n- float key, float *red, float *green, float *blue)
Convert CMYK values to RGB values.
\nSee also: al_color_cmyk, al_color_rgb_to_cmyk
\nExamples:
\n\n
\n- ex_color.cpp
\nal_color_hsl
\n-\n+\n \nALLEGRO_COLOR al_color_hsl(float h, float s, float l)\n-ALLEGRO_COLOR al_color_hsl(float h, float s, float l)
Return an ALLEGRO_COLOR\n structure from HSL (hue, saturation, lightness) values.
\nParameters:
\n\n@@ -322,17 +318,15 @@\n
\n- ex_clip.c
\n- ex_palette.c
\nal_color_hsl_to_rgb
\n\n+ float *red, float *green, float *blue)\n \nvoid al_color_hsl_to_rgb(float hue, float saturation, float lightness,\n- float *red, float *green, float *blue)\n-void al_color_hsl_to_rgb(float hue, float saturation, float lightness,\n- float *red, float *green, float *blue)
Convert values in HSL color model to RGB color model.
\nParameters:
\n\n
- hue - Color hue angle in the range 0..360
\n@@ -348,16 +342,15 @@\n\n
\n- ex_color.cpp
\n- ex_palette.c
\nal_color_hsv
\n-\n+\n \nALLEGRO_COLOR al_color_hsv(float h, float s, float v)\n-ALLEGRO_COLOR al_color_hsv(float h, float s, float v)
Return an ALLEGRO_COLOR\n structure from HSV (hue, saturation, value) values.
\nParameters:
\n\n@@ -375,17 +368,15 @@\n
\n- ex_color.cpp
\n- ex_multisample.c
\nal_color_hsv_to_rgb
\n\n+ float *red, float *green, float *blue)\n \nvoid al_color_hsv_to_rgb(float hue, float saturation, float value,\n- float *red, float *green, float *blue)\n-void al_color_hsv_to_rgb(float hue, float saturation, float value,\n- float *red, float *green, float *blue)
Convert values in HSV color model to RGB color model.
\nParameters:
\n\n
- hue - Color hue angle in the range 0..360
\n@@ -399,16 +390,15 @@\n href=\"color.html#al_color_hsl_to_rgb\">al_color_hsl_to_rgb\nExamples:
\n\n
\n- ex_color.cpp
\nal_color_html
\n-\n+\n \nInterprets an HTML-style hex number (e.g.\u00a0#00faff) as a color. The\n accepted format is the same as al_color_html_to_rgb.
\nReturns the interpreted color, or\n@@ -419,17 +409,15 @@\n Allegro 5.0.x.
\n
See also: al_color_html_to_rgb, al_color_rgb_to_html
\nbool al_color_html_to_rgb(char const *string,\n- float *red, float *green, float *blue)\n-bool al_color_html_to_rgb(char const *string,\n- float *red, float *green, float *blue)
Interprets an HTML-style hex number (e.g.\u00a0#00faff) as a color. The\n only accepted formats are \u201c#RRGGBB\u201d and \u201cRRGGBB\u201d where R, G, B are\n hexadecimal digits [0-9A-Fa-f].
\nReturns true on success, false on failure. On failure all components\n@@ -438,17 +426,15 @@\n
Note: the behaviour on invalid strings is different from\n Allegro 5.0.x.
\n \nSee also: al_color_html, al_color_rgb_to_html
\nvoid al_color_rgb_to_html(float red, float green, float blue,\n- char *string)\n-void al_color_rgb_to_html(float red, float green, float blue,\n- char *string)
Create an HTML-style string representation of an ALLEGRO_COLOR, e.g.\u00a0#00faff.
\nParameters:
\nExamples:
\nReturn an ALLEGRO_COLOR\n with the given name. If the color is not found then black is\n returned.
\nSee ex_drag_and_drop.c\n
bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b)\n-bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b)
Parameters:
\nReturns: true if a name from the list above was passed, else\n false.
\nSee also: al_color_name
\nvoid al_color_rgb_to_cmyk(float red, float green, float blue,\n- float *cyan, float *magenta, float *yellow, float *key)\n-void al_color_rgb_to_cmyk(float red, float green, float blue,\n- float *cyan, float *magenta, float *yellow, float *key)
Each RGB color can be represented in CMYK with a K component of 0\n with the following formula:
\nC = 1 - R\n M = 1 - G\n@@ -557,17 +539,15 @@\n Examples:
\n \n - ex_color.cpp
\n
\n al_color_rgb_to_hsl
\n void al_color_rgb_to_hsl(float red, float green, float blue,\n- float *hue, float *saturation, float *lightness)\n-void al_color_rgb_to_hsl(float red, float green, float blue,\n- float *hue, float *saturation, float *lightness)
\n+ float *hue, float *saturation, float *lightness)
\n \n Given an RGB triplet with components in the range 0..1, return the\n hue in degrees from 0..360 and saturation and lightness in the range\n 0..1.
\nSee also: ex_color.cpp
void al_color_rgb_to_hsv(float red, float green, float blue,\n- float *hue, float *saturation, float *value)\n-void al_color_rgb_to_hsv(float red, float green, float blue,\n- float *hue, float *saturation, float *value)
Given an RGB triplet with components in the range 0..1, return the\n hue in degrees from 0..360 and saturation and value in the range\n 0..1.
\nSee also: \n Given an RGB triplet with components in the range 0..1, find a color\n name describing it approximately. See also: al_color_name_to_rgb, Examples: Convert RGB values to XYZ color space. Since: 5.2.3 See also: al_color_xyz, al_color_xyz_to_rgb Return an ALLEGRO_COLOR\n structure from XYZ values. The CIE 1931 XYZ color space consists of\n three components in the range 0..1. The Y component corresponds to\n luminance and the X and Z components define the color. Since: 5.2.3 See also: al_color_xyz_to_rgb, al_color_rgb_to_xyz Convert XYZ color values to RGB color space. Since: 5.2.3 See also: al_color_xyz, al_color_rgb_to_xyz Convert RGB values to xyY color space. Since: 5.2.3 See also: al_color_xyy, al_color_xyy_to_rgb Return an ALLEGRO_COLOR\n structure from xyY values. The Y component in the xyY color space is the\n same as the Y in XYZ. However the x and y values are computed from XYZ like this: Since: 5.2.3 See also: al_color_xyy_to_rgb, al_color_rgb_to_xyy Convert xyY color values to RGB color space. Since: 5.2.3 See also: al_color_xyy, al_color_rgb_to_xyy Convert RGB values to L*a*b* color space. Since: 5.2.3 See also: al_color_lab, al_color_lab_to_rgb Examples: Return an ALLEGRO_COLOR\n structure from CIE L*a*b* values. The L* component corresponds to\n luminance from 0..1. The a* and b* components are in the range\n -1..+1. Convert CIE L*a*b* color values to RGB color space. Since: 5.2.3 See also: al_color_lab, al_color_rgb_to_lab Examples: Convert RGB values to CIE LCH color space. Since: 5.2.3 See also: al_color_lch, al_color_lch_to_rgb Examples: Return an ALLEGRO_COLOR\n structure from CIE LCH values. LCH colors are very similar to HSL, with\n the same meaning of L and H and C corresponding to S. However LCH is\n more visually uniform. Furthermore, this function expects the angle for\n@@ -811,34 +770,30 @@\n Examples: Convert CIE LCH color values to RGB color space. Since: 5.2.3 See also: al_color_lch, al_color_rgb_to_lch Examples: This function computes the CIEDE2000 color difference between two RGB\n colors. This is a visually uniform color difference, unlike for example\n the RGB distance. When using the RGB distance (Euklidean distance between two RGB\n@@ -861,31 +816,28 @@\n Examples: Convert RGB values to YUV color space. See also: al_color_yuv, al_color_yuv_to_rgb Examples: Return an ALLEGRO_COLOR\n structure from YUV values. See also: al_color_yuv_to_rgb, Examples: Convert YUV color values to RGB color space. See also: al_color_yuv, al_color_rgb_to_yuv Examples: Returns the (compiled) version of the addon, in the same format as al_get_allegro_version. Checks if all components of the color are between 0 and 1. Some of\n the color conversions in this addon support color spaces with more\n colors than can be represented in sRGB and when converted to RGB will\n result in invalid color components outside the 0..1 range. Since: 5.2.3 Convert RGB values to the Oklab color space. Since: 5.2.8 See also: al_color_oklab, al_color_oklab_to_rgb Examples: Return an ALLEGRO_COLOR\n structure from Oklab values. The L component corresponds to luminance\n from 0..1. The a and b components are in the range -1..+1. Examples: Convert Oklab color values to RGB. Since: 5.2.8 See also: al_color_oklab, al_color_rgb_to_oklab Convert gamma corrected sRGB values (i.e.\u00a0normal RGB) to linear sRGB\n space. Since: 5.2.8 See also: al_color_linear,\n@@ -996,16 +938,15 @@\n href=\"color.html#al_color_linear_to_rgb\">al_color_linear_to_rgbal_color_rgb_to_name
\n-char const *al_color_rgb_to_name(float r, float g, float b)\n-char const *al_color_rgb_to_name(float r, float g, float b)
\n
\n al_color_rgb_to_xyz
\n void al_color_rgb_to_xyz(float red, float green, float blue,\n- float *x, float *y, float *z)\n-void al_color_rgb_to_xyz(float red, float green, float blue,\n- float *x, float *y, float *z)
al_color_xyz
\n-ALLEGRO_COLOR al_color_xyz(float x, float y, float z)\n-ALLEGRO_COLOR al_color_xyz(float x, float y, float z)
al_color_xyz_to_rgb
\n void al_color_xyz_to_rgb(float x, float y, float z,\n- float *red, float *green, float *blue)\n-void al_color_xyz_to_rgb(float x, float y, float z,\n- float *red, float *green, float *blue)
al_color_rgb_to_xyy
\n void al_color_rgb_to_xyy(float red, float green, float blue,\n- float *x, float *y, float *y2)\n-void al_color_rgb_to_xyy(float red, float green, float blue,\n- float *x, float *y, float *y2)
al_color_xyy
\n-ALLEGRO_COLOR al_color_xyy(float x, float y, float y2)\n-ALLEGRO_COLOR al_color_xyy(float x, float y, float y2)
al_color_xyy_to_rgb
\n void al_color_xyy_to_rgb(float x, float y, float y2,\n- float *red, float *green, float *blue)\n-void al_color_xyy_to_rgb(float x, float y, float y2,\n- float *red, float *green, float *blue)
al_color_rgb_to_lab
\n void al_color_rgb_to_lab(float red, float green, float blue,\n- float *l, float *a, float *b)\n-void al_color_rgb_to_lab(float red, float green, float blue,\n- float *l, float *a, float *b)
\n
\n al_color_lab
\n-ALLEGRO_COLOR al_color_lab(float l, float a, float b)\n-ALLEGRO_COLOR al_color_lab(float l, float a, float b)
al_color_lab_to_rgb
\n void al_color_lab_to_rgb(float l, float a, float b,\n- float *red, float *green, float *blue)\n-void al_color_lab_to_rgb(float l, float a, float b,\n- float *red, float *green, float *blue)
\n
\n al_color_rgb_to_lch
\n void al_color_rgb_to_lch(float red, float green, float blue,\n- float *l, float *c, float *h)\n-void al_color_rgb_to_lch(float red, float green, float blue,\n- float *l, float *c, float *h)
\n
\n al_color_lch
\n-ALLEGRO_COLOR al_color_lch(float l, float c, float h)\n-ALLEGRO_COLOR al_color_lch(float l, float c, float h)
\n
\n al_color_lch_to_rgb
\n void al_color_lch_to_rgb(float l, float c, float h,\n- float *red, float *green, float *blue)\n-void al_color_lch_to_rgb(float l, float c, float h,\n- float *red, float *green, float *blue)
\n
\n al_color_distance_ciede2000
\n double al_color_distance_ciede2000(ALLEGRO_COLOR color1,\n- ALLEGRO_COLOR color2) {\n-double al_color_distance_ciede2000(ALLEGRO_COLOR color1,\n- ALLEGRO_COLOR color2) {
\n
\n al_color_rgb_to_yuv
\n void al_color_rgb_to_yuv(float red, float green, float blue,\n- float *y, float *u, float *v)\n-void al_color_rgb_to_yuv(float red, float green, float blue,\n- float *y, float *u, float *v)
\n
\n al_color_yuv
\n-ALLEGRO_COLOR al_color_yuv(float y, float u, float v)\n-ALLEGRO_COLOR al_color_yuv(float y, float u, float v)
\n
\n al_color_yuv_to_rgb
\n void al_color_yuv_to_rgb(float y, float u, float v,\n- float *red, float *green, float *blue)\n-void al_color_yuv_to_rgb(float y, float u, float v,\n- float *red, float *green, float *blue)
\n
\n al_get_allegro_color_version
\n-\n+\n \n al_is_color_valid
\n \n al_color_rgb_to_oklab
\n void al_color_rgb_to_oklab(float red, float green, float blue,\n- float *ol, float *oa, float *ob)\n-void al_color_rgb_to_oklab(float red, float green, float blue,\n- float *ol, float *oa, float *ob)
\n
\n al_color_oklab
\n-ALLEGRO_COLOR al_color_oklab(float l, float a, float b)\n-ALLEGRO_COLOR al_color_oklab(float l, float a, float b)
\n@@ -966,29 +912,25 @@\n
\n
\n al_color_oklab_to_rgb
\n void al_color_oklab_to_rgb(float ol, float oa, float ob,\n- float *red, float *green, float *blue)\n-void al_color_oklab_to_rgb(float ol, float oa, float ob,\n- float *red, float *green, float *blue)
al_color_rgb_to_linear
\n void al_color_rgb_to_linear(float red, float green, float blue,\n- float *r, float *g, float *b)\n-void al_color_rgb_to_linear(float red, float green, float blue,\n- float *r, float *g, float *b)
Examples:
\nALLEGRO_COLOR al_color_linear(float r, float g, float b)\n-ALLEGRO_COLOR al_color_linear(float r, float g, float b)
Return an ALLEGRO_COLOR\n structure from linear sRGB values. Allegro RGB values are assumed to be\n sRGB. The sRGB standard is in wide use by various display devices. It\n accounts for a standard gamma correction applied to RGB colors before\n@@ -1029,22 +970,23 @@\n
Examples:
\nvoid al_color_linear_to_rgb(float r, float g, float b,\n- float *red, float *green, float *blue)\n-void al_color_linear_to_rgb(float r, float g, float b,\n- float *red, float *green, float *blue)
Convert linear sRGB color values to gamma corrected (i.e.\u00a0normal) RGB\n values.
\nSince: 5.2.8
\nSee also: [al_color_linera], al_color_rgb_to_linear
\n-\n+ \n \n