Reference:Average Pattern - Revision history

Jholsenback: version changes

2017-06-30T10:33:21Z

version changes

Jholsenback: added 256 upper limit change

2016-12-18T15:26:32Z

added 256 upper limit change

Jholsenback: link repair after build error

2016-12-17T16:58:06Z

link repair after build error

Jholsenback: 1 revision: Reference Migration Initial Load

2012-03-15T19:05:05Z

1 revision: Reference Migration Initial Load

Jholsenback: link repair

2012-03-15T13:16:51Z

link repair

New page

[[Category:Patterns]]
{{#indexentry:average, keyword}}
{{#indexentry:average, pattern}}
{{#indexentry:keyword, average}}
{{#indexentry:pattern, average}}
{{#indexentry:pigment_map, average}}
{{#indexentry:keyword, pigment_map}}
Technically <code>average</code> is not a pattern type but it is listed here
because the syntax is similar to other patterns. Typically a pattern type specifies
how colors or normals are chosen from a <code>pigment_map</code>,
<code>texture_map</code>, <code>density_map</code>, or <code>normal_map
</code>, however <code>average</code> tells POV-Ray to
average together all of the patterns you specify. Average was originally
designed to be used in a normal statement with a <code>normal_map</code> as a
method of specifying more than one normal pattern on the same surface.
However average may be used in a pigment statement with a <code>
pigment_map</code> or in a texture statement with a <code>texture_map</code>
or media density with <code>density_map</code> to average colors too.

When used with pigments, the syntax is:
<pre>
AVERAGED_PIGMENT:

pigment {
pigment_map {
PIGMENT_MAP_ENTRY...
}
}

PIGMENT_MAP_ENTRY:
[ [Weight] PIGMENT_BODY ]
</pre>

Where <code>Weight</code> is an optional float value that
defaults to 1.0 if not specified. This weight value is the relative weight
applied to that pigment. Each PIGMENT_BODY is anything which can be
inside a <code>pigment{...}</code> statement. The <code>pigment</code>
keyword and <code>{}</code> braces need not be specified.
Note: The <code>[]</code> brackets are part of the actual 
PIGMENT_MAP_ENTRY. They are not notational symbols denoting optional
parts. The brackets surround each entry in the <code>pigment_map</code>.

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

For example
<pre>
pigment {
average
pigment_map {
[1.0 Pigment_1]
[2.0 Pigment_2]
[0.5 Pigment_3]
}
}
</pre>

All three pigments are evaluated. The weight values are multiplied by the
resulting color. They are then divided by the total of the weights which, in
this example is 3.5. When used with <code>texture_map</code> or <code>
density_map</code> it works the same way.

When used with a <code>normal_map</code> in a normal statement, multiple
copies of the original surface normal are created and are perturbed by each
pattern. The perturbed normals are then weighted, added and normalized.

See the sections [[Reference:Pigment Map|Pigment Maps and Pigment Lists]], [[Reference:Normal Map|Normal Maps and Normal Lists]], [[Reference:Patterned Textures#Texture Maps|Texture Maps]], and [[Reference:Media#Density Maps and Density Lists|Density Maps and Density Lists]] for more information.

@@ Line 40: / Line 40: @@
 PIGMENT_MAP_ENTRY</em>. They are not notational symbols denoting optional
 parts. The brackets surround each entry in the <code>pigment_map</code>.</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>
 For example</p>

@@ Line 40: / Line 40: @@
 PIGMENT_MAP_ENTRY</em>. They are not notational symbols denoting optional
 parts. The brackets surround each entry in the <code>pigment_map</code>.</p>
-<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>
 For example</p>

@@ Line 64: / Line 64: @@
 pattern. The perturbed normals are then weighted, added and normalized.</p>
 <p>
-See the sections [[Reference:Pigment Map|Pigment Maps and Pigment Lists]], [[Reference:Normal Map|Normal Maps and Normal Lists]], [[Reference:Patterned Textures#Texture Maps|Texture Maps]], and [[Reference:Media#Density Maps and Density Lists|Density Maps and Density Lists]] for more information.</p>
+See the sections [[Reference:Pigment Map|Pigment Maps and Pigment Lists]], [[Reference:Normal Map|Normal Maps and Normal Lists]], [[Reference:Patterned Textures#Texture Maps|Texture Maps]], and [[Reference:Density#Density Maps and Density Lists|Density Maps and Density Lists]] for more information.</p>

← Older revision	Revision as of 19:05, 15 March 2012
(No difference)