SunVox.java

package com.github.technus.sunvoxlib.model;

import com.github.technus.sunvoxlib.SunVoxLib;
import com.github.technus.sunvoxlib.model.number.*;
import com.github.technus.sunvoxlib.model.slot.Slot;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import static com.github.technus.sunvoxlib.model.SunVoxException.*;

public class SunVox implements AutoCloseable {
    protected static SunVox INSTANCE = new SunVox();

    public static SunVox getInstance() {
        return INSTANCE;
    }

    private volatile BufferType bufferType;
    private volatile boolean useCallback;
    private EngineVersion engineVersion;

    @Override
    public void close() {
        deinit();
    }

    public boolean isInitialized(){
        return bufferType!=null;
    }

    public boolean isUsingCallbacks(){
        if(!isInitialized())
            throw new RuntimeException("Cannot check if callbacks are required on non initialized engine");
        return useCallback;
    }

    public BufferType getBufferType(){
        if(!isInitialized())
            throw new RuntimeException("Cannot check if buffer type on non initialized engine");
        return bufferType;
    }

    public EngineVersion getEngineVersion(){
        if(!isInitialized())
            throw new RuntimeException("Cannot check engine version on non initialized engine");
        return engineVersion;
    }

    /**
     *
     * @param slot slot number
     * @param track_num track number (within the virtual pattern)
     * @param note 0 - nothing; 1..127 - note number; 128 - note off; 129, 130... - see {@link NoteCommand}
     * @param vel velocity 1..129; 0 - default
     * @param module 0 (empty) or module number + 1 (1..65535)
     * @param ctl 0xCCEE; CC - controller number (1..255); EE - effect
     * @param ctl_val value of the controller or parameter of the effect
     */
    public void sendEvent(int slot, int track_num, int note, int vel, int module, int ctl, int ctl_val) {
        voidIfOk(SunVoxLib.sv_send_event(slot, track_num, note, vel, module, ctl, ctl_val));
    }

    //region Main

    /**
     * Global sound system initialization
     * @param freq desired sample rate (Hz)
     *            min - 44100
     *            the actual rate may be different, if SV_INIT_FLAG_OFFLINE is not set
     * @param flags set of flags {@link InitializationFlag}
     * @return SunVox engine version
     */
    public EngineVersion init(int freq, InitializationFlag... flags) {
        return init(null,freq,flags);
    }

    /**
     * Global sound system initialization
     * @param config string with additional configuration in the following format: "option_name=value|option_name=value"
     *               or NULL for auto config
     *               example: "buffer=1024|audiodriver=alsa|audiodevice=hw:0,0"
     * @param freq desired sample rate (Hz)
     *            min - 44100
     *            the actual rate may be different, if SV_INIT_FLAG_OFFLINE is not set
     * @param flags set of flags {@link InitializationFlag}
     * @return SunVox engine version
     */
    public EngineVersion init(String config, int freq, InitializationFlag... flags) {
        return init(config,freq,2,flags);
    }

    /**
     * Global sound system initialization
     * @param config string with additional configuration in the following format: "option_name=value|option_name=value"
     *               or NULL for auto config
     *               example: "buffer=1024|audiodriver=alsa|audiodevice=hw:0,0"
     * @param freq desired sample rate (Hz)
     *            min - 44100
     *            the actual rate may be different, if SV_INIT_FLAG_OFFLINE is not set
     * @param channels only 2 supported now
     * @param flags set of flags {@link InitializationFlag}
     * @return SunVox engine version
     */
    protected synchronized EngineVersion init(String config, int freq, int channels, InitializationFlag... flags) {
        if(isInitialized())
            throw new RuntimeException("Was already initialized");
        BufferType type = BufferType.forFlags(flags);
        useCallback = Arrays.stream(flags).anyMatch(x->x.getValue()==InitializationFlag.USER_AUDIO_CALLBACK.getValue());
        engineVersion = new EngineVersion(intIfOk(SunVoxLib.sv_init(config,freq,channels,InitializationFlag.ofAll(flags).getValue())));
        bufferType = type;
        return engineVersion;
    }

    /**
     * Global sound system deinitialization
     */
    protected synchronized void deinit() {
        if(!isInitialized())
            throw new RuntimeException("Was already deinitialized");
        voidIfOk(SunVoxLib.sv_deinit());
        bufferType = null;
    }

    /**
     * Get current sampling rate (it may differ from the frequency specified in {@link #init})
     * @return sampling rate
     */
    public int getSampleRate() {
        return intIfOk(SunVoxLib.sv_get_sample_rate());
    }

    /**
     * Handle input ON/OFF requests to enable/disable input ports of the sound card (for example, after the Input module creation).
     * Call it from the main thread only, where the SunVox sound stream is not locked.
     */
    public void updateInput() {
        voidIfOk(SunVoxLib.sv_update_input());
    }

    /**
     * get the next piece of SunVox audio from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @return buffer status
     */
    @Deprecated
    public int audioCallback(byte[] buf, int frames, int latency, int out_time) {
        return intIfOk(SunVoxLib.sv_audio_callback(buf, frames, latency, out_time));
    }

    /**
     * get the next piece of SunVox audio from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @return buffer status
     */
    @Deprecated
    public BufferStatus callback(byte[] buf, int frames, int latency, int out_time) {
        return BufferStatus.MAPPING.get(audioCallback(buf,frames,latency,out_time));
    }

    /**
     * get the next piece of SunVox audio from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @return buffer status
     */
    public int audioCallback(short[] buf, int frames, int latency, int out_time) {
        return intIfOk(SunVoxLib.sv_audio_callback(buf, frames, latency, out_time));
    }

    /**
     * get the next piece of SunVox audio from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @return buffer status
     */
    public BufferStatus callback(short[] buf, int frames, int latency, int out_time) {
        return BufferStatus.MAPPING.get(audioCallback(buf, frames, latency, out_time));
    }

    /**
     * get the next piece of SunVox audio from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @return buffer status
     */
    public int audioCallback(float[] buf, int frames, int latency, int out_time) {
        return intIfOk(SunVoxLib.sv_audio_callback(buf, frames, latency, out_time));
    }

    /**
     * get the next piece of SunVox audio from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @return buffer status
     */
    public BufferStatus callback(float[] buf, int frames, int latency, int out_time) {
        return BufferStatus.MAPPING.get(audioCallback(buf, frames, latency, out_time));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_type bufferType
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public int audioCallback2(byte[] buf, int frames, int latency, int out_time, BufferType in_type, int in_channels, byte[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, in_type.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_type bufferType
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public BufferStatus callback2(byte[] buf, int frames, int latency, int out_time, BufferType in_type, int in_channels, byte[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_type, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public int audioCallback2(byte[] buf, int frames, int latency, int out_time, int in_channels, short[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, BufferType.INT16.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public BufferStatus callback2(byte[] buf, int frames, int latency, int out_time, int in_channels, short[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public int audioCallback2(byte[] buf, int frames, int latency, int out_time, int in_channels, float[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, BufferType.FLOAT32.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public BufferStatus callback2(byte[] buf, int frames, int latency, int out_time, int in_channels, float[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_type bufferType
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public int audioCallback2(short[] buf, int frames, int latency, int out_time, BufferType in_type, int in_channels, byte[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, in_type.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_type bufferType
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public BufferStatus callback2(short[] buf, int frames, int latency, int out_time, BufferType in_type, int in_channels, byte[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_type, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public int audioCallback2(short[] buf, int frames, int latency, int out_time, int in_channels, short[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, BufferType.INT16.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public BufferStatus callback2(short[] buf, int frames, int latency, int out_time, int in_channels, short[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public int audioCallback2(short[] buf, int frames, int latency, int out_time, int in_channels, float[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, BufferType.FLOAT32.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public BufferStatus callback2(short[] buf, int frames, int latency, int out_time, int in_channels, float[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_type bufferType
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public int audioCallback2(float[] buf, int frames, int latency, int out_time, BufferType in_type, int in_channels, byte[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, in_type.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_type bufferType
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    @Deprecated
    public BufferStatus callback2(float[] buf, int frames, int latency, int out_time, BufferType in_type, int in_channels, byte[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_type, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public int audioCallback2(float[] buf, int frames, int latency, int out_time, int in_channels, short[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, BufferType.INT16.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public BufferStatus callback2(float[] buf, int frames, int latency, int out_time, int in_channels, short[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public int audioCallback2(float[] buf, int frames, int latency, int out_time, int in_channels, float[] in_buf) {
        return intIfOk(SunVoxLib.sv_audio_callback2(buf, frames, latency, out_time, BufferType.FLOAT32.getValue(), in_channels, in_buf));
    }

    /**
     * send some data to the Input module and receive the filtered data from the Output module
     * @param buf output buffer of type {@link Short} (if {@link InitializationFlag#AUDIO_INT16} is set in {@link #init})
     *            or {@link Float} (if {@link InitializationFlag#AUDIO_FLOAT32} is set in {@link #init})
     *            stereo data will be interleaved in this buffer: LRLR... (LR is a single frame (Left+Right))
     * @param frames number of frames in destination buffer
     * @param latency audio latency (in frames)
     * @param out_time buffer output time (in system ticks)
     * @param in_channels number of input channels
     * @param in_buf input buffer
     *               stereo data must be interleaved in this buffer: LRLR...
     * @return buffer status
     */
    public BufferStatus callback2(float[] buf, int frames, int latency, int out_time, int in_channels, float[] in_buf) {
        return BufferStatus.MAPPING.get(audioCallback2(buf, frames, latency, out_time, in_channels, in_buf));
    }

    //endregion

    //region Other

    /**
     * SunVox engine uses system-provided time space, measured in system tick (don't confuse it with the project ticks).
     * These ticks are required for parameters of functions such as {@link #audioCallback} {@link #audioCallback2} and {@link Slot#setEventT}.
     * @return current tick counter (from 0 to 0xFFFFFFFF)
     */
    public int getTicks() {
        return intIfOk(SunVoxLib.sv_get_ticks());
    }

    /**
     * SunVox engine uses system-provided time space, measured in system tick (don't confuse it with the project ticks).
     * These ticks are required for parameters of functions such as {@link #audioCallback} {@link #audioCallback2} and {@link Slot#setEventT}.
     * @return number of system ticks per second
     */
    public int getTicksPerSecond() {
        return intIfOk(SunVoxLib.sv_get_ticks_per_second());
    }

    /**
     * Get the latest messages from the log
     * @param size max number of bytes to read
     * @return latest log messages
     */
    public String getLog(int size) {
        return stringIfNotNull(SunVoxLib.sv_get_log(size));
    }

    //endregion
}