FSOUND_3D_SetAttributes

This updates the position and velocity of a 3d sound playing on a channel.

signed char F_API FSOUND_3D_SetAttributes(
int channel,
const F_FLOAT_API *pos,
const F_FLOAT_API *vel
);

Parameters

channel	Channel you want to apply 3d positioning to.
pos	Pointer to a position vector (xyz float triplet) of the emitter in world space, measured in distance units. This can be NULL to ignore it.
vel	Pointer to a velocity vector (xyz float triplet), of the emitter measured in distance units PER SECOND. This can be NULL to ignore it.

Return Value

On success, TRUE is returned.
On failure, FALSE is returned.

Remarks

FSOUND treats +X as right, +Y as up, and +Z as forwards.
---------
A 'distance unit' is specified by FSOUND_3D_SetDistanceFactor. By default this is set to meters which is a distance scale of 1.0.
See FSOUND_3D_SetDistanceFactor for more on this.
---------
FSOUND vectors expect 3 floats representing x y and z in that order. I.e. a typical definition
of a vector is
typedef struct
{
float x;
float y;
float z;
} VECTOR;
or simply an array of 3 floats.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

[API function]