Documentation:Tutorial Section 3.1 - Revision history

Clipka: Indexentries fix

2016-12-16T14:09:35Z

Indexentries fix

Jholsenback: moved out of place section

2016-12-07T21:20:52Z

moved out of place section

Clipka: indexentry fix

2016-05-03T22:45:05Z

indexentry fix

Jholsenback: 1 revision: link repair after reference reorg

2012-07-01T12:00:02Z

1 revision: link repair after reference reorg

Jholsenback: link repair

2012-06-30T18:40:50Z

link repair

ThorstenFroehlich at 19:55, 26 November 2011

2011-11-26T19:55:16Z

Jholsenback: image format changes

2011-05-25T18:01:48Z

image format changes

Jholsenback: continue cleanup pass

2010-09-16T15:35:57Z

continue cleanup pass

Jholsenback: heading chages

2010-03-25T07:36:46Z

heading chages

Jholsenback: removed famous quote(s) in 2 places

2010-03-18T17:11:49Z

removed famous quote(s) in 2 places

@@ Line 7: / Line 7: @@
 <br>
 <!--</wikitalk>--->
 {{#indexentry:Shapes, polygon based}}
-===Polygon Based Shapes===
 {{#indexentry:mesh, tutorial}}
 <p>Mesh objects are very useful because they allow us to create objects
 containing hundreds or thousands of triangles. Compared to a simple union of
@@ Line 459: / Line 460: @@
 <code>mesh2</code>. uv_mapping is supported for texturing using a <code>texture_list</code>.</p>
 {{#indexentry:polygon, tutorial}}
 <p>The <code><!--<linkto "polygon">polygon</linkto>--->[[Reference:Polygon|polygon]]</code> object can be used to create any planar, n-sided shapes like squares, rectangles, pentagons, hexagons, octagons, etc.</p>
 <p>
@@ Line 593: / Line 594: @@
 </table>
 {{#indexentry:Shapes, other}}
-===Other Shapes===
 ====Blob Object====
 <p>Blobs are described as spheres and cylinders covered with <em>goo</em> which stretches to smoothly join them (see section <!--<linkto "Blob">Blob</linkto>--->[[Reference:Blob|Blob]]).</p>
@@ Line 710: / Line 712: @@
 strength of two spherical components is overlapping there.</p>
 {{#indexentry:New Features, component types}}
 <p>The shape shown so far is interesting, but limited. POV-Ray has a few
 extra tricks that extend its range of usefulness however. For example, as we
@@ Line 769: / Line 771: @@
 component's interaction with its fellow components. In fact, next let us
 give this fellow something to interact with, shall we?</p>
 {{#indexentry:Blob Constructs, complex}}
 {{#indexentry:Negative Strength, blob}}
 <p>Beginning a new POV-Ray file, we enter
 this somewhat more complex example:</p>
@@ Line 864: / Line 867: @@
 knowledge of blob mechanics to make a wide array of smooth, flowing organic
 shapes!</p>
 {{#indexentry:height_field, tutorial}}
 <p>A <code>height_field</code> is an object that has a surface that is
 determined by the color value or palette index number of an image designed

@@ Line 967: / Line 967: @@
 <p>Wow! The Himalayas have come to our computer screen!</p>
 <!--<wikinav>--->
 <br>
@@ Line 983: / Line 973: @@
 [[Documentation:Tutorial Section 3#Text Object|Text Object]]</td>
 <td width=50% bgcolor=#EEEEEF align=right>
-[[Documentation:Tutorial Section 3.2#Simple functions|Simple functions]]</td></tr>
+[[Documentation:Tutorial Section 3.2#Isosurface Object|Isosurface Object]]</td></tr>
 </table>
 <!--</wikinav>--->

@@ Line 769: / Line 769: @@
 component's interaction with its fellow components. In fact, next let us
 give this fellow something to interact with, shall we?</p>
-{{#indexentry:Blob Constructs, complex|Negative Strength, blob}}
+{{#indexentry:Blob Constructs, complex}}
 =====Complex Blob Constructs and Negative Strength=====
 <p>Beginning a new POV-Ray file, we enter

@@ Line 26: / Line 26: @@
 sides. We create an empty file called <code>meshdemo.pov</code> and add the
 following lines. Note that a mesh is - not surprisingly - declared using the
-keyword <code><!--<linkto "mesh">mesh</linkto>--->[[Documentation:Reference Section 4.1#Mesh|mesh]]</code>.</p>
+keyword <code><!--<linkto "mesh">mesh</linkto>--->[[Reference:Mesh|mesh]]</code>.</p>
 <pre>
    camera {
@@ Line 461: / Line 461: @@
 {{#indexentry:polygon, tutorial}}
 ====Polygon Object====
-<p>The <code><!--<linkto "polygon">polygon</linkto>--->[[Documentation:Reference Section 4.2#Polygon|polygon]]</code> object can be used to create any planar, n-sided
+<p>The <code><!--<linkto "polygon">polygon</linkto>--->[[Reference:Polygon|polygon]]</code> object can be used to create any planar, n-sided shapes like squares, rectangles, pentagons, hexagons, octagons, etc.</p>
 <p>
 A polygon is defined by a number of points that describe its shape. Since
@@ Line 597: / Line 596: @@
 ===Other Shapes===
 ====Blob Object====
-<p>Blobs are described as spheres and cylinders covered with <em>goo</em>
+<p>Blobs are described as spheres and cylinders covered with <em>goo</em> which stretches to smoothly join them (see section <!--<linkto "Blob">Blob</linkto>--->[[Reference:Blob|Blob]]).</p>
 <p>
 Ideal for modeling atoms and molecules, blobs are also powerful tools for
@@ Line 884: / Line 882: @@
 </pre>
-<p>The <code><!--<linkto "hf_gray_16">hf_gray_16</linkto>--->[[Documentation:Reference Section 3.1#HF_Gray_16|hf_gray_16]]</code> keyword causes the output to be in a special
+<p>The <code><!--<linkto "hf_gray_16">hf_gray_16</linkto>--->[[Reference:Global Settings#HF_Gray_16|hf_gray_16]]</code> keyword causes the output to be in a special 16 bit grayscale that is perfect for generating height fields. The normal 8 bit output will lead to less smooth surfaces.</p>
 <p>
 Now we create a camera positioned so that it points directly down the z-axis

@@ Line 7: / Line 7: @@
 <br>
 <!--</wikitalk>--->
 ===Polygon Based Shapes===
-<!--<indexentry "Shapes, polygon based">--->
+{{#indexentry:mesh, tutorial}}
 ====Mesh Object====
 <p>Mesh objects are very useful because they allow us to create objects
 containing hundreds or thousands of triangles. Compared to a simple union of
@@ Line 460: / Line 459: @@
 <code>mesh2</code>. uv_mapping is supported for texturing using a <code>texture_list</code>.</p>
 ====Polygon Object====
 <p>The <code><!--<linkto "polygon">polygon</linkto>--->[[Documentation:Reference Section 4.2#Polygon|polygon]]</code> object can be used to create any planar, n-sided
 shapes like squares, rectangles, pentagons, hexagons, octagons, etc.</p>
@@ Line 595: / Line 594: @@
 </table>
 ===Other Shapes===
 ====Blob Object====
 <p>Blobs are described as spheres and cylinders covered with <em>goo</em>
@@ Line 713: / Line 712: @@
 strength of two spherical components is overlapping there.</p>
 =====Component Types and Other New Features=====
 <p>The shape shown so far is interesting, but limited. POV-Ray has a few
 extra tricks that extend its range of usefulness however. For example, as we
@@ Line 772: / Line 771: @@
 component's interaction with its fellow components. In fact, next let us
 give this fellow something to interact with, shall we?</p>
 =====Complex Blob Constructs and Negative Strength=====
 <p>Beginning a new POV-Ray file, we enter
 this somewhat more complex example:</p>
@@ Line 866: / Line 865: @@
 knowledge of blob mechanics to make a wide array of smooth, flowing organic
 shapes!</p>
 ====Height Field Object====
 <p>A <code>height_field</code> is an object that has a surface that is
 determined by the color value or palette index number of an image designed
@@ Line 971: / Line 970: @@
 <p>Wow! The Himalayas have come to our computer screen!</p>
 ====Isosurface Object====
 <p>Isosurfaces are shapes described by mathematical functions.</p>

← Older revision	Revision as of 12:00, 1 July 2012
(No difference)

@@ Line 115: / Line 115: @@
 all options.</p>
-<p>[[Image:TutImgMesh2.gif|to be written as mesh2]]</p>
+<table class="centered" width="660px" cellpadding="0" cellspacing="10">
 <p>We will turn the mesh sketched above into a <code>mesh2</code> object.
@@ Line 575: / Line 584: @@
 </pre>
-<p>[[Image:TutImgPolyword.png|The word &quot;POV&quot; made with one polygon statement.]]</p>
+<table class="centered" width="340px" cellpadding="0" cellspacing="10">
 ===Other Shapes===
@@ Line 618: / Line 636: @@
 </pre>
-<p>[[Image:TutImgSimpblob.png|A simple, two-part blob.]]</p>
+<table class="centered" width="340px" cellpadding="0" cellspacing="10">
 <p>The threshold is simply the overall strength value at which the blob
@@ Line 658: / Line 685: @@
 </pre>
-<p>[[Image:TutImgSphblob.png|The spherical components made visible.]]</p>
+<table class="centered" width="340px" cellpadding="0" cellspacing="10">
 <p>Now the secrets of the kissing spheres are laid bare. These
@@ Line 771: / Line 807: @@
 </pre>
-<p>[[Image:TutImgBlobhand.png|A hand made with blobs.]]</p>
+<table class="centered" width="340px" cellpadding="0" cellspacing="10">
 <p>As we can guess from the comments, we are building a hand here. After we
@@ Line 802: / Line 847: @@
 </pre>
-<p>[[Image:TutImgImprhand.png|The hand without the swollen joints.]]</p>
+<table class="centered" width="340px" cellpadding="0" cellspacing="10">
 <p>Much better! The negative strength of the spherical components counteracts
@@ Line 904: / Line 958: @@
 higher resolution with anti-aliasing.</p>
-<p>[[Image:TutImgPvhfield.png|A height field created completely with POV-Ray.]]</p>
+<table class="centered" width="340px" cellpadding="0" cellspacing="10">
 <p>Wow! The Himalayas have come to our computer screen!</p>

@@ Line 575: / Line 575: @@
 </pre>
-<p><!--<img src="tut_img/polyword.png" alt="The word &quot;POV&quot; made with one polygon statement.">--->[[Image:TutImgPolyword.png|The word &quot;POV&quot; made with one polygon statement.]]</p>
+<p>[[Image:TutImgPolyword.png|The word &quot;POV&quot; made with one polygon statement.]]</p>
 ===Other Shapes===
 <!--<indexentry "Shapes, other">--->
 ====Blob Object====
-<p>Blobs are described as spheres and cylinders covered with &quot;goo&quot;
+<p>Blobs are described as spheres and cylinders covered with <em>goo</em>
-which stretches to smoothly join them (see section &quot;<!--<linkto "Blob">Blob</linkto>--->[[Documentation:Reference Section 4#Blob|Blob]]&quot;).</p>
+which stretches to smoothly join them (see section <!--<linkto "Blob">Blob</linkto>--->[[Documentation:Reference Section 4#Blob|Blob]]).</p>
 <p>
 Ideal for modeling atoms and molecules, blobs are also powerful tools for
-creating many smooth flowing &quot;organic&quot; shapes.</p>
+creating many smooth flowing <em>organic</em> shapes.</p>
 <p>
 A slightly more mathematical way of describing a blob would be to say that
@@ Line 867: / Line 867: @@
 We will get an image that will produce an excellent height field. We create a
 new file called <code>hfdemo.pov</code> and edit it as follows:</p>
-<p class="Note"><strong>Note:</strong> Windows users, unless you specify <code>+FT</code> as above,
+<p class="Note"><strong>Note:</strong> Unless you specify <code>+FT</code> as above, you will get a <em>PNG</em> file, the default cross-platform output file type. In this case you will need to use <code>png</code> instead of <code>tga</code> in the <code>height_field</code> statement below.</p>
 <pre>
    #include &quot;colors.inc&quot;

@@ Line 10: / Line 10: @@
 <!--<indexentry "Shapes, polygon based">--->
-===Mesh Object===
+====Mesh Object====
 <!--<indexentry "mesh, tutorial">--->
 <p>Mesh objects are very useful because they allow us to create objects
@@ Line 105: / Line 105: @@
 chesmsh.pov</code>.</p>
-===Mesh2 Object===
+====Mesh2 Object====
 <p>The <code>mesh2</code> is a representation of a mesh, that is much more
 like POV-Ray's internal mesh representation than the standard <code>mesh</code>.
@@ Line 233: / Line 233: @@
 </pre>
-===Smooth triangles and mesh2===
+=====Smooth triangles and mesh2=====
 <p>In case we want a smooth mesh, the same steps we did also apply to the
 normals in a mesh. For each vertex there is one normal vector listed in
@@ Line 306: / Line 306: @@
 </pre>
-===UV mapping and mesh2===
+=====UV mapping and mesh2=====
 <p>uv_mapping is a method of 'sticking' 2D textures on an object in such a way that it
 follows the form of the object. For uv_mapping on triangles imagine it as follows;
@@ Line 388: / Line 388: @@
 </pre>
-===A separate texture per triangle===
+=====A separate texture per triangle=====
 <p>By using the <code>texture_list</code> it is possible to specify a texture per triangle
 or even per vertex in the mesh. In the latter case the three textures per triangle will
@@ Line 451: / Line 451: @@
 <code>mesh2</code>. uv_mapping is supported for texturing using a <code>texture_list</code>.</p>
-===Polygon Object===
+====Polygon Object====
 <!--<indexentry "polygon, tutorial">--->
 <p>The <code><!--<linkto "polygon">polygon</linkto>--->[[Documentation:Reference Section 4.2#Polygon|polygon]]</code> object can be used to create any planar, n-sided
@@ Line 579: / Line 579: @@
 ===Other Shapes===
 <!--<indexentry "Shapes, other">--->
-===Blob Object===
+====Blob Object====
 <p>Blobs are described as spheres and cylinders covered with &quot;goo&quot;
 which stretches to smoothly join them (see section &quot;<!--<linkto "Blob">Blob</linkto>--->[[Documentation:Reference Section 4#Blob|Blob]]&quot;).</p>
@@ Line 677: / Line 677: @@
 strength of two spherical components is overlapping there.</p>
-===Component Types and Other New Features===
+=====Component Types and Other New Features=====
 <!--<indexentry "New Features, component types">--->
 <p>The shape shown so far is interesting, but limited. POV-Ray has a few
@@ Line 736: / Line 736: @@
 component's interaction with its fellow components. In fact, next let us
 give this fellow something to interact with, shall we?</p>
-===Complex Blob Constructs and Negative Strength===
+=====Complex Blob Constructs and Negative Strength=====
 <!--<indexentry "Blob Constructs, complex" "Negative Strength, blob">--->
 <p>Beginning a new POV-Ray file, we enter
@@ Line 812: / Line 812: @@
 knowledge of blob mechanics to make a wide array of smooth, flowing organic
 shapes!</p>
-===Height Field Object===
+====Height Field Object====
 <!--<indexentry "height_field, tutorial">--->
 <p>A <code>height_field</code> is an object that has a surface that is
@@ Line 911: / Line 911: @@
 <p>Wow! The Himalayas have come to our computer screen!</p>
-===Isosurface Object===
+====Isosurface Object====
 <!--<indexentry primary "isosurface, tutorial">--->
 <p>Isosurfaces are shapes described by mathematical functions.</p>