Process creation/destruction

Create and destroy a process instance. More...

Classes
struct	impact_CInstance
struct	impact_CParameters

Functions
struct impact_CParameters *	impact_NewParameters ()
void	impact_FreeParameters (struct impact_CParameters *params)
void	impact_SetParameter (struct impact_CParameters *params, const char *name, const char *value)
const char *	impact_GetParameter (struct impact_CParameters *params, const char *name)
void	impact_FreeParameterValue (const char *value)
struct impact_CInstance *	impact_InitProcess (const char *LoginKey, const char *RadioName, const char *Access_Key_ID, const char *Access_Key_Secret, const char *save_path)
struct impact_CInstance *	impact_InitProcess2 (const char *LoginKey, const char *RadioName, const char *Access_Key_ID, const char *Access_Key_Secret, const char *save_path, const struct impact_CParameters *parameters)
struct impact_CInstance *	impact_InitProcess3 (const char *LoginKey, const char *RadioName, const char *Access_Key_ID, const char *Access_Key_Secret, const char *save_path, const struct impact_CParameters *parameters, unsigned int frames_per_chunk)
unsigned int	impact_GetProcessChunkFrames (struct impact_CInstance *instance)
int	impact_TerminateProcess (struct impact_CInstance *instance)
void	impact_ExitProcess (struct impact_CInstance *instance)

Detailed Description

Create and destroy a process instance, and retrieve some general information about the process.

Function Documentation

impact_ExitProcess()

void impact_ExitProcess

(

struct impact_CInstance *

instance

)

Quit and destroy the instance

Parameters

instance

the instance to destroy

impact_FreeParameters()

void impact_FreeParameters

(

struct impact_CParameters *

params

)

Free the parameters created with impact_NewParameters.

impact_FreeParameterValue()

void impact_FreeParameterValue

(

const char *

value

)

Free a parameter value returned by impact_GetParameter

Parameters

value

the returned value

impact_GetParameter()

const char * impact_GetParameter	(	struct impact_CParameters *	params,
		const char *	name
	)

Get current parameter value.

Returned value must be freed with impact_FreeParameterValue

impact_GetProcessChunkFrames()

unsigned int impact_GetProcessChunkFrames

(

struct impact_CInstance *

instance

)

Get the number of audio frames in each chunk of processing.

The value reflects the frames_per_chunk parameter passed to impact_InitProcess3

Parameters

instance

the instance to destroy

Returns

the number of audio frames in each chunk of processing

Note

A Frame is a set of impact_GetChannelCount samples

impact_InitProcess()

struct impact_CInstance * impact_InitProcess	(	const char *	LoginKey,
		const char *	RadioName,
		const char *	Access_Key_ID,
		const char *	Access_Key_Secret,
		const char *	save_path
	)

Create a process instance with default parameters (from env)

Same as impact_InitProcess2, but with default parameters (from env)

Deprecated:

Use impact_InitProcess3

impact_InitProcess2()

struct impact_CInstance * impact_InitProcess2	(	const char *	LoginKey,
		const char *	RadioName,
		const char *	Access_Key_ID,
		const char *	Access_Key_Secret,
		const char *	save_path,
		const struct impact_CParameters *	parameters
	)

Create a process instance with default frames_per_chunk (64)

Same as impact_InitProcess3, but with default frames_per_chunk

Deprecated:

Use impact_InitProcess3

impact_InitProcess3()

struct impact_CInstance * impact_InitProcess3	(	const char *	LoginKey,
		const char *	RadioName,
		const char *	Access_Key_ID,
		const char *	Access_Key_Secret,
		const char *	save_path,
		const struct impact_CParameters *	parameters,
		unsigned int	frames_per_chunk
	)

Create a process instance

The output will have to be freed with impact_ExitProcess

Attention

The save_path must be an existing folder with R/W access, or be NULL (then it uses volatile memory storage)

If the save_path is NULL or the folder is empty, a default configuration with a default preset will be loaded, unless using Custom preset managagement.

If used in a container, we recommend to put a volume for this path, so it will survive updates.

License access

The licenses are retrieved via Internet and access some servers. You may use an alternate server by changing LICENSE_SERVER in the parameters.

See also Environment variables and parameters

Parameters

LoginKey	SOUND4 Login key (was User ID)
RadioName	SOUND4 RadioName
Access_Key_ID	SOUND4 AWS access ID
Access_Key_Secret	SOUND4 AWS access Secret
save_path	Path where we can load/save the configuration. If NULL, memory storage will be used.
parameters	Parameters
frames_per_chunk	The number of audio frames in each chunk of processing. Must be in the list returned by impact_GetPossibleChunkSizeInFrames

Returns

A new process instance

impact_NewParameters()

struct impact_CParameters * impact_NewParameters

(

)

Create parameters to use with impact_InitProcess2.

The output will have to be freed with impact_FreeParameters

The default values are taken from environment (for compatibility).

impact_SetParameter()

void impact_SetParameter	(	struct impact_CParameters *	params,
		const char *	name,
		const char *	value
	)

Set a new parameter.

Some values are in taken from env, so see Environment variables and parameters for usable variables

See also Custom preset managagement

impact_TerminateProcess()

int impact_TerminateProcess

(

struct impact_CInstance *

instance

)

Terminate the processing

This is useful only with file processing, to get the final status. For some plugins, this is mandatory

Parameters

instance

the instance to terminate

Returns

0 is success, <0 if error, >0 if some status