| R3D_OBJECTS(1) | General Commands Manual | R3D_OBJECTS(1) |
rd3_objects - object types used by the Raster3D package
These are the object descriptor types, and the required parameters, recognized by the render program and other components of the Raster3D package.
x1, y1, z1, x2, y2, z2, x3, y3, z3, red, green, blue;
x, y, z, radius, red, green, blue;
x1, y1, z1, R1, x2, y2, z2, R2, red, green, blue.
(R1 is the cylinder radius, R2 is currently ignored).
x1, y1, z1, R1, x2, y2, z2, R2, red, green, blue.
(R1 is the cylinder radius, R2 is currently ignored).
x1, y1, z1, x2, y2, z2, x3, y3, z3, red, green, blue;
The plane is defined by any three points. It's color fades from full
intensity in the foreground to half-intensity at the back.
Explicit vertex normals for preceding triangle object. This object must directly follow the triangle object, and uses the same format.
These values override the specification of lighting and specular
highlighting in the header records, allowing some objects to have different
surface properties from the rest. The specified values will apply to all
subsequent objects until an object of type 9 is encountered. The parameters
are read as free format floating point numbers from the next line of the
input stream:
8
MPHONG MSPEC SR SG SB CLRITY OPT1 OPT2 OPT3 OPT4
Terminates application of all previously defined special material properties (object type 8) or isolation from TMAT transformation (object type 15).
These object types are used as label descriptors. The current version of render ignores them unless the -labels option is selected on the command line.
This is a colored, non-shadowing, light source with finite [x y z]
coordinates and a limited range of illumination. Control parameters are read
in free format from a single line of input following the line specifying the
object type.
13
GLOWSRC(3) GLOWRAD GLOW GOPT GPHONG GLOWCOL(3)
x, y, z, limiting_radius, red, green, blue, A, B, C, D, E, F, G, H, I, J
Quadric surfaces include spheres, cones, ellipsoids, paraboloids, and hyperboloids. The motivation for this code was to allow rendering thermal ellipsoids for atoms, so the other shapes have not been extensively tested. A quadric surface is described by 10 parameters (A...J). Although these parameters are sufficient to describe a quadric surface located anywhere, for efficiency during rendering it is also useful to know the center and a bounding sphere. So by convention we require that (A...J) describe a surface centered at the origin, and add additional parameters x, y, z to add a translation component. Therefore a QUADRIC descriptor to render has the 17 parameters listed above.
The surface is the set of points for which Q(x,y,z) = 0 where
Q(x,y,z) = Ax2 + By2 + Cz2 + 2Dxy + 2Eyz + 2Fzx + 2Gx + 2Hy + 2Iz + J
Points further from the origin (prior to translation!) than the limiting radius are not rendered.
Objects following this descriptor are interpreted as being in an absolute coordinate system centered at the origin and having unit extent in X, Y, and Z. If the image is rectangular, coordinates run from -0.5 to +0.5 along both X and Y. If the image is rectangular, coordinates run from -0.5 to +0.5 along the shorter dimension. The rotation and translation described by the TMAT matrix is not applied. This isolation from TMAT applies to subsequent objects until an object of type 9 is encountered.
Object type 16 is always followed by a single record that affects the rendering of the entire scene. Currently the options are FOG, FRONTCLIP, and BACKCLIP. There are also options ROTATION and TRANSLATION that affect only objects following their appearance in the input stream.
Explicit vertex colours for preceding triangle or cylinder object.
R1 G1 B1 R2 G2 B2 R3 G3 B3
Explicit transparency at vertices of preceding object. All three
values are required, though only the first two are used for cylinders, and
only the first one for spheres.
Trans1 Trans2 Trans3
Similar to object type 15, except the the x and y scales are the same only in the case of a square image. Both the x and y axes run from -0.5 to +0.5 regardless of the aspect ratio of the rendered image.
PostScript and HTML documentation
render(l)
| 8 May 1999 | Raster3D |