| ActiveTcl User Guide |

### NAME

Snack_NewSound, Snack_DeleteSound, Snack_GetSound, Snack_ResizeSoundStorage,
Snack_UpdateExtremes - manipulate Snack sound objects

### SYNOPSIS

#include <snack.h>

Snack_NewSound(frequency, format, nChannels)
Snack_DeleteSound(sound)
Snack_GetSound(interp, name)
Snack_ResizeSoundStorage(sound, length)
Snack_UpdateExtremes(sound, start, end, flag)

### ARGUMENTS

int frequency (in)
Sampling frequency of the new sound object
int format (in)
Sample encoding format of the new sound object
int nChannels (in)
Number of channels of the new sound object
Sound *sound (in)
Pointer to a Snack sound object
Tcl_Interp *interp (in)
char *name (in)
int length (in)
int start (in)
int end (in)
int flag (in)

### DESCRIPTION

Snack_NewSound creates a new Snack sound object by allocating and initializing a sound struct. It takes the arguments frequency, sample encoding format and number of channels, nChannels. Snack_DeleteSound deallocates all storage associated with sound. Snack_GetSound returns a pointer to a Snack sound given its sound command name.
Snack_ResizeSoundStorage is used to set the storage associated with a sound to accomodate length samples. Memory is allocated or deallocated as necessary. Snack_UpdateExtremes scans the samples of sound from start to end and records the extremes in the sound struct. The flag is used to specify whether to reset the current recorded extremes before calculating new ones (SNACK_NEW_SOUND) or if they should be kept and possibly updated (SNACK_MORE_DATA).