Callback

NAME

Snack_AddCallback, Snack_RemoveCallback, Snack_ExecCallbacks - track changes to Snack sound objects

SYNOPSIS

#include <snack.h>
Snack_AddCallback(sound, procedure, clientData)
Snack_RemoveCallback(sound, id)
Snack_ExecCallbacks(sound, flag)

ARGUMENTS

Sound *sound (in)
    Sound object to attach the callback to.
updateProc *procedure (in)
    Procedure to invoke when the sound data changes.
ClientData *clientData (in)
    Arbitrary one-word value to pass to procedure.
int id (in)
    Unique identifer for the callback.
int flag (in)
    Flag which specifies how the sound changed.

DESCRIPTION

Snack_AddCallback adds a callback procedure to sound, that will be called whenever its content changes. It returns an id number that can be used by Snack_RemoveCallback to remove the callback. The clientData parameter to procedure is a copy of the clientData argument given to Snack_AddCallback when
the callback was created. Typically, clientData points to a data structure containing application-specific
information about what to do in procedure.
Snack_ExecCallbacks is used in sub-commands so that changes to a sound can be tracked for example Snack´s canvas item types. The flag specifies whether all sound data has changed (SNACK_NEW_SOUND) or if new data has been appended (SNACK_MORE_DATA).