GetConceptualFaceDiscriminator

This function returns a unique name for the conceptualFace.
The name will be the same for each recalculation of the geometry.
The return value (and optional argument name) have a valid content till the next call of this
function or till the model is closed.

Note: This allows to keep track of conceptual faces if te number of conceptual faces changes.

For example in case of a boolean operation where the type of placement of objects is changing.

Syntax

C++ 32 bit

C++ 64 bit

C# 32 bit

C# 64 bit

//
//   Strong typing definition
//
const char      * GetConceptualFaceDiscriminator(
                        OwlInstance             owlInstance,
                        int64_t                 index,
                        const char              ** name
                    );

static  inline  const char  * GetConceptualFaceDiscriminator(
                                    OwlInstance             owlInstance,
                                    int64_t                 index,
                                    char                    ** name
                                )
{
    return  GetConceptualFaceDiscriminator(
                    owlInstance,
                    index,
                    (const char**) name
                );
}

static  inline  const char  * GetConceptualFaceDiscriminator(
                                    OwlInstance             owlInstance,
                                    int64_t                 index
                                )
{
    return  GetConceptualFaceDiscriminator(
                    owlInstance,
                    index,
                    (const char**) nullptr              //    name
                );
}


//
//   Weak typing definition
//
const char  __declspec(dllexport) * __stdcall   GetConceptualFaceDiscriminator(
                                                        int64_t                 owlInstance,
                                                        int64_t                 index,
                                                        const char              ** name
                                                    );

static  inline  const char  * GetConceptualFaceDiscriminator(
                                    int64_t                 owlInstance,
                                    int64_t                 index,
                                    char                    ** name
                                )
{
    return  GetConceptualFaceDiscriminator(
                    owlInstance,
                    index,
                    (const char**) name
                );
}

static  inline  const char  * GetConceptualFaceDiscriminator(
                                    int64_t                 owlInstance,
                                    int64_t                 index
                                )
{
    return  GetConceptualFaceDiscriminator(
                    owlInstance,
                    index,
                    (const char**) nullptr              //    name
                );
}

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 name

Size: 64 bit / 8 byte (reference)
???.