Previous Topic Index Next Topic
[API function]

FSOUND_Geometry_Material_SetAttributes

Set the relfectiveness and transmittance attributes of a material.

signed char F_API FSOUND_Geometry_Material_SetAttributes(
FSOUND_MATERIAL *material,
float reflectancegain,
float reflectancefreq,
float transmittancegain,
float transmittancefreq
);

Parameters

material Pointer to a valid fsound geometry material
reflectancegain A floating point number between 0 and 1.
Reflectance gain is how much of the original signal is relfected off this
material. 0 means none of the signal is reflected, and 1 means all of it
is reflected.
reflectancefreq A floating point number between 0 and 1.
Reflectance high frequency is the level of the signals frequency that is
reflected back to the listener. 0 means no frequencies are reflected
back whereas 1 means all frequencies are reflected back.
transmittancegain A floating point number between 0 and 1.
Transmittance gain is how much of the original signal passed through this
material. 0 means none of the signal is transmitted, or passes through,
whereas 1 means all of it passes through, so it is completely transparent.
transmittancefreq A floating point number between 0 and 1.
Transmittance high frequency is the level of the signals frequency that
can pass through the material.. 0 means no frequencies are pass through
the material, whereas 1 means all frequencies are transmittable through
the material.

Return Value

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

Remarks

Attributes set, do not take affect unless FSOUND_Geometry_Material_Set is called within
the rendering of a scene.

See Also

FSOUND_Geometry_Material_Create , FSOUND_Geometry_Material_GetAttributes , FSOUND_Geometry_Material_Set

This document copyright ©Firelight Multimedia, 1999-2001. All rights reserved.
Generated Thu Sep 13 00:18:09 2001 by SourceDoc v0.10, the automated source code documenter.