Configuration
FishSound can be configured on most platforms using the GNU autoconf ./configure system described below.
For Win32, see the README.win32 section. You will need to edit win32/config.h
by hand to achieve the customizations described below.
It is possible to customize the functionality of libfishsound by using various ./configure flags when building it from source; for example you can build a smaller version of libfishsound to only decode or encode, or and you can choose to disable support for a particular codec. By default, both decoding and encoding support is built for all codecs found on the system.
For general information about using ./configure, see the file INSTALL
Configuring with --disable-encode will remove all support for encoding:
- All internal encoding related functions will not be built
- Any attempt to call fish_sound_new() with mode == FISH_SOUND_ENCODE will fail, returning NULL
- Any attempt to call fish_sound_encode() will return FISH_SOUND_ERR_DISABLED
- The resulting library will not be linked against libvorbisenc
Configuring with --disable-decode will remove all support for decoding:
- All internal decoding related functions will not be built
- Any attempt to call fish_sound_new() with mode == FISH_SOUND_DECODE will fail, returning NULL
- Any attempt to call fish_sound_decode() will return FISH_SOUND_ERR_DISABLED
Configuring with --disable-vorbis will remove all support for Vorbis:
- All internal Vorbis related functions will not be built
- Any attempt to call fish_sound_new() with mode == FISH_SOUND_ENCODE and fsinfo->format == FISH_SOUND_VORBIS will fail, returning NULL
- The resulting library will not be linked against libvorbis or libvorbisenc
Configuring with --disable-speex will remove all support for Speex:
- All internal Speex related functions will not be built
- Any attempt to call fish_sound_new() with mode == FISH_SOUND_ENCODE and fsinfo->format == FISH_SOUND_SPEEX will fail, returning NULL
- The resulting library will not be linked against libspeex
Upon successful configuration, you should see something like this:
------------------------------------------------------------------------
libfishsound 0.6.0: Automatic configuration OK.
General configuration:
Experimental code: ........... no
Decoding support: ............ yes
Encoding support: ............ yes
Library configuration (./src/libfishsound):
Vorbis support: .............. yes
Speex support: ............... yes
Example programs (./src/examples):
identify decode encode
Installation paths:
libfishsound: ................ /usr/local/lib
C header files: .............. /usr/local/include/fishsound
Documentation: ............... /usr/local/share/doc/libfishsound
Example programs will be built but not installed.
------------------------------------------------------------------------
Generated on Thu Jun 24 18:46:04 2004 for libfishsound by
1.3.5