Reference:Bitmap Modifiers - Revision history

Jholsenback: version addition

2017-06-26T10:33:27Z

version addition

Jholsenback: 3.7.1 updates

2016-12-18T14:21:09Z

3.7.1 updates

Clipka: Indexentries fix

2016-12-17T01:19:53Z

Indexentries fix

Jholsenback: 1 revision: Reference Migration Initial Load

2012-03-15T19:05:06Z

1 revision: Reference Migration Initial Load

Jholsenback: 1 revision: Initial Load (TF)

2012-03-11T22:28:13Z

1 revision: Initial Load (TF)

New page

[[Category:Pattern Modifiers]]
A bitmap modifier is a modifier used inside an <code>image_map</code>,
<code>bump_map</code> or <code>material_map</code> to specify how the 2-D
bitmap is to be applied to the 3-D surface. Several bitmap modifiers apply to
specific kinds of maps and they are covered in the appropriate sections. The
bitmap modifiers discussed in the following sections are applicable to all
three types of bitmaps.

{{#indexentry:once, bitmap modifier}}
{{#indexentry:bitmap modifier, once}}
==The once Option==
Normally there are an infinite number of repeating image maps, bump maps
or material maps created over every unit square of the x-y-plane like tiles.
By adding the <code>once</code> keyword after a file name you can eliminate
all other copies of the map except the one at (0,0) to (1,1). In image maps,
areas outside this unit square are treated as fully transparent. In bump
maps, areas outside this unit square are left flat with no normal
modification. In material maps, areas outside this unit square are textured
with the first texture of the texture list.

For example:
<pre>
image_map {
gif "mypic.gif"
once
}
</pre>

{{#indexentry:map_type, bitmap modifier}}
{{#indexentry:bitmap modifier, map_type}}
==The map_type Option==
The default projection of the image onto the x-y-plane is called a 
planar map type. This option may be changed by adding the <code>
map_type</code> keyword followed by an integer number specifying the way to
wrap the image around the object.

A <code>map_type 0</code> gives the default planar mapping already
described.

A <code>map_type 1</code> gives a spherical mapping. It assumes that the
object is a sphere of any size sitting at the origin. The y-axis is the
north/south pole of the spherical mapping. The top and bottom edges of the
image just touch the pole regardless of any scaling. The left edge of the
image begins at the positive x-axis and wraps the image around the sphere
from west to east in a -y-rotation. The image covers the sphere exactly once.
The <code>once</code> keyword has no meaning for this mapping type.

With <code>map_type 2</code> you get a cylindrical mapping. It assumes that
a cylinder of any diameter lies along the y-axis. The image wraps around the
cylinder just like the spherical map but the image remains one unit tall from
y=0 to y=1. This band of color is repeated at all heights unless the <code>
once</code> keyword is applied.

Finally <code>map_type 5</code> is a torus or donut shaped mapping. It
assumes that a torus of major radius one sits at the origin in the x-z-plane.
The image is wrapped around similar to spherical or cylindrical maps. However
the top and bottom edges of the map wrap over and under the torus where they
meet each other on the inner rim.

Types 3 and 4 are still under development.
Note: The <code>map_type</code> option may also be applied to <code>
bump_map</code> and <code>material_map</code> statements.

For example:
<pre>
sphere{<0,0,0>,1
pigment{
image_map {
gif "world.gif"
map_type 1
}
}
}
</pre>

{{#indexentry:interpolate, bitmap modifier}}
{{#indexentry:bitmap modifier, interpolate}}
==The interpolate Option==
Adding the <code>interpolate</code> keyword can smooth the jagged look of a bitmap. When POV-Ray checks a color for an image map or a bump amount for a bump map, it often checks a point that is not directly on top of one pixel but sort of between several differently colored pixels. Interpolations return an in-between value so that the steps between the pixels in the map will look smoother.

Although <code>interpolate</code> is legal in material maps, the color index is interpolated before the texture is chosen. It does not interpolate the final color as you might hope it would. In general, interpolation of material maps serves no useful purpose but this may be fixed in future versions.

There are currently three types of interpolation: <code>interpolate 2</code> gives bilinear interpolation, <code>interpolate 3</code> gives bicubic, and <code>interpolate 4</code> gives normalized distance.
For example:
<pre>
image_map {
gif "mypic.gif"
interpolate 2
}
</pre>

The default is no interpolation. Normalized distance is the slowest, bilinear does a better job of picking the between color, and arguably, bicubic interpolation is a slight improvement, however it is subject to over-sharpening at some color borders. Normally bilinear is used.

If your map looks jagged, try using interpolation instead of going to a higher resolution image. The results can be very good.

@@ Line 38: / Line 38: @@
    <li>A <code>map_type 5</code> gives a torus or donut shaped mapping. It assumes that a torus of major radius one sits at the origin in the x-z-plane. The image is wrapped around similar to spherical or cylindrical maps. However the top and bottom edges of the map wrap over and under the torus where they meet each other on the inner rim.</li>
    <li>Types 3 and 4 are still under development.</li>
-   <li>Finally <code>map_type 7</code> produces an <em>angular</em> shaped mapping to be used with light probes.</li>
+   <li>A <code>map_type 7</code> {{New}} in version 3.8 produces an <em>angular</em> shaped mapping to be used with light probes.</li>
 </ul>
 <p class="Note"><strong>Note:</strong> The <code>map_type</code> option may also be applied to <code>

@@ Line 30: / Line 30: @@
 {{#indexentry:map_type, bitmap modifier}}
 {{#indexentry:bitmap modifier, map_type}}
-<p>The default projection of the image onto the x-y-plane is called a <em>
+<p>The default projection of the image onto the x-y-plane is called a <em>planar map type</em>. This option may be changed by adding the <code>map_type</code> keyword followed by an integer number specifying the way to wrap the image around the object.</p>
 planar map type</em>. This option may be changed by adding the <code>
-map_type</code> keyword followed by an integer number specifying the way to
+<ul>
-wrap the image around the object.</p>
+  <li>A <code>map_type 0</code> gives the default planar mapping already described.</li>
-<p>
+  <li>A <code>map_type 1</code> gives a spherical mapping. It assumes that the object is a sphere of any size sitting at the origin. The y-axis is the north/south pole of the spherical mapping. The top and bottom edges of the image just touch the pole regardless of any scaling. The left edge of the image begins at the positive x-axis and wraps the image around the sphere from west to east in a -y-rotation. The image covers the sphere exactly once. The <code>once</code> keyword has no meaning for this mapping type.</li>
-A <code>map_type 0</code> gives the default planar mapping already
+  <li>With <code>map_type 2</code> you get a cylindrical mapping. It assumes that a cylinder of any diameter lies along the y-axis. The image wraps around the cylinder just like the spherical map but the image remains one unit tall from y=0 to y=1. This band of color is repeated at all heights unless the <code>once</code> keyword is applied.</li>
-described.</p>
+  <li>A <code>map_type 5</code> gives a torus or donut shaped mapping. It assumes that a torus of major radius one sits at the origin in the x-z-plane. The image is wrapped around similar to spherical or cylindrical maps. However the top and bottom edges of the map wrap over and under the torus where they meet each other on the inner rim.</li>
-<p>
+  <li>Types 3 and 4 are still under development.</li>
-A <code>map_type 1</code> gives a spherical mapping. It assumes that the
+  <li>Finally <code>map_type 7</code> produces an <em>angular</em> shaped mapping to be used with light probes.</li>
-object is a sphere of any size sitting at the origin. The y-axis is the
+</ul>
 <p class="Note"><strong>Note:</strong> The <code>map_type</code> option may also be applied to <code>
 bump_map</code> and <code>material_map</code> statements.</p>

@@ Line 7: / Line 7: @@
 three types of bitmaps.</p>
 {{#indexentry:once, bitmap modifier}}
 {{#indexentry:bitmap modifier, once}}
 <p>Normally there are an infinite number of repeating image maps, bump maps
 or material maps created over every unit square of the x-y-plane like tiles.
@@ Line 27: / Line 27: @@
 </pre>
 {{#indexentry:map_type, bitmap modifier}}
 {{#indexentry:bitmap modifier, map_type}}
 <p>The default projection of the image onto the x-y-plane is called a <em>
 planar map type</em>. This option may be changed by adding the <code>
@@ Line 74: / Line 74: @@
 </pre>
 {{#indexentry:interpolate, bitmap modifier}}
 {{#indexentry:bitmap modifier, interpolate}}
 <p>Adding the <code>interpolate</code> keyword can smooth the jagged look of a bitmap. When POV-Ray checks a color for an image map or a bump amount for a bump map, it often checks a point that is not directly on top of one pixel but sort of between several differently colored pixels. Interpolations return an in-between value so that the steps between the pixels in the map will look smoother.</p>
 <p>

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