mpictures man page on Plan9

Man page or keyword search:  
man Server   549 pages
apropos Keyword Search (all sections)
Output format
Plan9 logo
[printable version]


       mpictures - picture inclusion macros

       troff -mpictures [ options ] file ...

       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,  rep‐
	      resented 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), 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
		     o	    Outline the picture with a box.
		     s	    Freely scale both picture dimensions.
		     w	    White out the area to be occupied by the picture.
			    Attach the picture to the left right, top, or bot‐
			    tom 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:

		     Offset the frame from the left  margin  by	 this  amount,
		     default 0i.

		     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.5×11-inch page.  Nothing prevents the picture from
       being placed off the page.


       A picture file that can't be read by the	 PostScript  postprocessor  is
       replaced by white space.

       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.

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Plan9

List of man pages available for Plan9

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net