| 1 |
/* RCSid $Id: pmapmat.h,v 2.14 2021/02/22 13:27:49 rschregle Exp $ */ |
| 2 |
/* |
| 3 |
====================================================================== |
| 4 |
Photon map support routines for scattering by materials. |
| 5 |
|
| 6 |
Roland Schregle (roland.schregle@{hslu.ch, gmail.com}) |
| 7 |
(c) Fraunhofer Institute for Solar Energy Systems, |
| 8 |
supported by the German Research Foundation |
| 9 |
(DFG LU-204/10-2, "Fassadenintegrierte Regelsysteme FARESYS") |
| 10 |
(c) Lucerne University of Applied Sciences and Arts, |
| 11 |
supported by the Swiss National Science Foundation |
| 12 |
(SNSF #147053, "Daylight Redirecting Components") |
| 13 |
====================================================================== |
| 14 |
|
| 15 |
*/ |
| 16 |
|
| 17 |
|
| 18 |
#ifndef PMAPMAT_H |
| 19 |
#define PMAPMAT_H |
| 20 |
|
| 21 |
#include "pmap.h" |
| 22 |
|
| 23 |
#ifdef __cplusplus |
| 24 |
extern "C" { |
| 25 |
#endif |
| 26 |
|
| 27 |
/* |
| 28 |
Check for paths already accounted for in photon map to avoid |
| 29 |
double-counting during backward raytracing. |
| 30 |
|
| 31 |
ambRayInPmap(): Check for DIFFUSE -> (DIFFUSE|SPECULAR) -> * |
| 32 |
subpaths. These occur during the backward pass |
| 33 |
when an ambient ray spawns an indirect diffuse or |
| 34 |
specular ray. These subpaths are already |
| 35 |
accounted for in the global photon map. |
| 36 |
*/ |
| 37 |
#define ambRayInPmap(r) ((r) -> crtype & AMBIENT && photonMapping && \ |
| 38 |
(ambounce < 0 || (r) -> rlvl > 1)) |
| 39 |
|
| 40 |
/* |
| 41 |
shadowRayInPmap(): Check for DIFFUSE -> SPECULAR -> LIGHT |
| 42 |
subpaths. These occur during the backward pass |
| 43 |
when a shadow ray is transferred through a |
| 44 |
transparent material. These subpaths are already |
| 45 |
accounted for by caustic photons in the global, |
| 46 |
contrib, or dedicated caustic photon map. |
| 47 |
|
| 48 |
!!! DISABLED FOR TESTING PENDING REPLACEMENT BY srcRayInPmap() !!! |
| 49 |
*/ |
| 50 |
#if 1 |
| 51 |
#define shadowRayInPmap(r) 0 |
| 52 |
#else |
| 53 |
#define shadowRayInPmap(r) (((globalPmap && ambounce < 0) || \ |
| 54 |
causticPmap || contribPmap) && \ |
| 55 |
(r) -> crtype & SHADOW) |
| 56 |
#endif |
| 57 |
|
| 58 |
/* srcRayInPmap(): Check whether a source ray transferred through |
| 59 |
* medium (e.g. glass/dielectric) is already |
| 60 |
* accounted for in the photon map. This is used by |
| 61 |
* badcomponent() in source.c when checking source |
| 62 |
* hits (glows and lights, hence ambient and shadow |
| 63 |
* rays). |
| 64 |
*/ |
| 65 |
#define srcRayInPmap(r) (((globalPmap && ambounce < 0) || \ |
| 66 |
causticPmap || contribPmap) && \ |
| 67 |
(r) -> crtype & (AMBIENT | SHADOW) && \ |
| 68 |
(r) -> rtype & (TRANS | REFRACTED)) |
| 69 |
|
| 70 |
/* Check if scattered ray spawns a caustic photon; |
| 71 |
* !!! NOTE this returns a single bit as boolean value (0|1), rather |
| 72 |
* !!! than the original short int, hence the explicit test against zero. |
| 73 |
* !!! This allows the macro the be used in a conditional statement |
| 74 |
* !!! and when setting a photon's caustic flag in newPhoton(). */ |
| 75 |
#define PMAP_CAUSTICRAY(r) (((r) -> rtype & SPECULAR) != 0) |
| 76 |
|
| 77 |
|
| 78 |
/* Scattered photon ray types for photonRay() */ |
| 79 |
#define PMAP_DIFFREFL (REFLECTED | AMBIENT) |
| 80 |
#define PMAP_DIFFTRANS (REFLECTED | AMBIENT | TRANS) |
| 81 |
#define PMAP_SPECREFL (REFLECTED | SPECULAR) |
| 82 |
#define PMAP_SPECTRANS (REFLECTED | SPECULAR | TRANS) |
| 83 |
#define PMAP_REFRACT (REFRACTED | SPECULAR) |
| 84 |
#define PMAP_XFER (TRANS) |
| 85 |
|
| 86 |
|
| 87 |
|
| 88 |
/* Dispatch table for photon scattering functions */ |
| 89 |
extern int (*photonScatter []) (OBJREC*, RAY*); |
| 90 |
|
| 91 |
/* List of antimatter sensor modifier names */ |
| 92 |
extern char *photonSensorList [MAXSET + 1]; |
| 93 |
|
| 94 |
|
| 95 |
|
| 96 |
/* Spawn a new photon ray from a previous one; this is effectively a |
| 97 |
* customised rayorigin(). */ |
| 98 |
void photonRay (const RAY *rayIn, RAY *rayOut, int rayOutType, |
| 99 |
COLOR fluxAtten); |
| 100 |
|
| 101 |
/* Init photonScatter[] dispatch table with material specific scattering |
| 102 |
routines */ |
| 103 |
void initPhotonScatterFuncs (); |
| 104 |
|
| 105 |
/* Find antimatter geometry declared as photon sensors */ |
| 106 |
void getPhotonSensors (char **sensorList); |
| 107 |
|
| 108 |
#ifdef __cplusplus |
| 109 |
} |
| 110 |
#endif |
| 111 |
|
| 112 |
#endif |
