fbxlibrary.h

Go to the documentation of this file.

/****************************************************************************************
 
   Copyright (C) 2012 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_SCENE_LIBRARY_H_
#define _FBXSDK_SCENE_LIBRARY_H_

#include <fbxsdk/fbxsdk_def.h>

#include <fbxsdk/scene/fbxdocument.h>
#include <fbxsdk/scene/fbxobjectfilter.h>

#include <fbxsdk/fbxsdk_nsbegin.h>

class FbxLocalizationManager;
class FbxCriteria;

class FBXSDK_DLL FbxLibrary : public FbxDocument
{
    FBXSDK_OBJECT_DECLARE(FbxLibrary,FbxDocument);

public:
    FbxLibrary* GetParentLibrary(void) const;

    void SystemLibrary(bool pSystemLibrary);

    bool IsSystemLibrary() const;

    void LocalizationBaseNamePrefix(const char* pPrefix);

    FbxString LocalizationBaseNamePrefix() const;

    // =======================================================================
    //
    // sub-library
    //
    // =======================================================================

    bool AddSubLibrary(FbxLibrary* pSubLibrary);

    bool RemoveSubLibrary(FbxLibrary* pSubLibrary);

    int GetSubLibraryCount(void) const;

    FbxLibrary* GetSubLibrary(int pIndex) const;

    FbxObject* CloneAsset( FbxObject* pToClone, FbxObject* pOptionalDestinationContainer = NULL) const;

    
    static FbxCriteria GetAssetCriteriaFilter();

    static FbxCriteria GetAssetDependentsFilter();

    bool ImportAssets(FbxLibrary* pSrcLibrary);

    bool ImportAssets(FbxLibrary* pSrcLibrary, const FbxCriteria& pAssetFilter);


    template < class T > T* InstantiateMember( const T* pFBX_TYPE, const FbxObjectFilter& pFilter, bool pRecurse = true, FbxObject* pOptContainer = NULL);


    // =======================================================================
    //
    // Localization
    //
    // =======================================================================
    FbxLocalizationManager& GetLocalizationManager() const;

    virtual const char* Localize( const char* pID, const char* pDefault = NULL ) const;

    // =======================================================================
    //
    // Shading Object
    //
    // =======================================================================

    bool AddShadingObject(FbxObject* pShadingObject);

    bool RemoveShadingObject(FbxObject* pShadingObject);

    int GetShadingObjectCount(void) const;

    FbxObject* GetShadingObject(int pIndex) const;

    int GetShadingObjectCount(const FbxImplementationFilter& pCriteria) const;

    FbxObject* GetShadingObject(int pIndex, const FbxImplementationFilter& pCriteria) const;

//
//  WARNING!
//
//  Anything beyond these lines may not be documented accurately and is
//  subject to change without notice.
//
#ifndef DOXYGEN_SHOULD_SKIP_THIS
protected:
    // Constructor / Destructor
    FbxLibrary(FbxManager& pManager, const char* pName);

    virtual void Destruct(bool pRecursive, bool pDependents);
    virtual void Construct(const FbxLibrary* pFrom);

    mutable FbxLocalizationManager* mLocalizationManager;
#endif // #ifndef DOXYGEN_SHOULD_SKIP_THIS
};


    template < class T > T* FbxLibrary::InstantiateMember( const T* pFBX_TYPE, const FbxObjectFilter& pFilter, bool pRecurse, FbxObject* pOptContainer )
    {
        // first check all materials in the library.
        int i;
        for(i = 0; i < GetMemberCount( FBX_TYPE(T) ); ++i )
        {
            T* lObject = GetMember( FBX_TYPE(T), i );
            if( pFilter.Match(lObject) )
                return FbxCast<T>(CloneAsset(lObject,pOptContainer));
        }

        if( pRecurse )
        {
            // then check all materials in each sub-library.
            for( i = 0; i < GetMemberCount( FBX_TYPE(FbxLibrary) ); ++i )
            {
                FbxLibrary* lLibrary = GetMember( FBX_TYPE(FbxLibrary), i );
                T* lClonedObject = lLibrary->InstantiateMember( pFBX_TYPE, pFilter, pRecurse, pOptContainer );
                if( lClonedObject )
                    return lClonedObject;
            }
        }

        return NULL;
    }

//
//  WARNING!
//
//  Anything beyond these lines may not be documented accurately and is
//  subject to change without notice.
//
#ifndef DOXYGEN_SHOULD_SKIP_THIS

    class FBXSDK_DLL FbxEventPopulateSystemLibrary : public FbxEvent<FbxEventPopulateSystemLibrary>
    {
      FBXSDK_EVENT_DECLARE(FbxEventPopulateSystemLibrary)

        public:         

            FbxEventPopulateSystemLibrary(FbxLibrary* pLibrary) { mLibrary = pLibrary; }

           

            inline FbxLibrary* GetLibrary() const { return mLibrary; }
        private:
            FbxLibrary*    mLibrary;
    };

    class FBXSDK_DLL FbxEventUpdateSystemLibrary : public FbxEvent<FbxEventUpdateSystemLibrary>
    {
        FBXSDK_EVENT_DECLARE(FbxEventUpdateSystemLibrary)
        public:

            FbxEventUpdateSystemLibrary(FbxLibrary *pLibrary) { mLibrary = pLibrary; }



            inline FbxLibrary* GetLibrary() const { return mLibrary; }

        private:
                FbxLibrary*    mLibrary;
    };

#endif // #ifndef DOXYGEN_SHOULD_SKIP_THIS

    class FBXSDK_DLL FbxEventWriteLocalization : public FbxEvent<FbxEventWriteLocalization>
    {
        FBXSDK_EVENT_DECLARE(FbxEventWriteLocalization)
        public:
            FbxEventWriteLocalization(FbxLibrary* pAssetLibrary) { mAssetLibrary = pAssetLibrary; }

            inline FbxLibrary* GetLibrary() const { return mAssetLibrary; }

        private:
            FbxLibrary*    mAssetLibrary;
    };

    //
    //  WARNING!
    //
    //  Anything beyond these lines may not be documented accurately and is
    //  subject to change without notice.
    //
    #ifndef DOXYGEN_SHOULD_SKIP_THIS

    // Some assets correspond 1:1 with files containing their actual data.
    class FBXSDK_DLL FbxEventMapAssetFileToAssetObject : public FbxEvent<FbxEventMapAssetFileToAssetObject>
    {
        FBXSDK_EVENT_DECLARE(FbxEventMapAssetFileToAssetObject)
        public:

            // pFile - The asset file to query
            FbxEventMapAssetFileToAssetObject(const char* pFile) :
                mAsset(NULL),
                mFilePath( pFile )
                {}

            // listeners query this
            inline const char* GetFilePath() const { return mFilePath; }

            // listeners set this
            mutable FbxObject* mAsset;

        private:
            FbxString mFilePath;
    };

    #endif //DOXYGEN_SHOULD_SKIP_THIS

#include <fbxsdk/fbxsdk_nsend.h>

#endif /* _FBXSDK_SCENE_LIBRARY_H_ */