SpatDIF

h1. Directivity Extension

{{toc}}

    * Orientation of entity (Yaw, Pitch, Roll)

    * Directivity model ...... there are different models out there, what might be the best?

          o AudioTwist

          o Spatialisateur (aperture)

          o Space Unit Generator

          o openAL, directX 

          o X3D (ellipsoids)

          o CATT-Acoustics (SD0, SD1, SD2 file format)

          o Common Loudspeaker File Format (CLF)

h1. Review

h2. "OpenAL":http://connect.creativelabs.com/openal/default.aspx

??ability to simulate realistic directivity characteristics by either *specifying parametric filtering associated to radiation angles*, or *triplets of angle, frequency and attenuation*.?? 

       (Jean Marc Jot, "Scene Description Model and Rendering Engine for Interactive Virtual Acoustics", 120th AES Convention)

h2. "X3D":http://libx3d.sourceforge.net/ISO-IEC-19775-X3DAbstractSpecification/index.html  Sound Node

    * Inner ellipsoid defines a volume of space in which the maximum level of the sound is audible. Within this ellipsoid, the normalized sample data is scaled by the intensity field and there is no attenuation. The inner ellipsoid is defined by extending the direction vector through the location. The @minBack@ and @minFront@ fields specify distances behind and in front of the location along the direction vector respectively. The inner ellipsoid has one of its foci at location (the second focus is implicit) and intersects the direction vector at @minBack@ and @minFront@.

* Outer ellipsoid defines a volume of space that bounds the audibility of the sound. No sound can be heard outside of this outer ellipsoid. The outer ellipsoid is defined by extending the direction vector through the location. The @maxBack@ and @maxFront@ fields specify distances behind and in front of the location along the direction vector respectively. The outer ellipsoid has one of its foci at location (the second focus is implicit) and intersects the direction vector at @maxBack@ and @maxFront@.

* The @minFront@, @maxFront@, @minBack@, and @maxBack@ fields are defined in local coordinates, and are ≥ zero. 

* @minBack@ ≤  @maxBack@ 

* @minFront@ ≤ @maxFront@

* Parameters are specified in the local coordinate system but the ellipsoids' geometry is affected by ancestors' transformations.

* Between the two ellipsoids, there shall be a *linear attenuation ramp* in loudness, from 0 dB at the minimum ellipsoid to -20 dB at the maximum ellipsoid:  *attenuation = -20 × (d' / d")* (*d'* is the distance along the location-to-viewer vector, measured from the transformed minimum ellipsoid boundary to the viewer, and *d"* is the distance along the location-to-viewer vector from the transformed minimum ellipsoid boundary to the transformed maximum ellipsoid boundary)

!X3D.gif!

<pre>

Sound : X3DSoundNode {

  SFVec3f [in,out] direction  0 0 1 (-∞,∞)

  SFFloat [in,out] intensity  1     [0,1]

  SFVec3f [in,out] location   0 0 0 (-∞,∞)

  SFFloat [in,out] maxBack    10    [0,∞)

  SFFloat [in,out] maxFront   10    [0,∞)

  SFNode  [in,out] metadata   NULL  [X3DMetadataObject]

  SFFloat [in,out] minBack    1     [0,∞)

  SFFloat [in,out] minFront   1     [0,∞)

  SFFloat [in,out] priority   0     [0,1]

  SFNode  [in,out] source     NULL  [X3DSoundSourceNode]

  SFBool  []       spatialize TRUE

}</pre>

h2. [[Space Unit Generator]]

!SUG.gif!

h2. AudioTwist

h2. X3DAudio

h2. "DirectX Audio / XACT":http://msdn.microsoft.com/en-us/library/bb147394(VS.85).aspx AUDIO_CONE

* concentric cones

* at any angle outside the outer cone, the volume is attenuated. The outside cone volume level is expressed as a linear amplitude scaler: 1.0f represents no attenuation applied to the original signal, 0.5f denotes an attenuation of 6dB, and 0.0f results in silence. Amplification (volume > 1.0f) is also allowed and is not clamped. The valid volume range is actually 0.0f to 2.0f.

* Between the inner and outer cones is a zone of transition from the inside volume to the outside volume. The volume approaches the cone's outer volume as the angle increases.

* Cones can affect parameters other than volume. Low pass filter and reverb send level may also be affected. For example, with a cone on the listener, one can specify all sounds behind the listener get a bit muffled and have slightly higher reverb-to-direct ratio content. 

!DirectX-Audio.gif!

h3. API X3DAUDIO_CONE

Specifies directionality for a single-channel non-LFE emitter by scaling DSP behavior with respect to the emitter's orientation.

<pre>

typedef struct X3DAUDIO_CONE {

    FLOAT32 InnerAngle;

    FLOAT32 OuterAngle;

    FLOAT32 InnerVolume;

    FLOAT32 OuterVolume;

    FLOAT32 InnerLPF;

    FLOAT32 OuterLPF;

    FLOAT32 InnerReverb;

    FLOAT32 OuterReverb;

} X3DAUDIO_CONE, *LPX3DAUDIO_CONE;</pre>

Members

@InnerAngle@: Inner cone angle in radians. This value must be within 0.0f to X3DAUDIO_2PI.

@OuterAngle@: Outer cone angle in radians. This value must be within InnerAngle to X3DAUDIO_2PI.

@InnerVolume@: Volume scaler on/within inner cone. This value must be within 0.0f to 2.0f.

@OuterVolume@: Volume scaler on/beyond outer cone. This value must be within 0.0f to 2.0f.

@InnerLPF@: LPF direct-path or reverb-path coefficient scaler on/within inner cone. This value is only used for LPF calculations and must be within 0.0f to 1.0f.

@OuterLPF@: LPF direct-path or reverb-path coefficient scaler on or beyond outer cone. This value is only used for LPF calculations and must be within 0.0f to 1.0f.

@InnerReverb@: Reverb send level scaler on or within inner cone. This must be within 0.0f to 2.0f.

@OuterReverb@: Reverb send level scaler on/beyond outer cone. This must be within 0.0f to 2.0f. 

h1. Files