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