Reference:General Output Options - Revision history

Jholsenback: version changes

2017-06-26T10:08:06Z

version changes

Clipka: Another indexentry fix

2016-12-17T12:58:52Z

Another indexentry fix

Clipka: Indexentries fix

2016-12-16T14:59:40Z

Indexentries fix

Jholsenback: 3.7.1 updates

2016-12-08T17:12:09Z

3.7.1 updates

Jholsenback: noting deprecation

2016-12-08T15:57:02Z

noting deprecation

Clipka: indexentry fix

2016-05-03T23:17:05Z

indexentry fix

Jholsenback: technical corrections

2012-11-09T11:46:46Z

technical corrections

Jholsenback: cleanup

2012-08-10T15:28:58Z

cleanup

Jholsenback: 1 revision: underscore link repair

2012-07-17T18:09:33Z

1 revision: underscore link repair

Jholsenback: still testing that theory

2012-07-12T08:51:43Z

still testing that theory

@@ Line 285: / Line 285: @@
 <code>+FN</code><em>n</em>, which will override these settings. It is up to the user to make sure that all other options are set the same as the original render.</p>
-<p>{{New}} as of version 3.7.1 the <code>Create_Continue_Trace_Log</code> option was added to offer greater resource control. The user can suppress the creation of this file by simply setting the <em>ini-option</em> <code>Create_Continue_Trace_Log=false</code> or using the <code>-CC</code> command line option.</p>
+<p>{{New}} as of version 3.8 the <code>Create_Continue_Trace_Log</code> option was added to offer greater resource control. The user can suppress the creation of this file by simply setting the <em>ini-option</em> <code>Create_Continue_Trace_Log=false</code> or using the <code>-CC</code> command line option.</p>
 <p>The <code>Create_Ini</code> option or <code>+GI</code> switch provides an easy way to create an INI file with all of the rendering options, so you can re-run files with the same options, or ensure you have all the same options when resuming. This option creates an INI file with every option set at the value used for that rendering. This includes default values which you have not specified. For example if you run POV-Ray with...</p>

@@ Line 1: / Line 1: @@
 [[Category:Command-Line and INI-File Options]]
 {{#indexentry:Options, general output}}
 {{#indexentry:Options, height and width}}
 {{#indexentry:Resolution}}
 <table width="100%" class="option-list">

@@ Line 53: / Line 53: @@
 <p>This INI parameter sets the number of megabytes of RAM to allow for output image caching. If the output image happens to use more than this, a file backed temporary image is used instead. If using this option you <em>must</em> specify a value. This option is on by default and its value is 128.</p>
 {{#indexentry:Options, partial output}}
 <table width="100%" class="option-list">
 <tr>
@@ Line 166: / Line 166: @@
 <p>When rendering a subset of <em>columns</em> (<code>+sc/+ec</code>) and/or <em>rows</em> (<code>+sr/+er</code>), POV-Ray generates a full width image and fills the not rendered columns with black pixels. This should not be a problem for any image reading program no matter what file format is used. Earlier versions of POV-Ray had problems when a subset of <em>rows</em> (<code>+sr/+er</code>) was rendered.  The full height information was written into the image file header but it only wrote image data for those lines that were actually rendered. This made output files that were incompatible with various image processing tools. In version 3.7 this is no longer the case.</p>
 {{#indexentry:Options, interruption}}
 <p class="Note"><strong>Note:</strong> {{Change}} these items are <em>deprecated</em> as of version 3.7</p>
 <table width="100%" class="option-list">
@@ Line 223: / Line 222: @@
 scene lines parsed.</p>
 {{#indexentry:Options, resuming}}
 <table width="100%" class="option-list">
 <tr>

@@ Line 240: / Line 240: @@
 <td><code>-C</code>{{#indexentry:-c}}</td>
 <td>Sets continued trace off</td>
 </tr>
@@ Line 263: / Line 278: @@
 </table>
-<p>If you abort a render while it is in progress or if you used the <code>[[Reference:General Output Options#Partial Output Options|:End_Row|End_Row]]</code> option to end the render prematurely, you can use <code>Continue_Trace=on</code> or <code>+C</code> option to continue the render later at the point where you left off. This option reads in the previously generated output file, displays the partial image rendered so far, then
+<p>If you abort a render while it is in progress or if you used the <code>[[Reference:General Output Options#Partial Output Options|:End_Row|End_Row]]</code> option to end the render prematurely, you can use <code>Continue_Trace=on</code> or <code>+C</code> option to continue the render later at the point where you left off. This option reads in the previously generated output file, displays the partial image rendered so far, then proceeds with the ray-tracing. The state or continue trace information file must exist for the <code>Continue_Trace=true</code> / <code>+C</code> option to work.</p>
 <p>The <code>Continue_Trace</code> option may not work if the <code>Start_Row</code> option has been set to anything but the top of the file, depending on the output format being used. Also POV-Ray cannot continue the file once it has been opened and saved again by any program.</p>
@@ Line 271: / Line 285: @@
 specified. Some file formats (namely TGA and PNG) also store information about where the file started (i. e. <code> +SC</code><em>n</em> and <code>+SR</code><em>n</em> options), alpha output <code>+UA</code>, and bit-depth
 <code>+FN</code><em>n</em>, which will override these settings. It is up to the user to make sure that all other options are set the same as the original render.</p>
 <p>The <code>Create_Ini</code> option or <code>+GI</code> switch provides an easy way to create an INI file with all of the rendering options, so you can re-run files with the same options, or ensure you have all the same options when resuming. This option creates an INI file with every option set at the value used for that rendering. This includes default values which you have not specified. For example if you run POV-Ray with...</p>

@@ Line 169: / Line 169: @@
 ==Interrupting Options==
+<p class="Note"><strong>Note:</strong> {{Change}} these items are <em>deprecated</em> as of version 3.7</p>
 <table width="100%" class="option-list">
 <tr>
@@ Line 224: / Line 224: @@
 {{#indexentry:Options, resuming}}
 ==Resuming Options==
 <table width="100%" class="option-list">

@@ Line 65: / Line 65: @@
 <td>Set first column to n percent of width</td>
 </tr>
@@ Line 70: / Line 76: @@
 <td><code>+SC</code>0.n{{#indexentry:+sc}}</td>
-<td>Same as <code>Start_Column</code></td>
+<td>Same as <code>Start_Column=</code>0.n</td>
 </tr>
@@ Line 86: / Line 92: @@
 <tr>
-<td><code>+S</code>n{{#indexentry:+sr}}</td>
+<td><code>+SR</code>n{{#indexentry:+sr}}</td>
 <td>Same as <code>Start_Row=</code>n</td>
@@ Line 92: / Line 98: @@
 <tr>
-<td><code>+SR</code>0.n or <code>+S</code>0.n</td>
+<td><code>+SR</code>0.n</td>
 <td>Same as <code>Start_Row=</code>0.n</td>
@@ Line 107: / Line 113: @@
 <td>Set last column to n percent of width</td>
 </tr>
@@ Line 112: / Line 124: @@
 <td><code>+EC</code>0.n{{#indexentry:+ec}}</td>
-<td>Same as <code>End_Column</code></td>
+<td>Same as <code>End_Column=</code>0.n</td>
 </tr>
@@ Line 128: / Line 140: @@
 <tr>
-<td><code>+E</code>n{{#indexentry:+er}}</td>
+<td><code>+ER</code>n{{#indexentry:+er}}</td>
 <td>Same as <code>End_Row=</code>n</td>
@@ Line 134: / Line 146: @@
 <tr>
-<td><code>+ER</code>0.n or <code>+E</code>0.n</td>
+<td><code>+ER</code>0.n</td>
 <td>Same as <code>End_Row=</code>0.n</td>
@@ Line 147: / Line 159: @@
 <p> For example: <code> Start_Row=0.75</code> and <code>Start_Column=0.75</code> starts on a row 75% down from the top at a column 75% from the left. Thus it renders only the lower-right 25% of the image regardless of the specified width and height.</p>
-<p>The <code>+SR</code>, <code>+ER</code>, <code> +SC</code> and <code>+EC</code> switches work in the same way as the corresponding INI-style settings for both absolute settings or percentages. Early versions of POV-Ray allowed only start and end rows to be specified with <code>+S</code><em>n</em> and <code> +E</code><em>n</em> so they are still supported in addition to <code> +SR</code> and <code>+ER</code>.</p>
+<p>The <code>+SR</code>, <code>+ER</code>, <code> +SC</code> and <code>+EC</code> switches work in the same way as the corresponding INI-style settings for both absolute settings or percentages.</p>
 <p>When rendering a subset of <em>columns</em> (<code>+sc/+ec</code>) and/or <em>rows</em> (<code>+sr/+er</code>), POV-Ray generates a full width image and fills the not rendered columns with black pixels. This should not be a problem for any image reading program no matter what file format is used. Earlier versions of POV-Ray had problems when a subset of <em>rows</em> (<code>+sr/+er</code>) was rendered.  The full height information was written into the image file header but it only wrote image data for those lines that were actually rendered. This made output files that were incompatible with various image processing tools. In version 3.7 this is no longer the case.</p>
 {{#indexentry:Options, interruption}}
 ==Interrupting Options==

@@ Line 212: / Line 212: @@
 <tr>
 <td width="30%"><code>Continue_Trace=</code>bool{{#indexentry:Continue_Trace, ini-option}}</td>
 <td width="70%">Sets continued trace on/off</td>
 </tr>
@@ Line 218: / Line 217: @@
 <tr>
 <td><code>+C</code>{{#indexentry:+c}}</td>
 <td>Sets continued trace on</td>
 </tr>
@@ Line 224: / Line 222: @@
 <tr>
 <td><code>-C</code>{{#indexentry:-c}}</td>
 <td>Sets continued trace off</td>
 </tr>
@@ Line 230: / Line 227: @@
 <tr>
 <td><code>Create_Ini=</code>file{{#indexentry:Create_Ini, ini-option}}</td>
 <td>Generate an INI file to file</td>
 </tr>
@@ Line 236: / Line 232: @@
 <tr>
 <td><code>Create_Ini=</code>true</td>
 <td>Generate file.ini where file is scene name.</td>
 </tr>
@@ Line 242: / Line 237: @@
 <tr>
 <td><code>Create_Ini=</code>false</td>
 <td>Turn off generation of previously set file.ini</td>
 </tr>
@@ Line 248: / Line 242: @@
 <tr>
 <td><code>+GI</code>file{{#indexentry:+gi}}</td>
 <td>Same as <code>Create_Ini=</code>file</td>
 </tr>
 </table>
-<p>If you abort a render while it is in progress or if you used the
+<p>If you abort a render while it is in progress or if you used the <code>[[Reference:General Output Options#Partial Output Options|:End_Row|End_Row]]</code> option to end the render prematurely, you can use <code>Continue_Trace=on</code> or <code>+C</code> option to continue the render later at the point where you left off. This option reads in the previously generated output file, displays the partial image rendered so far, then
-<code>[[Reference:General Output Options#Partial Output Options|:End_Row|End_Row]]</code> option to end the render prematurely, you can use
+proceeds with the ray-tracing. This option cannot be used if file output is disabled with <code>[[Reference:File Output Options|:Output_to_file|Output_to_file]]=off</code> or <code>-F</code>.</p>
 <code>Continue_Trace=on</code> or <code>+C</code> option to continue the render
-later at the point where you left off. This option reads in the previously
+<p>The <code>Continue_Trace</code> option may not work if the <code>Start_Row</code> option has been set to anything but the top of the file, depending on the output format being used. Also POV-Ray cannot continue the file once it has been opened and saved again by any program.</p>
 generated output file, displays the partial image rendered so far, then
-proceeds with the ray-tracing. This option cannot be used if file output is
+<p>POV-Ray tries to figure out where to resume an interrupted trace by reading any previously generated data in the specified output file. All file formats contain the image size, so this will override any image size settings
-disabled with <code>[[Reference:File Output Options|:Output_to_file|Output_to_file]]=off</code>
+specified. Some file formats (namely TGA and PNG) also store information about where the file started (i. e. <code> +SC</code><em>n</em> and <code>+SR</code><em>n</em> options), alpha output <code>+UA</code>, and bit-depth
-or <code>-F</code>.</p>
+<code>+FN</code><em>n</em>, which will override these settings. It is up to the user to make sure that all other options are set the same as the original render.</p>
 <p>
-The <code>Continue_Trace</code> option may not work if the <code>Start_Row</code>
+<p>The <code>Create_Ini</code> option or <code>+GI</code> switch provides an easy way to create an INI file with all of the rendering options, so you can re-run files with the same options, or ensure you have all the same options when resuming. This option creates an INI file with every option set at the value used for that rendering. This includes default values which you have not specified. For example if you run POV-Ray with...</p>
 option has been set to anything but the top of the file, depending on the output format being used. Also POV-Ray cannot continue the file once it has been opened and saved again by any program</p>
 <pre>
 POVRAY +Isimple.pov MYOPTS +GIrerun.ini MOREOPTS
 </pre>
-<p>POV-Ray will create a file called <code>rerun.ini</code> with all of the
+<p>POV-Ray will create a file called <code>rerun.ini</code> with all of the options used to generate this scene. The file is not written until all options have been processed. This means that in the above example, the file
-options used to generate this scene. The file is not written until all
+will include options from both <code>myopts.ini</code> and <code>moreopts.ini</code> despite the fact that the <code>+GI</code> switch is specified between them. You may now re-run the scene with...</p>
 options have been processed. This means that in the above example, the file
 <pre>
 POVRAY RERUN
@@ Line 296: / Line 269: @@
 <p>or resume an interrupted trace with</p>
 <pre>
 POVRAY RERUN +C
 </pre>
-<p>If you add other switches with the <code>rerun.ini</code> reference, they
+<p>If you add other switches with the <code>rerun.ini</code> reference, they will be included in future re-runs because the file is re-written every time you use it.</p>
 will be included in future re-runs because the file is re-written every time
-you use it.</p>
+<p>The <code>Create_Ini</code> option is also useful for documenting how a scene was rendered. If you render <code> waycool.pov</code> with <code>Create_Ini=on</code> then it will create a file <code>waycool.ini</code> that
-<p>
+you could distribute along with your scene file so other users can exactly re-create your image.</p>

← Older revision	Revision as of 18:09, 17 July 2012
(No difference)