camera.h Source File

00001 /*
00002     Copyright (C) 1998-2001 by Jorrit Tyberghein
00003 
00004     This library is free software; you can redistribute it and/or
00005     modify it under the terms of the GNU Library General Public
00006     License as published by the Free Software Foundation; either
00007     version 2 of the License, or (at your option) any later version.
00008 
00009     This library is distributed in the hope that it will be useful,
00010     but WITHOUT ANY WARRANTY; without even the implied warranty of
00011     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012     Library General Public License for more details.
00013 
00014     You should have received a copy of the GNU Library General Public
00015     License along with this library; if not, write to the Free
00016     Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
00017 */
00018 
00019 #ifndef __IENGINE_CAMERA_H__
00020 #define __IENGINE_CAMERA_H__
00021 
00022 #include "csutil/scf.h"
00023 #include "csgeom/transfrm.h"
00024 
00025 #define CS_VEC_FORWARD   csVector3(0,0,1)
00026 #define CS_VEC_BACKWARD  csVector3(0,0,-1)
00027 #define CS_VEC_RIGHT     csVector3(1,0,0)
00028 #define CS_VEC_LEFT      csVector3(-1,0,0)
00029 #define CS_VEC_UP        csVector3(0,1,0)
00030 #define CS_VEC_DOWN      csVector3(0,-1,0)
00031 
00032 #define CS_VEC_ROT_RIGHT  csVector3(0,1,0)
00033 #define CS_VEC_ROT_LEFT   csVector3(0,-1,0)
00034 #define CS_VEC_TILT_RIGHT (-csVector3(0,0,1))
00035 #define CS_VEC_TILT_LEFT  (-csVector3(0,0,-1))
00036 #define CS_VEC_TILT_UP    (-csVector3(1,0,0))
00037 #define CS_VEC_TILT_DOWN  (-csVector3(-1,0,0))
00038 
00039 class csCamera;
00040 class csVector3;
00041 class csVector2;
00042 struct iSector;
00043 struct iPolygon3D;
00044 
00045 SCF_VERSION (iCamera, 0, 2, 0);
00046 
00070 struct iCamera : public iBase
00071 {
00073   virtual iCamera *Clone () const = 0;
00074 
00076   virtual int GetFOV () const = 0;
00078   virtual float GetInvFOV () const = 0;
00080   virtual float GetFOVAngle () const = 0;
00081 
00086   virtual void SetFOV (int fov, int width) = 0;
00091   virtual void SetFOVAngle (float fov, int width) = 0;
00092 
00097   virtual float GetShiftX () const = 0;
00102   virtual float GetShiftY () const = 0;
00107   virtual void SetPerspectiveCenter (float x, float y) = 0;
00108 
00117   virtual csOrthoTransform& GetTransform () = 0;
00118 
00120   virtual const csOrthoTransform& GetTransform () const = 0;
00121 
00126   virtual void SetTransform (const csOrthoTransform& tr) = 0;
00127 
00134   virtual void MoveWorld (const csVector3& v, bool cd = true) = 0;
00138   virtual void Move (const csVector3& v, bool cd = true) = 0;
00146   virtual void MoveWorldUnrestricted (const csVector3& v) = 0;
00154   virtual void MoveUnrestricted (const csVector3& v) = 0;
00155 
00157   virtual iSector* GetSector () const = 0;
00159   virtual void SetSector (iSector*) = 0;
00160 
00165   virtual void Correct (int n) = 0;
00166 
00168   virtual bool IsMirrored () const = 0;
00170   virtual void SetMirrored (bool m) = 0;
00171 
00178   virtual iPolygon3D* GetHit (csVector3& v) = 0;
00179 
00186   virtual csPlane3* GetFarPlane () const = 0;
00187 
00196   virtual void SetFarPlane (csPlane3* fp) = 0;
00197 
00204   virtual long GetCameraNumber () const = 0;
00205 
00207   virtual void Perspective (const csVector3& v, csVector2& p) const = 0;
00209   virtual void InvPerspective (const csVector2& p, float z,
00210         csVector3& v) const = 0;
00211 
00219   virtual void OnlyPortals (bool hop) = 0;
00220 
00222   virtual bool GetOnlyPortals () = 0;
00223 };
00224 
00225 #endif
00226