Previous Topic Index Next Topic
[Define]

FSOUND_MODES

Sample description bitfields, OR them together for loading and describing samples.
NOTE. If the file format being loaded already has a defined format, such as WAV or MP3, then
trying to override the pre-defined format with a new set of format flags will not work. For
example, an 8 bit WAV file will not load as 16bit if you specify FSOUND_16BITS. It will just
ignore the flag and go ahead loading it as 8bits. For these type of formats the only flags
you can specify that will really alter the behaviour of how it is loaded, are the following.
FSOUND_LOOP_OFF
FSOUND_LOOP_NORMAL
FSOUND_LOOP_BIDI
FSOUND_HW3D
FSOUND_2D
FSOUND_STREAMABLE
FSOUND_LOADMEMORY
FSOUND_LOADRAW
FSOUND_MPEGACCURATE
See flag descriptions for what these do.

FSOUND_LOOP_OFF 0x00000001 /* For non looping samples. */
FSOUND_LOOP_NORMAL 0x00000002 /* For forward looping samples. */
FSOUND_LOOP_BIDI 0x00000004 /* For bidirectional looping samples. (no effect if in hardware). */
FSOUND_8BITS 0x00000008 /* For 8 bit samples. */
FSOUND_16BITS 0x00000010 /* For 16 bit samples. */
FSOUND_MONO 0x00000020 /* For mono samples. */
FSOUND_STEREO 0x00000040 /* For stereo samples. */
FSOUND_UNSIGNED 0x00000080 /* For source data containing unsigned samples. */
FSOUND_SIGNED 0x00000100 /* For source data containing signed data. */
FSOUND_DELTA 0x00000200 /* For source data stored as delta values. */
FSOUND_IT214 0x00000400 /* For source data stored using IT214 compression. */
FSOUND_IT215 0x00000800 /* For source data stored using IT215 compression. */
FSOUND_HW3D 0x00001000 /* Attempts to make samples use 3d hardware acceleration. (if the card supports it) */
FSOUND_2D 0x00002000 /* Ignores any 3d processing. Overrides FSOUND_HW3D. Located in software. */
FSOUND_STREAMABLE 0x00004000 /* For a streamomg sound where you feed the data to it. If you dont supply this sound may come out corrupted. (only affects a3d output) */
FSOUND_LOADMEMORY 0x00008000 /* "name" will be interpreted as a pointer to data for streaming and samples. */
FSOUND_LOADRAW 0x00010000 /* Will ignore file format and treat as raw pcm. */
FSOUND_MPEGACCURATE 0x00020000 /* For FSOUND_Stream_OpenFile - for accurate FSOUND_Stream_GetLengthMs/FSOUND_Stream_SetTime. WARNING, see FSOUNDStream_OpenFile for inital opening time performance issues. */
FSOUND_FORCEMONO 0x00040000 /* For forcing stereo streams and samples to be mono - needed with FSOUND_HW3D - incurs speed hit */
FSOUND_HW2D 0x00080000 /* 2D hardware sounds. allows hardware specific effects */
FSOUND_ENABLEFX 0x00100000 /* Allows DX8 FX to be played back on a sound. Requires DirectX 8 - Note these sounds cannot be played more than once, be 8 bit, be less than a certain size, or have a changing frequency */
FSOUND_NORMAL (FSOUND_LOOP_OFF | FSOUND_8BITS | FSOUND_MONO)

See Also

FSOUND_Stream_GetLength , FSOUND_Stream_GetLengthMs , FSOUND_Stream_OpenFile , FSOUND_Stream_SetTime

This document copyright ©Firelight Multimedia, 1999-2001. All rights reserved.
Generated Thu Sep 13 00:18:10 2001 by SourceDoc v0.10, the automated source code documenter.