GetConceptualFace

This function returns a handle to the conceptual face. Be aware that different instances can return the same handles (however with possible different startIndices and noTriangles).
Argument index should be at least zero and smaller then return value of GetConceptualFaceCnt().
Argument startIndex shows the first index used.
Argument noTriangles returns the number of triangles, each triangle is existing of 3 unique indices.

Syntax

//   Visual Studio for Windows
public:
__int64 __declspec(dllexport) __stdcall GetConceptualFace(
            __int64             owlInstance,
            __int64             index,
            __int64             * startIndexTriangles,
            __int64             * noTriangles
        );

//   Linux, OS-X and non-Visual Studio Windows solutions
public:
int64_t GetConceptualFace(
            int64_t             owlInstance,
            int64_t             index,
            int64_t             * startIndexTriangles,
            int64_t             * noTriangles
        );    

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 conceptual faces available.

Property startIndexTriangles

Size: 64 bit / 8 byte (reference)
The first index in the indices array representing a Triangle by a reference in the vertices array.

Property noTriangles

Size: 64 bit / 8 byte (reference)
This attribute is filled with the number of triangles within the given instance.