mixCreateAudioDecoderIo function mixer

Pointer<MixAudioDecoder> mixCreateAudioDecoderIo(Pointer<SdlIoStream> io, bool closeio, int props)

Create a MIX_AudioDecoder from an SDL_IOStream.

Most apps won't need this, as SDL_mixer's usual interfaces will decode audio as needed. However, if one wants to decode an audio file into a memory buffer without playing it, this interface offers that.

This function allows properties to be specified. This is intended to supply file-specific settings, such as where to find SoundFonts for a MIDI file, etc. In most cases, the caller should pass a zero to specify no extra properties.

If closeio is true, then io will be closed when this decoder is done with it. If this function fails and closeio is true, then io will be closed before this function returns.

When done with the audio decoder, it can be destroyed with MIX_DestroyAudioDecoder().

This function requires SDL_mixer to have been initialized with a successful call to MIX_Init(), but does not need an actual MIX_Mixer to have been created.

\param io the i/o stream from which to load data. \param closeio if true, close the i/o stream when done with it. \param props decoder-specific properties. May be zero. \returns an audio decoder, ready to decode.

\threadsafety It is safe to call this function from any thread.

\since This function is available since SDL_mixer 3.0.0.

\sa MIX_CreateAudioDecoder_IO \sa MIX_DecodeAudio \sa MIX_DestroyAudioDecoder

extern SDL_DECLSPEC MIX_AudioDecoder * SDLCALL MIX_CreateAudioDecoder_IO(SDL_IOStream *io, bool closeio, SDL_PropertiesID props)

Implementation

Pointer<MixAudioDecoder> mixCreateAudioDecoderIo(
  Pointer<SdlIoStream> io,
  bool closeio,
  int props,
) {
  final mixCreateAudioDecoderIoLookupFunction = _libMixer
      .lookupFunction<
        Pointer<MixAudioDecoder> Function(
          Pointer<SdlIoStream> io,
          Uint8 closeio,
          Uint32 props,
        ),
        Pointer<MixAudioDecoder> Function(
          Pointer<SdlIoStream> io,
          int closeio,
          int props,
        )
      >('MIX_CreateAudioDecoder_IO');
  return mixCreateAudioDecoderIoLookupFunction(io, closeio ? 1 : 0, props);
}