| 100 |
|
may be useful if the resulting photon map size greatly deviates from |
| 101 |
|
\fInphotons\fR with a very low average reflectance. |
| 102 |
|
|
| 103 |
< |
.IP "\fB\-api \fIxmin ymin zmin xmax ymax zmax\fR" |
| 104 |
< |
Define a region of interest within which to store photons exclusively; |
| 105 |
< |
photons will only be stored within the volume bounded by the given minimum |
| 106 |
< |
and maximum coordinates. Multiple instances of this option may be specified |
| 107 |
< |
with cumulative effect to define compound regions of interest. This is |
| 108 |
< |
useful for constraining photons to only the relevant regions of a scene, but |
| 109 |
< |
may increase the photon distribution time. |
| 103 |
> |
.IP "\fB\-api \fImin_x min_y min_z max_x max_y max_z\fR" |
| 104 |
> |
Define a rectangular region of interest within which to store photons |
| 105 |
> |
exclusively; photons will only be stored within the volume bounded by the |
| 106 |
> |
given minimum and maximum coordinates. Multiple instances of this option may |
| 107 |
> |
be specified with cumulative effect to define compound regions of interest. |
| 108 |
> |
This is useful for constraining photons to only the relevant regions of a |
| 109 |
> |
scene, but may increase the photon distribution time. |
| 110 |
|
.IP |
| 111 |
|
\fBWARNING: this is an optimisation option for advanced users (an elite |
| 112 |
|
group collectively known as \fIZe Ekspertz\fB) and may yield biased results. |
| 113 |
|
Use with caution!\fR |
| 114 |
|
|
| 115 |
+ |
.IP "\fB-apI \fIpos_x pos_y pos_z rad\fR" |
| 116 |
+ |
Similar to \fB\-api\fR, but with a spherical region of interest of given |
| 117 |
+ |
radius, centred at the given coordinates. |
| 118 |
+ |
|
| 119 |
|
.IP "\fB\-apm \fImaxbounce\fR" |
| 120 |
|
Synonymous with \fB\-lr\fR for backwards compatibility. May be removed in |
| 121 |
|
future releases. |
| 151 |
|
Bidirectional emission; photons are emitted from both sides of the port. |
| 152 |
|
.RE |
| 153 |
|
.IP |
| 154 |
< |
Situations that call for a reversed photon port include, for |
| 155 |
< |
example, using fenestrations as ports that were (for whatever |
| 156 |
< |
reason) defined with outward facing normals, or using a \fBmist\fR |
| 154 |
> |
Some typical situations that call for a reversed photon port include, for |
| 155 |
> |
example: |
| 156 |
> |
.RS |
| 157 |
> |
.IP (a) |
| 158 |
> |
Using fenestrations as ports that were (for whatever |
| 159 |
> |
reason) defined with outward facing normals, |
| 160 |
> |
.IP (b) |
| 161 |
> |
Using a \fBmist\fR |
| 162 |
|
primitive as a port, since this requires outward facing normals in order to |
| 163 |
< |
register the photons as having entered the volume. |
| 163 |
> |
register the photons as having entered the volume, |
| 164 |
> |
.IP (c) |
| 165 |
> |
Reorienting a port associated with a \fBbsdf\fR modifier, since inverting |
| 166 |
> |
its normal would also reorient the BSDF and alter its behaviour. |
| 167 |
> |
.RE |
| 168 |
> |
.IP |
| 169 |
> |
Other oddball scenarios are conceivable. If in doubt, specify a |
| 170 |
> |
bidirectional port orientation for a slight performance penalty, |
| 171 |
> |
as photon emission is attempted from both sides. For well-defined |
| 172 |
> |
port geometry with inward-facing normals, just use the default; |
| 173 |
> |
doan' mess with da normalz. |
| 174 |
> |
.IP |
| 175 |
> |
Photon port geometry is discretised according to the |
| 176 |
> |
\fB\-dp\fR and \fB\-ds\fR options. These parameters aid in resolving |
| 177 |
> |
spatially and directionally varying illuminance received by the port |
| 178 |
> |
from distant light sources, e.g due to partial occlusion |
| 179 |
> |
or when using climate-based sky models. |
| 180 |
|
|
| 181 |
|
.IP "\fB\-apO \fImodfile\fR" |
| 182 |
|
Read photon port modifiers from the file \fImodfile\fR as a more convenient |
| 247 |
|
are unconditionally absorbed and discarded. |
| 248 |
|
|
| 249 |
|
.IP "\fB\-dp \fIsampleres\fR" |
| 250 |
< |
Resolution for sampling the spatial emission distribution of a modified |
| 251 |
< |
light source (e.g. via \fIbrightfunc\fR), in samples per steradian. This |
| 252 |
< |
is required for numerically integrating the flux emitted by the light |
| 253 |
< |
source and for constructing a probability density function for photon |
| 254 |
< |
emission. The accuracy of photon emission from modified sources |
| 255 |
< |
therefore depends on this parameter. This parameter may need increasing |
| 250 |
> |
Angular resolution for sampling the spatial emission distribution of a |
| 251 |
> |
modified light source or photon port (e.g. via \fIbrightfunc\fR), in samples |
| 252 |
> |
per steradian. |
| 253 |
> |
This is required to numerically integrate the flux emitted by the light |
| 254 |
> |
source and construct a probability density function for photon emission. |
| 255 |
> |
The accuracy of photon emission from a modified source or port |
| 256 |
> |
therefore depends on this parameter. The resolution may need to be increased |
| 257 |
|
with complex emission distributions in combination with caustics. |
| 258 |
|
|
| 259 |
|
.IP "\fB\-ds \fIpartsize\fR" |
| 260 |
< |
Light source partition size ratio; a light source object is spatially |
| 261 |
< |
partitioned to distribute the photon emission over its surface. This |
| 262 |
< |
parameter specifies the ratio of the size (per dimension) of each |
| 263 |
< |
partition to the scene cube, and may need increasing for modified light |
| 264 |
< |
sources (e.g. via \fIbrightfunc\fR) with high spatial variation. |
| 260 |
> |
Light source partition size ratio; a local light source object (or photon |
| 261 |
> |
port in case of a distant source) is spatially partitioned to distribute the |
| 262 |
> |
photon emission over its surface. This parameter specifies the ratio of the |
| 263 |
> |
size (per dimension) of each partition to the scene cube, and may need |
| 264 |
> |
to be reduced for modified light sources (e.g. via \fIbrightfunc\fR) with |
| 265 |
> |
high spatial variance, or for partially occluded photon ports. |
| 266 |
|
|
| 267 |
|
.IP "\fB\-e \fIfile\fR" |
| 268 |
|
Redirect diagnostics and progress reports to \fIfile\fR instead of the |
| 310 |
|
|
| 311 |
|
.IP "\fB\-n \fInproc\fR" |
| 312 |
|
Use \fInproc\fR processes for parallel photon distribution. There is no |
| 313 |
< |
benefit in specifying more than the number of physical CPU cores available. |
| 314 |
< |
This option is currently not available on Windows. |
| 313 |
> |
benefit in specifying more than the number of physical CPU cores available |
| 314 |
> |
(so doan' even try). This option is currently not available on Windows -- |
| 315 |
> |
so there, tuff luck. |
| 316 |
|
|
| 317 |
|
.IP "\fB\-t \fIinterval\fR" |
| 318 |
|
Output a progress report every \fIinterval\fR seconds. This includes |
| 417 |
|
|
| 418 |
|
.RS |
| 419 |
|
\fIFraunhofer Institute for Solar Energy Systems\fR funded by |
| 420 |
< |
the German Research Foundation (\fIDFG LU204/10-2\fR, "Fassadenintegrierte |
| 420 |
> |
the German Research Foundation (\fIDFG LU-204/10-2\fR, "Fassadenintegrierte |
| 421 |
|
Regelsysteme (FARESYS)"), |
| 422 |
|
|
| 423 |
|
\fILucerne University of Applied Sciences and Arts\fR funded by |
