Carbon


AudioSelection

Header: Sound.h

struct AudioSelection {
    SInt32 unitType; 
    UnsignedFixed selStart; 
    UnsignedFixed selEnd;
};
typedef AudioSelection AudioSelectionPtr;

Field descriptions

unitType

The type of unit of time used in the selStart and selEnd fields. You can set this to seconds by specifying the constant unitTypeSeconds. See “Unit Type Constants”.

selStart

The starting point in seconds of the sound to play. If selStart is greater than selEnd, SndStartFilePlay returns an error.

selEnd

The ending point in seconds of the sound to play. You can use either of the two constants, unitTypeSeconds or unitTypeNoSelection. If the value in the unitType field is unitTypeNoSelection, then the values in the selStart and selEnd fields are ignored and the entire sound plays. Alternatively, if you wish to play an entire sound, you can pass NULL instead of a pointer to an audio selection record to the SndStartFilePlay function.

You can pass a pointer to an audio selection structure to the SndStartFilePlay function to play only part of a sound in a file on disk. The AudioSelection data type defines an audio selection structure.

You should use this data structure only if you need to access this information or to customize sound play.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)