Audio managing (any audio)

Process audio in any format and size. More...

Enumerations
enum	impact_SampleFormat {   INVALID_FORMAT =0 , S16_LE , S16_BE , S24_LE ,   S24_BE , S32_LE , S32_BE , F32_LE ,   F32_BE , S16_NATIVE =S16_LE , S24_NATIVE =S24_LE , S32_NATIVE =S32_LE ,   F32_NATIVE =F32_LE }

Functions
const char *	impact_GetFormatName (const enum impact_SampleFormat fmt)
enum impact_SampleFormat	impact_GetFormatFromName (const char *name)
unsigned int	impact_GetBytesFromFormat (const enum impact_SampleFormat fmt)
unsigned int	impact_GetMaxPacketFrame (struct impact_CInstance *instance)
unsigned int	impact_AddAudio (struct impact_CInstance *instance, const uint8_t *payload, unsigned int nFrame, enum impact_SampleFormat fmt)
unsigned int	impact_AddPadAudio (struct impact_CInstance *instance)
unsigned int	impact_GetOutputCount (struct impact_CInstance *instance)
unsigned int	impact_GetAudio (struct impact_CInstance *instance, uint8_t *payload, unsigned int max_nFrame, enum impact_SampleFormat fmt)

Detailed Description

This allows various payload size and formats, at the expense of internal conversions. This can be useful when receiving audio from network.

Remarks

It is more optimized to use Direct processing.

Enumeration Type Documentation

impact_SampleFormat

enum impact_SampleFormat

Supported formats for audio I/O

Enumerator
INVALID_FORMAT	Invalid.
S16_LE	16-bit signed integer, little-endian
S16_BE	16-bit signed integer, big-endian
S24_LE	24-bit signed integer, little-endian
S24_BE	24-bit signed integer, big-endian
S32_LE	32-bit signed integer, little-endian
S32_BE	32-bit signed integer, big-endian
F32_LE	32-bit floating-point, little-endian
F32_BE	32-bit floating-point, big-endian
S16_NATIVE	16-bit signed integer, native
S24_NATIVE	24-bit signed integer, native
S32_NATIVE	32-bit signed integer, native
F32_NATIVE	32-bit floating-point, native

Definition at line 774 of file sound4.impact.cl.h.

Function Documentation

impact_AddAudio()

unsigned int impact_AddAudio	(	struct impact_CInstance *	instance,
		const uint8_t *	payload,
		unsigned int	nFrame,
		enum impact_SampleFormat	fmt
	)

Convert and process the payload.

Parameters

instance	the processing instance
payload	the binary raw audio buffer
nFrame	the number of frames in the payload
fmt	the format of the payload

Returns

number of unprocessed frames (if can not store output) if non zero, consume output and restart where it stopped

impact_AddPadAudio()

unsigned int impact_AddPadAudio

(

struct impact_CInstance *

instance

)

Add silence to finish the current audio chunk and process it

Parameters

instance

the processing instance

Returns

number of added silence frame

impact_GetAudio()

unsigned int impact_GetAudio	(	struct impact_CInstance *	instance,
		uint8_t *	payload,
		unsigned int	max_nFrame,
		enum impact_SampleFormat	fmt
	)

Consume the output

Parameters

instance	the processing instance
payload	the binary raw audio buffer to store output
max_nFrame	the maximum number of frames that can be stored in the payload
fmt	the wanted format of the payload

Returns

number of frames put in the buffer

impact_GetBytesFromFormat()

unsigned int impact_GetBytesFromFormat

(

const enum impact_SampleFormat

fmt

)

Get the format byte size

Parameters

fmt	the format

Returns

the number of bytes used by this format for a single channel audio sample

impact_GetFormatFromName()

enum impact_SampleFormat impact_GetFormatFromName

(

const char *

name

)

Convert string to format

Parameters

name	the format string

Returns

the matching format, or INVALID_FORMAT if invalid.

impact_GetFormatName()

const char * impact_GetFormatName

(

const enum impact_SampleFormat

fmt

)

Convert format to string

Parameters

fmt	the format

Returns

the string name of the format

impact_GetMaxPacketFrame()

unsigned int impact_GetMaxPacketFrame

(

struct impact_CInstance *

instance

)

Maximum packet size (in frames) that can be queued at output.

Parameters

instance

The process instance

Returns

Maximum packet size (in frames) that can be queued at output.

impact_GetOutputCount()

unsigned int impact_GetOutputCount

(

struct impact_CInstance *

instance

)

Get the available output size

Parameters

instance

the processing instance

Returns

number of available frames at output