Reference:Global Settings - Revision history

Clipka: /* Noise_generator */ canonicalize a version number

2021-06-09T14:37:18Z

Noise_generator: canonicalize a version number

Clipka: /* Assumed_Gamma */ canonicalize a version number

2021-06-09T14:34:53Z

Assumed_Gamma: canonicalize a version number

Jholsenback: move detail to output file type

2018-10-27T07:44:08Z

move detail to output file type

Jholsenback: indexentries reviewed no changes

2016-12-16T17:58:55Z

indexentries reviewed no changes

Jholsenback: more link repairs

2016-11-21T20:30:32Z

Jholsenback: link repair

2016-11-21T20:27:49Z

link repair

Jholsenback: corrections

2015-03-15T13:06:40Z

corrections

Jholsenback: indexentry tag repair

2015-03-15T12:53:33Z

indexentry tag repair

Jholsenback: clarification

2014-04-17T10:20:33Z

clarification

Jholsenback: over zealous "cut" removed tag(s)

2014-04-07T11:53:48Z

over zealous "cut" removed tag(s)

@@ Line 254: / Line 254: @@
 <p> There are three noise generators implemented. </p>
 <ul>
-<li><code>noise_generator 1</code> the noise that was used in POV_Ray 3.1</li>
+<li><code>noise_generator 1</code> the noise that was used in POV_Ray v3.1</li>
 <li><code>noise_generator 2</code> 'range corrected' version of the old noise, it does not show the plateaus seen with <code>noise_generator 1</code> </li>
 <li><code>noise_generator 3</code> generates Perlin noise</li>

@@ Line 119: / Line 119: @@
 <p class="Note"><strong>Note:</strong> Using any value other than 1.0 will produce physically inaccurate results. Furthermore, if you decide to go for a different value for convenience, it is highly recommended to set this value to the same as your <code>Display_Gamma</code>. Using this parameter for artistic purposes is strongly discouraged.</p>
-<p class="Note"><strong>Note:</strong> As of POV-Ray 3.7 this keyword is considered mandatory (except in legacy scenes) and consequently enables the <em>experimental</em> gamma handling feature. Future versions of POV-Ray may treat the absence of this keyword in non-legacy scenes as an error.</p>
+<p class="Note"><strong>Note:</strong> As of POV-Ray v3.7 this keyword is considered mandatory (except in legacy scenes) and consequently enables the <em>experimental</em> gamma handling feature. Future versions of POV-Ray may treat the absence of this keyword in non-legacy scenes as an error.</p>
 <p>See section [[Documentation:Tutorial Section 3.3#Gamma Handling|Gamma Handling]] for more information about gamma.</p>

@@ Line 126: / Line 126: @@
 {{#indexentry:hf_gray_16, global_settings}}
 {{#indexentry:keyword, hf_gray_16}}
-<p class="Note"><strong>Note:</strong> In version 3.7 the <code>hf_gray_16</code> keyword in the <code>global_settings</code> block has been deprecated. If encountered, it has no effect on the output type and will additionally generate a warning message.</p>
+<p>A {{Change}} as of version 3.7 has deprecated the <code>hf_gray_16</code> keyword in the <code>global_settings</code> block. If encountered, it has no effect on the output type and will additionally generate a warning message. Grayscale output can still be used to generate heightfields for use in other POV-Ray scenes. See: [[Reference:File Output Options#Output File Type|Output File Type]] for details.</p>
 ==Irid_Wavelength==

@@ Line 110: / Line 110: @@
 &lt;1,1,1&gt;</code>. Only the rgb components are used. The actual ambient
 used is: <em>Ambient = Finish_Ambient * Global_Ambient</em>.</p>
-<p>
+<p>See the section [[Reference:Finish#Ambient|Ambient]] for more information.</p>
 ==Assumed_Gamma==

@@ Line 92: / Line 92: @@
 <code>max_trace_level</code> to set an upper limit on the number of rays spawned.</p>
 <p>
-See the section [[Reference:Global Settings#Max_Trace_Level|:max_trace_level|Max_Trace_Level]] for details on how ADC and <code>max_trace_level</code> interact.</p>
+See the section [[Reference:Global Settings#Max_Trace_Level|Max_Trace_Level]] for details on how ADC and <code>max_trace_level</code> interact.</p>
 ==Ambient_Light==
@@ Line 133: / Line 133: @@
 <p>With <code>Grayscale_Output=true</code>, the <strong>output file</strong> will be in the form of a grayscale image that can be used to generate heightfields, because the height at any point is dependent on the brightness of the pixel. The brightness of a pixel is calculated in the same way that color images are converted to grayscale images:<em><code> height = 0.3 * red + 0.59 * green + 0.11 * blue</code></em>.</p>
-<p>It should also be noted that setting the <code>Grayscale_Output=true</code> INI option will <strong>NOT</strong> cause the preview display, if used, to be grayscale rather than color. See the section [[Reference:Height Field|:Height Field|Height Field]] for a description of how POV-Ray heightfields are stored for each file type.</p>
+<p>It should also be noted that setting the <code>Grayscale_Output=true</code> INI option will <strong>NOT</strong> cause the preview display, if used, to be grayscale rather than color. See the section [[Reference:Height Field|Height Field]] for a description of how POV-Ray heightfields are stored for each file type.</p>
 <p class="Note"><strong>Note:</strong> Grayscale output implies the maximum bit-depth the format supports is 16, it is not valid to specify bits per color channel with 'g' (e.g. <code>+Fng16</code> is not allowed, and nor for that matter is <code>+Fn16g</code>). If bits per channel is provided via an INI option, it is ignored.</p>
@@ Line 217: / Line 217: @@
 approximately 0.0039 since a change smaller than that could not be visible in
 a 24 bit image. Generally this setting is perfectly adequate and should be
-left alone. Setting <code>[[Reference:Global Settings#ADC_Bailout|:adc_bailout|adc_bailout]]</code> to 0 will disable ADC, relying
+left alone. Setting <code>[[Reference:Global Settings#ADC_Bailout|adc_bailout]]</code> to 0 will disable ADC, relying
 completely on <code> max_trace_level</code> to set an upper limit on the
 number of rays spawned.</p>
@@ Line 252: / Line 252: @@
 {{#indexentry:number_of_waves, global_settings}}
 {{#indexentry:keyword, number_of_waves}}
-<p>The <code>[[Reference:Waves Pattern|:waves|waves]]</code> and <code>[[Reference:Ripples Pattern|:ripples|ripples]]</code>
+<p>The <code>[[Reference:Waves Pattern|waves]]</code> and <code>[[Reference:Ripples Pattern|ripples]]</code>
 patterns are generated by summing a series of waves, each with a slightly different center and size. By default, ten waves are summed but this amount can be globally controlled by changing the <code>number_of_waves</code> setting.</p>
 <pre>

@@ Line 70: / Line 70: @@
 item are given in the following sections.</p>
 {{#indexentry:adc_bailout, global_settings}}
 {{#indexentry:keyword, adc_bailout}}
 <p>In scenes with many reflective and transparent surfaces, POV-Ray can get
 bogged down tracing multiple reflections and refractions that contribute very
@@ Line 94: / Line 94: @@
 See the section [[Reference:Global Settings#Max_Trace_Level|:max_trace_level|Max_Trace_Level]] for details on how ADC and <code>max_trace_level</code> interact.</p>
 {{#indexentry:ambient_light, global_settings}}
 {{#indexentry:keyword, ambient_light}}
 <p>Ambient light is used to simulate the effect of inter-diffuse reflection
 that is responsible for lighting areas that partially or completely lie in
@@ Line 114: / Line 113: @@
 See the section [[Reference:Finish#Ambient|:Ambient|Ambient]] for more information.</p>
 {{#indexentry:assumed_gamma, keyword}}
 {{#indexentry:keyword, assumed_gamma}}
 <p>The <code>assumed_gamma</code> statement specifies a dsiplay gamma for which all color literals in the scene are presumed to be pre-corrected; at the same time it also defines the <em>working gamma space</em> in which POV-Ray will perform all its color computations.</p>
@@ Line 125: / Line 124: @@
 <p>See section [[Documentation:Tutorial Section 3.3#Gamma Handling|Gamma Handling]] for more information about gamma.</p>
 {{#indexentry:hf_gray_16, global_settings}}
 {{#indexentry:keyword, hf_gray_16}}
 <p>Grayscale output can be used to generate heightfields for use in other POV-Ray scenes, and may be specified via <code>Grayscale_Output=true</code> as an INI option, or <code>+Fxg</code> (for output type 'x') as a command-line option. For example, <code>+Fng</code> for PNG and <code>+Fpg</code> for PPM (effectively PGM) grayscale output. By default this option is off.</p>
@@ Line 141: / Line 139: @@
 <p>Currently PNG, and PPM are the only file formats that support grayscale output.</p>
 {{#indexentry:irid_wavelength, global_settings}}
 {{#indexentry:keyword, irid_wavelength}}
 <p>Iridescence calculations depend upon the dominant wavelengths of the
 primary colors of red, green and blue light. You may adjust the values using
@@ Line 159: / Line 156: @@
 option as a means to experiment with other values.</p>
 {{#indexentry:charset, global_settings}}
 {{#indexentry:keyword, charset}}
@@ Line 167: / Line 165: @@
 {{#indexentry:sys, global_settings}}
 {{#indexentry:keyword, sys}}
 <p>This allows you to specify the assumed character set of all text strings.
 If you specify <code>ascii</code> only standard ASCII character codes in the
@@ Line 182: / Line 178: @@
 specific documentation.</p>
 {{#indexentry:max_trace_level, global_settings}}
 {{#indexentry:keyword, max_trace_level}}
 <p>In scenes with many reflective and transparent surfaces POV-Ray can get
 bogged down tracing multiple reflections and refractions that contribute very
@@ Line 243: / Line 239: @@
 </p>
 {{#indexentry:max_intersections, global_settings}}
 {{#indexentry:keyword, max_intersections}}
 <p>Previous versions of POV-Ray used a set of internal stacks to collect ray/object intersection points. As of version 3.7 <code>max_intersections</code> has been deprecated, and using it in the global settings blocks now produces a warning at parse time.</p>
 {{#indexentry:mm_per_unit, global_settings}}
 {{#indexentry:keyword, mm_per_unit}}
 <p>See the section [[Reference:Finish#Subsurface Light Transport|Subsurface Light Transport]] for more information about the role of <code>mm_per_unit</code> in the global settings block.</p>
 {{#indexentry:number_of_waves, global_settings}}
 {{#indexentry:keyword, number_of_waves}}
 <p>The <code>[[Reference:Waves Pattern|:waves|waves]]</code> and <code>[[Reference:Ripples Pattern|:ripples|ripples]]</code>
 patterns are generated by summing a series of waves, each with a slightly different center and size. By default, ten waves are summed but this amount can be globally controlled by changing the <code>number_of_waves</code> setting.</p>
@@ Line 267: / Line 260: @@
 <p>Changing this value affects both waves and ripples alike on all patterns in the scene.</p>
 {{#indexentry:noise_generator, global_settings}}
 {{#indexentry:keyword, noise_generator}}
 <p> There are three noise generators implemented. </p>
 <ul>
@@ Line 279: / Line 272: @@
 <p class="Note"><strong>Note:</strong> The noise_generators can also be used within the pigment/normal/etc. statement.</p>
 {{#indexentry:subsurface, global_settings}}
 <p>See the section [[Reference:Finish#Subsurface Light Transport|Subsurface Light Transport]] for more information about the role of <code>subsurface</code> in the global settings block.</p>

@@ Line 248: / Line 248: @@
 ==Max_Intersections==
 <p>Previous versions of POV-Ray used a set of internal stacks to collect ray/object intersection points. As of version 3.7 <code>max_intersections</code> has been deprecated, and using it in the global settings blocks now produces a warning at parse time.</p>
 ==Mm_Per_Unit==