Difference between revisions of "User:Jholsenback"

From POV-Wiki
Jump to navigation Jump to search
m (beta34 section complete)
 
(101 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
===Organization===
 
===Organization===
 
<p align="justify">
 
<p align="justify">
−
Basically, I've been using this area as a scratch pad of sorts. As I complete things, and clean-up I'll probably just add a link [[User:Jholsenback#Links|here]] for reference. </p>
+
Basically, I've been using this area as a scratch pad of sorts. Old pages that I didn't want to loose track of are listed [[User:Jholsenback#Archives|here]] for easy access. </p>
  
 
===Scratch Pad===
 
===Scratch Pad===
−
====Change Log Extracts====
+
 
−
These are [http://www.povray.org/beta/changes.txt change-log] extracts that might be useful with helping to update the documentation. For now they are just in reverse chronological order until I can arrange them in a more useful manner.
+
====Syntax Diagram Examples====
−
=====Beta 35=====
+
<p>This is an example of the proposed format that's going to replace the pre-formatted text blocks which are currently being used, in the reference section narrative. Since there are some differences in the presentation of this construct in <em>html</em> and on <em>this documentation Wiki</em>, here's what you'll need to know.</p>
−
:*Radiosity <code>maximum_reuse</code> parameter now governs the maximum effective radius of a sample more directly.
+
<ol>
−
:* Added "out-of-the-box" transparency support for GIF files.
+
  <li>The syntax diagram is now inside a <strong>div</strong> tag instead of <strong>pre</strong> tag.</li>
−
:* Added support for PNG sRGB chunks.
+
  <li>The <strong>dt</strong> and <strong>dd</strong> elements of the list require that their ending tags be enclosed in the comments notation.</li>
−
<p class="Note"><strong>Note:</strong> Non-legacy scene default gamma handling for image input files has changed significantly from previous betas, affecting all file formats except OpenEXR, Radiance HDR and (with minor differences) most flavors of PNG; there will be NO corresponding warnings. See below for more detail.</p>
+
  <li>The first <strong>dt</strong> element that precedes the wiki link is required to properly align the link in the box.</li>
−
<p>Input image files not carrying unambiguous gamma information will now be assumed to match a common gamma setting, and gamma-adjusted accordingly; this common input file gamma setting can be specified in the scene file using the following syntax:</p>
+
  <li>Use underscores instead if spaces in the page address of the wiki link. The wiki parses to the first space to get the page address.</li>
−
<pre>
+
  <li>Please pick up the leading tabs when using copy and paste to maintain source readability when it's converted to html.</li>
−
global_settings {
+
  <li>No edits or comments on this copy, go [[User_Talk:Jholsenback|here]] instead.</li>
−
  file_gamma GAMMA
+
</ol>
−
  }
+
<p></p>
−
</pre>
+
<div class="Syntax">
−
<p>where GAMMA is either a numeric expression specifying the approximate display gamma for which input files are assumed to be gamma pre-corrected, or the keyword <code>srgb</code> indicating that input files are assumed to match the sRGB standard. (In the latter case, gamma adjustment is applied according to the sRGB standard, instead of approximating with a gamma 2.2 power-law function.) The default setting is sRGB.</p>
+
<dl>
−
<p>Regardless of this global setting, gamma correction is not applied if the image input file is obviously used as a mere data container, such as when immediately used in a height field.</p>
+
<dt><!--</dt>--->
−
<p>Default gamma handling rules for any image input file can be overridden by specifying <code>file_gamma</code> GAMMA immediately after the file name, e.g.:</p>
+
<dd class="Jump">[http://wiki.povray.org/content/Documentation:Reference_Section_3#Camera Go to documentation Wiki]<!--</dd>--->
−
<pre>
+
<dt>CAMERA:<!--</dt>--->
−
image_map {
+
<dd><code>camera {</code> [CAMERA_ITEMS...] <code>}</code><!--</dd>--->
−
  jpeg "foobar.jpg" file_gamma 1.8
+
<dt>CAMERA_ITEMS:<!--</dt>--->
−
  interpolate 2
+
<dd>CAMERA_TYPE | CAMERA_VECTOR | CAMERA_MODIFIER | CAMERA_IDENTIFIER<!--</dd>--->
−
  }
+
</dl>
−
</pre>
+
</div>
−
<p>This also applies to contexts where gamma adjustment is not normally applied, e.g. file formats that are defined to be encoded linearly, or files used in height fields, to simplify handling of files not conforming to standards.</p>
+
====Reference Section Reorganization====
−
<p class="Note"><strong>Note:</strong> Gamma handling for PNG input files has changed as follows in legacy <code>#version 3.6</code> scenes:</p>
+
<p>Starting a new sub-section for notes ... </p>
 +
 
 +
====Image Layout Templates====
 +
 
 +
<ul>
 +
  <li>single image narrative on the right with captions</li>
 +
</ul>
 +
 
 +
<table class="centered" width="700px" cellpadding="0" cellspacing="10">
 +
<tr>
 +
<td>
 +
[[Image:TutImgMediatut6.png|center|320px<!--left--->]]
 +
</td>
 +
<td>
 +
<p>As suggested previously, the scattering color and extinction values were adjusted until the image looked good. In this kind of scene usually very small values are needed.</p>
 +
 
 +
<p>Note how the container box is quite smaller than the room itself. Container boxes should always be sized as minimally as possible. If the box were as big as the room much higher values for <code>samples</code> would be needed for a good result, thus resulting in a much slower rendering.</p>
 +
</td>
 +
</tr>
 +
<tr>
 +
<td>
 +
  <p class="caption">more advanced scattering media example</p>
 +
</td>
 +
<td>
 +
</td>
 +
</tr>
 +
</table>
 +
 
 
<ul>
 
<ul>
−
<li>In the absence of an <code>assumed_gamma</code> statement, non-indexed PNG files with a gAMA chunk (i.e. virtually all PNG files) will appear far brighter than with POV-Ray 3.6</li>
+
  <li>same as above only mirrored</li>
−
<li>In the presence of an <code>assumed_gamma 1.0</code> statement, indexed PNG files (uncommon) will appear darker than with POV-Ray 3.6</li>
 
−
<li>In the presence of an <code>assumed_gamma 2.2</code> statement, PNG files with a gAMA lower than 2.2 (uncommon) will appear darker than with POV-Ray 3.6</li>
 
−
<li>PNG files with an sRGB chunk but no gAMA chunk may appear significantly different than with POV-Ray 3.6</li>
 
−
<li>PNG files may generally appear slightly different than with POV-Ray 3.6</li>
 
 
</ul>
 
</ul>
−
<p>A warning will be printed in these cases, except for the latter.</p>
+
 
−
=====Beta 34=====
+
<table class="centered" width="700px" cellpadding="0" cellspacing="10">
−
:* Added support for diffuse backside illumination:
+
<tr>
−
<p>To model thin, diffusely-translucent objects (e.g. paper, curtains, leaves etc.), an optional 2nd float parameter has been added to the <code>diffuse</code> finish statement to control the effect of illumination from the back of the surface. The default value is 0.0, i.e. no diffuse backside illumination. For realistic results, the sum of both parameters should be between 0.0 and 1.0, and the 2nd parameter should be the smaller of the two.</p>
+
<td>
−
<p class="Note"><strong>Note:</strong> This feature is currently experimental and may be subject to change. In particular, the syntax as well as interoperation with <code>double_illuminate</code>, multi-layered textures or <code>conserve_energy</code> are still under investigation.</p>
+
<p>As suggested previously, the scattering color and extinction values were adjusted until the image looked good. In this kind of scene usually very small values are needed. </p>
−
<p>A new sample scene, &quot;advanced/diffuse_back.pov&quot;, has been provided to illustrate this new feature.</p>
+
 
−
:* New option added speed up radiosity pretrace:
+
<p>Note how the container box is quite smaller than the room itself. Container boxes should always be sized as minimally as possible. If the box were as big as the room much higher values for <code>samples</code> would be needed for a good result, thus resulting in a much slower rendering. </p>
−
<p>As some computations don't contribute to the generation of radiosity samples, they can safely be skipped during radiosity pretrace to gain some speed if the pretrace's other role as a coarse preview is not required.</p>
+
</td>
−
<p>The following .ini file/command line options control whether pretrace performs all computations so it can double-feature as a coarse preview  (&quot;vain pretrace&quot;):</p>
+
<td >
−
<pre>
+
[[Image:TutImgMediatut6.png|center|320px<!--right--->]]
−
Radiosity_Vain_Pretrace=bool   turns vain pretrace on/off
+
</td>
−
+RVP                          turns vain pretrace on (default)
+
</tr>
−
-RVP                          turns vain pretrace off
+
<tr>
−
</pre>
+
<td>
−
<p class="Note"><strong>Note:</strong> with vain pretrace off, preview will look remarkably odd during the radiosity pretrace phase; this is normal, and no reason to be alarmed.</p>
+
</td>
−
<p>At the moment, turning vain pretrace off will affect only classic lighting computations (diffuse lighting, higlights and iridescence); other features expendable during pretrace may follow in future versions.</p>
+
<td>
−
:* Windows console version now sends stream output to stderr by default.
+
  <p class="caption">more advanced scattering media example</p>
−
=====Beta 33=====
+
</td>
 +
</tr>
 +
</table>
 +
 
 +
<ul>
 +
  <li>panel of 3 with a border and captions</li>
 +
</ul>
 +
 
 +
<table class="matte" width="700px" cellpadding="0" cellspacing="10">
 +
<tr>
 +
  <td>
 +
    [[Image:TutImgRadA01.png|center|220px<!--leftpanel--->]]
 +
  </td>
 +
  <td>
 +
    [[Image:TutImgRadA03.png|center|220px<!--centerpanel--->]]
 +
   </td>
 +
  <td>
 +
    [[Image:TutImgRadA0103.png|center|220px<!--rightpanel--->]]
 +
  </td>
 +
</tr>
 +
<tr>
 +
  <td>
 +
    <p class="caption">no radiosity</p>
 +
  </td>
 +
  <td>
 +
    <p class="caption">radiosity</p>
 +
  </td>
 +
  <td>
 +
    <p class="caption">difference w/o radiosity</p>
 +
  </td>
 +
</tr>
 +
</table>
  
 
====Keyword Addition Example====
 
====Keyword Addition Example====
 
This outlines the steps to add a new keyword to the documentation. In this case <code>deprecated</code>
 
This outlines the steps to add a new keyword to the documentation. In this case <code>deprecated</code>
  
−
:* first determine where the [[Documentation:Reference Section 2.4#Deprecation Support|descriptive passage]] goes then add it
+
:* first determine where the [[Reference:Declare_and_Local_Directives#Deprecation_Support|descriptive passage]] goes then add it
−
:* update the [[Documentation:Reference Section 2.4#The #declare and #local Directives|syntax diagram]] in the appropriate places
+
:* update the [[Reference:Declare_and_Local_Directives#Declaring_identifiers|syntax diagram]] in the appropriate places
−
:* update the [[Documentation:Reference Section 8#Identifier Declaration|syntax diagram]] in the Quick Reference
+
:* update the [[Reference:Keywords|Identifiers and Keywords]] list
−
:* update the [[Documentation:Reference Section 2#Identifiers and Keywords|Identifiers and Keywords]] list (not done yet)
+
:* document any other [[Reference:Glass_old.inc|place(s)]] that it's used
−
::<p class="Note"><strong>Note:</strong> save this until all keyword additions have been identified because it's an alphabetic list in html table form.</p>
 
−
:* document any other [[Documentation:Reference Section 7.2#glass_old.inc|place(s)]] that it's used
 
 
:* add a table of contents [[Documentation:Reference Table of Contents#Scene Description Language|entry]]
 
:* add a table of contents [[Documentation:Reference Table of Contents#Scene Description Language|entry]]
  
−
===Links===
+
====NEW Template Test Area====
−
:*The source and notes on the [[Documentation:LaTex_Files|LaTeX]] markup used in the documentation.
+
<p>The {{New}} and {{Change}} templates can now be used inside a paragraph. See additional examples:</p>
 +
:*<p>This is a {{New}} feature as of version 3.7.1</p>
 +
:*<p>... and this is a {{Change}} in behavior as of version 3.7.0</p>
 +
<p>See also:</p>
 +
:*Usage in [[Reference:Numeric Expressions#Built-in Constants|tau]]
 +
:*also for the [[Reference:Torus|torus]] object
 +
 
 +
===Archives===
 +
:* Developers [[ Documentation:Developers_Notes|notes]] from when the Wiki-DocGen project started
 +
:* The source and notes on the [[Documentation:LaTex_Files|LaTeX]] markup used in the documentation
 +
:* The change-log has been reviewed and the results are [[Documentation:ToDo ChangeListReview|here]]
 +
:* <p>Some text here just <span class="formula">f(x) = x&#770;&#915;</span> for comparison.</p>
 +
:* Some <em>wiki-docgen</em> process [[User:Jholsenback/WikiDocGen|notes]]

Latest revision as of 07:19, 18 September 2019

Organization

Basically, I've been using this area as a scratch pad of sorts. Old pages that I didn't want to loose track of are listed here for easy access.

Scratch Pad

Syntax Diagram Examples

This is an example of the proposed format that's going to replace the pre-formatted text blocks which are currently being used, in the reference section narrative. Since there are some differences in the presentation of this construct in html and on this documentation Wiki, here's what you'll need to know.

  1. The syntax diagram is now inside a div tag instead of pre tag.
  2. The dt and dd elements of the list require that their ending tags be enclosed in the comments notation.
  3. The first dt element that precedes the wiki link is required to properly align the link in the box.
  4. Use underscores instead if spaces in the page address of the wiki link. The wiki parses to the first space to get the page address.
  5. Please pick up the leading tabs when using copy and paste to maintain source readability when it's converted to html.
  6. No edits or comments on this copy, go here instead.

Go to documentation Wiki
CAMERA:
camera { [CAMERA_ITEMS...] }
CAMERA_ITEMS:
CAMERA_TYPE | CAMERA_VECTOR | CAMERA_MODIFIER | CAMERA_IDENTIFIER

Reference Section Reorganization

Starting a new sub-section for notes ...

Image Layout Templates

  • single image narrative on the right with captions
TutImgMediatut6.png

As suggested previously, the scattering color and extinction values were adjusted until the image looked good. In this kind of scene usually very small values are needed.

Note how the container box is quite smaller than the room itself. Container boxes should always be sized as minimally as possible. If the box were as big as the room much higher values for samples would be needed for a good result, thus resulting in a much slower rendering.

more advanced scattering media example
  • same as above only mirrored

As suggested previously, the scattering color and extinction values were adjusted until the image looked good. In this kind of scene usually very small values are needed.

Note how the container box is quite smaller than the room itself. Container boxes should always be sized as minimally as possible. If the box were as big as the room much higher values for samples would be needed for a good result, thus resulting in a much slower rendering.

TutImgMediatut6.png

more advanced scattering media example
  • panel of 3 with a border and captions
TutImgRadA01.png
TutImgRadA03.png
TutImgRadA0103.png

no radiosity

radiosity

difference w/o radiosity

Keyword Addition Example

This outlines the steps to add a new keyword to the documentation. In this case deprecated

NEW Template Test Area

The New and Change templates can now be used inside a paragraph. See additional examples:

  • This is a New feature as of version 3.7.1

  • ... and this is a Change in behavior as of version 3.7.0

See also:

Archives

  • Developers notes from when the Wiki-DocGen project started
  • The source and notes on the LaTeX markup used in the documentation
  • The change-log has been reviewed and the results are here

  • Some text here just f(x) = x̂Γ for comparison.

  • Some wiki-docgen process notes
Retrieved from "https://wiki.povray.org/content?title=User:Jholsenback&oldid=9703"