Firelight Technologies FMOD Studio API

System::set3DNumListeners

Sets the number of 3D 'listeners' in the 3D sound scene. This function is useful mainly for split-screen game purposes.

C++ Syntax

FMOD_RESULT System::set3DNumListeners(
  int numlisteners
);

C Syntax

FMOD_RESULT FMOD_System_Set3DNumListeners(
  FMOD_SYSTEM *system,
  int numlisteners
);

Parameters

numlisteners

Number of listeners in the scene. Valid values are from 1-4 inclusive. Default = 1.

Return Values

If the function succeeds then the return value is FMOD_OK.
If the function fails then the return value will be one of the values defined in the FMOD_RESULT enumeration.

Remarks

If the number of listeners is set to more than 1, then panning and doppler are turned off. All sound effects will be mono. FMOD uses a 'closest sound to the listener' method to determine what should be heard in this case.

See Also

• System::get3DNumListeners
• System::set3DListenerAttributes

Version 1.03.06 Built on Apr 17, 2014