Cube

Syntax:

	(cube
           (material: material)
           (radius: number)
           (scale: coord)
           (thickness: number)
           (center: coord)
           (solid: boolean)
           (name: string)
           (color: number)
           (index-of-refraction: number)
           (reflectivity: number)
           (emissivitiy: number)
           (transparency: number))

material:

The material of the object. See Primitive Procedures - Material for details.

radius:

A number denoting the half the length of each side of the cube in meters. The default size is 1.

scale:

A set of coordinates giving the scale of each dimension (x, y, z) of the cube. The default scale is (1, 1, 1).

thickness:

A number denoting the thickness of a hollow cube. The default thickness is 10% of the size.

Note: Solid cubes do not have a thickness.

center:

A set of coordinates giving the position of the center of the cube in meters. The default center is at the origin, (0, 0, 0).

solid:

A boolean value indicating whether the cube is solid or hollow. True, #t, denotes solid; false, #f, denotes hollow. The default value is solid, or true.

name:

A tag which can be added to the object for identification purposes. The default name is "Cube".

color:

A coordinate indicating the (r, g, b) value of the base color of the object. Each element is on the range {0, 1}. The default color is grey, (.5, .5, .5}.

transparency:

A number on the range {0, 1} indicating the percent loss in intensity of light per meter of material traveled through. A value of 1 results in a perfectly transparent surface, a value of 0 results in a perfectly opaque surface. The default transparency is 0, or opaque.

Note: In determining the appearance of the object, transparency is multiplied by the color. For example, an object with color (0, 0, 0) cannot be at all transparent, regardless of the transparency of the material.

emissivity:

A number on the range {0,1} indicating the emissivity of the material. A value of 1 results in a material with maximum glow; a value of 0 results in a material that does not glow. The default emissivity is 0.

index-of-refraction:

A number on the range {1,2} indicating the index of refraction of the material. The index of refraction of air is 1.0; for water it is 1.33. The default index-of-refraction is 1.2.

shininess

A number on the range {0,1} indicating the sharpness of the specular highlight. Shiny materials have a small, sharp highlight; matte materials have a large, dull highlight. A value of 1 indicates the highest shininess; 0 indicates the least shininess.

reflectivity:

A number on the range {0,1} indicating the reflectivity of the material. A value of 1 is a perfectly reflective material, i.e. a perfect mirror; a value of 0 is a completely dull material.

Example:

(cube (size: 4) (thickness: .4) (solid: #f))

This code creates a hollow cube with sides of length 4. The thickness of each surface of the cube is .4.