IpatchSampleTransform

typedef struct _IpatchSampleTransform IpatchSampleTransform;

Private structure, use functions to access it.

IpatchSampleTransformClass

typedef struct {
} IpatchSampleTransformClass;

IpatchSampleTransformFunc ()

void        (*IpatchSampleTransformFunc)    (IpatchSampleTransform *transform);

Audio conversion handler prototype. Handler will modify samples of transform if number of samples changes (a change in the number of channels occurs).

ipatch_sample_transform_new ()

IpatchSampleTransform* ipatch_sample_transform_new
                                            (int src_format,
                                             int dest_format);

Create a new sample transform object. If src_format and dest_format are not 0 then the transform is initialized for the given source and destination formats, otherwise they are expected to be set later with ipatch_sample_transform_set_formats().

ipatch_sample_transform_set_formats ()

void        ipatch_sample_transform_set_formats
                                            (IpatchSampleTransform *transform,
                                             int src_format,
                                             int dest_format);

Initialize a sample transform object for converting from src_format to dest_format.

ipatch_sample_transform_alloc ()

void        ipatch_sample_transform_alloc   (IpatchSampleTransform *transform,
                                             guint frames);

Allocate buffers for transforming between two audio formats, for which transform has previously been initialized for with ipatch_sample_transform_new() or ipatch_sample_transform_set_formats().

ipatch_sample_transform_alloc_size ()

int         ipatch_sample_transform_alloc_size
                                            (IpatchSampleTransform *transform,
                                             guint size);

Like ipatch_sample_transform_alloc() but allocates buffers based on a maximum size and returns the maximum number of sample frames which can be converted at a time using this size.

ipatch_sample_transform_free_buffers ()

void        ipatch_sample_transform_free_buffers
                                            (IpatchSampleTransform *transform);

Free sample transform buffers.

ipatch_sample_transform_set_buffers ()

void        ipatch_sample_transform_set_buffers
                                            (IpatchSampleTransform *transform,
                                             gpointer buf1,
                                             gpointer buf2,
                                             guint max_frames);

Assign user allocated buffers to be used for transforming sample data. Either this function, ipatch_sample_transform_set_buffers_size(), ipatch_sample_transform_alloc() or ipatch_sample_transform_alloc_size() must be called before conversion can commence. buf1 and buf2 should be large enough to convert max_frames at a time - see ipatch_sample_transform_get_frame_sizes().

ipatch_sample_transform_get_buffers ()

void        ipatch_sample_transform_get_buffers
                                            (IpatchSampleTransform *transform,
                                             gpointer *buf1,
                                             gpointer *buf2);

Get the sample data buffers in a sample transform object.

ipatch_sample_transform_get_frame_sizes ()

void        ipatch_sample_transform_get_frame_sizes
                                            (IpatchSampleTransform *transform,
                                             guint *buf1_size,
                                             guint *buf2_size);

Get max frame sizes for transform buffers. When transforming audio the first buffer must be at least frames * buf1_size bytes in size and the second buffer must be at least frames * buf2_size, where frames is the max number of frames to convert in batch.

ipatch_sample_transform_convert ()

gpointer    ipatch_sample_transform_convert (IpatchSampleTransform *transform,
                                             guint frames);

Convert the format of a buffer of audio. The transform object must have had its sample formats set and buffers assigned or allocated.