gfx/povray/camera.h

   1 /****************************************************************************
   2 *                   camera.h
   3 *
   4 *  This module contains all defines, typedefs, and prototypes for CAMERA.C.
   5 *
   6 *  from Persistence of Vision(tm) Ray Tracer
   7 *  Copyright 1996,1999 Persistence of Vision Team
   8 *---------------------------------------------------------------------------
   9 *  NOTICE: This source code file is provided so that users may experiment
  10 *  with enhancements to POV-Ray and to port the software to platforms other
  11 *  than those supported by the POV-Ray Team.  There are strict rules under
  12 *  which you are permitted to use this file.  The rules are in the file
  13 *  named POVLEGAL.DOC which should be distributed with this file.
  14 *  If POVLEGAL.DOC is not available or for more info please contact the POV-Ray
  15 *  Team Coordinator by email to team-coord@povray.org or visit us on the web at
  16 *  http://www.povray.org. The latest version of POV-Ray may be found at this site.
  17 *
  18 * This program is based on the popular DKB raytracer version 2.12.
  19 * DKBTrace was originally written by David K. Buck.
  20 * DKBTrace Ver 2.0-2.12 were written by David K. Buck & Aaron A. Collins.
  21 *
  22 *****************************************************************************/
  23
  24
  25 #ifndef CAMERA_H
  26 #define CAMERA_H
  27
  28
  29
  30 /*****************************************************************************
  31 * Global preprocessor defines
  32 ******************************************************************************/
  33
  34
  35
  36
  37 /* Available camera types. [DB 8/94] */
  38
  39 #define PERSPECTIVE_CAMERA      1
  40 #define ORTHOGRAPHIC_CAMERA     2
  41 #define FISHEYE_CAMERA          3
  42 #define ULTRA_WIDE_ANGLE_CAMERA 4
  43 #define OMNIMAX_CAMERA          5
  44 #define PANORAMIC_CAMERA        6
  45 #define CYL_1_CAMERA            7
  46 #define CYL_2_CAMERA            8
  47 #define CYL_3_CAMERA            9
  48 #define CYL_4_CAMERA           10
  49
  50
  51
  52 /*****************************************************************************
  53 * Global typedefs
  54 ******************************************************************************/
  55
  56 typedef struct Camera_Struct CAMERA;
  57
  58 struct Camera_Struct
  59 {
  60   VECTOR Location;
  61   VECTOR Direction;
  62   VECTOR Up;
  63   VECTOR Right;
  64   VECTOR Sky;
  65   VECTOR Look_At;                /* Used only to record the user's preference */
  66   DBL Focal_Distance, Aperture;  /* ARE 9/92 for focal blur.           */
  67   int Blur_Samples;              /* ARE 9/92 for focal blur.           */
  68   DBL Confidence;                /* Probability for confidence test.   */
  69   DBL Variance;                  /* Max. variance for confidence test. */
  70   int Type;                      /* Camera type.                       */
  71   DBL Angle;                     /* Viewing angle.                     */
  72   TNORMAL *Tnormal;              /* Primary ray pertubation.           */
  73 };
  74
  75
  76
  77 /*****************************************************************************
  78 * Global variables
  79 ******************************************************************************/
  80
  81
  82
  83
  84 /*****************************************************************************
  85 * Global functions
  86 ******************************************************************************/
  87
  88 void Translate_Camera (CAMERA *Cm, VECTOR Vector);
  89 void Rotate_Camera (CAMERA *Cm, VECTOR Vector);
  90 void Scale_Camera (CAMERA *Cm, VECTOR Vector);
  91 void Transform_Camera (CAMERA *Cm, TRANSFORM *Trans);
  92 CAMERA *Copy_Camera (CAMERA *Old);
  93 CAMERA *Create_Camera (void);
  94 void Destroy_Camera (CAMERA *Cm);
  95
  96
  97 #endif