ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/util/ranimove.h
Revision: 3.9
Committed: Fri Oct 5 00:59:38 2012 UTC (10 years, 1 month ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 3.8: +2 -2 lines
Log Message:
Created pmblur2 command to compute better motion blur from ranimove runs

File Contents

# Content
1 /* RCSid $Id: ranimove.h,v 3.8 2012/09/28 22:20:49 greg Exp $ */
2 /*
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 #ifndef _RAD_RANIMOVE_H_
20 #define _RAD_RANIMOVE_H_
21
22 #include "ray.h"
23 #include "view.h"
24 #include "vars.h"
25
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29
30 /* input variables (alphabetical by name) */
31 #define BASENAME 0 /* output image base name */
32 #define END 1 /* number of animation frames */
33 #define EXPOSURE 2 /* how to compute exposure */
34 #define HIGHQ 3 /* high quality setting */
35 #define LOWQ 4 /* low quality setting */
36 #define MBLUR 5 /* motion blur parameter */
37 #define MNAME 6 /* motion vector file */
38 #define MOVE 7 /* object movement */
39 #define OCONV 8 /* oconv options */
40 #define OCTREEF 9 /* octree file name */
41 #define RATE 10 /* frame rate (fps) */
42 #define RESOLUTION 11 /* desired final resolution */
43 #define RIF 12 /* rad input file */
44 #define VIEWFILE 13 /* animation frame views */
45 #define ZNAME 14 /* depth file */
46
47 #define NV_INIT 15 /* number of variables */
48
49 #define VV_INIT { \
50 {"BASENAME", 3, 0, NULL, onevalue}, \
51 {"END", 3, 0, NULL, intvalue}, \
52 {"EXPOSURE", 3, 0, NULL, onevalue}, \
53 {"highq", 2, 0, NULL, catvalues}, \
54 {"lowq", 2, 0, NULL, catvalues}, \
55 {"MBLUR", 2, 0, NULL, fltvalue}, \
56 {"MNAME", 2, 0, NULL, onevalue}, \
57 {"move", 2, 0, NULL, NULL}, \
58 {"oconv", 2, 0, NULL, catvalues}, \
59 {"OCTREE", 3, 0, NULL, onevalue}, \
60 {"RATE", 2, 0, NULL, fltvalue}, \
61 {"RESOLUTION", 3, 0, NULL, onevalue}, \
62 {"RIF", 3, 0, NULL, onevalue}, \
63 {"VIEWFILE", 2, 0, NULL, onevalue}, \
64 {"ZNAME", 2, 0, NULL, onevalue} \
65 }
66
67 struct ObjMove {
68 int parent; /* parent object index */
69 char name[64]; /* object name */
70 char xf_file[128]; /* transform file name */
71 char spec[512]; /* object file or command */
72 char prio_file[128]; /* priority file name */
73 int cfm; /* current frame number */
74 char xfs[512]; /* part transform arguments */
75 MAT4 xfm; /* part transform matrix */
76 MAT4 cxfm; /* combined transform matrix */
77 MAT4 bxfm; /* transform to previous frame */
78 double prio; /* part priority */
79 double cprio; /* combined priority */
80 };
81
82 extern int silent; /* run silently? */
83
84 extern int quickstart; /* time initial frame as well? */
85
86 extern int nprocs; /* number of rendering processes */
87
88 extern int rtperfrm; /* seconds to spend per frame */
89
90 extern double ndthresh; /* noticeable difference threshold */
91 extern int ndtset; /* did user set ndthresh? */
92
93 extern int fbeg; /* starting frame */
94 extern int fend; /* ending frame */
95 extern int fcur; /* current frame being rendered */
96
97 extern char lorendoptf[]; /* LQ options file */
98 extern RAYPARAMS lorendparams; /* LQ rendering parameters */
99 extern char hirendoptf[]; /* HQ options file */
100 extern RAYPARAMS hirendparams; /* HQ rendering parameters */
101 extern RAYPARAMS *curparams; /* current parameter settings */
102 extern int twolevels; /* low and high quality differ */
103
104 extern double mblur; /* vflt(MBLUR) */
105 extern double rate; /* vflt(RATE) */
106
107 extern char objtmpf[]; /* object temporary file */
108
109 extern struct ObjMove *obj_move; /* object movements */
110
111 extern int haveprio; /* high-level saliency specified */
112
113 extern int gargc; /* global argc for printargs */
114 extern char **gargv; /* global argv for printargs */
115
116 /*************************************************************************
117 * Frame rendering stuff (defined in ranimove1.c and ranimove2.c)
118 */
119 /* enumerated accuracy map values */
120 #define ANOVAL 0 /* unevaluated pixel */
121 #define ALOWQ 1 /* single low-quality sample */
122 #define AHIGHQ 2 /* single high-quality sample */
123 #define AMIN 3 /* start of error lookup table */
124 #define ADISTANT 255 /* ray went off to infinity */
125
126 extern double acctab[256]; /* accuracy value table */
127
128 extern int hres, vres; /* frame resolution (fcur) */
129 extern double pixaspect; /* pixel aspect ratio */
130
131 extern VIEW vw; /* view for this frame */
132 extern COLOR *cbuffer; /* color at each pixel */
133 extern float *zbuffer; /* depth at each pixel */
134 extern OBJECT *obuffer; /* object id at each pixel */
135 extern short *xmbuffer; /* x motion at each pixel */
136 extern short *ymbuffer; /* y motion at each pixel */
137 extern uby8 *abuffer; /* accuracy at each pixel */
138 extern uby8 *sbuffer; /* sample count per pixel */
139 extern COLOR *outbuffer; /* output buffer (may equal cbuffer) */
140
141 extern VIEW vwprev; /* last frame's view */
142 extern COLOR *cprev; /* last frame colors */
143 extern float *zprev; /* last frame depth */
144 extern OBJECT *oprev; /* last frame objects */
145 extern uby8 *aprev; /* last frame accuracy */
146
147 extern float *cerrmap; /* conspicuous error map */
148 extern int cerrzero; /* is all of cerrmap zero? */
149 extern COLOR *val2map; /* value-squared map for variance */
150
151 extern double frm_stop; /* when to stop rendering this frame */
152
153 extern double hlsmax; /* maximum high-level saliency */
154
155 #define CSF_SMN (1./0.82) /* 1/avg_tracking_efficacy */
156
157 #define wbuffer zprev /* used for final filtering */
158
159 #define fndx(x,y) ((y)*hres + (x))
160
161 #define MO_UNK -32768 /* unknown motion value */
162
163 #define FOV_DEG 1.0 /* foveal radius (degrees) */
164
165 #define LOG_E1 (-0.0233) /* ln(0.977) */
166 #define errorf(i) exp(LOG_E1*((i)-AMIN))
167 #define errori(e) (int)(log(e)*(1./LOG_E1) + (AMIN+.5))
168
169 #define NSAMPOK 5 /* samples enough for error estimation */
170
171 #define NPINTERP 4 /* number of pixels to interpolate */
172
173 #define ATIDIFF 7 /* error difference for time extrapolation */
174
175 /* ranimove1.c */
176 extern void init_frame(void);
177 extern void filter_frame(void);
178 extern void send_frame(void);
179 extern void free_frame(void);
180 extern void write_map(float *mp, char *fn);
181 extern void sample_pos(double hv[2], int x, int y, int sn);
182 extern void comp_frame_error(void);
183 extern int getclosest(int *iarr, int nc, int x, int y);
184 extern int getambcolor(COLOR clr, int obj);
185 extern double sample_wt(int xo, int yo);
186 extern double estimaterr(COLOR cs, COLOR cs2, int ns, int ns0);
187 extern double comperr(int *neigh, int nc, int ns0);
188
189 /* ranimove2.c */
190 extern int refine_first();
191 extern void conspicuity(void);
192 extern int refine_frame(int pass);
193
194 /* ranimove.c */
195 extern double getTime(void);
196 extern double obj_prio(OBJECT obj);
197 extern int getmove(OBJECT obj);
198 extern char * getoctspec(int n);
199 extern double expspec_val(char *s);
200 extern char *getexp(int n); /* XXX partly duplicated function */
201 extern VIEW *getview(int n); /* XXX duplicated function */
202 double getTime();
203 /*
204 int countviews();
205 void setdefaults(),
206 void setmove(),
207 setrendparams();
208 getradfile(),
209 animate(),
210 */
211
212 #ifdef __cplusplus
213 }
214 #endif
215 #endif /* _RAD_RANIMOVE_H_ */
216