The SSpLocalizationData QuickTime structure provides a format for sound localization data.
The QTPlgSound3DDesc class provides you with properties and methods that let you whether access or create new instances of such a QuickTime description structure. You can use instances of this class to set up the property of the class and apply 3D sound effect data to a sound track.
→
The QTPlgSound3DDesc class constructors are called when you create a new instance of the class, while the ˜QTPlgSound3DDesc class destructor, is called automatically when the class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to nil.
Once a new class instance is returned, it is good practice to check the class property to be sure that the new object can be used. See the validity requirements for more details.
The class provides you with the following initializer methods:
()
This is the default constructor. Use this constructor to create a completely new data descriptor container in memory.
The following class properties will be initialized to default values:
- =
kMedium_Air - =
kSrcMode_Ambient - =1.0
- =50.0
- =0
(other as QTPlgSound3DDesc)
This is the copy constructor. The properties of the object to be copied will be used to initialize the
new class instance properties
returns the handle to the sound localization data structure in use.
useful for toolbox programmers (use with care: you could invalidate the handle causing unpredictable results
(probably an application crash))
establishes CPU load versus quality; 0 is best
specifies the medium for sound propagation. You can use one of the
defined by the class
specifies the type of filtering to apply. You can use one of the
defined by the class
specifies the number of reflections
etsablishes the value of the humidity (per cent) when medium is air. The range is from 0.0 to
100.0
specifies the distance between walls as reverberation model. The measurement unit is meter and the minimum value is
0.0
specifies the bounce attenuation as reverberation model. The units are decibels
specifies the mix level as reverberation model. The units are decibels
establishes the nominal distance for recording. The units are meters and the minimum value is 0.0
specifies the
cos(angle/2)
of the attenuation cone in degrees. The range is from 0.0 to
360.0
specifies the amount of attenuation (in decibels) outside the cone
specifies the angle of the meridian; the position is up. The units are meters and range is
from –3.14 to 3.14
specifies the angle of the parallel; the position is left. The range is from –1.57
to 1.57
specifies the distance between source and listener. The units are meters and reange is from 0.0 to
10.0
specifies the
cos(angle)
between cone and listener. Units are degrees and range from 0.0 to
180.0
specifies the speed of source toward the listener. The units are meters/second and
the minimum value is 0.0
specifies the speed of listener toward the source. The units are meters/second and
the minimum value is 0.0
the air medium for sound propagation
the water medium for sound propagation
no filtering applied
localized by source position
coming from all around
already binaurally localized