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 #include <fbxfilesdk/fbxfilesdk_def.h>
00042 
00043 #include <fbxfilesdk/components/kbaselib/klib/kstring.h>
00044 #include <fbxfilesdk/components/kbaselib/klib/kerror.h>
00045 
00046 #include <fbxfilesdk/fbxfilesdk_nsbegin.h>
00047 
00048 class KFbxNode;
00049 class KFbxSdkManager;
00050 class KFbxScene;
00051 class KFbxCamera;
00052 class KFbxCameraSwitcher;
00053 class KFbxGlobalCameraSettingsProperties;
00054 
00055 #define PRODUCER_PERSPECTIVE "Producer Perspective"
00056 #define PRODUCER_TOP "Producer Top"
00057 #define PRODUCER_FRONT "Producer Front"
00058 #define PRODUCER_BACK "Producer Back"
00059 #define PRODUCER_RIGHT "Producer Right"
00060 #define PRODUCER_LEFT "Producer Left"
00061 #define PRODUCER_BOTTOM "Producer Bottom"
00062 #define CAMERA_SWITCHER "Camera Switcher"
00063 
00064 
00071 class KFBX_DLL KFbxGlobalCameraSettings
00072 {
00073     KFBXNEW_DECLARE_FRIEND
00078     public:
00086         bool SetDefaultCamera(char* pCameraName);
00087 
00091         char* GetDefaultCamera() const;
00092 
00094         void RestoreDefaultSettings();
00095 
00101         typedef enum
00102         {
00103             eSTANDARD,
00104             eXRAY,
00105             eMODELS_ONLY
00106         } EViewingMode;
00107 
00111         void SetDefaultViewingMode(EViewingMode pViewingMode);
00112 
00116         EViewingMode GetDefaultViewingMode() const;
00117 
00119 
00126 
00129         void CreateProducerCameras();
00130 
00133         void DestroyProducerCameras();
00134 
00139         bool IsProducerCamera(KFbxCamera* pCamera) const;
00140 
00155         KFbxCameraSwitcher* GetCameraSwitcher() const;
00156 
00160         void                SetCameraSwitcher(KFbxCameraSwitcher* pSwitcher);
00161 
00165         KFbxCamera* GetCameraProducerPerspective() const;
00166 
00170         KFbxCamera* GetCameraProducerTop() const;
00171 
00175         KFbxCamera* GetCameraProducerBottom() const;
00176 
00180         KFbxCamera* GetCameraProducerFront() const;
00181 
00185         KFbxCamera* GetCameraProducerBack() const;
00186 
00190         KFbxCamera* GetCameraProducerRight() const;
00191 
00195         KFbxCamera* GetCameraProducerLeft() const;
00196 
00198 
00202         const KFbxGlobalCameraSettings& operator=(const KFbxGlobalCameraSettings& pGlobalCameraSettings);
00203 
00209 
00213         KError& GetError();
00214 
00220         typedef enum
00221         {
00222             eNULL_PARAMETER,
00223             eUNKNOWN_CAMERA_NAME,
00224             eERROR_COUNT
00225         } EError;
00226 
00230         EError GetLastErrorID() const;
00231 
00235         const char* GetLastErrorString() const;
00236 
00238 
00240     //
00241     //  WARNING!
00242     //
00243     //  Anything beyond these lines may not be documented accurately and is
00244     //  subject to change without notice.
00245     //
00247 
00248     #ifndef DOXYGEN_SHOULD_SKIP_THIS
00249         bool CopyProducerCamera(KString pCameraName, const KFbxCamera* pCamera) const;
00250         int  GetProducerCamerasCount() const { return 7; }
00251     private:
00252         KFbxGlobalCameraSettings(KFbxSdkManager& pManager, KFbxScene& pScene);
00253         ~KFbxGlobalCameraSettings();
00254 
00255         KFbxGlobalCameraSettingsProperties* mPH;
00256 
00257         friend class KFbxScene;
00258 
00259     #endif // #ifndef DOXYGEN_SHOULD_SKIP_THIS
00260 
00261 };
00262 
00263 #include <fbxfilesdk/fbxfilesdk_nsend.h>
00264 
00265 #endif // FBXFILESDK_KFBXPLUGINS_KFBXGLOBALCAMERASETTINGS_H
00266