render -png < infile.r3d > outfile.png
render -avs < infile.r3d > outfile.avs
render [-quality NN] -jpeg < infile.r3d > outfile.jpeg
render -tiff outfile.tiff < infile.r3d
render -sgi [outfile.rgb] < infile.r3d
render -out outfile.xxx < infile.r3d
Render reads an ascii file consisting of several header lines followed by individual object descriptors. The objects are rendered using a fast Z-buffer algorithm to produce a high quality pixel image which contains one light source, additional non-shadowing light sources, specular highlighting, transparency, and Phong shaded surfaces. Output is to stdout [or optional file] in the form of a pixel image with 24 bits of color information per pixel. As of version 2.7, the default output format is PNG.
Force anti-aliasing (SCHEME 4)
Force output of transparency information (SCHEME 0). This only works if the output image format supports an alpha channel (AVS, TIFF, but not JPEG). Note that this turns off anti-aliasing.
By default render will produce an PNG image on stdout. The -avs flag will cause it to output an AVS image file instead, or stream the output to stdout if no file is specified.
Set background color. #RRGGBB is a hexadecimal number representing the red, green and blue components.
Turn off anti-aliasing (SCHEME 1) to increase rendering speed.
Only meaningful in conjunction with the -labels option. Modifies the interpretation of font sizes during label processing. Defaults to -fontscale 3.0, which will generate PostScript labels that are at the correct nominal fint size when printed at 300 dpi.
Apply gamma correction to output image.
Prints a short summary of command line options.
Invert image top-to-bottom. This may be necessary if you are using some odd viewing program.
Only if compiled with -DJPEG_SUPPORT. By default render will produce an PNG image on stdout. The -jpeg flag will cause it to output a JPEG image file instead, or stream the output to stdout if no file is specified.
Process labels (object types 10, 11, 12) and create a PostScript output file label3d.ps in addition to the rendered image file. Output filename defaults to label3d.ps. This option is used by the label3d script.
Only if compiled with -DIMAGE_PIPE. The -out flag causes render to pipe output to the ImageMagick command convert, with instructions to convert it to an image file whose type is determined by the filename extension xxx.
Only if compiled with -DPNG_SUPPORT. This is now the default output format. The -png flag will stream the output to stdout if no file is specified.
Only meaningful in conjunction with -jpeg option; sets the quality (compression level) of the output image. Allowable values 1 - 100 (default 90).
Turn shadowing on or off.
Override the image size parameters (NTX,NTY,NPX,NPY) in file header and produce an output image that is exactly HHH pixels in the horizontal and VVV pixels in the vertical.
Only if compiled with -DLIBIMAGE_SUPPORT. The -sgi flag will cause render to output an SGI libimage style *.rgb file instead of writing to stdout. The filename defaults to render.rgb, but specifying a file on the command line will override this default.
Only if compiled with -DTIFF_SUPPORT. The -tiff flag will cause render to output a TIFF image to the specified file instead of writing to stdout.
(same as -alpha). Force output of transparency information (SCHEME 0). This only works if the output image format supports an alpha channel (AVS, TIFF, but not JPEG). Note that this turns off anti-aliasing.
Rescale image by factor ZZ (ZZ% if the % sign is present).
I.e. schemes 0, 1, and 4 produce a NTX*NPX by NTY*NPY pixel image; scheme 3 produces a (2/3)NTX*NPX by (2/3)NTY*NPY image. Scheme 3 requires NPX and NPY to be divisible by 3. Schemes 2 and 4 require NPX and NPY to be divisible by 2.
Title (This is a 1280x1024 pixel anti-aliased image)
80 64 tiles in x,y
24 24 pixels (x,y) per tile
3 anti-aliasing level 3; 3x3->2x2
0 0 0 black background
F no shadows cast
25 Phong power
0.25 secondary light contribution
0.05 ambient light contribution
0.25 specular reflection component
4.0 eye position
1 1 1 main light source (from over right shoulder)
1 0 0 0 TMAT matrix describing
0 1 0 0 input coordinate transformation
0 0 1 0
0 0 0 0.6 enlarge by 40% (smaller scalar -> bigger objects)
3 mixed objects
* (free format triangle descriptors)
* (free format sphere descriptors)
* (free format cylinder descriptors)
At any point in the input stream to render where an object descriptor would be legal, it is also legal to insert a line beginning with `@'. In this case the remainder of the line is interpreted as the name of a file from which further input is taken. This mechanism makes it possible to re-use standard objects in multiple rendered scenes, e.g. a set of bounding planes or standard definitions of material properties. When input from this level of file indirection is terminated by encountering an object descriptor of type 0, control returns to the previous input stream. Multiple levels of file indirection are possible.
Files are first searched for in the current directory. If this search fails, they are sought relative to the library directory specified by the environmental variable R3D_LIB.
For Raster3D object types and object descriptor formats, see the man page for r3d_objects.
Some error messages may be safely ignored.
Possible shadowing error NSXMAX= xxx
This is most usually caused by an object which projects far out of the field of view, for example a plane surface. In most cases the shadowing "error" refers to a shadow which lies outside of the image entirely. However, if your image does in fact contain missing or truncated shadows you can overcome this problem by re-compiling the render program with larger values of NSX and NSY as indicated by the error message.
If you are creating images of very large proteins, or if you are rendering surfaces with many facets, then you may fill the storage arrays in render. If so you will get an error message something like
STOP 1234 **** too many objects - increase MAXOBJ and recompile
See the HTML or PostScript documentation for instructions on increasing array sizes.