kfbxwriter.h

Go to the documentation of this file.
00001 
00004 #ifndef _FBXSDK_WRITER_H_
00005 #define _FBXSDK_WRITER_H_
00006 
00007 /**************************************************************************************
00008 
00009  Copyright © 2001 - 2007 Autodesk, Inc. and/or its licensors.
00010  All Rights Reserved.
00011 
00012  The coded instructions, statements, computer programs, and/or related material
00013  (collectively the "Data") in these files contain unpublished information
00014  proprietary to Autodesk, Inc. and/or its licensors, which is protected by
00015  Canada and United States of America federal copyright law and by international
00016  treaties.
00017 
00018  The Data may not be disclosed or distributed to third parties, in whole or in
00019  part, without the prior written consent of Autodesk, Inc. ("Autodesk").
00020 
00021  THE DATA IS PROVIDED "AS IS" AND WITHOUT WARRANTY.
00022  ALL WARRANTIES ARE EXPRESSLY EXCLUDED AND DISCLAIMED. AUTODESK MAKES NO
00023  WARRANTY OF ANY KIND WITH RESPECT TO THE DATA, EXPRESS, IMPLIED OR ARISING
00024  BY CUSTOM OR TRADE USAGE, AND DISCLAIMS ANY IMPLIED WARRANTIES OF TITLE,
00025  NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR USE.
00026  WITHOUT LIMITING THE FOREGOING, AUTODESK DOES NOT WARRANT THAT THE OPERATION
00027  OF THE DATA WILL BE UNINTERRUPTED OR ERROR FREE.
00028 
00029  IN NO EVENT SHALL AUTODESK, ITS AFFILIATES, PARENT COMPANIES, LICENSORS
00030  OR SUPPLIERS ("AUTODESK GROUP") BE LIABLE FOR ANY LOSSES, DAMAGES OR EXPENSES
00031  OF ANY KIND (INCLUDING WITHOUT LIMITATION PUNITIVE OR MULTIPLE DAMAGES OR OTHER
00032  SPECIAL, DIRECT, INDIRECT, EXEMPLARY, INCIDENTAL, LOSS OF PROFITS, REVENUE
00033  OR DATA, COST OF COVER OR CONSEQUENTIAL LOSSES OR DAMAGES OF ANY KIND),
00034  HOWEVER CAUSED, AND REGARDLESS OF THE THEORY OF LIABILITY, WHETHER DERIVED
00035  FROM CONTRACT, TORT (INCLUDING, BUT NOT LIMITED TO, NEGLIGENCE), OR OTHERWISE,
00036  ARISING OUT OF OR RELATING TO THE DATA OR ITS USE OR ANY OTHER PERFORMANCE,
00037  WHETHER OR NOT AUTODESK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS
00038  OR DAMAGE.
00039 
00040 **************************************************************************************/
00041 
00042 #include <kaydaradef.h>
00043 
00044 #ifndef KFBX_DLL
00045     #define KFBX_DLL K_DLLIMPORT
00046 #endif
00047 
00048 
00049 #include <klib/kerror.h>
00050 #include <klib/kstring.h>
00051 #include <klib/karrayul.h>
00052 
00053 #include <kbaselib_forward.h>
00054 #ifndef MB_FBXSDK
00055 #include <kbaselib_nsuse.h>
00056 #endif
00057 #include <kfbxplugins/kfbxrenamingstrategy.h>
00058 
00059 #include <fbxfilesdk_nsbegin.h>
00060 
00061 class KFbxNode;
00062 class KFbxScene;
00063 class KFbxSdkManager;
00064 class KFbxExporter;
00065 class KFbxStreamOptions;
00066 
00067 class KFBX_DLL KFbxWriter
00068 {
00069 
00070 public:
00071 
00072     KFbxWriter(KFbxSdkManager& pManager);
00073     virtual ~KFbxWriter();
00074 
00075     virtual bool FileCreate(char* pFileName) = 0;
00076     virtual bool FileClose() = 0;
00077     virtual bool IsFileOpen() = 0;
00078 
00079     virtual KFbxStreamOptions* GetWriteOptions() = 0;
00080     virtual bool Write(KFbxScene &pScene, KFbxStreamOptions* pStreamOptions) = 0;
00081     
00082     virtual bool PreprocessScene(KFbxScene &pScene) = 0;
00083     virtual bool PostprocessScene(KFbxScene &pScene) = 0;
00084     
00085     bool SetFileExportVersion(KString pVersion);
00086     
00087     void SetRenamingMode(KFbxSceneRenamer::ERenamingMode pRenamingMode){mRenamingMode = pRenamingMode;}
00088     inline void SetResamplingRate(double pResamplingRate){mResamplingRate = pResamplingRate;}
00089 
00091     typedef enum 
00092     {
00093         eFILE_CORRUPTED,
00094         eFILE_NOT_OPENED,
00095         eFILE_NOT_CREATED,
00096         eOUT_OF_DISK_SPACE,
00097         eSTREAM_OPTIONS_NOT_SET,
00098         eUNIDENTIFIED_ERROR,
00099         eEMBEDDED_OUT_OF_SPACE,
00100         eERROR_COUNT
00101     } EError;
00102 
00103     KError&  GetError();
00104     EError   GetLastErrorID();
00105     char* GetLastErrorString();
00106 
00107     void     GetMessage(KString &pMessage);
00108     void     ClearMessage();
00109 
00110     
00111     KFbxWriter& operator=(KFbxWriter const&) { return *this; }
00112     virtual KFbxNode* FindRootNode(KFbxScene& pScene);
00113     virtual bool CheckSpaceInNodeNameRecursive(KFbxNode* pNode, KString& pNodeNameList);
00114     
00115     typedef KFbxWriter* (*CreateFuncType)(KFbxSdkManager& pManager, 
00116                                           KFbxExporter& pExporter,
00117                                           int pID);
00118     
00119     enum KInfoRequest {
00120         eInfoExtension, // return a null terminated char const* const*
00121         eInfoDescriptions, // return a null terminated char const* const*
00122         eInfoVersions, // return a null terminated char const* const*
00123         eReserved1 = 0xFBFB,
00124     };
00125     
00126     typedef void* (*GetInfoFuncType)(KInfoRequest pRequest, int pWriterTypeId);
00127 
00128 protected:
00129     KFbxSdkManager& mManager;
00130     KError mError;
00131 
00132     KString         mMessage;
00133     KString mFileVersion;
00134     double  mResamplingRate;
00135     KFbxSceneRenamer::ERenamingMode mRenamingMode;
00136 };
00137 
00138 #include <fbxfilesdk_nsend.h>
00139 
00140 #endif // #ifndef _FBXSDK_WRITER_H_
00141 
00142