Homec4science
Diffusion RADIANCE Photon Map (pmapmerge) Browse

RadiancePmap/pmapopt.c
593b23987c45pmapmerge

Last Change
Raw File

pmapopt.c
View Options

#ifndef lint
static const char RCSid[] = "$Id: pmapopt.c,v 2.10 2020/06/15 22:18:57 rschregle Exp $";
#endif
/*
==================================================================
Photon map interface to RADIANCE render options
Roland Schregle (roland.schregle@{hslu.ch, gmail.com})
(c) Fraunhofer Institute for Solar Energy Systems,
supported by the German Research Foundation
(DFG LU-204/10-2, "Fassadenintegrierte Regelsysteme" (FARESYS))
(c) Lucerne University of Applied Sciences and Arts,
supported by the Swiss National Science Foundation
(SNSF #147053, "Daylight Redirecting Components")
(c) Tokyo University of Science,
supported by the JSPS Grants-in-Aid for Scientific Research
(KAKENHI JP19KK0115, "Three-Dimensional Light Flow")
==================================================================
$Id: pmapopt.c,v 2.10 2020/06/15 22:18:57 rschregle Exp $
*/
#include "ray.h"
#include "pmapparm.h"
int getPmapRenderOpt (int ac, char *av [])
/* Parse next render option for photon map; interface to getrenderopt();
* return -1 if parsing failed, else number of parameters consumed */
{
#define check(ol,al) (av[0][ol] || badarg(ac-1,av+1,al))
/* Evaluate boolean option, setting var accordingly */
#define check_bool(olen, var) switch (av [0][olen]) { \
case '\0': \
var = !var; break; \
case 'y': case 'Y': case 't': case 'T': case '+': case '1': \
var = 1; break; \
case 'n': case 'N': case 'f': case 'F': case '-': case '0': \
var = 0; break; \
default: \
return -1; \
}
static int t = -1; /* pmap parameter index */
if (ac < 1 || !av [0] || av [0][0] != '-')
return -1;
switch (av [0][1]) {
case 'a':
switch (av [0][2]) {
case 'p': /* photon map */
/* Photon map bumps up ambounce from its default 0; SHOULD
THIS REMAIN THE DEFAULT BEHAVIOUR? In some cases it's
desirable to render photons directly via ab -1 */
ambounce += (ambounce == 0);
if (!check(3, "s")) {
/* File -> assume bwidth = 1 or precomputed pmap */
if (++t >= NUM_PMAP_TYPES)
error(USER, "too many photon maps");
pmapParams [t].fileName = savqstr(av [1]);
pmapParams [t].minGather = pmapParams [t].maxGather =
defaultGather;
}
else return -1;
if (!check(3, "si")) {
/* File + bandwidth */
pmapParams [t].minGather = pmapParams [t].maxGather =
atoi(av [2]);
if (!pmapParams [t].minGather)
return -1;
}
else {
sprintf(errmsg,
"missing photon lookup bandwidth, defaulting to %d",
defaultGather
);
error(WARNING, errmsg);
return 1;
}
if (!check(3, "sii")) {
/* File + min bwidth + max bwidth -> bias compensation */
pmapParams [t].maxGather = atoi(av [3]);
if (pmapParams [t].minGather >= pmapParams [t].maxGather)
return -1;
return 3;
}
/* Transient pmap currently only supported by kd-tree */
#ifndef PMAP_OOC
if (!check(3, "sif")) {
/* File + bwidth + time -> transient pmap */
pmapParams [t].time = atof(av [3]);
if (pmapParams [t].time < 0)
error(USER, "invalid time %g -- "
"we're not Steven bloody Hawking, you know!"
);
return 3;
}
#endif
else return 2;
case 'm': /* Fixed max photon search radius */
if (check(3, "f") || (maxDistFix = atof(av [1])) <= 0)
error(USER, "invalid max photon search radius");
return 1;
#ifdef PMAP_OOC
case 'c':
/* OOC pmap cache page size ratio */
if (check(3, "f") || (pmapCachePageSize = atof(av [1])) <= 0)
error(USER, "invalid photon cache page size ratio");
return 1;
case 'C':
/* OOC pmap cache size (in photons); 0 = no caching */
if (check(3, "s"))
error(USER, "invalid number of cached photons");
/* Parsing failure sets to zero and disables caching */
pmapCacheSize = parseMultiplier(av [1]);
return 1;
#endif
#ifdef PMAP_PHOTONFLOW
case 'H':
/* Hemispherical lookup switch for lightflow pmap */
check_bool(3, hemiLightFlow);
if (hemiLightFlow && sphericalIrrad)
error(USER,
"hemispherical lookups and mean spherical irradiance "
"are mutually exclusive"
);
else return 0;
case 'S':
/* Mean spherical / planar irrad switch for lightflow pmap */
check_bool(3, sphericalIrrad);
if (sphericalIrrad && hemiLightFlow)
error(USER,
"spherical irradiance and hemispherical lookups "
"are mutually exclusive"
);
else return 0;
#endif
}
}
#undef check
/* Unknown option */
return -1;
}
void printPmapDefaults ()
/* Print defaults for photon map render options */
{
printf("-am %.1f\t\t\t\t# max photon search radius\n", maxDistFix);
#ifdef PMAP_OOC
printf("-ac %.1f\t\t\t\t# photon cache page size ratio\n",
pmapCachePageSize);
printf("-aC %ld\t\t\t# num cached photons\n", pmapCacheSize);
#endif
#ifdef PMAP_PHOTONFLOW
printf(hemiLightFlow
? "-aH+\t\t\t\t# Hemispherical lookups for lightflow photons\n"
: "-aH-\t\t\t\t# Spherical lookups for lightflow photons\n"
);
printf(sphericalIrrad
? "-aS+\t\t\t\t# spherical irradiance from lightflow photons\n"
: "-aS-\t\t\t\t# planar irradiance from lightflow photons\n"
);
#endif
}
c4science · Help