Documentation:Tutorial Section 2 - Revision history

Clipka: Indexentries fix

2016-12-16T14:03:36Z

Indexentries fix

Show changes

Jholsenback: layout changed

2016-10-16T13:57:31Z

layout changed

Jholsenback: minor grammar

2016-10-07T18:01:31Z

minor grammar

Jholsenback: better wording

2016-10-07T17:57:42Z

better wording

Jholsenback: user contributed clarification

2016-10-07T17:22:55Z

user contributed clarification

Clipka: indexentry fix

2016-05-03T22:38:46Z

indexentry fix

Jholsenback: link correction

2012-07-03T12:12:38Z

link correction

Jholsenback: 1 revision: link repair after reference reorg

2012-07-01T11:59:58Z

1 revision: link repair after reference reorg

Jholsenback: link repair

2012-06-29T23:57:23Z

link repair

Jholsenback: put it back

2011-12-20T09:01:56Z

put it back

@@ Line 27: / Line 27: @@
 <tr>
    <td>
-     [[Image:TutImgHanded.gif|center|220px<!--leftpanel--->]]
+     <p class="tabletext">This kind of coordinate system is called a left-handed coordinate system. If we use our left hand's fingers we can easily see why it is called left-handed. We just point our thumb in the direction of the positive x-axis (to the right), the index finger in the direction of the positive y-axis (straight up) and the middle finger in the positive z-axis direction (forward). We can only do this with our left hand. If we had used our right hand we would not have been able to point the middle finger in the correct direction.</p>
    </td>
    <td>
-     <p class="tabletext">This kind of coordinate system is called a left-handed coordinate system. If we use our left hand's fingers we can easily see why it is called left-handed. We just point our thumb in the direction of the positive x-axis (to the right), the index finger in the direction of the positive y-axis (straight up) and the middle finger in the positive z-axis direction (forward). We can only do this with our left hand. If we had used our right hand we would not have been able to point the middle finger in the correct direction.</p>
+     [[Image:TutImgHanded.gif|center|220px<!--rightpanel--->]]
    </td>
    <td>
-     [[Image:TutImgAerobics.png|center|220px<!--rightpanel--->]]
+     <p class="caption">The left-handed coordinate system</p>
    </td>
 </tr>
 <tr>
    <td>
-     <p class="caption">The left-handed coordinate system</p>
+     [[Image:TutImgAerobics.png|center|220px<!--leftpanel--->]]
    </td>
    <td>
+     <p class="tabletext">The left hand can also be used to determine rotation directions. To do this we must perform the famous <em>Computer Graphics Aerobics</em> exercise. We hold up our left hand and point our thumb in the positive direction of the axis of rotation. Our fingers will curl in the positive direction of rotation. Similarly if we point our thumb in the negative direction of the axis our fingers will curl in the negative direction of rotation.</p>
    </td>
    <td>
      <p class="caption">Computer Graphics Aerobics</p>
    </td>
 </tr>
 </table>
 {{#indexentry:Right-Handed coordinate system}}
 <p>When a right-handed system is used, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification will need to be changed, additionally be sure to use the right hand for the <em>Aerobics</em> exercise. This pertains to <em>both</em> the coordinate system and rotations. See the detailed description in [[Reference:Camera#Handedness|:Handedness|handedness]] for more information.</p>

@@ Line 52: / Line 52: @@
 {{#indexentry:Right-Handed coordinate system}}
-<p>When a right-handed system is used, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification will need to be changed, additionally be sure to use the right hand for the <em>Aerobics</em> exercise. This pertains to <em>both</em> the coordinate system and rotations. See the detailed description in [[Reference:Camera#Handedness|:Handedness|handedness]] for more details.</p>
+<p>When a right-handed system is used, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification will need to be changed, additionally be sure to use the right hand for the <em>Aerobics</em> exercise. This pertains to <em>both</em> the coordinate system and rotations. See the detailed description in [[Reference:Camera#Handedness|:Handedness|handedness]] for more information.</p>
 <p>There is some controversy over whether POV-Ray's method of doing a right-handed system is really proper. To avoid problems we stick with the left-handed system which is not in dispute.</p>
 {{#indexentry:Standard Include Files, adding}}

@@ Line 50: / Line 50: @@
 <p>The left hand can also be used to determine rotation directions. To do this we must perform the famous <em>Computer Graphics Aerobics</em> exercise. We hold up our left hand and point our thumb in the positive direction of the axis of rotation. Our fingers will curl in the positive direction of rotation. Similarly if we point our thumb in the negative direction of the axis our fingers will curl in the negative direction of rotation.</p>
 <p>In the above illustration, the left hand is curling around the x-axis. The thumb points in the positive x direction and the fingers curl over in the positive rotation direction.</p>
-<p>
 {{#indexentry:Right-Handed coordinate system}}
-If we want to use a right-handed system, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification needs to be changed. See the detailed description in [[Reference:Camera#Handedness|:Handedness|Handedness]]. When a right-handed system is used for POV-Ray be sure to use your right hand for the <em>Aerobics</em> exercise. This pertains to <em>both</em> the coordinate system and rotations.</p>
+<p>When a right-handed system is used, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification will need to be changed, additionally be sure to use the right hand for the <em>Aerobics</em> exercise. This pertains to <em>both</em> the coordinate system and rotations. See the detailed description in [[Reference:Camera#Handedness|:Handedness|handedness]] for more details.</p>
 <p>There is some controversy over whether POV-Ray's method of doing a right-handed system is really proper. To avoid problems we stick with the left-handed system which is not in dispute.</p>
 {{#indexentry:Standard Include Files, adding}}
 {{#indexentry:include, keyword}}

@@ Line 52: / Line 52: @@
 <p>
 {{#indexentry:Right-Handed coordinate system}}
-If we want to use a right-handed system, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification needs to be changed. See the detailed description in [[Reference:Camera#Handedness|:Handedness|Handedness]]. In a right-handed system we use our right hand for the <em>Aerobics</em>.</p>
+If we want to use a right-handed system, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification needs to be changed. See the detailed description in [[Reference:Camera#Handedness|:Handedness|Handedness]]. When a right-handed system is used for POV-Ray be sure to use your right hand for the <em>Aerobics</em> exercise. This pertains to <em>both</em> the coordinate system and rotations.</p>
 <p>There is some controversy over whether POV-Ray's method of doing a right-handed system is really proper. To avoid problems we stick with the left-handed system which is not in dispute.</p>
 {{#indexentry:Standard Include Files, adding}}
 {{#indexentry:include, keyword}}
 ====Adding Standard Include Files====
 <p>Using our personal favorite text editor, we create a file called <code>demo.pov</code>.

@@ Line 55: / Line 55: @@
 <p>There is some controversy over whether POV-Ray's method of doing a right-handed system is really proper. To avoid problems we stick with the left-handed system which is not in dispute.</p>
-{{#indexentry:Standard Include Files, adding|include, keyword}}
+{{#indexentry:Standard Include Files, adding}}
 ====Adding Standard Include Files====
 <p>Using our personal favorite text editor, we create a file called <code>demo.pov</code>.
@@ Line 686: / Line 687: @@
 <p>
 CSG objects can be extremely complex. They can be deeply nested. In other words there can be unions of differences or intersections of merges or differences of intersections or even unions of intersections of differences of merges... ad infinitum. CSG objects are (almost always) finite objects and thus respond to auto-bounding and can be transformed like any other POV primitive shape.</p>
-{{#indexentry:Union, CSG|union, tutorial}}
+{{#indexentry:Union, CSG}}
 ====CSG Union====

@@ Line 340: / Line 340: @@
 creates precise, sharp shadows. In the real world, penumbral or
 soft shadows are often seen. Later we will learn how to use
-[[Reference:Light Source|:light sources|extended light sources]] to soften the shadows.</p>
+[[Reference:Light Source#Area Lights|:light sources|extended light sources]] to soften the shadows.</p>
 {{#indexentry:torus, tutorial}}
 ====Torus Object====

← Older revision	Revision as of 11:59, 1 July 2012
(No difference)

@@ Line 14: / Line 14: @@
 things like placing cameras and light sources. We will also learn how to
 create a large variety of objects and how to assign different textures to
-them. The more sophisticated features like [[Documentation:Reference Section 3.2#How Radiosity Works|:radiosity|radiosity]],
+them. The more sophisticated features like [[Reference:Radiosity#How Radiosity Works|:radiosity|radiosity]],
-[[Documentation:Reference Section 6#Interior|:interior|interior]], [[Documentation:Reference Section 6.1#Media|:media|media]] and
+[[Reference:Interior|:interior|interior]], [[Reference:Media|:media|media]] and [[Reference:Atmospheric Media|:atmosphere|atmospheric effects]] will be explained in detail.</p>
 ===Our First Image===
@@ Line 53: / Line 52: @@
 <p>
 {{#indexentry:Right-Handed coordinate system}}
-If we want to use a right-handed system, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification needs to be changed. See the detailed description in [[Documentation:Reference Section 3#Handedness|:Handedness|Handedness]]. In a right-handed system we use our right hand for the <em>Aerobics</em>.</p>
+If we want to use a right-handed system, as some CAD systems and modelers do, the <code>right</code> vector in the camera specification needs to be changed. See the detailed description in [[Reference:Camera#Handedness|:Handedness|Handedness]]. In a right-handed system we use our right hand for the <em>Aerobics</em>.</p>
 <p>There is some controversy over whether POV-Ray's method of doing a right-handed system is really proper. To avoid problems we stick with the left-handed system which is not in dispute.</p>
@@ Line 89: / Line 88: @@
 may themselves contain include files, but we are limited to declaring
 includes nested only ten levels deep.</p>
-<p>Filenames specified in the include statements will be searched for in the current directory first. If it fails to find your .Inc files in the current directory, POV-Ray searches any [[Documentation:Reference Section 1.2#Library Paths|:library paths|library paths]] that you have specified. Library paths are options set by the <code>+L</code> [[Documentation:Tutorial Section 2.2#Command Line Switches|command-line switch]] or <code>[[Documentation:Reference Section 1.2#Library Paths|:Library_Path|Library_Path]]</code> option. See the chapter [[Documentation:Tutorial Section 2.2#Setting POV-Ray Options|Setting POV-Ray Options]] for more information on library paths.</p>
+<p>Filenames specified in the include statements will be searched for in the current directory first. If it fails to find your .Inc files in the current directory, POV-Ray searches any [[Reference:Scene Parsing Options#Library Paths|:library paths|library paths]] that you have specified. Library paths are options set by the <code>+L</code> [[Documentation:Tutorial Section 2.2#Command Line Switches|command-line switch]] or <code>[[Reference:Scene Parsing Options#Library Paths|:Library_Path|Library_Path]]</code> option. See the chapter [[Documentation:Tutorial Section 2.2#Setting POV-Ray Options|Setting POV-Ray Options]] for more information on library paths.</p>
 <p>Because it is more useful to keep include files in a separate directory, standard installations of POV-Ray place these files in the <code>c:\povray3\include</code> directory (replace <code>c:\povray3</code> with the actual directory that you installed POV-Ray in). If you get an error message saying that POV-Ray cannot open <em>colors.inc</em> or other include files, make sure that you specify the library path properly.</p>
 {{#indexentry:Camera, adding}}
@@ Line 161: / Line 160: @@
 colors.inc</code>.</p>
 <p>
-If no standard color is available for our needs, we may define our own color by using the [[Documentation:Reference Section 2.1#Specifying Colors|:color|color]] keyword followed by <code>red</code>, <code>green</code> and <code> blue</code> keywords specifying the amount of red, green and blue to be mixed. For example a nice shade of pink can be specified by:</p>
+If no standard color is available for our needs, we may define our own color by using the [[Reference:Color Expressions|:color|color]] keyword followed by <code>red</code>, <code>green</code> and <code> blue</code> keywords specifying the amount of red, green and blue to be mixed. For example a nice shade of pink can be specified by:</p>
 <pre>
    color red 1.0 green 0.8 blue 0.8
@@ Line 181: / Line 180: @@
 </pre>
-<p>Colors are explained in more detail in section [[Documentation:Reference Section 2.1#Specifying Colors|Specifying Colors]].</p>
+<p>Colors are explained in more detail in section [[Reference:Color Expressions|:color|Color Expressions]].</p>
 {{#indexentry:light_source, defining}}
@@ Line 341: / Line 340: @@
 creates precise, sharp shadows. In the real world, penumbral or
 soft shadows are often seen. Later we will learn how to use
-[[Documentation:Reference Section 4.4#Light Sources|:light sources|extended light sources]] to soften the shadows.</p>
+[[Reference:Light Source|:light sources|extended light sources]] to soften the shadows.</p>
 {{#indexentry:torus, tutorial}}
 ====Torus Object====
@@ Line 682: / Line 681: @@
 {{#indexentry:CSG, what is}}
 ====What is CSG?====
-<p><em>CSG</em> stands for <em>Constructive Solid Geometry</em>. POV-Ray allows us to construct complex solids by combining primitive shapes in four different ways. In the <code>[[Documentation:Reference Section 4.3#Union|:union|union]]</code> statement, two or more shapes are added together. With the <code>[[Documentation:Reference Section 4.3#Intersection|:intersection|intersection]]</code> statement, two or more shapes are combined to make a new shape that consists of the area common to both shapes. The <code>[[Documentation:Reference Section 4.3#Difference|:difference|difference]]</code> statement, an initial shape has all subsequent shapes subtracted from it.</p>
+<p><em>CSG</em> stands for <em>Constructive Solid Geometry</em>. POV-Ray allows us to construct complex solids by combining primitive shapes in four different ways. In the <code>[[Reference:Union|:union|union]]</code> statement, two or more shapes are added together. With the <code>[[Reference:Intersection|:intersection|intersection]]</code> statement, two or more shapes are combined to make a new shape that consists of the area common to both shapes. The <code>[[Reference:Difference|:difference|difference]]</code> statement, an initial shape has all subsequent shapes subtracted from it.</p>
 <p>
-And last but not least <code>[[Documentation:Reference Section 4.3#Merge|:merge|merge]]</code>, which is like a union where the surfaces inside the union are removed (useful in transparent CSG objects). We will deal with each of these in detail in the next few sections.</p>
+And last but not least <code>[[Reference:Merge|:merge|merge]]</code>, which is like a union where the surfaces inside the union are removed (useful in transparent CSG objects). We will deal with each of these in detail in the next few sections.</p>
 <p>
 CSG objects can be extremely complex. They can be deeply nested. In other words there can be unions of differences or intersections of merges or differences of intersections or even unions of intersections of differences of merges... ad infinitum. CSG objects are (almost always) finite objects and thus respond to auto-bounding and can be transformed like any other POV primitive shape.</p>