Reference:Object - Revision history

Maurice: Precision about 40 char limited version number

2021-07-02T20:48:35Z

Precision about 40 char limited version number

Clipka: canonicalize a version number

2021-06-09T14:45:02Z

canonicalize a version number

Jholsenback: fixed odd break in text

2018-11-08T08:58:19Z

fixed odd break in text

Jholsenback: overzealous cut

2018-11-08T08:54:10Z

overzealous cut

Jholsenback: technical correction

2018-11-08T08:46:51Z

technical correction

Jholsenback: addition

2018-11-08T08:32:41Z

addition

Jholsenback: 1 revision: reference layout changes

2012-08-08T13:11:26Z

1 revision: reference layout changes

Jholsenback: cleanup round 2

2012-08-07T00:35:02Z

cleanup round 2

Jholsenback: 1 revision: link repair

2012-07-23T19:27:42Z

1 revision: link repair

Jholsenback: link repair

2012-07-21T18:09:50Z

link repair

@@ Line 32: / Line 32: @@
 <p>Where <em>IDENTIFIER</em> is the name of the identifier and <em>OBJECT</em> is any valid object. To invoke an object identifier, you wrap it in an <code>object{...}</code> statement. You use the <code>object</code> statement regardless of what type of object it originally was. Although early versions of POV-Ray required this <code> object</code> wrapper all of the time, now it is only used with <em>OBJECT_IDENTIFIERS</em>.</p>
-<p class="Note"><strong>Note:</strong> In previous versions identifier names <em>were</em> limited to 40 characters. There has been a {{Change}} removing that restriction.</p>
+<p class="Note"><strong>Note:</strong> In versions prior to 3.6.2, identifier names <em>were</em> limited to 40 characters. There has been a {{Change}} removing that restriction.</p>
 <p>
 Object modifiers are covered in detail later. However here is a brief overview.</p>

@@ Line 37: / Line 37: @@
 <p>
 The texture describes the surface properties of the object. Complete details are in [[Reference:Texture|textures]]. Textures are combinations of pigments, normals, and finishes. In the section [[Reference:Pigment|:pigment|pigment]] you will learn how to specify the color or pattern of colors inherent in the material. In [[Reference:Normal|normal]], we describe a method of simulating various patterns of bumps, dents, ripples
-or waves by modifying the surface normal vector. The section on [[Reference:Finish|finish]] describes the reflective properties of the surface. The [[Reference:Interior|Interior]] is a feature introduced in POV-Ray 3.1. It contains information about the interior of the object which was formerly contained in the finish and halo parts of a texture. Interior items are no longer part of the texture. Instead, they attach directly to the objects. The halo feature has been discontinued and replaced with a new feature called [[Reference:Media|Media]] which replaces both halo and atmosphere.</p>
+or waves by modifying the surface normal vector. The section on [[Reference:Finish|finish]] describes the reflective properties of the surface. The [[Reference:Interior|Interior]] is a feature introduced in POV-Ray v3.1. It contains information about the interior of the object which was formerly contained in the finish and halo parts of a texture. Interior items are no longer part of the texture. Instead, they attach directly to the objects. The halo feature has been discontinued and replaced with a new feature called [[Reference:Media|Media]] which replaces both halo and atmosphere.</p>
 <p>
 Bounding shapes are finite, invisible shapes which wrap around complex, slow rendering shapes in order to speed up rendering time. Clipping shapes are used to cut away parts of shapes to expose a hollow interior. Transformations tell the ray-tracer how to move, size or rotate the shape and/or the texture in the scene.</p>

@@ Line 4: / Line 4: @@
 <p>Objects are the building blocks of your scene. There are a lot of different types of objects supported by POV-Ray. In the following sections, we describe [[Reference:Finite Solid Primitives|Finite Solid Primitives]], [[Reference:Finite Patch Primitives|Finite Patch Primitives]] and [[Reference:Infinite Solid Primitives|Infinite Solid Primitives]]. These primitive shapes may be combined into complex shapes using [[Reference:Constructive Solid Geometry|Constructive Solid Geometry]] (also known as CSG).</p>
 <p>
-The basic syntax of an object is a keyword describing its type, some floats,
+The basic syntax of an object is a keyword describing its type, some floats, vectors or other parameters which further define its location and/or shape and some optional object modifiers such as texture, interior_texture, pigment, normal, finish, interior, bounding, clipping or transformations. Specifically the syntax
 is:</p>
 <pre>
@@ Line 27: / Line 24: @@
 </pre>
-<p>Object identifiers may be declared to make scene files more readable and
+<p>Object identifiers may be declared to make scene files more readable and to parameterize scenes so that changing a single declaration changes many values. An identifier is declared as follows.</p>
 <pre>
 OBJECT_DECLARATION:
@@ Line 39: / Line 34: @@
 <p class="Note"><strong>Note:</strong> In previous versions identifier names <em>were</em> limited to 40 characters. There has been a {{Change}} removing that restriction.</p>
 <p>
-Object modifiers are covered in detail later. However here is a brief
+Object modifiers are covered in detail later. However here is a brief overview.</p>
 <p>
-The texture describes the surface properties of the object. Complete details
+The texture describes the surface properties of the object. Complete details are in [[Reference:Texture|textures]]. Textures are combinations of pigments, normals, and finishes. In the section [[Reference:Pigment|:pigment|pigment]] you will learn how to specify the color or pattern of colors inherent in the material. In [[Reference:Normal|normal]], we describe a method of simulating various patterns of bumps, dents, ripples
-are in [[Reference:Texture|textures]]. Textures are combinations of pigments, normals,
+or waves by modifying the surface normal vector. The section on [[Reference:Finish|finish]] describes the reflective properties of the surface. The [[Reference:Interior|Interior]] is a feature introduced in POV-Ray 3.1. It contains information about the interior of the object which was formerly contained in the finish and halo parts of a texture. Interior items are no longer part of the texture. Instead, they attach directly to the objects. The halo feature has been discontinued and replaced with a new feature called [[Reference:Media|Media]] which replaces both halo and atmosphere.</p>
 <p>
-Bounding shapes are finite, invisible shapes which wrap around complex, slow
+Bounding shapes are finite, invisible shapes which wrap around complex, slow rendering shapes in order to speed up rendering time. Clipping shapes are used to cut away parts of shapes to expose a hollow interior. Transformations tell the ray-tracer how to move, size or rotate the shape and/or the texture in the scene.</p>

@@ Line 36: / Line 36: @@
 </pre>
-<p>Where <em>IDENTIFIER</em> is the name of the identifier <em>OBJECT</em> is any valid object. To invoke an object identifier, you wrap it in an <code>object{...}</code> statement. You use the <code>object</code> statement regardless of what type of object it originally was. Although early versions of POV-Ray required this <code> object</code> wrapper all of the time, now it is only used with <em>OBJECT_IDENTIFIERS</em>.</p>
+<p>Where <em>IDENTIFIER</em> is the name of the identifier and <em>OBJECT</em> is any valid object. To invoke an object identifier, you wrap it in an <code>object{...}</code> statement. You use the <code>object</code> statement regardless of what type of object it originally was. Although early versions of POV-Ray required this <code> object</code> wrapper all of the time, now it is only used with <em>OBJECT_IDENTIFIERS</em>.</p>
 <p class="Note"><strong>Note:</strong> In previous versions identifier names <em>were</em> limited to 40 characters. There has been a {{Change}} removing that restriction.</p>
 <p>

@@ Line 36: / Line 36: @@
 </pre>
-<p>Where <em>IDENTIFIER</em> is the name of the identifier up to 40
+<p>Where <em>IDENTIFIER</em> is the name of the identifier <em>OBJECT</em> is any valid object. To invoke an object identifier, you wrap it in an <code>object{...}</code> statement. You use the <code>object</code> statement regardless of what type of object it originally was. Although early versions of POV-Ray required this <code> object</code> wrapper all of the time, now it is only used with <em>OBJECT_IDENTIFIERS</em>.</p>
-characters long and <em>OBJECT</em> is any valid object. To invoke
+<p class="Note"><strong>Note:</strong> In previous versions identifier names <em>were</em> limited to 40 characters. There has been a {{Change}} removing that restriction.</p>
 <p>
 Object modifiers are covered in detail later. However here is a brief

@@ Line 16: / Line 16: @@
 FINITE_SOLID_OBJECT:
    BLOB | BOX | CONE | CYLINDER | HEIGHT_FIELD | ISOSURFACE | JULIA_FRACTAL |
-   LATHE | OVUS | PARAMETRIC | PRISM | SPHERE | SPHERE_SWEEP | SUPERELLIPSOID |
+   LATHE | LEMON | OVUS | PARAMETRIC | PRISM | SPHERE | SPHERE_SWEEP | SUPERELLIPSOID |
    SOR | TEXT | TORUS
 FINITE_PATCH_OBJECT:

← Older revision	Revision as of 13:11, 8 August 2012
(No difference)

@@ Line 2: / Line 2: @@
 [[Category:Objects]]
 <!--<sectiondesc desc=<"scene objects reference">--->
-<p>Objects are the building blocks of your scene. There are a lot of different types of objects supported by POV-Ray. In the following sections, we describe [[Reference:Object#Finite Solid Primitives|Finite Solid Primitives]], [[Reference:Object#Finite Patch Primitives|Finite Patch Primitives]] and [[Reference:Object#Infinite Solid Primitives|Infinite Solid Primitives]]. These primitive shapes may be combined into complex shapes using [[Reference:Object#Constructive Solid Geometry|Constructive Solid Geometry]] (also known as CSG).</p>
+<p>Objects are the building blocks of your scene. There are a lot of different types of objects supported by POV-Ray. In the following sections, we describe [[Reference:Finite Solid Primitives|Finite Solid Primitives]], [[Reference:Finite Patch Primitives|Finite Patch Primitives]] and [[Reference:Infinite Solid Primitives|Infinite Solid Primitives]]. These primitive shapes may be combined into complex shapes using [[Reference:Constructive Solid Geometry|Constructive Solid Geometry]] (also known as CSG).</p>
 <p>
 The basic syntax of an object is a keyword describing its type, some floats,
@@ Line 62: / Line 62: @@
 tell the ray-tracer how to move, size or rotate the shape and/or the texture
 in the scene.</p>

← Older revision	Revision as of 19:27, 23 July 2012
(No difference)

@@ Line 64: / Line 64: @@
 ==Finite Solid Primitives==
 <p>There are seventeen different solid finite primitive shapes: [[Reference:Blob|blob]], [[Reference:Box|box]],
-[[Reference:Cone|cone]], [[Reference:Cylinder|cylinder]], [[Reference:Height Field|height field]], [[Reference:Isosurface|isosurface]], [[Reference:Julia Fractal|Julia fractal]], [[Reference:Lathe|lathe]], [[Reference:Ovus|ovus]], [[Reference:Parametric|parametric]], [[Reference:Prism|prism]], [[Reference:Sphere|sphere]], [[Reference:Sphere Sweep|sphere_sweep]], [[Reference:Superellipsoid|superellipsoid]], [[Reference:Sor|surface of revolution]], [[Reference:Text|text]] and [[Reference:Torus|torus]]. These have a
+[[Reference:Cone|cone]], [[Reference:Cylinder|cylinder]], [[Reference:Height Field|height field]], [[Reference:Isosurface|isosurface]], [[Reference:Julia Fractal|Julia fractal]], [[Reference:Lathe|lathe]], [[Reference:Ovus|ovus]], [[Reference:Parametric|parametric]], [[Reference:Prism|prism]], [[Reference:Sphere|sphere]], [[Reference:Sphere Sweep|sphere_sweep]], [[Reference:Superquadric Ellipsoid|superellipsoid]], [[Reference:Surface of Revolution|surface of revolution]], [[Reference:Text|text]] and [[Reference:Torus|torus]]. These have a
 well-defined <em>inside</em> and can be used in CSG (see [[Reference:Object#Constructive Solid Geometry|Constructive Solid Geometry]]). They are finite and respond to automatic bounding. You may specify an interior for these objects.</p>
@@ Line 176: / Line 176: @@
 </pre>
-<p>Transformations such as translate, rotate and scale have already been discussed. The modifiers <em>[[Reference:Texture|Textures]]</em> and its parts <em>[[Reference:Pigment|Pigment]]</em>, <em>[[Reference:Normal|Normal]]</em>, and <em>[[Reference:Finish|Finish]]</em> as well as <em>[[Reference:Interior|Interior]]</em>, and <em>[[Reference:Media|Media]]</em> (which is part of interior) are each in major chapters of their own below. In the sub-sections below we cover several other important modifiers: <code>[[Reference:Clipped_By Object Modifier|clipped_by]]</code>, <code>[[Reference:Bounded_By Object Modifier|bounded_by]]</code>, <code>[[Reference:Material|material]]</code>, <code>[[Reference:Inverse Object Modifier|inverse]]</code>, <code>[[Reference:Hollow Object Modifier|hollow]]</code>, <code>[[Reference:No_Shadow Object Modifier|no_shadow]]</code>, <code>[[Reference:No_Image Object Modifier|no_image]]</code>, <code>[[Reference:No_Reflection Object Modifier|no_reflection]]</code>, <code>[[Reference:Double_Illuminate Object Modifier|double_illuminate]]</code>, <code>[[Reference:No_Radiosity Object Modifier|no_radiosity]]</code> and <code>[[Reference:Sturm Object Modifier|sturm]]</code>. Although the examples below use object statements and object identifiers, these modifiers may be used on any type of object such as sphere, box etc.</p>
+<p>Transformations such as translate, rotate and scale have already been discussed. The modifiers <em>[[Reference:Texture|Textures]]</em> and its parts <em>[[Reference:Pigment|Pigment]]</em>, <em>[[Reference:Normal|Normal]]</em>, and <em>[[Reference:Finish|Finish]]</em> as well as <em>[[Reference:Interior|Interior]]</em>, and <em>[[Reference:Media|Media]]</em> (which is part of interior) are each in major chapters of their own below. In the sub-sections below we cover several other important modifiers: <code>[[Reference:Clipped By Object Modifier|clipped_by]]</code>, <code>[[Reference:Bounded By Object Modifier|bounded_by]]</code>, <code>[[Reference:Material|material]]</code>, <code>[[Reference:Inverse Object Modifier|inverse]]</code>, <code>[[Reference:Hollow Object Modifier|hollow]]</code>, <code>[[Reference:No Shadow Object Modifier|no_shadow]]</code>, <code>[[Reference:No Image Object Modifier|no_image]]</code>, <code>[[Reference:No Reflection Object Modifier|no_reflection]]</code>, <code>[[Reference:Double Illuminate Object Modifier|double_illuminate]]</code>, <code>[[Reference:No Radiosity Object Modifier|no_radiosity]]</code> and <code>[[Reference:Sturm Object Modifier|sturm]]</code>. Although the examples below use object statements and object identifiers, these modifiers may be used on any type of object such as sphere, box etc.</p>