AXART_3D

C Specification

#include <revolution.h>
#include <revolution/axart.h>
typedef struct
{
    AXART_ART   art;

    // runtime user parameters

    f32         hAngle;         // horizontal angle
    f32         vAngle;         // vertical angle
    f32         dist;           // distance from listener
    f32         closingSpeed;   // for Doppler
    u32         update;         // set to true after changing parameters

    // do not write to these parameters

    u8          pan;
    u8          span;
    u8          src;
    u16         itdL;
    u16         itdR;
    f32         pitch;
    s32         attenuation;

} AXART_3D;

Description

AXART_3D is a data structure that describes a 3D sound articulator. This articulator will place an AXART_SOUND in 3D space. Do not use this articulator sound in conjunction with AXART_PANNING or AXART_ITD. For the AXART_3D structure, you must call AXARTInitArt3D() prior to calling AXARTAddArticulator().

Data Member Description
AXART_ART art AXART articulator descriptor maintained by AXART. Do not write to this parameter.
f32 hAngle Horizontal angle for the sound source relative to the camera. Units are in radians.
f32 vAngle Vertical angle for the sound source relative to the camera. Units are in radians.
f32 dist Distance for the sound source relative to the camera.
f32 closingSpeed Closing speed for the sound source relative to the camera.
u32 update Set to TRUE after changing hAngle, vAngle, dist, or closingSpeed. This causes AXART to update the sound source position, pitch, and volume.
u8 pan AXART generated pan value. Do not write to this parameter.
u8 span AXART generated span value. Do not write to this parameter.
u8 src AXART generated SRC type. Do not write to this parameter.
u16 itdL AXART generated ITD. Do not write to this parameter.
u16 itdR AXART generated ITD. Do not write to this parameter.
f32 pitch AXART generated pitch. Do not write to this parameter.
s32 attenuation AXART generated volume attenuation. Do not write to this parameter.

See Also

AXARTSet3DDistanceScale
AXARTSet3DDopplerScale
AXARTInitArt3D
AXARTAddArticulator
AXART_PANNING
AXART_ITD
AXART_ART
AXART_SOUND

Revision History

2006/03/01 Initial version.

CONFIDENTIAL