![]() |
![]() ![]() ![]() |
signed char F_API FSOUND_Geometry_AddPolygon(
float *p1,
float *p2,
float *p3,
float *p4,
float *normal,
unsigned int mode,
float *openingfactor
);
p1 | Pointer to the polygons vertex. This must be a pointer to an array of 3 floats. This value cannot be NULL. |
p2 | Pointer to the polygons vertex. This must be a pointer to an array of 3 floats. This value cannot be NULL. |
p3 | Pointer to the polygons vertex. This must be a pointer to an array of 3 floats. This value cannot be NULL. |
p4 | Pointer to the polygons vertex. This must be a pointer to an array of 3 floats. This CAN be NULL, if you are specifying a triangle and not a quad. |
normal | Pointer to the polygons vertex. This must be a pointer to an array of 3 floats. This value CAN be NULL. If it is, then a nomral is computed based for you. This is only to save time computing a normal internally, it does not matter which direction it faces. (ie what winding) |
mode | This is a setting of bits defined by FSOUND_GEOMETRY_MODES to determine what type of polygon it is, ie reflective or an opening for example. |
openingfactor | Pointer to a polygon opening factor. This value is only relevant if FSOUND_GEOMETRY_OPENING or FSOUND_GEOMETRY_OPENING_REFERENCE is supplied, and is ignored otherwise. Valid ranges are and from 0 to 1. 0 is closed, 1 is fully open. Remember that FSOUND_GEOMETRY_OPENING is only relevant to the previous polygon. if this value is NULL, then this polygon is discarded and there is no hole. |