Difference between revisions of "Documentation Talk:Reference Section 6.1"

From POV-Wiki
Jump to navigation Jump to search
m (added a "Note" about sampling method 3 behavior)
m
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
===Sampling Parameters & Methods===
+
Regarding the note at the end of http://wiki.povray.org/content/Documentation:Reference_Section_6#Media
<!--<indexentry primary "intervals">--->
 
<p>Media effects are calculated by sampling the media along the path of the
 
ray. It uses a method called <em>Monte Carlo integration.</em> The <code>intervals</code>
 
keyword may be used to specify the integer number of intervals used to
 
sample the ray. The default number of intervals is 10. For object media the
 
intervals are spread between the entry and exit points as the ray passes
 
through the container object. For atmospheric media, the intervals spans the
 
entire length of the ray from its start until it hits an object. For media
 
types which interact with spotlights or cylinder lights, the intervals
 
which are not illuminated by these light types are weighted differently
 
than the illuminated intervals when distributing samples.</p>
 
  
<!--<indexentry primary "ratio">--->
+
The casting of a shadow depend on the kind of media concerned.
<p>The <code>ratio</code> keyword distributes intervals differently between lit
 
and unlit areas. The default value of <code>ratio 0.9</code> means that lit
 
intervals get more samples than unlit intervals. Note that the total number
 
of intervals must exceed the number of illuminated intervals. If a ray
 
passes in and out of 8 spotlights but you have only specified 5 intervals
 
then an error occurs.</p>
 
  
<!--<indexentry primary "samples">--->
+
Absorbing media always cast a shadow.
<p>The <code>samples</code> <em><code>Min</code></em>,
 
<em><code> Max</code></em> keyword specifies the minimum and maximum number
 
of samples taken per interval. The default values are <code>samples
 
1,1</code>. </p>
 
  
<!--<indexentry "confidence, media">--->
+
Scattering media also cast a shadow unless it's extinction is set to zero.
<!--<indexentry "variance, media">--->
 
<p>As each interval is sampled, the variance is computed. If the
 
variance is below a threshold value, then no more samples are needed. The
 
<code>variance</code> and <code>confidence</code> keywords specify the
 
permitted variance allowed and the confidence that you are within that
 
variance. The exact calculations are quite complex and involve chi-squared
 
tests and other statistical principles too messy to describe here. The
 
default values are <code>variance 1.0/128</code> and <code>confidence
 
0.9</code>. For slower more accurate results, decrease the variance and
 
increase the confidence.</p>
 
<p class="Note"><strong>Note:</strong> the maximum number of samples
 
limits the calculations even if the proper variance and confidence are
 
never reached.</p>
 
  
<!--<indexentry primary "method">--->
+
Emissive media never cast shadow.
<p>The <code>method</code> keyword lets you specify what sampling method is used,
 
POV-Ray provides three. <code>Method 1</code> is the method described above.</p>
 
  
<p>Sample <code>method 2</code> distributes samples evenly along the viewing ray or light ray.
 
The latter can make things look smoother sometimes. If you specify a max samples higher than
 
the minimum samples, POV will take additional samples, but they will be random, just like in
 
method 1. Therefore, it is suggested you set the max samples equal to the minimum samples.
 
<code>jitter</code> will cause method 2 to look similar to method 1. It should be followed by
 
a float, and a value of 1 will stagger the samples in the full range between samples.</p>
 
  
<!--<indexentry primary "aa_level" "aa_threshold">--->
+
I would suggest reordering the 3 sampling methods descriptions.
<p>Sample <code>method 3</code> uses adaptive sampling (similar to adaptive anti-aliasing)
 
which is very much like the sampling method used in POV-Ray 3.0's atmosphere. This code was
 
written from the ground-up to work with media, however. Adaptive sampling works by taking
 
another sample between two existing samples if there is too much variance in the original
 
two samples. This leads to fewer samples being taken in areas where the effect from the media
 
remains constant. The adaptive sampling is only performed if the minimum
 
samples are set to 3 or more.</p>
 
  
<p class=”Note”><strong>Note:</strong> As of version 3.5 the default sampling <code>method</code> is 3, <code>intervals</code> is 1 and <code>samples Min=Max</code> so a single <code>samples</code> parameter is acceptable. The sampling methods 1 and 2 has been retained for legacy purposes.</p>
+
Start with method 3.
  
<p>You can specify the anti-aliasing recursion depth using the <code>aa_level</code>
+
Then, put the warning followed by methods 1 and 2.
keyword followed by an integer. You can specify the anti-aliasing threshold by using the  
+
 
<code>aa_threshold</code> followed by a float. The default for <code>aa_level</code> is 4
+
* the above issues have been addressed --[[User:Jholsenback|jholsenback]] 23:50, 11 April 2010 (UTC)
and the default <code>aa_threshold</code> is 0.1. <code>jitter</code> also works with method 3.
+
 
Sample method 3 ignores the maximum samples value. It is usually best to only use one interval
+
 
with method 3. Too many intervals can lead to artefacts, and POV will create more intervals
+
A few minor suggestions:
if it needs them.</p>
+
 
 +
Section 6
 +
 
 +
Transformations apply only the density statements
 +
->
 +
Transformations apply only to the density statements
 +
 
 +
There should be a consistent capitalization for
 +
the first word in a "Note"
 +
 
 +
Section 6.1
 +
 
 +
The emission keyword specifies a color of ...
 +
->
 +
The emission keyword specifies the color of ...
 +
 
 +
Although we say they "emit" light, this only means that they are visible
 +
without any illumination shining on them. They do not really emit light that
 +
is cast on to nearby objects.  ->   Particles which emit light are visible without
 +
requiring additional
 +
illumination. However, they will only illuminate other objects if
 +
radiosity is used with media on.
 +
 
 +
a scattering media -> scattering media
 +
 
 +
, additionally samples Min=Max so a single samples parameter is acceptable.
 +
->
 +
This doesn't really seem to belong in the box. Rather, when describing
 +
samples Min, Max below, add "The value for Max may be omitted, in which
 +
case the range Min = Max will be used".
 +
 
 +
a max samples higher than the minimum samples
 +
->
 +
a maximum number of samples higher than the minimum number
 +
of samples
 +
 
 +
Generally, commas are set a bit sparsely. Here are some which
 +
should probably be there for grammatical correctness:
 +
 
 +
After "for example" (2x)
 +
After "However" (3x at beginning of sentence)
 +
Before "i.e."
 +
After "For object media"
 +
After "In addition"
 +
After "Typically"
 +
 
 +
[[User:Froesccn|Froesccn]] 21:18, 19 April 2010 (UTC)
 +
 
 +
:* Thanks for reviewing these pages. The changes have been done --[[User:Jholsenback|jholsenback]] 12:17, 20 April 2010 (UTC)

Latest revision as of 12:17, 20 April 2010

Regarding the note at the end of http://wiki.povray.org/content/Documentation:Reference_Section_6#Media

The casting of a shadow depend on the kind of media concerned.

Absorbing media always cast a shadow.

Scattering media also cast a shadow unless it's extinction is set to zero.

Emissive media never cast shadow.


I would suggest reordering the 3 sampling methods descriptions.

Start with method 3.

Then, put the warning followed by methods 1 and 2.

  • the above issues have been addressed --jholsenback 23:50, 11 April 2010 (UTC)


A few minor suggestions:

Section 6

Transformations apply only the density statements -> Transformations apply only to the density statements

There should be a consistent capitalization for the first word in a "Note"

Section 6.1

The emission keyword specifies a color of ... -> The emission keyword specifies the color of ...

Although we say they "emit" light, this only means that they are visible without any illumination shining on them. They do not really emit light that is cast on to nearby objects. -> Particles which emit light are visible without requiring additional illumination. However, they will only illuminate other objects if radiosity is used with media on.

a scattering media -> scattering media

, additionally samples Min=Max so a single samples parameter is acceptable. -> This doesn't really seem to belong in the box. Rather, when describing samples Min, Max below, add "The value for Max may be omitted, in which case the range Min = Max will be used".

a max samples higher than the minimum samples -> a maximum number of samples higher than the minimum number of samples

Generally, commas are set a bit sparsely. Here are some which should probably be there for grammatical correctness:

After "for example" (2x) After "However" (3x at beginning of sentence) Before "i.e." After "For object media" After "In addition" After "Typically"

Froesccn 21:18, 19 April 2010 (UTC)

  • Thanks for reviewing these pages. The changes have been done --jholsenback 12:17, 20 April 2010 (UTC)