mixGenerate function mixer

int mixGenerate(Pointer<MixMixer> mixer, Pointer<NativeType> buffer, int buflen)

Generate mixer output when not driving an audio device.

SDL_mixer allows the creation of MIX_Mixer objects that are not connected to an audio device, by calling MIX_CreateMixer() instead of MIX_CreateMixerDevice(). Such mixers will not generate output until explicitly requested through this function.

The caller may request as much audio as desired, so long as buflen is a multiple of the sample frame size specified when creating the mixer (for example, if requesting stereo Sint16 audio, buflen must be a multiple of 4: 2 bytes-per-channel times 2 channels).

The mixer will mix as quickly as possible; since it works in sample frames instead of time, it can potentially generate enormous amounts of audio in a small amount of time.

On success, this always fills buffer with buflen bytes of audio; if all playing tracks finish mixing, it will fill the remaining buffer with silence.

Each call to this function will pick up where it left off, playing tracks will continue to mix from the point the previous call completed, etc. The mixer state can be changed between each call in any way desired: tracks can be added, played, stopped, changed, removed, etc. Effectively this function does the same thing SDL_mixer does internally when the audio device needs more audio to play.

This function can not be used with mixers from MIX_CreateMixerDevice(); those generate audio as needed internally.

This function returns the number of bytes of real audio mixed, which might be less than buflen. While all buflen bytes of buffer will be initialized, if available tracks to mix run out, the end of the buffer will be initialized with silence; this silence will not be counted in the return value, so the caller has the option to identify how much of the buffer has legimitate contents vs appended silence. As such, any value >= 0 signifies success. A return value of -1 means failure (out of memory, invalid parameters, etc).

\param mixer the mixer for which to generate more audio. \param buffer a pointer to a buffer to store audio in. \param buflen the number of bytes to store in buffer. \returns The number of bytes of mixed audio, discounting appended silence, on success, or -1 on failure; call SDL_GetError() for more information.

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

\since This function is available since SDL_mixer 3.0.0.

\sa MIX_CreateMixer

extern SDL_DECLSPEC int SDLCALL MIX_Generate(MIX_Mixer *mixer, void *buffer, int buflen)

Implementation

int mixGenerate(
  Pointer<MixMixer> mixer,
  Pointer<NativeType> buffer,
  int buflen,
) {
  final mixGenerateLookupFunction = _libMixer
      .lookupFunction<
        Int32 Function(
          Pointer<MixMixer> mixer,
          Pointer<NativeType> buffer,
          Int32 buflen,
        ),
        int Function(
          Pointer<MixMixer> mixer,
          Pointer<NativeType> buffer,
          int buflen,
        )
      >('MIX_Generate');
  return mixGenerateLookupFunction(mixer, buffer, buflen);
}