mpictures(6) [plan9 man page]
MPICTURES(6) Games Manual MPICTURES(6) NAME
mpictures - picture inclusion macros SYNOPSIS
troff -mpictures [ options ] file ... DESCRIPTION
Mpictures macros insert PostScript pictures into troff(1) documents. The macros are: .BP source height width position offset flags label Define a frame and place a picture in it. Null arguments, represented by "", are interpreted as defaults. The arguments are: source Name of a PostScript picture file, optionally suffixed with (n) to select page number n from the file (first page by default). height Vertical size of the frame, default 3.0i. width Horizontal size of the frame, current line length by default. position (default), or to left-justify, center, or right-justify the frame. offset Move the frame horizontally from the original position by this amount, default 0i. flags One or more of: ad Rotate the picture clockwise d degrees, default d=90. o Outline the picture with a box. s Freely scale both picture dimensions. w White out the area to be occupied by the picture. l,r,t,b Attach the picture to the left right, top, or bottom of the frame. label Place label at distance 1.5v below the frame. If there's room, .BP fills text around the frame. Everything destined for either side of the frame goes into a diversion to be retrieved when the accumulated text sweeps past the trap set by .BP or when the diversion is explicitly closed by .EP. .PI source height,width,yoffset,xoffset flags. This low-level macro, used by .BP, can help do more complex things. The two arguments not already described are: xoffset Offset the frame from the left margin by this amount, default 0i. yoffset Offset the frame from the current baseline, measuring positive downward, default 0i. .EP End a picture started by .BP; .EP is usually called implicitly by a trap at frame bottom. If a PostScript file lacks page-delimiting comments, the entire file is included. If no %%BoundingBox comment is present, the picture is assumed to fill an 8.5x11-inch page. Nothing prevents the picture from being placed off the page. SEE ALSO
troff(1) DIAGNOSTICS
A picture file that can't be read by the PostScript postprocessor is replaced by white space. BUGS
A picture and associated text silently disappear if a diversion trap set by .BP isn't reached. Call .EP at the end of the document to retrieve it. Macros in other packages may break the adjustments made to the line length and indent when text is being placed around a picture. A missing or improper %%BoundingBox comment may cause the frame to be filled incorrectly. MPICTURES(6)
Check Out this Related Man Page
RA_RGBE(1) General Commands Manual RA_RGBE(1) NAME
ra_rgbe - convert between different RADIANCE picture types SYNOPSIS
ra_rgbe [ -r ][ -e +/-stops ][ -f ][ -n frameno ] [ input [ outspec ] ] DESCRIPTION
Ra_rgbe converts between RADIANCE run-length encoded and flat formats, and separates concatanated animation frames produced by rpict(1). The -e option specifies an exposure compensation in f-stops (powers of two). Only integer stops are allowed, for efficiency. By default, ra_rgbe produces a flat RADIANCE picture file from any type of RADIANCE input picture. The -r option causes ra_rgbe to produce a run- length encoded file instead. If the input file consists of multiple animation frames as produced by rpict with the -S option, ra_rgbe will read each frame and write it to the output file created by calling printf(3) with the output specification and frame number as arguments. If the output specification begins with an exclamation mark ('!'), then this interpreted as a command spec., which is also run through printf with the frame number to get the final command. This command must accept a Radiance picture on its standard input, and may write results either to a file or to the standard output. The -n option may be used to select a specific frame for output, and other frames in the input will be skipped. Nor- mally, all frames will be read and written. Ra_rgbe will report an error and exit if the target output file already exists, unless the -f option is given. If the output file is miss- ing, the standard output is used. If the input file is missing or set to '-', the standard input is used. NOTES
The file format for RADIANCE pictures was changed between release 1.4 and release 2.0. The older format can still be read by all the pro- grams, but only the newer format is produced. This newer format cannot be read by RADIANCE software prior to release 2.0. Ra_rgbe provides some downward compatibility by producing files that can be read by older RADIANCE software. The resultant files are also easier to manipulate with programs designed to read raw raster data. The other use for ra_rgbe is as a quicker way to adjust the exposure of a RADIANCE picture than pfilt(1), since ra_rgbe only allows integer f-stop changes. In this mode, ra_rgbe should be used with the -r option. AUTHOR
Greg Ward ACKNOWLEDGEMENT
Work on this program was initiated and sponsored by the LESO group at EPFL in Switzerland. SEE ALSO
pfilt(1), printf(1), ra_xyze(1), rpict(1) RADIANCE
1/23/98 RA_RGBE(1)