| 1 |
/* RCSid $Id: view.h,v 2.22 2022/01/12 21:07:39 greg Exp $ */ |
| 2 |
/* |
| 3 |
* view.h - header file for image generation. |
| 4 |
* |
| 5 |
* Include after stdio.h and rtmath.h |
| 6 |
* Includes resolu.h |
| 7 |
*/ |
| 8 |
#ifndef _RAD_VIEW_H_ |
| 9 |
#define _RAD_VIEW_H_ |
| 10 |
|
| 11 |
#include "resolu.h" |
| 12 |
|
| 13 |
#ifdef __cplusplus |
| 14 |
extern "C" { |
| 15 |
#endif |
| 16 |
|
| 17 |
/* view types */ |
| 18 |
#define VT_PER 'v' /* perspective */ |
| 19 |
#define VT_PAR 'l' /* parallel */ |
| 20 |
#define VT_ANG 'a' /* angular fisheye */ |
| 21 |
#define VT_HEM 'h' /* hemispherical fisheye */ |
| 22 |
#define VT_PLS 's' /* planispheric fisheye */ |
| 23 |
#define VT_CYL 'c' /* cylindrical panorama */ |
| 24 |
|
| 25 |
typedef struct { |
| 26 |
int type; /* view type */ |
| 27 |
FVECT vp; /* view origin */ |
| 28 |
FVECT vdir; /* view direction */ |
| 29 |
FVECT vup; /* view up */ |
| 30 |
double vdist; /* view distance */ |
| 31 |
double horiz; /* horizontal view size */ |
| 32 |
double vert; /* vertical view size */ |
| 33 |
double hoff; /* horizontal image offset */ |
| 34 |
double voff; /* vertical image offset */ |
| 35 |
double vfore; /* fore clipping plane */ |
| 36 |
double vaft; /* aft clipping plane (<=0 for inf) */ |
| 37 |
FVECT hvec; /* computed horizontal image vector */ |
| 38 |
FVECT vvec; /* computed vertical image vector */ |
| 39 |
double hn2; /* DOT(hvec,hvec) */ |
| 40 |
double vn2; /* DOT(vvec,vvec) */ |
| 41 |
} VIEW; /* view parameters */ |
| 42 |
|
| 43 |
extern VIEW stdview; |
| 44 |
|
| 45 |
#define viewaspect(v) sqrt((v)->vn2/(v)->hn2) |
| 46 |
|
| 47 |
#define STDVIEW {VT_PER,{0.,0.,0.},{0.,1.,0.},{0.,0.,1.}, \ |
| 48 |
1.,45.,45.,0.,0.,0.,0., \ |
| 49 |
{0.,0.,0.},{0.,0.,0.},0.,0.} |
| 50 |
|
| 51 |
#define VIEWSTR "VIEW=" |
| 52 |
#define VIEWSTRL 5 |
| 53 |
|
| 54 |
/* return values/flags for viewloc() */ |
| 55 |
#define VL_BAD 0 /* illegal position (i.e. origin) */ |
| 56 |
#define VL_GOOD 0x1 /* result is valid */ |
| 57 |
#define VL_BEHIND 0x2 /* world point is behind fore plane */ |
| 58 |
#define VL_OUTSIDE 0x4 /* world point is outside frustum */ |
| 59 |
#define VL_BEYOND 0x8 /* point is beyond aft clipping plane */ |
| 60 |
|
| 61 |
extern char *progname; /* global argv[0] */ |
| 62 |
extern char *fixargv0(char *arg0); |
| 63 |
extern char *setview(VIEW *v); |
| 64 |
extern char *cropview(VIEW *v, double x0, double y0, double x1, double y1); |
| 65 |
extern void normaspect(double va, double *ap, int *xp, int *yp); |
| 66 |
extern double viewray(FVECT orig, FVECT direc, VIEW *v, double x, double y); |
| 67 |
extern int jitteraperture(FVECT orig, FVECT direc, VIEW *v, double dia); |
| 68 |
extern int viewloc(FVECT ip, VIEW *v, FVECT p); |
| 69 |
extern void pix2loc(RREAL loc[2], RESOLU *rp, int px, int py); |
| 70 |
extern void loc2pix(int pp[2], RESOLU *rp, double lx, double ly); |
| 71 |
extern int getviewopt(VIEW *v, int ac, char *av[]); |
| 72 |
extern int sscanview(VIEW *vp, char *s); |
| 73 |
extern void fprintview(VIEW *vp, FILE *fp); |
| 74 |
extern char *viewopt(VIEW *vp); |
| 75 |
extern int isview(char *s); |
| 76 |
extern int viewfile(char *fname, VIEW *vp, RESOLU *rp); |
| 77 |
|
| 78 |
|
| 79 |
#ifdef __cplusplus |
| 80 |
} |
| 81 |
#endif |
| 82 |
#endif /* _RAD_VIEW_H_ */ |
| 83 |
|
