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
 
1.3.5