kfbxglobalcamerasettings.h

Go to the documentation of this file.
00001 
00004 #ifndef FBXFILESDK_KFBXPLUGINS_KFBXGLOBALCAMERASETTINGS_H
00005 #define FBXFILESDK_KFBXPLUGINS_KFBXGLOBALCAMERASETTINGS_H
00006 
00007 /**************************************************************************************
00008 
00009  Copyright (C) 2001 - 2009 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 <fbxfilesdk/components/kbaselib/kaydaradef_h.h>
00043 #include <fbxfilesdk/components/kbaselib/kaydara.h>
00044 
00045 #include <fbxfilesdk/components/kbaselib/klib/kstring.h>
00046 #include <fbxfilesdk/components/kbaselib/klib/kerror.h>
00047 
00048 #include <fbxfilesdk/fbxfilesdk_nsbegin.h>
00049 
00050 class KFbxNode;
00051 class KFbxSdkManager;
00052 class KFbxScene;
00053 class KFbxCamera;
00054 class KFbxCameraSwitcher;
00055 class KFbxGlobalCameraSettingsProperties;
00056 
00057 #define PRODUCER_PERSPECTIVE "Producer Perspective"
00058 #define PRODUCER_TOP "Producer Top"
00059 #define PRODUCER_FRONT "Producer Front"
00060 #define PRODUCER_BACK "Producer Back"
00061 #define PRODUCER_RIGHT "Producer Right"
00062 #define PRODUCER_LEFT "Producer Left"
00063 #define PRODUCER_BOTTOM "Producer Bottom"
00064 #define CAMERA_SWITCHER "Camera Switcher"
00065 
00066 
00070 class KFBX_DLL KFbxGlobalCameraSettings
00071 {
00072 
00077     public:
00085         bool SetDefaultCamera(char* pCameraName);
00086 
00090         char* GetDefaultCamera();
00091 
00093         void RestoreDefaultSettings();
00094 
00100         typedef enum
00101         {
00102             eSTANDARD,
00103             eXRAY,
00104             eMODELS_ONLY
00105         } EViewingMode;
00106 
00110         void SetDefaultViewingMode(EViewingMode pViewingMode);
00111 
00115         EViewingMode GetDefaultViewingMode();
00116 
00118 
00125 
00128         void CreateProducerCameras();
00129 
00132         void DestroyProducerCameras();
00133 
00138         bool IsProducerCamera(KFbxCamera* pCamera);
00139 
00158         KFbxCameraSwitcher* GetCameraSwitcher();
00159 
00163         void                SetCameraSwitcher(KFbxCameraSwitcher* pSwitcher);
00164 
00168         KFbxCamera* GetCameraProducerPerspective();
00169 
00173         KFbxCamera* GetCameraProducerTop();
00174 
00178         KFbxCamera* GetCameraProducerBottom();
00179 
00183         KFbxCamera* GetCameraProducerFront();
00184 
00188         KFbxCamera* GetCameraProducerBack();
00189 
00193         KFbxCamera* GetCameraProducerRight();
00194 
00198         KFbxCamera* GetCameraProducerLeft();
00199 
00201 
00205         const KFbxGlobalCameraSettings& operator=(const KFbxGlobalCameraSettings& pGlobalCameraSettings);
00206 
00212 
00216         KError& GetError();
00217 
00223         typedef enum
00224         {
00225             eNULL_PARAMETER,
00226             eUNKNOWN_CAMERA_NAME,
00227             eERROR_COUNT
00228         } EError;
00229 
00233         EError GetLastErrorID() const;
00234 
00238         const char* GetLastErrorString() const;
00239 
00241 
00243     //
00244     //  WARNING!
00245     //
00246     //  Anything beyond these lines may not be documented accurately and is
00247     //  subject to change without notice.
00248     //
00250 
00251     #ifndef DOXYGEN_SHOULD_SKIP_THIS
00252         bool CopyProducerCamera(KString pCameraName, const KFbxCamera* pCamera);
00253         int  GetProducerCamerasCount() { return 7; }
00254     private:
00255         KFbxGlobalCameraSettings(KFbxSdkManager& pManager, KFbxScene& pScene);
00256         ~KFbxGlobalCameraSettings();
00257 
00258         KFbxGlobalCameraSettingsProperties* mPH;
00259 
00260         friend class KFbxScene;
00261 
00262     #endif // #ifndef DOXYGEN_SHOULD_SKIP_THIS
00263 
00264 };
00265 
00266 #include <fbxfilesdk/fbxfilesdk_nsend.h>
00267 
00268 #endif // FBXFILESDK_KFBXPLUGINS_KFBXGLOBALCAMERASETTINGS_H
00269