Session API for clients.

Data Structures
struct	_jack_session_event

Typedefs
typedef enum JackSessionEventType	jack_session_event_type_t
typedef enum JackSessionFlags	jack_session_flags_t
typedef struct _jack_session_event	jack_session_event_t
typedef void(*	JackSessionCallback )(jack_session_event_t *event, void *arg)

Enumerations
enum	JackSessionEventType { JackSessionSave = 1, JackSessionSaveAndQuit = 2, JackSessionSaveTemplate = 3 }
enum	JackSessionFlags { JackSessionSaveError = 0x01, JackSessionNeedTerminal = 0x02 }

Functions
int	jack_set_session_callback (jack_client_t *client, JackSessionCallback session_callback, void *arg) JACK_WEAK_EXPORT
int	jack_session_reply (jack_client_t *client, jack_session_event_t *event) JACK_WEAK_EXPORT
void	jack_session_event_free (jack_session_event_t *event) JACK_WEAK_EXPORT
char *	jack_client_get_uuid (jack_client_t *client) JACK_WEAK_EXPORT

Detailed Description

Typedef Documentation

typedef struct _jack_session_event jack_session_event_t

typedef enum JackSessionEventType jack_session_event_type_t

typedef enum JackSessionFlags jack_session_flags_t

Session flags.

typedef void(* JackSessionCallback)(jack_session_event_t *event, void *arg)

Prototype for the client supplied function that is called whenever a session notification is sent via jack_session_notify().

Ownership of the memory of event is passed to the application. It must be freed using jack_session_event_free when its not used anymore.

The client must promptly call jack_session_reply for this event.

Parameters

event	The event structure.
arg	Pointer to a client supplied structure.

Enumeration Type Documentation

enum JackSessionEventType

Session event type.

if a client cant save templates, i might just do a normal save.

There is no "quit without saving" event because a client might refuse to quit when it has unsaved data, but other clients may have already quit. This results in too much confusion, so it is unsupported.

Enumerator:

JackSessionSave	Save the session completely. The client may save references to data outside the provided directory, but it must do so by creating a link inside the provided directory and referring to that in any save files. The client must not refer to data files outside the provided directory directly in save files, because this makes it impossible for the session manager to create a session archive for distribution or archival.
JackSessionSaveAndQuit	Save the session completly, then quit. The rules for saving are exactly the same as for JackSessionSave.
JackSessionSaveTemplate	Save a session template. A session template is a "skeleton" of the session, but without any data. Clients must save a session that, when restored, will create the same ports as a full save would have. However, the actual data contained in the session may not be saved (e.g. a DAW would create the necessary tracks, but not save the actual recorded data).

enum JackSessionFlags

jack_session_flags_t bits

Enumerator:

JackSessionSaveError	An error occured while saving.
JackSessionNeedTerminal	Client needs to be run in a terminal.

Function Documentation

char* jack_client_get_uuid

(

jack_client_t *

client

)

get the assigned uuid for client. safe to call from callback and all other threads. memory needs to be freed.

void jack_session_event_free

(

jack_session_event_t *

event

)

free memory used by a jack_session_event_t this also frees the memory used by the command_line pointer. if its non NULL.

int jack_session_reply	(	jack_client_t *	client,
		jack_session_event_t *	event
	)

Reply to a session event.

This can either be called directly from the callback, or later from a different thread. For example, it is possible to push the event through a queue and execute the save code from the GUI thread.

Returns

0 on success, otherwise a non-zero error code

int jack_set_session_callback	(	jack_client_t *	client,
		JackSessionCallback	session_callback,
		void *	arg
	)

Tell the JACK server to call session_callback when a session event is to be delivered.

setting more than one session_callback per process is probably a design error. if you have a multiclient application its more sensible to create a jack_client with only a session callback set.

Returns

0 on success, otherwise a non-zero error code