ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/util/ranimove.h
Revision: 3.4
Committed: Fri Jun 27 11:32:12 2003 UTC (19 years, 5 months ago) by schorsch
Content type: text/plain
Branch: MAIN
Changes since 3.3: +14 -1 lines
Log Message:
Instrumented headers against multiple inclusion and for use from C++.
Continued ANSIfication.

File Contents

# User Rev Content
1 schorsch 3.4 /* RCSid $Id: ranimove.h,v 3.3 2003/06/27 06:53:23 greg Exp $ */
2 greg 3.1 /*
3     * ranimove.h
4     *
5     * Radiance object animation program
6     *
7     * The main difference between this program and ranimate is that
8     * ranimove is optimized for object motion, and includes a complete
9     * blur simulation. We also have a number of clever schemes
10     * for optimizing the computation, allowing rendering time
11     * per frame and noticeable difference threshold to be specified.
12     * Parallel rendering uses multiple processors on the local host,
13     * and network rendering is not directly supported. (However, no
14     * one says you can't run ranimove on other machines at the
15     * same time; just be careful not to overlap frames.)
16     *
17     * See the ranimove(1) man page for further details.
18     */
19 schorsch 3.4 #ifndef _RAD_RANIMOVE_H_
20     #define _RAD_RANIMOVE_H_
21     #ifdef __cplusplus
22     extern "C" {
23     #endif
24    
25 greg 3.1
26     #include "ray.h"
27     #include "view.h"
28     #include "vars.h"
29     /* input variables (alphabetical by name) */
30     #define BASENAME 0 /* output image base name */
31     #define END 1 /* number of animation frames */
32     #define EXPOSURE 2 /* how to compute exposure */
33     #define HIGHQ 3 /* high quality setting */
34     #define LOWQ 4 /* low quality setting */
35     #define MBLUR 5 /* motion blur parameter */
36     #define MOVE 6 /* object movement */
37     #define OCONV 7 /* oconv options */
38     #define OCTREEF 8 /* octree file name */
39     #define RATE 9 /* frame rate (fps) */
40     #define RESOLUTION 10 /* desired final resolution */
41     #define RIF 11 /* rad input file */
42     #define VIEWFILE 12 /* animation frame views */
43    
44     #define NV_INIT 13 /* number of variables */
45    
46     #define VV_INIT { \
47     {"BASENAME", 3, 0, NULL, onevalue}, \
48     {"END", 3, 0, NULL, intvalue}, \
49     {"EXPOSURE", 3, 0, NULL, onevalue}, \
50     {"highq", 2, 0, NULL, catvalues}, \
51     {"lowq", 2, 0, NULL, catvalues}, \
52     {"MBLUR", 2, 0, NULL, fltvalue}, \
53     {"move", 2, 0, NULL, NULL}, \
54     {"oconv", 2, 0, NULL, catvalues}, \
55     {"OCTREE", 3, 0, NULL, onevalue}, \
56     {"RATE", 2, 0, NULL, fltvalue}, \
57     {"RESOLUTION", 3, 0, NULL, onevalue}, \
58     {"RIF", 3, 0, NULL, onevalue}, \
59     {"VIEWFILE", 2, 0, NULL, onevalue} \
60     }
61    
62     struct ObjMove {
63     int parent; /* parent object index */
64     char name[64]; /* object name */
65     char xf_file[128]; /* transform file name */
66     char spec[512]; /* object file or command */
67     char prio_file[128]; /* priority file name */
68     int cfm; /* current frame number */
69     char xfs[512]; /* part transform arguments */
70     MAT4 xfm; /* part transform matrix */
71     MAT4 cxfm; /* combined transform matrix */
72     MAT4 bxfm; /* transform to previous frame */
73     double prio; /* part priority */
74     double cprio; /* combined priority */
75     };
76    
77     extern int silent; /* run silently? */
78    
79     extern int quickstart; /* time initial frame as well? */
80    
81     extern int nprocs; /* number of rendering processes */
82    
83     extern int rtperfrm; /* seconds to spend per frame */
84    
85     extern double ndthresh; /* noticeable difference threshold */
86     extern int ndtset; /* did user set ndthresh? */
87    
88     extern int fbeg; /* starting frame */
89     extern int fend; /* ending frame */
90     extern int fcur; /* current frame being rendered */
91    
92     extern char lorendoptf[]; /* LQ options file */
93     extern RAYPARAMS lorendparams; /* LQ rendering parameters */
94     extern char hirendoptf[]; /* HQ options file */
95     extern RAYPARAMS hirendparams; /* HQ rendering parameters */
96     extern RAYPARAMS *curparams; /* current parameter settings */
97     extern int twolevels; /* low and high quality differ */
98    
99     extern double mblur; /* vflt(MBLUR) */
100     extern double rate; /* vflt(RATE) */
101    
102     extern char objtmpf[]; /* object temporary file */
103    
104     extern struct ObjMove *obj_move; /* object movements */
105    
106     extern int haveprio; /* high-level saliency specified */
107    
108     extern int gargc; /* global argc for printargs */
109     extern char **gargv; /* global argv for printargs */
110    
111     VIEW *getview();
112     int countviews();
113     int getmove();
114     char *getexp(), *getoctspec(), *getobjname(), *getxf();
115     double expspec_val(), obj_prio();
116     void setdefaults(), setmove(), animate(), getradfile(), setrendparams();
117     void init_frame(), filter_frame(), send_frame(), free_frame();
118     int refine_frame();
119     double getTime();
120    
121     /*************************************************************************
122     * Frame rendering stuff (defined in ranimove1.c and ranimove2.c)
123     */
124     /* enumerated accuracy map values */
125     #define ANOVAL 0 /* unevaluated pixel */
126     #define ALOWQ 1 /* single low-quality sample */
127     #define AHIGHQ 2 /* single high-quality sample */
128     #define AMIN 3 /* start of error lookup table */
129     #define ADISTANT 255 /* ray went off to infinity */
130    
131     extern double acctab[256]; /* accuracy value table */
132    
133     extern int hres, vres; /* frame resolution (fcur) */
134     extern double pixaspect; /* pixel aspect ratio */
135    
136     extern VIEW vw; /* view for this frame */
137     extern COLOR *cbuffer; /* color at each pixel */
138     extern float *zbuffer; /* depth at each pixel */
139     extern OBJECT *obuffer; /* object id at each pixel */
140     extern short *xmbuffer; /* x motion at each pixel */
141     extern short *ymbuffer; /* y motion at each pixel */
142     extern BYTE *abuffer; /* accuracy at each pixel */
143     extern BYTE *sbuffer; /* sample count per pixel */
144    
145     extern VIEW vwprev; /* last frame's view */
146     extern COLOR *cprev; /* last frame colors */
147     extern float *zprev; /* last frame depth */
148     extern OBJECT *oprev; /* last frame objects */
149     extern BYTE *aprev; /* last frame accuracy */
150    
151     extern float *cerrmap; /* conspicuous error map */
152     extern int cerrzero; /* is all of cerrmap zero? */
153     extern COLOR *val2map; /* value-squared map for variance */
154    
155     extern double frm_stop; /* when to stop rendering this frame */
156    
157     extern double hlsmax; /* maximum high-level saliency */
158    
159     #define CSF_SMN (1./0.82) /* 1/avg_tracking_efficacy */
160    
161     #define outbuffer cprev /* used to hold final output */
162     #define wbuffer zprev /* used for final filtering */
163    
164     #define fndx(x,y) ((y)*hres + (x))
165    
166     #define MO_UNK -32768 /* unknown motion value */
167    
168     #define FOV_DEG 1.0 /* foveal radius (degrees) */
169    
170     #define LOG_E1 (-0.0233) /* ln(0.977) */
171     #define errorf(i) exp(LOG_E1*((i)-AMIN))
172     #define errori(e) (int)(log(e)*(1./LOG_E1) + (AMIN+.5))
173    
174     #define NSAMPOK 5 /* samples enough for error estimation */
175    
176     #define NPINTERP 4 /* number of pixels to interpolate */
177    
178     #define ATIDIFF 7 /* error difference for time extrapolation */
179    
180     void write_map(), sample_pos(), comp_frame_error(), conspicuity();
181     int getclosest(), getambcolor(), refine_first();
182     double sample_wt(), estimaterr(), comperr();
183 schorsch 3.4
184    
185     #ifdef __cplusplus
186     }
187     #endif
188     #endif /* _RAD_RANIMOVE_H_ */
189