GetFace

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

//
//   Strong typing definition
//
void            GetFace(
                        OwlInstance             owlInstance,
                        int64_t                 index,
                        int64_t                 * startIndex,
                        int64_t                 * noOpenings
                    );


//
//   Weak typing definition
//
void    __declspec(dllexport) __stdcall 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 buffer 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.