Reference:Image Pattern - Revision history

Jr: fix wording

2025-05-09T11:14:11Z

fix wording

Jholsenback: missed one

2018-02-06T11:46:30Z

missed one

Jholsenback: consistency

2018-02-04T19:30:21Z

consistency

Jholsenback: remove multi-link markup

2018-01-08T11:15:53Z

remove multi-link markup

Jholsenback: version changes

2017-06-26T10:28:26Z

version changes

Clipka: Added one more srgb indexentry

2016-12-17T13:14:51Z

Added one more srgb indexentry

Jholsenback: indexentry additions

2016-10-13T10:50:31Z

indexentry additions

Jholsenback: 3.7.1 updates

2016-10-13T09:02:31Z

3.7.1 updates

Le Forgeron at 09:12, 1 March 2014

2014-03-01T09:12:44Z

Jholsenback: 1 revision: Reference Migration Initial Load

2012-03-15T19:06:22Z

1 revision: Reference Migration Initial Load

@@ Line 64: / Line 64: @@
 <p class="Note"><strong>Note:</strong> This pattern uses an image to get the gray values. If you want exactly the same possibilities but need to get gray values from a pigment, you can use the <code>[[Reference:Pigment Pattern|pigment_pattern]]</code>.</p>
-<p>While POV-Ray will normally interpret the image pattern input file as a container of linear data irregardless of file type, this can be overridden for any individual image pattern input file by specifying <code>gamma</code> GAMMA immediately after the file name. For example:</p>
+<p>While POV-Ray will normally interpret the image pattern input file as a container of linear data irrespective of file type, this can be overridden for any individual image pattern input file by specifying <code>gamma</code> GAMMA immediately after the file name. For example:</p>
 <pre>
 image_pattern {

@@ Line 37: / Line 37: @@
 IMAGE_PATTERN:
    image_pattern {
-     BITMAP_TYPE &quot;filename&quot; [gamma GAMMA] [premultiplied BOOL]
+     [BITMAP_TYPE] &quot;filename&quot; [gamma GAMMA] [premultiplied BOOL]
      [IMAGE_MAP_MODS...]
+     }

@@ Line 37: / Line 37: @@
 IMAGE_PATTERN:
    image_pattern {
-     BITMAP_TYPE &quot;bitmap.ext&quot; [gamma GAMMA] [premultiplied BOOL]
+     BITMAP_TYPE &quot;filename&quot; [gamma GAMMA] [premultiplied BOOL]
      [IMAGE_MAP_MODS...]
+     }

@@ Line 63: / Line 63: @@
 </pre>
-<p class="Note"><strong>Note:</strong> This pattern uses an image to get the gray values. If you want exactly the same possibilities but need to get gray values from a pigment, you can use the [[Reference:Pigment Map|:pigment_pattern|pigment_pattern]].</p>
+<p class="Note"><strong>Note:</strong> This pattern uses an image to get the gray values. If you want exactly the same possibilities but need to get gray values from a pigment, you can use the <code>[[Reference:Pigment Pattern|pigment_pattern]]</code>.</p>
 <p>While POV-Ray will normally interpret the image pattern input file as a container of linear data irregardless of file type, this can be overridden for any individual image pattern input file by specifying <code>gamma</code> GAMMA immediately after the file name. For example:</p>
 <pre>

@@ Line 73: / Line 73: @@
 {{#indexentry:bt2020, keyword}}
 {{#indexentry:srgb, keyword}}
-<p>This will cause POV-Ray to perform gamma adjustment or decoding on the input file data before building the image pattern. Alternatively to a numerical value, <code>srgb</code> may be specified to denote that the file format is pre-corrected or encoded using the <em>sRGB transfer function</em> instead of a power-law gamma function. {{New}} in version 3.7.1, other valid special values are <code>bt709</code> and <code>bt2020</code>, denoting that the file is encoded or pre-corrected using the ITU-R BT.709 or BT.2020 transfer function, respectively. See section [[Documentation:Tutorial Section 3.3#Gamma Handling|Gamma Handling]] for more details.</p>
+<p>This will cause POV-Ray to perform gamma adjustment or decoding on the input file data before building the image pattern. Alternatively to a numerical value, <code>srgb</code> may be specified to denote that the file format is pre-corrected or encoded using the <em>sRGB transfer function</em> instead of a power-law gamma function. {{New}} in version 3.8, other valid special values are <code>bt709</code> and <code>bt2020</code>, denoting that the file is encoded or pre-corrected using the ITU-R BT.709 or BT.2020 transfer function, respectively. See section [[Documentation:Tutorial Section 3.3#Gamma Handling|Gamma Handling]] for more details.</p>

@@ Line 13: / Line 13: @@
 {{#indexentry:pattern, use_alpha}}
 {{#indexentry:use_alpha}}
-<p>Instead of placing the color of the image on the object like an <code>image_map</code>, an <code>image_pattern</code> specifies an entire texture item (color, pigment, normal or texture) based on the gray value at that point.</p>
+<p>Instead of placing the color of the image on the object using an <code>image_map</code>, the <code>image_pattern</code> specifies an entire texture item (color, pigment, normal or texture) based on the gray value at that point.</p>
-<p>This gray-value is checked against a list and the corresponding item is then used for the texture at that particular point. For values between listed items, an averaged texture is calculated.</p>
+<p>This gray value is evaluated against a list and the corresponding item is then used for the texture at that particular point. For values between listed items, an averaged texture is calculated.</p>
-<p>It takes a standard image specification and has one option, <code>use_alpha</code>, which works similar to <code>use_color</code> or <code>use_index</code>.</p>
+<p>It takes a standard image specification with the option, <code>use_alpha</code>, which works similar to <code>use_color</code> or <code>use_index</code>.</p>
 <p class="Note"><strong>Note:</strong> See the section [[Reference:Image Map#Using the Alpha Channel|Using the Alpha Channel]] for some important information regarding the use of <code>image_pattern</code>.</p>
 <p>Syntax:</p>
@@ Line 22: / Line 22: @@
    pigment {
      IMAGE_PATTERN
-     color_map { COLOR_MAP_BODY } |
+     color_map { COLOR_MAP_BODY } | colour_map { COLOR_MAP_BODY } | pigment_map { PIGMENT_MAP_BODY }
+     }
 NORMAL:
    normal {
@@ Line 32: / Line 29: @@
      normal_map { NORMAL_MAP_BODY }
+     }
 TEXTURE:
    texture {
@@ Line 44: / Line 40: @@
      [IMAGE_MAP_MODS...]
+     }
+BITMAP_TYPE:
-IMAGE_MAP_MOD:
+  exr | gif | hdr | iff | jpeg | pgm | png | ppm | sys | tga | tiff
    map_type Type | once | interpolate Type | use_alpha
-  ITEM_MAP_BODY:
+ITEM_MAP_BODY:
    ITEM_MAP_IDENTIFIER | ITEM_MAP_ENTRY...
-  ITEM_MAP_ENTRY:
+ITEM_MAP_ENTRY:
    [ GRAY_VALUE  ITEM_MAP_ENTRY... ]
 </pre>
-<p>It is also useful for creating texture <em>masks</em>, like the following:</p>
+<p>It is also useful for creating texture <em>masks</em> as in the following:</p>
 <pre>
 texture {
    image_pattern { tga &quot;image.tga&quot; use_alpha }
    texture_map {
-     [0 Mytex ]
+     [0 Mytex]
-     [1 pigment { transmit 1 } ]
+     [1 pigment { transmit 1 }]
+     }
+   }
 </pre>
-<p class="Note"><strong>Note:</strong> This pattern uses an image to get the gray values from. If you want exactly the
+<p class="Note"><strong>Note:</strong> This pattern uses an image to get the gray values. If you want exactly the same possibilities but need to get gray values from a pigment, you can use the [[Reference:Pigment Map|:pigment_pattern|pigment_pattern]].</p>
-same possibilities but need to get gray values from a pigment, you can use the [[Reference:Pigment Map|:pigment_pattern|pigment_pattern]].</p>
+<p>While POV-Ray will normally interpret the image pattern input file as a container of linear data irregardless of file type, this can be overridden for any individual image pattern input file by specifying <code>gamma</code> GAMMA immediately after the file name. For example:</p>
 <pre>
 image_pattern {
@@ Line 73: / Line 70: @@
+   }
 </pre>
-<p>This will cause POV-Ray to perform gamma adjustment or -decoding on the input file data before building the image pattern. Alternatively to a numerical value, <code>srgb</code> may be specified to denote that the file format is pre-corrected or encoded using the <em>sRGB transfer function</em> instead of a power-law gamma function. See section [[Documentation:Tutorial Section 3.3#Gamma Handling|Gamma Handling]] for more information on gamma.</p>
+<p>This will cause POV-Ray to perform gamma adjustment or decoding on the input file data before building the image pattern. Alternatively to a numerical value, <code>srgb</code> may be specified to denote that the file format is pre-corrected or encoded using the <em>sRGB transfer function</em> instead of a power-law gamma function. {{New}} in version 3.7.1, other valid special values are <code>bt709</code> and <code>bt2020</code>, denoting that the file is encoded or pre-corrected using the ITU-R BT.709 or BT.2020 transfer function, respectively. See section [[Documentation:Tutorial Section 3.3#Gamma Handling|Gamma Handling]] for more details.</p>

← Older revision		Revision as of 09:12, 1 March 2014
Line 74:		Line 74:
	</pre>		</pre>
	<p>This will cause POV-Ray to perform gamma adjustment or -decoding on the input file data before building the image pattern. Alternatively to a numerical value, <code>srgb</code> may be specified to denote that the file format is pre-corrected or encoded using the <em>sRGB transfer function</em> instead of a power-law gamma function. See section [[Documentation:Tutorial Section 3.3#Gamma Handling\|Gamma Handling]] for more information on gamma.</p>		<p>This will cause POV-Ray to perform gamma adjustment or -decoding on the input file data before building the image pattern. Alternatively to a numerical value, <code>srgb</code> may be specified to denote that the file format is pre-corrected or encoded using the <em>sRGB transfer function</em> instead of a power-law gamma function. See section [[Documentation:Tutorial Section 3.3#Gamma Handling\|Gamma Handling]] for more information on gamma.</p>
		+
		+
		+	<table class="centered" width="420px" cellpadding="0" cellspacing="10">
		+	<tr>
		+	<td>[[Image:RefImgImagePigment.png\|center\|200px<!--centered--->]]</td>
		+	<td>[[Image:RefImgImageNormal.png\|center\|200px<!--centered--->]]</td>
		+	</tr>
		+	<tr>
		+	<td colspan="2"><p class="caption">image pattern used as pigment and normal respectively</p></td>
		+	</tr>
		+	</table>

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