| 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 |
|
| 140 |
extern VIEW vwprev; /* last frame's view */ |
| 141 |
extern COLOR *cprev; /* last frame colors */ |
| 142 |
extern float *zprev; /* last frame depth */ |
| 143 |
extern OBJECT *oprev; /* last frame objects */ |
| 144 |
extern uby8 *aprev; /* last frame accuracy */ |
| 145 |
|
| 146 |
extern float *cerrmap; /* conspicuous error map */ |
| 147 |
extern int cerrzero; /* is all of cerrmap zero? */ |
| 148 |
extern COLOR *val2map; /* value-squared map for variance */ |
| 149 |
|
| 150 |
extern double frm_stop; /* when to stop rendering this frame */ |
| 151 |
|
| 152 |
extern double hlsmax; /* maximum high-level saliency */ |
| 153 |
|
| 154 |
#define CSF_SMN (1./0.82) /* 1/avg_tracking_efficacy */ |
| 155 |
|
| 156 |
#define outbuffer cprev /* used to hold final output */ |
| 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 |
|
