GetConceptualFaceDiscriminatorW

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 wchar_t   * GetConceptualFaceDiscriminatorW(
                        OwlInstance             owlInstance,
                        int64_t                 index,
                        const wchar_t           ** name
                    );

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

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


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

static  inline  const wchar_t   * GetConceptualFaceDiscriminatorW(
                                        int64_t                 owlInstance,
                                        int64_t                 index,
                                        wchar_t                 ** name
                                    )
{
    return  GetConceptualFaceDiscriminatorW(
                    owlInstance,
                    index,
                    (const wchar_t**) name
                );
}

static  inline  const wchar_t   * GetConceptualFaceDiscriminatorW(
                                        int64_t                 owlInstance,
                                        int64_t                 index
                                    )
{
    return  GetConceptualFaceDiscriminatorW(
                    owlInstance,
                    index,
                    (const wchar_t**) 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: 32 bit / 4 byte (reference)
???.