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.


//   Visual Studio for Windows
void __declspec(dllexport) __stdcall GetFace(
            __int64             owlInstance,
            __int64             index,
            __int64             * startIndex,
            __int64             * noOpenings

//   Linux, OS-X and non-Visual Studio Windows solutions
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.