Lrchairs 1.1.1 User Manual

Abstract

[Thumbnail which links to a demo image] Lrchairs is a library module from the Persistence of Vision Ray Tracer (POV-Ray) Object Collection that defines an inexpensive chair. The textures of the frame and seat are set by the user.


Table of Contents


Overview

Downloaded Files

The italicized nnnnnn in some of the file names represents the 6-digit number that is in the name of the .zip file.

Key Files
File Description
lrchairs.html The user manual (this document)
lrchairs.inc The lrchairs software
lrchairs_example.pov An example scene description file demonstrating the use of lrchairs
lrchairs.jpg Sample output images
lrchairs_thumbnail.jpg
Administrative Files
File Description
READMEnnnnnn.html Important information about using the POV-Ray Object Collection
lrchairs_description.txt A brief description of lrchairs
lrchairs_keywords.txt A list of keywords
lrchairs_prereqs.txt Prerequisites (empty file)
lrchairs.css Other administrative files
cc-LGPL-a.png
Versionnnnnnn.js

Table of contents


Prerequisites

Lrchairs requires POV-Ray 3.5 or later.

Namespace Compliance

All file names in this module and all global and local identifiers defined in lrchairs.inc comply fully with the Object Collection naming standards, as revised August 2008 and proposed August 2012. The reserved prefixes for this module are “lrchairs” and “Cp,” including any uppercase and lowercase variants. To avoid conflicts, do not introduce into your scene description file any identifiers with these names, or any identifiers that start with these names plus an underscore.

The identifier View_POV_Include_Stack from the standard include file debug.inc is referenced by lrchairs.inc, although debug.inc itself is not used.

Usage

Include this file once prior to using any of the features of lrchairs:

#include "lrchairs.inc"

Including the file more than once is harmless, though unnecessary.

Table of contents


Macro

Cp_Chair (Cp_Ftex, Cp_Stex)

Defines a cheap chair. The chair faces the −z direction, and the origin is between the bottom ends of the rear legs. The unit scale of the model is 1 foot (30.48 cm).

Arguments

Formal Parameter Type Description
Cp_Ftex texture The texture of the frame of the chair.
Cp_Stex texture The texture of the seat and back of the chair.

Table of contents


Scale Conversions

The unit scale of the chair is 1 foot. If your scene uses a different POV unit, you may scale the chair with one of the following values:

Identifier Type Description Value
CP_CM float Use this if your scene’s unit is 1 centimeter. 30.48
CP_FOOT float Included for completeness, you may use this if your scene’s unit is 1 foot. 1
CP_INCH float Use this if your scene’s unit is 1 inch. 12
CP_METER float Use one of these if your scene’s unit is 1 meter. 0.3048
CP_METRE
CP_YARD float Use this if your scene’s unit is 1 yard. 1/3

Here is an example for a scene with a POV unit of 1 meter:

object
{ Cp_Chair (MyFrameTexture, MySeatTexture)
  scale CP_METER
}

As always, remember to scale the chair before translating it to its final location.

Table of contents


About Lrchairs

Copyright © 2008 Leroy Whetstone (new website under construction) and © 2014 – 2019 Richard Callwood III. Some rights reserved. Licensed under the Creative Commons-GNU Lesser General Public License.

The entire artistic credit for this model goes to Mr. Whetstone.

Object Collection Categories

Change Log

Version Date Notes Author
1.0 2008 August 21
  • The initial Object Collection version is released.
Leroy Whetstone
1.0A 2008 August 21
  • A typo is corrected.
Leroy Whetstone
1.1 2014 December 31
  • The module is brought into full namespace compliance.
  • The POV-Ray version is set to 3.5.
  • Scale conversions are added.
Richard Callwood III
1.1.1 2019 March 30
  • The messages to the debug stream stating that lrchairs.inc is included are suppressed by default.
  • Mr. Whetstone’s contact information is updated.
Richard Callwood III

Table of contents