Version

menu_open
Wwise SDK 2021.1.14

◆ Compute3DPositioning() [1/2]

virtual AKRESULT AK::IAkMixerPluginContext::Compute3DPositioning ( AkReal32  in_fAngle,
AkReal32  in_fElevation,
AkReal32  in_fSpread,
AkReal32  in_fFocus,
AkChannelConfig  in_inputConfig,
AkChannelMask  in_uInputChanSel,
AkChannelConfig  in_outputConfig,
AkReal32  in_fCenterPerc,
AK::SpeakerVolumes::MatrixPtr  out_mxVolumes 
)
pure virtual

Compute standard 3D positioning. You may use the returned volume matrix with IAkGlobalPluginContext::MixNinNChannels.

Note: The cartesian counterpart of Compute3DPositioning, that uses emitter and listener transforms, should be used instead of this function. It is more complete and more efficient.
Note: ComputePositioning is more general than this one, as it can also compute speaker gains for non-3D spatialization, and should be favored.
Returns
AK_Success if successful, AK_Fail otherwise.
See also
IAkGlobalPluginContext
Parameters
in_fAngle Incident angle, in radians [-pi,pi], where 0 is the azimuth (positive values are clockwise).
in_fElevation Incident elevation angle, in radians [-pi/2,pi/2], where 0 is the horizon (positive values are above the horizon).
in_fSpread Spread ([0,1]).
in_fFocus Focus ([0,1]).
in_inputConfig Channel configuration of the input.
in_uInputChanSel Mask of input channels selected for panning (excluded input channels don't contribute to the output).
in_outputConfig Desired output configuration.
in_fCenterPerc Center percentage. Only applies to mono inputs to outputs that have a center.
out_mxVolumes Returned volumes matrix. Must be preallocated using AK::SpeakerVolumes::Matrix::GetRequiredSize() (see AK::SpeakerVolumes::Matrix services).

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise