FSOUND_3D_SetAttributes

##### [API function]

## 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

### See Also

FSOUND_3D_GetAttributes , FSOUND_3D_GetMinMaxDistance , FSOUND_3D_Listener_GetAttributes , FSOUND_3D_Listener_SetAttributes , FSOUND_3D_Listener_SetCurrent , FSOUND_3D_SetAttributes , FSOUND_3D_SetDistanceFactor , FSOUND_3D_SetMinMaxDistance , FSOUND_3D_SetRolloffFactor , FSOUND_Sample_SetMinMaxDistance , FSOUND_Update

This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Thu Dec 15 17:31:27 2005 by SourceDoc v0.10, the automated source code documenter.