This function gets the individual faces including the meta data, i.e. the number of openings within this specific face.
This call is for very dedicated use, it would be more common to iterate over the individual conceptual faces.
Syntax
// Visual Studio for Windows
public:
void __declspec(dllexport) __stdcall GetFace(
__int64 owlInstance,
__int64 index,
__int64 * startIndex,
__int64 * noOpenings
);
// Linux, OS-X and non-Visual Studio Windows solutions
public:
void GetFace(
int64_t owlInstance,
int64_t index,
int64_t * startIndex,
int64_t * noOpenings
);
Property owlInstance
Size: 64 bit / 8 byte (value)
The handle to the specific instance in the design tree. The instance handle is static within one open model but is most probably different when the same instance is opened in another model. The instance is always exactly of one unique class.
Property index
Size: 64 bit / 8 byte (value)
This is the index (0 based) of the face in the set of faces available.
Property startIndex
Size: 32 bit / 4 byte (reference)
This attribute will be filled with the start index in the index array for this API call / context.
Property noOpenings
Size: 32 bit / 4 byte (reference)
The number of openings available in this specific face. It is only returned if noOpenings is non-zero, i.e. this attribute is optional.