Reference:Density - Revision history

Jholsenback: version changes

2017-06-30T08:58:20Z

version changes

Jholsenback: added 256 upper limit change

2016-12-18T15:32:23Z

added 256 upper limit change

Jholsenback: removed lead-in heading to correct double header in build

2016-12-17T17:39:00Z

removed lead-in heading to correct double header in build

Jholsenback: link repair after build error

2016-12-17T17:07:07Z

link repair after build error

Jholsenback: initial creation

2016-12-17T16:02:44Z

initial creation

New page

==Density==
{{#indexentry:density, media}}
{{#indexentry:keyword, density}}
Particles of media are normally distributed in constant density throughout the media. However, the <code>density</code> statement allows you to vary the density across space using any of POV-Ray's pattern functions such as those used in textures. If no <code>density</code> statement is given then the density remains a constant value of 1.0 throughout the media. More than one <code>density</code> may be specified per <code>media</code> statement. See [[Reference:Media#Multiple Density vs. Multiple Media|Multiple Density vs. Multiple Media]].

The syntax for <code>density</code> is:
<pre>
DENSITY:
density {
[DENSITY_IDENTIFIER]
[DENSITY_TYPE]
[DENSITY_MODIFIER...]
}

DENSITY_TYPE:
PATTERN_TYPE | COLOR
DENSITY_MODIFIER:
PATTERN_MODIFIER | DENSITY_LIST | color_map { COLOR_MAP_BODY } |
colour_map { COLOR_MAP_BODY } | density_map { DENSITY_MAP_BODY }
</pre>

The <code>density</code> statement may begin with an optional density identifier. All subsequent values modify the defaults or the values in the identifier. The next item is a pattern type. This is any one of POV-Ray's pattern functions such as <code>[[Reference:Bozo Pattern|:bozo|bozo]]</code>, <code>[[Reference:Wood Pattern|:wood|wood]]</code>, <code>[[Reference:Gradient Pattern|:gradient|gradient]]</code>, <code>[[Reference:Waves Pattern|:waves|waves]]</code>, etc. Of particular usefulness are the <code>[[Reference:Spherical Pattern|:spherical|spherical]]</code>, <code>[[Reference:Planar Pattern|:planar|planar]]</code>, <code>[[Reference:Cylindrical Pattern|:cylindrical|cylindrical]]</code>, and <code>[[Reference:Boxed Pattern|:boxed|boxed]]</code> patterns which were previously available only for use with our discontinued <code>halo</code> feature. All patterns return a value from 0.0 to 1.0. This value is interpreted as the density of the media at that particular point. See the section [[Reference:Pattern|:Pattern|Pattern]] for details on particular pattern types. Although a solid COLOR pattern is legal, in general it is used only when the <code>density</code> statement is inside a <code>density_map</code>.

===General Density Modifiers===
A <code>density</code> statement may be modified by any of the general pattern modifiers such as transformations, <code>turbulence</code> and <code>warp</code>. See [[Reference:Pattern Modifiers|Pattern Modifiers]] for details. In addition, there are several density-specific modifiers which can be used.

===Density with color_map===
{{#indexentry:color_map, density}}
Typically, a <code>media</code> uses just one constant color throughout. Even if you vary the density, it is usually just one color which is specified by the <code>absorption</code>, <code>emission</code>, or <code>scattering</code> keywords. However, when using <code>emission</code> to simulate fire or explosions, the center of the flame (high density area) is typically brighter and white or yellow. The outer edge of the flame (less density) fades to orange, red, or in some cases deep blue. To model the density-dependent change in color which is visible, you may specify a <code>color_map</code>. The pattern function returns a value from 0.0 to 1.0 and the value is passed to the color map to compute what color or blend of colors is used. See [[Reference:Color Map|Color Maps]] for details on how pattern values work with <code>color_map</code>. This resulting color is multiplied by the <code>absorption</code>, <code>emission</code> and <code>scattering</code> color. Currently there is no way to specify different color maps for each media type within the same <code>media</code> statement.

Consider this example:

<pre>
media {
emission 0.75
scattering {1, 0.5}
density {
spherical
color_map {
[0.0 rgb <0,0,0.5>]
[0.5 rgb <0.8, 0.8, 0.4>]
[1.0 rgb <1,1,1>]
}
}
}
</pre>

The color map ranges from white at density 1.0 to bright yellow at density 0.5 to deep blue at density 0. Assume we sample a point at density 0.5. The emission is 0.75*<0.8,0.8,0.4> or <0.6,0.6,0.3>. Similarly the scattering color is 0.5*<0.8,0.8,0.4> or <0.4,0.4,0.2>.

For block pattern types <code>checker</code>, <code>hexagon</code>, and <code>brick</code> you may specify a color list such as this:

<pre>
density {
checker
density {rgb<1,0,0>}
density {rgb<0,0,0>}
}
</pre>

See [[Reference:Pigment#Color List Pigments|Color List Pigments]] which describes how <code>pigment</code> uses a color list. The same principles apply when using them with <code>density</code>.

===Density Maps and Density Lists===
{{#indexentry:keyword, density_map}}
In addition to specifying blended colors with a color map you may create a blend of densities using a <code>density_map</code>. The syntax for a density map is identical to a color map except you specify a density in each map entry (and not a color).

The syntax for <code>density_map</code> is as follows:

<pre>
DENSITY_MAP:
density_map { DENSITY_MAP_BODY }
DENSITY_MAP_BODY:
DENSITY_MAP_IDENTIFIER | DENSITY_MAP_ENTRY...
DENSITY_MAP_ENTRY:
[ Value DENSITY_BODY ]
</pre>

Where <code>Value</code> is a float value between 0.0 and 1.0 inclusive and each DENSITY_BODY is anything which can be inside a <code>density{...}</code> statement. The <code>density</code> keyword and <code>{}</code> braces need not be specified.

Note: The <code>[]</code> brackets are part of the actual DENSITY_MAP_ENTRY. They are not notational symbols denoting optional parts. The brackets surround each entry in the density map.

There may be from 2 to 256 entries in the map.

Density maps may be nested to any level of complexity you desire. The densities in a map may have color maps or density maps or any type of density you want.

Density lists may also be used with block patterns such as <code>checker</code>, <code>hexagon</code> and <code>brick</code>, as well as the object pattern <code>object</code>.

For example:

<pre>
density {
checker
density { Flame scale .8 }
density { Fire scale .5 }
}
</pre>

Note: In the case of block patterns the <code>density</code> wrapping is required around the density information.

A density map is also used with the <code>average</code> density type. See [[Reference:Average Pattern|:Average|Average]] for details.

You may declare and use density map identifiers but the only way to declare a density block pattern list is to declare a density identifier for the entire density.

===Multiple Density vs. Multiple Media===
It is possible to have more than one <code>media</code> specified per object and it is legal to have more than one <code>density</code> per <code>media</code>. The effects are quite different.

Consider this example:

<pre>
object {
MyObject
pigment { rgbf 1 }
interior {
media {
density { Some_Density }
density { Another_Density }
}
}
}
</pre>

As the media is sampled, calculations are performed for each density pattern at each sample point. The resulting samples are multiplied together. Suppose one density returned <code>rgb<.8,.8,.4></code> and the other returned <code>rgb<.25,.25,0></code>. The resulting color is <code>rgb<.2,.2,0></code>.

Note: In areas where one density returns zero, it will wipe out the other density. The end result is that only density areas which overlap will be visible. This is similar to a CSG intersection operation. Now consider:

<pre>
object {
MyObject
pigment { rgbf 1 }
interior {
media {
density { Some_Density }
}
media {
density { Another_Density }
}
}
}
</pre>

In this case each media is computed independently. The resulting colors are added together. Suppose one density and media returned <code>rgb<.8,.8,.4></code> and the other returned <code>rgb<.25,.25,0></code>. The resulting color is <code>rgb<1.05,1.05,.4></code>. The end result is that density areas which overlap will be especially bright and all areas will be visible. This is similar to a [[Reference:Constructive Solid Geometry|:CSG|CSG]] [[Reference:Union|:union|union]] operation. See the sample scene <code>~scenes\interior\media\media4.pov</code> for an example which illustrates this.

@@ Line 78: / Line 78: @@
 <p class="Note"><strong>Note:</strong> The <code>[]</code> brackets are part of the actual <em>DENSITY_MAP_ENTRY</em>. They are not notational symbols denoting optional parts. The brackets surround each entry in the density map.</p>
-<p>In <em>previous</em> versions there <em>had</em> to be from 2 to 256 entries in the map. A {{Change}} in version 3.7.1 has removed the upper restriction.</p>
+<p>In <em>previous</em> versions there <em>had</em> to be from 2 to 256 entries in the map. A {{Change}} in version 3.8 has removed the upper restriction.</p>
 <p>Density maps may be nested to any level of complexity you desire. The densities in a map may have color maps or density maps or any type of density you want.</p>

@@ Line 78: / Line 78: @@
 <p class="Note"><strong>Note:</strong> The <code>[]</code> brackets are part of the actual <em>DENSITY_MAP_ENTRY</em>. They are not notational symbols denoting optional parts. The brackets surround each entry in the density map.</p>
-<p>There may be from 2 to 256 entries in the map.</p>
+<p>In <em>previous</em> versions there <em>had</em> to be from 2 to 256 entries in the map. A {{Change}} in version 3.7.1 has removed the upper restriction.</p>
 <p>Density maps may be nested to any level of complexity you desire. The densities in a map may have color maps or density maps or any type of density you want.</p>

← Older revision		Revision as of 17:39, 17 December 2016
Line 1:		Line 1:
−	~~==Density==~~
	{{#indexentry:density, media}}		{{#indexentry:density, media}}
	{{#indexentry:keyword, density}}		{{#indexentry:keyword, density}}

@@ Line 2: / Line 2: @@
 {{#indexentry:density, media}}
 {{#indexentry:keyword, density}}
-<p>Particles of media are normally distributed in constant density throughout the media. However, the <code>density</code> statement allows you to vary the density across space using any of POV-Ray's pattern functions such as those used in textures. If no <code>density</code> statement is given then the density remains a constant value of 1.0 throughout the media. More than one <code>density</code> may be specified per <code>media</code> statement. See [[Reference:Media#Multiple Density vs. Multiple Media|Multiple Density vs. Multiple Media]].</p>
+<p>Particles of media are normally distributed in constant density throughout the media. However, the <code>density</code> statement allows you to vary the density across space using any of POV-Ray's pattern functions such as those used in textures. If no <code>density</code> statement is given then the density remains a constant value of 1.0 throughout the media. More than one <code>density</code> may be specified per <code>media</code> statement. See [[Reference:Density#Multiple Density vs. Multiple Media|Multiple Density vs. Multiple Media]].</p>
 <p>The syntax for <code>density</code> is:</p>