X3DAUDIO_EMITTER structure
Defines a singlepoint or multiplepoint 3D audio source that is used with an arbitrary number of sound channels.
Syntax
typedef struct X3DAUDIO_EMITTER { X3DAUDIO_CONE *pCone; X3DAUDIO_VECTOR OrientFront; X3DAUDIO_VECTOR OrientTop; X3DAUDIO_VECTOR Position; X3DAUDIO_VECTOR Velocity; FLOAT32 InnerRadius; FLOAT32 InnerRadiusAngle; UINT32 ChannelCount; FLOAT32 ChannelRadius; FLOAT32 *pChannelAzimuths; X3DAUDIO_DISTANCE_CURVE *pVolumeCurve; X3DAUDIO_DISTANCE_CURVE *pLFECurve; X3DAUDIO_DISTANCE_CURVE *pLPFDirectCurve; X3DAUDIO_DISTANCE_CURVE *pLPFReverbCurve; X3DAUDIO_DISTANCE_CURVE *pReverbCurve; FLOAT32 CurveDistanceScaler; FLOAT32 DopplerScaler; } X3DAUDIO_EMITTER, *LPX3DAUDIO_EMITTER;
Members
 pCone

Pointer to a sound cone. Used only with singlechannel emitters for matrix, LPF (both direct and reverb paths), and reverb calculations. NULL specifies the emitter is omnidirectional.
 OrientFront

Orientation of the front direction. This value must be orthonormal with OrientTop. OrientFront must be normalized when used. For singlechannel emitters without cones OrientFront is only used for emitter angle calculations. For multi channel emitters or singlechannel with cones OrientFront is used for matrix, LPF (both direct and reverb paths), and reverb calculations.
 OrientTop

Orientation of the top direction. This value must be orthonormal with OrientFront. OrientTop is only used with multichannel emitters for matrix calculations.
 Position

Position in userdefined world units. This value does not affect Velocity.
 Velocity

Velocity vector in userdefined world units/second. This value is used only for doppler calculations. It does not affect Position.
 InnerRadius

Value to be used for the inner radius calculations. If InnerRadius is 0, then no inner radius is used, but InnerRadiusAngle may still be used. This value must be between 0.0f and MAX_FLT.
 InnerRadiusAngle

Value to be used for the inner radius angle calculations. This value must be between 0.0f and X3DAUDIO_PI/4.0.
 ChannelCount

Number of emitters defined by the X3DAUDIO_EMITTER structure. Must be greater than 0.
 ChannelRadius

Distance from Position that channels will be placed if ChannelCount is greater than 1. ChannelRadius is only used with multichannel emitters for matrix calculations. Must be greater than or equal to 0.0f.
 pChannelAzimuths

Table of channel positions, expressed as an azimuth in radians along the channel radius with respect to the front orientation vector in the plane orthogonal to the top orientation vector. An azimuth of X3DAUDIO_2PI specifies a channel is a lowfrequency effects (LFE) channel. LFE channels are positioned at the emitter base and are calculated with respect to pLFECurve only, never pVolumeCurve. pChannelAzimuths must have at least ChannelCount elements, but can be NULL if ChannelCount = 1. The table values must be within 0.0f to X3DAUDIO_2PI. pChannelAzimuths is used with multichannel emitters for matrix calculations.
 pVolumeCurve

Volumelevel distance curve, which is used only for matrix calculations. NULL specifies a specialized default curve that conforms to the inverse square law, such that when distance is between 0.0f and CurveDistanceScaler × 1.0f, no attenuation is applied. When distance is greater than CurveDistanceScaler × 1.0f, the amplification factor is (CurveDistanceScaler × 1.0f)/distance. At a distance of CurveDistanceScaler × 2.0f, the sound will be at half volume or 6 dB, at a distance of CurveDistanceScaler × 4.0f, the sound will be at one quarter volume or 12 dB, and so on. pVolumeCurve and pLFECurve are independent of each other. pVolumeCurve does not affect LFE channel volume.
 pLFECurve

LFE rolloff distance curve, or NULL to use default curve: [0.0f, CurveDistanceScaler ×1.0f], [CurveDistanceScaler ×1.0f, 0.0f]. A NULL value for pLFECurve specifies a default curve that conforms to the inverse square law with distances <= CurveDistanceScaler clamped to no attenuation. pVolumeCurve and pLFECurve are independent of each other. pLFECurve does not affect non LFE channel volume.
 pLPFDirectCurve

Lowpass filter (LPF) directpath coefficient distance curve, or NULL to use the default curve: [0.0f, 1.0f], [1.0f, 0.75f]. pLPFDirectCurve is only used for LPF directpath calculations.
 pLPFReverbCurve

LPF reverbpath coefficient distance curve, or NULL to use default curve: [0.0f, 0.75f], [1.0f, 0.75f]. pLPFReverbCurve is only used for LPF reverb path calculations.
 pReverbCurve

Reverb send level distance curve, or NULL to use default curve: [0.0f, 1.0f], [1.0f, 0.0f].
 CurveDistanceScaler

Curve distance scaler that is used to scale normalized distance curves to userdefined world units, and/or to exaggerate their effect. This does not affect any other calculations. The value must be within the range FLT_MIN to FLT_MAX. CurveDistanceScaler is only used for matrix, LPF (both direct and reverb paths), and reverb calculations.
 DopplerScaler

Doppler shift scaler that is used to exaggerate Doppler shift effect. DopplerScaler is only used for Doppler calculations and does not affect any other calculations. The value must be within the range 0.0f to FLT_MAX.
Remarks
X3DAUDIO_EMITTER only supports a cone in a singlepoint emitter. Multipoint emitters are a convenient and efficient way to manage a related group of sound sources. Many properties are shared among all channel points, such as Doppler—the same Doppler shift is applied to all channels in the emitter. Thus, the Doppler value need only be calculated once, not perpoint as would be needed with multiple separate singlepoint emitters. Because X3DAUDIO_EMITTER only has one orientation vector, a multipoint emitter cone would be of limited usefulness, forcing all channels to behave as if they were facing the same direction. If multiple independent cones are needed, multiple singlepoint emitters should be used, each with its own orientation.
The parameter type X3DAUDIO_VECTOR is typed to DirectX::XMFLOAT3, to provide x , y , and z floatingpoint values.
X3DAudio uses a lefthanded Cartesian coordinate system, with values on the xaxis increasing from left to right, on the yaxis from bottom to top, and on the zaxis from near to far. Azimuths are measured clockwise from a given reference direction. To use X3DAudio with righthanded coordinates, you must negate the .z element of OrientFront, OrientTop, Position, and Velocity.
For userdefined distance curves, the distance field of the first point must be 0.0f and the distance field of the last point must be 1.0f.
If an emitter moves beyond a distance of (CurveDistanceScaler × 1.0f), the last point on the curve is used to compute the volume output level. The last point is determined by the following:
X3DAUDIO_DISTANCE_CURVE.pPoints[PointCount1].DSPSetting)
Inner Radius and Inner Radius Angle
InnerRadius is used to specify an area of smooth transition around the origin point as a sound travels directly through, above or below the listener. Elevation is accounted for by specifying an InnerRadiusAngle, whereby a sound whose elevation increases or decreases, will eventually start to bleed the sound into more than just two speakers.
When Inner Radius and Inner Radius Angle are not used, emitters are audible in the two closest speakers to their current position/orientation (or, if directly on a line with one speaker's defined angle, solely from that one speaker).
Inner Radius and Inner Radius Angle have no effect on emitters positioned outside of the cones they describe. Inside of the cone, they will gradually cause the sound to bleed into the opposite speakers, until the sound will be equally heard in all speakers when the emitter is at the same position as (or directly above or below) the listener.
Platform Requirements
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)
Requirements
Header 


See also