Previous Topic Index Next Topic
[API function]

FSOUND_Geometry_List_Create

Creates a new empty geometry list. Geometry lists are an optimization. Instead of
rebuilding the audio scene every frame with FSOUND_Geometry_AddPolygon, you can first
pre-build a list, and then use 1 call to FSOUND_Geometry_AddList which is in the
soundsystem's native format. The only downside is that the scene is not totally dynamic.
It is able to have some dynamics in that pointers set up with
FSOUND_GEOMETRY_OPENING_REFERENCE are still able to have their opening factors changed,
so you can open and close doors etc.
You can create multiple lists and add them into the audio scene without reasonable
limitation.

FSOUND_GEOMLIST * F_API FSOUND_Geometry_List_Create(
signed char boundingvolume
);

Parameters

geomlist Pointer to a valid geometry list
boudingvolume TRUE or FALSE. This specifies whether a bounding box optimization should
be calaculated as the list is created. Using this enables trivial acceptance
and rejection of lists, which can increase polygon throughputs dramatically.
It is enabled as an option in case the user wants to use their own rejection
techniques.

Return Value

On success, a pointer to a newly created Geometry list is returned.
On failure, NULL is returned.

Remarks

See Also

FSOUND_Geometry_AddList , FSOUND_Geometry_AddPolygon , FSOUND_Geometry_List_Begin , FSOUND_Geometry_List_End , FSOUND_Geometry_List_Free

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.