home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
NeXTSTEP 3.0
/
NeXTSTEP3.0.iso
/
NextDeveloper
/
Headers
/
sound
/
utilsound.h
< prev
Wrap
Text File
|
1991-08-09
|
2KB
|
66 lines
/*
* utilsound.h
* Copyright 1988-89 NeXT, Inc.
*
*/
#import "soundstruct.h"
#import "sounderror.h"
int SNDSampleCount(SNDSoundStruct *s);
/*
* Returns the number of sample frames in the sound. If the format is not
* recognized, or the sample count cannot be determined, then -1 is
* returned.
*/
int SNDGetDataPointer(SNDSoundStruct *s, char **ptr, int *size, int *width);
/*
* Return a pointer to the data portion of a soundstruct in ptr, the
* number of samples (NOT sample frames) in size, and the number of bytes per
* sample in width. Fragmented sounds return an error.
* Returns an error code.
*/
int SNDBytesToSamples(int byteCount, int channelCount, int dataFormat);
int SNDSamplesToBytes(int sampleCount, int channelCount, int dataFormat);
/*
* Converts bytes to samples and the converse, given also the channelCount
* and dataFormat. If the dataFormat is not recognized, then a negative value
* is returned.
* The number returned from SNDSamplesToBytes is useful as the "dataSize"
* argument to SNDAlloc.
*/
int SNDAlloc(SNDSoundStruct **s,
int dataSize,
int dataFormat,
int samplingRate,
int channelCount,
int infoSize);
/*
* Allocate a souBSHtructure and initialize its fields. The actual sample
* data is uninitialized, and the info string buffer is extended to the
* smallest quad boundary greater than zero. Both the dataSize and infoSize
* are expressed in bytes. An error code is returned.
* If no error, then a pointer to the allocated data is returned in "s".
*/
int SNDFree(SNDSoundStruct *s);
/*
* Frees "s", which was created and returned by one of the sound library
* routines.
*/
int SNDPlaySoundfile(char *path, int priority);
/*
* Play the soundfile specified by path. Playback occurs in the background,
* and this routine returns immediately. Playback interrupts any currently
* playing sound of the same or lower priority. When playback completes,
* the storage allocated by this function is automatically deallocated.
* An error code is returned.
*/