fbxpropertyhandle.h

Go to the documentation of this file.

/****************************************************************************************
 
   Copyright (C) 2013 Autodesk, Inc.
   All rights reserved.
 
   Use of this software is subject to the terms of the Autodesk license agreement
   provided at the time of installation or download, or which otherwise accompanies
   this software in either electronic or hard copy form.
 
****************************************************************************************/

#ifndef _FBXSDK_CORE_PROPERTY_HANDLE_H_
#define _FBXSDK_CORE_PROPERTY_HANDLE_H_

#include <fbxsdk/fbxsdk_def.h>

#include <fbxsdk/core/fbxconnectionpoint.h>
#include <fbxsdk/core/fbxpropertytypes.h>
#include <fbxsdk/core/fbxpropertydef.h>

#include <fbxsdk/fbxsdk_nsbegin.h>

class FbxPropertyPage;
class FbxPropertyHandle;
class FbxConnectionPointFilter;

class FBXSDK_DLL FbxPropertyHandle
{
public:

    static FbxPropertyHandle        Create();

    static FbxPropertyHandle        Create(const FbxPropertyHandle& pInstanceOf);

    static FbxPropertyHandle    Create(const char* pName, EFbxType pType=eFbxUndefined);

    static FbxPropertyHandle    Create(const char* pName, FbxPropertyHandle pTypeInfo);

    bool                        Destroy();

    FbxPropertyHandle();
    FbxPropertyHandle(const FbxPropertyHandle& pAddress);

    ~FbxPropertyHandle();


    FbxPropertyHandle(FbxPropertyPage* pPage, FbxInt pId=FBXSDK_PROPERTY_ID_ROOT);




    // Assignment
    FbxPropertyHandle& operator=(const FbxPropertyHandle& pHandle);

    bool    operator==(const FbxPropertyHandle& pHandle) const;

    bool    operator!=(const FbxPropertyHandle& pHandle) const;

    bool    Is(const FbxPropertyHandle& pHandle) const;

    bool    Valid() const;

    const char* GetName() const;
    const char* GetLabel() const;
    bool    SetLabel(const char* pLabel);

    EFbxType            GetType() const;
    FbxPropertyHandle   GetTypeInfo() const;

    // Flag management
    FbxPropertyAttr::EFlags GetFlags() const;
    
    FbxPropertyAttr::EInheritType   GetFlagsInheritType( FbxPropertyAttr::EFlags pFlags, bool pCheckReferences ) const;

    bool    ModifyFlags(FbxPropertyAttr::EFlags pFlags, bool pValue);

    bool    SetFlagsInheritType( FbxPropertyAttr::EFlags pFlags, FbxPropertyAttr::EInheritType pType );

    void*   GetUserData() const;

    bool    SetUserData(const void* pUserData);

    int     GetUserTag() const;

    bool    SetUserTag(int pUserData);


    int     AddEnumValue(const char* pStringValue);

    void    InsertEnumValue(int pIndex, const char* pStringValue);

    int     GetEnumCount();

    void    SetEnumValue(int pIndex, const char* pStringValue);

    void    RemoveEnumValue(int pIndex);

    char*   GetEnumValue(int pIndex);



    

    void    BeginCreateOrFindProperty();
    void    EndCreateOrFindProperty();

    inline bool IsRoot() const { return (mPage && (mId==0)) ? true : false; }

    bool    IsChildOf(const FbxPropertyHandle& pParent) const;

    bool    IsDescendentOf(const FbxPropertyHandle& pParent) const;

    bool    SetParent(const FbxPropertyHandle& pOther );

    FbxPropertyHandle   Add(const char* pName, const FbxPropertyHandle& pTypeInfo);

    FbxPropertyHandle   GetParent() const;

    

    FbxPropertyHandle   GetChild()  const;

    FbxPropertyHandle   GetSibling() const;

    FbxPropertyHandle   GetFirstDescendent()  const;

    FbxPropertyHandle   GetNextDescendent(const FbxPropertyHandle& pHandle) const;

    FbxPropertyHandle   Find(const char* pName, bool pCaseSensitive) const;

    FbxPropertyHandle   Find(const char* pName, const FbxPropertyHandle& pTypeInfo, bool pCaseSensitive) const;

    FbxPropertyHandle   Find(const char* pName, const char* pChildrenSeparator, bool pCaseSensitive) const;

    FbxPropertyHandle   Find(const char* pName, const char* pChildrenSeparator, const FbxPropertyHandle& pTypeInfo, bool pCaseSensitive) const;


    bool    ConnectSrc(const FbxPropertyHandle& pSrc, const FbxConnection::EType pType=FbxConnection::eDefault); 

    int     GetSrcCount(FbxConnectionPointFilter* pFilter=0) const; 

    FbxPropertyHandle   GetSrc(FbxConnectionPointFilter* pFilter=0, int pIndex=0) const; 

    bool    DisconnectSrc(const FbxPropertyHandle& pSrc);

    bool    IsConnectedSrc(const FbxPropertyHandle& pSrc);

    bool    ConnectDst(const FbxPropertyHandle& pDst, const FbxConnection::EType pType=FbxConnection::eDefault); 

    int     GetDstCount(FbxConnectionPointFilter* pFilter=0) const; 

    FbxPropertyHandle   GetDst(FbxConnectionPointFilter* pFilter=0, int pIndex=0) const; 

    bool    DisconnectDst(const FbxPropertyHandle& pDst);

    bool    IsConnectedDst(const FbxPropertyHandle& pDst);

    void    ClearConnectCache();

    void    WipeAllConnections();


    bool    HasMin() const;

    bool    GetMin(void* pValue, EFbxType pValueType) const;

    bool    SetMin(const void* pValue, EFbxType pValueType);

    template <class T> inline bool  SetMin( const T& pValue )           { return SetMin( &pValue,FbxTypeOf(pValue) ); }

    template <class T> inline T     GetMin( const T* pFBX_TYPE) const   { T lValue; GetMin( &lValue,FbxTypeOf(lValue) ); return lValue; }

    bool    HasSoftMin() const;

    bool    GetSoftMin(void* pValue, EFbxType pValueType) const;

    bool    SetSoftMin(const void* pValue, EFbxType pValueType);

    template <class T> inline bool  SetSoftMin( const T& pValue )           { return SetSoftMin( &pValue,FbxTypeOf(pValue) ); }

    template <class T> inline T     GetSoftMin( const T* pFBX_TYPE) const   { T lValue; GetSoftMin( &lValue,FbxTypeOf(lValue) ); return lValue; }

    bool    HasMax() const;

    bool    GetMax(void* pValue, EFbxType pValueType) const;

    bool    SetMax(const void* pValue, EFbxType pValueType);

    template <class T> inline bool  SetMax( const T& pValue )           { return SetMax( &pValue,FbxTypeOf(pValue) ); }

    template <class T> inline T     GetMax( const T* pFBX_TYPE) const   { T lValue; GetMax( &lValue,FbxTypeOf(lValue) ); return lValue; }

    bool    HasSoftMax() const;

    bool    GetSoftMax(void* pValue, EFbxType pValueType) const;

    bool    SetSoftMax  (const void* pValue, EFbxType pValueType);

    template <class T> inline bool  SetSoftMax( const T& pValue )           { return SetSoftMax( &pValue,FbxTypeOf(pValue) ); }

    template <class T> inline T     GetSoftMax( const T* pFBX_TYPE) const   { T lValue; GetSoftMax( &lValue,FbxTypeOf(lValue) ); return lValue; }



    FbxPropertyAttr::EInheritType   GetValueInheritType(bool pCheckReferences) const;

    bool    SetValueInheritType(FbxPropertyAttr::EInheritType pType);

    bool    GetDefaultValue(void* pValue, EFbxType pValueType) const;

    bool    Get(void* pValue, EFbxType pValueType) const;

    bool    Set(const void* pValue, EFbxType pValueType, bool pCheckValueEquality);

    template <class T> inline bool  Set( const T& pValue )          { return Set( &pValue,FbxTypeOf(pValue) ); }

    template <class T> inline T     Get( const T* pFBX_TYPE) const  { T lValue; Get( &lValue,FbxTypeOf(lValue) ); return lValue; }

public:

    void    SetPageDataPtr(void* pData);

    void*   GetPageDataPtr() const;



    bool    PushPropertiesToParentInstance();




    bool    IsAReferenceTo(void) const;

    void*   GetReferenceTo(void) const;

    bool    IsReferencedBy(void) const;

    int     GetReferencedByCount(void) const;

    void*   GetReferencedBy(int pIndex) const; 


private:
    FbxPropertyPage*    mPage;
    FbxInt              mId;

};

#include <fbxsdk/fbxsdk_nsend.h>

#endif /* _FBXSDK_CORE_PROPERTY_HANDLE_H_ */