Usenet 1994 January

home *** CD-ROM | disk | FTP | other *** search

/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume19 / xfig / part26 < prev next >

Wrap

Text File | 1993-05-27 | 67.8 KB | 1,866 lines

Newsgroups: comp.sources.x From: envbvs@epb9.lbl.gov (Brian V. Smith) Subject: v19i138: xfig - Draw amd manipulate objects in an X-Window, Part26/27 Message-ID: <1993May21.021816.7860@sparky.imd.sterling.com> X-Md4-Signature: 45129c8ace991f28af1710f0c74d0669 Sender: chris@sparky.imd.sterling.com (Chris Olson) Organization: Sterling Software Date: Fri, 21 May 1993 02:18:16 GMT Approved: chris@sparky.imd.sterling.com Submitted-by: envbvs@epb9.lbl.gov (Brian V. Smith) Posting-number: Volume 19, Issue 138 Archive-name: xfig/part26 Environment: X11 Supersedes: xfig: Volume 16, Issue 6-30,39 #! /bin/sh # This is a shell archive. Remove anything before this line, then unpack # it by saving it into a file and typing "sh file". To overwrite existing # files, type "sh file -c". You can also feed this as standard input via # unshar, or by typing "sh <file", e.g.. If this archive is complete, you # will see the following message at the end: # "End of archive 26 (of 27)." # Contents: Doc/xfig.man # Wrapped by envbvs@epb9.lbl.gov.lbl.gov on Mon May 3 12:06:10 1993 PATH=/bin:/usr/bin:/usr/ucb ; export PATH if test -f 'Doc/xfig.man' -a "${1}" != "-c" ; then echo shar: Will not clobber existing file \"'Doc/xfig.man'\" else echo shar: Extracting \"'Doc/xfig.man'\" $65304 characters$ sed "s/^X//" >'Doc/xfig.man' <<'END_OF_FILE' X'\" t X.\" the previous line makes man call tbl X.if t .po .9i X.TH XFIG 1 "Release 2.1(.7) (Protocol 2.1)" X.SH NAME Xxfig \- Facility for Interactive Generation of figures under X11 X.SH SYNOPSIS X.B xfig X[\fIoptions\fP] X[\fIfile\fP] X.SH DESCRIPTION X.I Xfig Xis a menu-driven tool that allows the user to draw and manipulate objects Xinteractively in an X window. X.B It runs under X version 11 X.B release 4 or higher Xand requires a two- or three-button mouse. X.I file Xspecifies the name of a file to be edited. The description of objects in Xthe file will be read at the start of \fIxfig\fP. X.PP XWhen using a two-button mouse Xuse the <Meta> key and the right button at the same time to effect Xthe action of the middle button. X.PP XThe \fITransFig\fP package is used to print or export the output from \fIxfig\fP. X.PP XNote for previous \fIxfig\fP users: X.PP XThe \fIf2p\fP and \fIf2ps\fP translators have been phased out Xbecause the \fITransFig\fP package from Micah Beck is a more general Xpurpose translator for more graphics languages. XThe \fITransFig\fP package can be used as a back-end processor to \fIxfig\fP Xto produce various types of output: X.IP "LaTeX - "12 X\fIfig2dev -L latex\fP translates \fIxfig\fP to \fILaTeX\fP Xpicture environment commands which can be Xprocessed along with other X.I LaTeX Xcommands. X.IP "Postscript - X\fIfig2dev -L ps\fP produces a \fIPostScript\fP output. X.IP "Pic - X\fIfig2dev -L pic\fP produces a pic output. X.IP "PiCTeX - X\fIfig2dev -L pictex\fP produces X.I PiCTeX Xoutput. XThis contains macros that can be used with the X.I PiCTeX Xenvironment under X.I TeX Xor X.I LaTeX. X.IP "Others - X\fIfig2dev\fP has options for these other languages: X\fIbox\fP, X\fIepic\fP, X\fIeepic\fP, Xand \fIeepicemu\fP. X.PP XThe \fITransFig\fP package is available via anonymous ftp from Xexport.lcs.mit.edu in /contrib/R5fixes/transfig-fixes/transfig.2.1.X.tar.Z, Xwhere the X is the current patchlevel. X.LP XNote: \fITransFig\fP versions 2.1.4 and later support color Xoutput for \fIPostScript\fP. X.SH OPTIONS X.TP X.B \-L[andscape] XMake \fIxfig\fP come up in landscape mode (10" x 8"). This is the default. X.TP X.B \-P[ortrait] XMake \fIxfig\fP come up in portrait mode (8" x 9"). X.TP X.B \-bg \fIcolor\fP XUse \fIcolor\fP as the background color for the canvas and buttons. X.TP X\fB-bol[d]\fP \fIfont\fP XCause the font used for displaying confirmation messages to be \fIfont\fP X(default = 8x13bold). X.TP X\fB-bu[tton]\fP \fIfont\fP XCause the font used for most buttons to be \fIfont\fP (default = 6x13). X.TP X.B \-de[bug] XTurn on debugging mode. Prints various debugging messages like font names etc. X.TP X.B \-e[xportLanguage] \fIlanguage\fP XSpecifies the language to be used for when exporting a fig file. XChoices are: X X.TS Xl l. XName Language X_ Xbox LaTeX box (figure boundary) Xlatex LaTeX picture Xepic LaTeX picture + epic macros Xeepic LaTeX picture + eepic macros Xeepicemu LaTeX picture + eepicemu macros Xpictex PiCTeX macros Xeps Encapuslated Postscript Xps Postscript Xpstex Combined PS/LaTeX (PS part) Xpstex_t Combined PS/LaTeX (LaTeX part) Xtextyl Textyl special commands Xtpic TPIC Xpic PIC Xxbm X11 Bitmap X.TE X.TP X.B \-fg \fIcolor\fP XUse \fIcolor\fP as the foreground color and default color for objects. X.TP X.B \-fl[ushleft] XSet the print option to print the figure flush left. XThe default is to center the figure on the page. X.TP X\fB-geom[etry]\fP \fIWxH+X+Y\fP XSpecifies the geometry for Fig application. X.TP X\fB-iconG[eometry]\fP \fI+X+Y\fP XSpecifies the position for the icon. X.TP X.B \-inc[hes] XMake inches the unit of choice (default). X.TP X.B \-me[tric] XMake centimeters the unit of choice. X XAfter \fIxfig\fP is started you may change the units from metric to Ximperial or vice versa from a popup menu available by pressing mouse Xbutton 3 in the \fIunits\fP box where the two rulers meet. X.TP X.B \-internalBW \fIwidth\fP XUse lines of width \fIwidth\fP between all buttons and panels (default = 1). X.TP X.B \-inv[verse] XUse inverse video (white on black). X.TP X.B \-k[eyFile] \fIcompose-key-file\fP XUse \fIcompose-key-file\fP instead of \fICompKeyDB\fP for compose (meta) key Xdatabase. If there are no "/"s in the name, the file must reside in the \fIxfig\fP Xlibrary directory, \fI$XFIGLIBDIR\fP, usually /usr/local/lib/X11/xfig. XIf there are any "/"s in the name it is taken as is (not relative Xto \fI$XFIGLIBDIR\fP). XIf there is a leading "~/" in the string then the ~ is expanded to the Xuser's home directory. X.TP X.B \-lat[exfonts] XStart \fIxfig\fP with \fILaTeX\fP font selection. Normally, the \fIPostScript\fP Xfonts are available as the default. This flag selects the \fILaTeX\fP Xfonts to start. X.TP X.B \-le[ft] XChange the position of the side panel window to the left of the canvas window. X.TP X.B \-mo[nochrome] XUse black and white only. X.TP X\fB-nor[mal]\fP \fIfont\fP XCause the font used for the message panel and ruler numbers to be \fIfont\fP. XThis font is also used on the canvas when the selected font is not available Xin an X11 font (default = fixed). X.TP X.B \-not[rack] XTurn off cursor (mouse) tracking arrows. X.TP X\fB-ph[eight]\fP \fIunits\fP XMake \fIxfig\fP come up \fIunits\fP high (where units are either cm or in). X.TP X\fB-pw[idth]\fP \fIunits\fP XMake \fIxfig\fP come up \fIunits\fP wide (where units are either cm or in). X.TP X.B \-ri[ght] XChange the position of the side panel window to the right of the canvas window X(default: left). X.TP X.B \-sc[alablefonts] XAllows use of the X11R5 scalable fonts. X.TP X.B \-nosc[alablefonts] XDisables use of the X11R5 scalable fonts. You might want to use this for Xdebugging. X.TP X.B \-sh[owallbuttons]\fP XShow all the \fIxfig\fP indicator buttons instead of only those relevant Xto the current drawing mode. Normally, the buttons \fIline width\fP, X\fIarea-fill\fP, \fIgrid mode\fP, \fItext size\fP, etc. are only visible when Xthey are relevant to the current drawing mode. XThe \fB-showallbuttons\fP option makes all Xof the indicator buttons visible at all times. This takes up more screen Xreal estate, but allows the user to see all settable parameters. X.TP X.B \-sp[ecialtext] XStart \fIxfig\fP with the \fIspecial text\fP mode for text objects. X.TP X\fB-startf[ontsize]\fP \fIpointsize\fP XSet the default font size for text objects (default = 12pt). X.TP X\fB-startl[atexFont]\fP \fIfont\fP XSet the starting font name for \fILaTeX\fP fonts. X.TP X\fB-startp[sFont]\fP \fIfont\fP XSet the starting font name for \fIPostscript\fP fonts. X.TP X.B \-te[xtoutline] XSpecifies that xfig will draw a red (on color machines) outline Xof the "actual" bounding box of text objects. XThis is mostly useful for determining what rotated text will look like Xsince xfig doesn't rotate the text (other than 0, 90, 180, or X270 degrees) on the canvas. X.TP X.B \-tr[ack] XTurn on cursor (mouse) tracking arrows (default). X.TP X\fB-users[cale]\fP \fIscale\fP XSet the multiplier for displayed line lengths etc. This factor is multiplied Xby the actual length, radius or diameter of the object currently Xbeing drawn on the canvas. It is useful for making scale drawings, where Xe.g. 1 inch = 1 foot (userscale = 12.0) or 1cm = 1m (userscale = 100.0). X.TP X\fB-useru[nit]\fP \fIunits\fP XThe \fIunits\fP string is printed with the length information when drawing objects. XFor example if the \fIuserscale\fP = 1.0 and the \fIuserunit\fP = \fIft\fP Xthen a line which is 3 inches long on the canvas would be displayed as X"length = 3 ft" when it is being drawn. X XAfter \fIxfig\fP is started you may change the \fIuserscale\fP Xand the \fIuserunit\fP from a popup menu available by pressing mouse Xbutton 3 in the \fIunits\fP box where the two rulers meet. X X X.SH "GRAPHICAL OBJECTS" XThe objects in \fIxfig\fP are divided into \fBprimitive objects\fP and X\fBcompound objects\fP. The primitive objects are: \fIARC\fP, \fICIRCLE\fP, X\fICLOSED SPLINE\fP, \fIELLIPSE\fP, \fIPOLYLINE\fP, \fIPOLYGON\fP, X\fIENCAPSULATED POSTSCRIPT\fP, \fIBOX\fP, \fIARC-BOX\fP, \fISPLINE\fP, Xand \fITEXT\fP. X.PP XA primitive object can be moved, rotated, flipped vertically or horizontally, Xscaled, copied, aligned within a compound object or erased. XThe TEXT primitive may not be flipped. It may be rotated but only the markers Xshow the rotation (on-screen) for angles other than 0, 90, 180 and 270 degrees. XText IS rotated on \fIPostScript\fP output. XThe attributes of any primitive object can be edited using a popup Xpanel (discussed below), so you can, for instance, set the position Xof an object manually. X.PP XA compound object is composed of primitive objects. The primitive objects Xthat constitute a compound can not be individually modified, but they can Xbe manipulated as an entity; a compound can be moved, rotated, flipped Xvertically or horizontally, scaled, copied or erased. A compound that Xcontains any boxes or arc-boxes may only be rotated by 90 degrees. X.PP XObjects may overlap other objects according to their "depth". Objects with Xlarger depth number are obscured by objects with smaller depth. X.PP X\fIRegular\fP polygons may be created using a special drawing mode, but a Xgeneral \fIPOLYGON\fP is created as a result, which may then be modified, i.e. Xthe individual vertices may be moved if desired. X.SH "DISPLAY WINDOWS" XTen regions comprise the display area of \fIxfig\fP: the Xcommand region, top ruler, side ruler, drawing mode region, Xediting mode region, filename region, message region, Xmouse function indicator region and canvas region, Xand indicator region with buttons to set and show current line thickness, Xline style, color, area-fill gray color and several other settings. X(The mouse function indicator region was inspired by the UPS Xdebugger from the University of Kent.) XThe drawing and editing mode regions may be placed (together) to the left or Xright of the the canvas window (default: left). X.SH "COMMAND PANEL FUNCTIONS" X.TP X.I Quit XExit from \fIxfig\fP, discarding the figure. If the figure has been modified and Xnot saved, the user will be asked to Xconfirm the action, by clicking mouse button 1 on a confirm/cancel popup menu. X.TP X.I Delete ALL XDelete all objects from the canvas window (may be undone). X.TP X.I Undo XUndo the last object creation, deletion or modification. X.TP X.I Redraw XRedraw the canvas. X.TP X.I Paste XPaste the object previously copied into the cut/paste file into the current Xfigure (at its original position). X.TP X.I File XPressing mouse button 3 on this button invokes \fISave\fP function without Xpopping up the file panel. X.br XMouse button 1 or \fI<Meta>f\fP pops up a panel which contains several Xfile-related functions: X.PP X.po +.5i X.nr LL 6i X.TP X.I Current Filename XThis is read-only AsciiTextWidget which contains the filename that will be used Xto write output to a file \fIif there is no name specified in\fP the X\fIFilename\fP panel. X.TP X.I Filename XThis is an editable AsciiTextWidget which contains the filename selected Xeither by clicking on a filename from the \fIAlternatives\fP list or Xby typing a name in directly. XPressing return in the Filename window will \fILoad\fP the file and copy Xthe name to the \fICurrent Filename\fP widget. X.TP X.I (File) Alternatives XPressing mouse button 1 on a filename in the file alternatives Xwindow will select that file by copying the filename into \fIFilename\fP window. XPressing return in this window will \fILoad\fP the file specified in the X\fIFilename\fP window (if any) or the \fICurrent Filename\fP widget. X.TP X.I Filename Mask XA wildcard mask may be typed into this editable AsciiTextWidget to restrict Xthe search of filenames to a subset ala the \fIls\fP command. XPressing return in this window will automatically Xrescan the current directory. XThis string may be set by setting the X toolkit resource X\fB*file_panel*mask*string\fP. X.TP X.I Current Directory XThis is an editable AsciiTextWidget which shows the current directory. XIt may be modified by the user to manually set a directory name. When Xreturn is pressed in this window the directory specified is scanned for Xfiles matching the \fIFilenamemask\fP, if any. X XThe ~ (tilde) character may be used to specify a user's home directory, ala Xunix shell tilde expansion. X.TP X.I (Directory) Alternatives XPressing mouse button 1 on a directory name in the directory Xalternatives list will do a "change directory" to that directory. X XPressing mouse button 3 in either the file or X\fIDirectory Alternatives\fP window will do a "change directory" to the Xparent directory. X.TP X.I Home XPressing this button will change the directory to the \f3$HOME\f1 directory Xof the user. X.TP X.I Rescan XPressing this button or \fI<Meta>r\fP will rescan the Xcurrent directory. X.TP X.I Cancel XPressing this button or \fI<Meta>c\fP will pop down the \fIFile\fP panel Xwithout making any changes to the directory or file name. X.TP X.I Save XPressing this button or \fI<Meta>s\fP will save the current contents of the Xcanvas in the file specified in the X\fIFilename\fP window \fIif any\fP, or the name specified in the X\fICurrent Filename\fP if the former is empty. XIf the file already exists a confirmation popup menu will appear Xasking the user to confirm or cancel the save. XIf there is a filename in the \fIFilename\fP window it is copied to the X\fICurrent Filename\fP window. X XThe current Export directory is updated to the current File directory when XSave is pressed. X.TP X.I Load XPressing this button or \fI<Meta>l\fP will clear the canvas of any Xcurrent figure and read the figure from the filename specified Xin the \fIFilename\fP menu item \fIif any\fP, or the name Xspecified in the \fICurrent Filename\fP if the former is empty. XIf there is a figure currently on the canvas and any modifications Xhave been made to it and not saved, a popup query Xwindow will first appear asking if the user wishes to discard the current Xfigure or cancel the \fILoad\fP operation. X XThe current Export directory is updated to the current File directory when XLoad is pressed. X XA popup message window will appear and diagnostic messages will be written Xif \fIxfig\fP changes any "illegal" object values to legal values. For example, Xolder versions of \fIxfig\fP were lax about initializing unused parts such as X\fIdepth\fP, and would produce very large, random values. X\fIXfig\fP now will "clean up" bad values and inform you when it does so. XAlso, if you read in an older file format, \fIxfig\fP will inform you that Xit is converting it to the current format for that version of \fIxfig\fP. X.br XThis window can be popped down by clicking the mouse button on the X\fIDismiss\fP button. X.TP X.I Merge Read XPressing this button or \fI<Meta>r\fP will read the figure from the filename Xspecified in the \fIFilename\fP window \fIif any\fP, or the name Xspecified in the \fICurrent Filename\fP if the former is empty, Xand merge it with the figure already shown on the canvas. X XSee \fILoad\fP above for a description of the popup message window. X.PP X.po -.5i X.nr LL 6.5i X.TP X.I Export XWill let you export the figure to an output file in one of several formats. XPressing mouse button 3 on this button invokes \fIExport\fP function without Xpopping up the export panel. X.br XMouse button 1 or \fI<Meta>e\fP pops up a directory browser widget and Xa menu with several export-related functions: X.PP X.po +.5i X.nr LL 6i X.TP X.I Magnification XThis is an editable AsciiTextWidget which contains the magnification to use Xwhen translating figure to the output language. The default is 100%. X.TP X.I Orientation XThis button will toggle the output orientation between Landscape (horizontal) Xand Portrait (vertical). The default orientation is the same as the mode Xthat \fIxfig\fP was started with. X.TP X.I Justification XThis window will only be sensitive when the language selected is "ps" (\fIPostScript\fP). XYou may choose that the figure is \fIflush left\fP or \fIcentered\fP in the Xoutput file. X.TP X.I Language XThe translation language to use for \fIxfig\fP output when output is Xdirected to a file. The default is \fIPostScript\fP. XThe figure may be saved as an X11 bitmap by choosing \fIXbitmap\fP as the Xoutput language. XThe bitmap is created from the figure, the size of which is determined Xby the enclosing rectangle of all the figure plus a small border. X.TP X.I Default Output Filename XThis is read-only AsciiTextWidget which contains the filename that will be used Xto write output to a file \fIif there is no name specified in\fP Output File. XThe default is the figure name plus an extension that reflects the output Xlanguage used, e.g. myfigure.ps if PostScript is the current language used. XIf the file already exists a confirmation popup menu will appear Xasking the user to confirm or cancel the save. X.TP X.I Output Filename XThis is an editable AsciiTextWidget which contains the filename to use Xto write output to a file. XPressing return in this window will \fIExport\fP the file and copy Xthe name to the \fIDefault Output Filename\fP widget. XIf the file already exists a confirmation popup menu will appear Xasking the user to confirm or cancel the save. X.TP X.I (File) Alternatives XPressing mouse button 1 on a filename in the file alternatives Xwindow will select that file by copying the filename into \fIFilename\fP window. XPressing return in this window will \fIExport\fP the file and copy Xthe name to the \fIDefault Output Filename\fP widget. X.TP X.I Filename Mask XA wildcard mask may be typed into this editable AsciiTextWidget to restrict Xthe search of filenames to a subset ala the \fIls\fP command. XPressing return in this window will automatically Xrescan the current directory. XThis string may be set by setting the X toolkit resource X\fB*export_panel*mask*string\fP. X.TP X.I Current Directory XThis is an editable AsciiTextWidget which shows the current directory. XIt may be modified by the user to manually set a directory name. When Xreturn is pressed in this window the directory specified is scanned for Xfiles matching the \fIFilenamemask\fP, if any. X XIt is automatically updated Xto follow the current File directory when a File Load or Save is done. X XThe ~ (tilde) character may be used to specify a user's home directory, ala Xunix shell tilde expansion. X.TP X.I (Directory) Alternatives XPressing mouse button 1 on a directory name in the directory Xalternatives list will do a "change directory" to that directory. X XPressing mouse button 3 in either the file or X\fIDirectory Alternatives\fP window will do a "change directory" to the Xparent directory. X.TP X.I Home XPressing this button will change the directory to the \f3$HOME\f1 directory Xof the user. X.TP X.I Rescan XPressing this button or \fI<Meta>r\fP will rescan the current directory. X.TP X.I Cancel XPressing this button or \fI<Meta>c\fP will pop down the \fIExport\fP menu Xwithout doing any print operation. X.TP X.I Export XPressing this button or \fI<Meta>e\fP will write (export) the figure Xto the file using the selected language. XIf the file already exists, a confirmation window will popup to ask the Xuser to confirm the write or cancel. XPressing return in the Output Filename window will also Export the file. X.PP X.po -.5i X.nr LL 6.5i X.TP X.I Print XPressing mouse button 3 on this button invokes \fIPrint to Printer\fP function Xwithout popping up the print panel. Pressing the \fIShift\fP key and Xmouse button 3 invokes the \fIPrint to Batch\fP function. XPressing mouse button 1 or \fI<Meta>p\fP pops up a menu with several Xprint-related functions: X.PP X.po +.5i X.nr LL 6i X.TP X.I Magnification XThis is an AsciiTextWidget which contains the magnification to use Xwhen translating figure to the output language. X.TP X.I Orientation XThis button will toggle the output orientation between Landscape (horizontal) Xand Portrait (vertical). The default orientation is the same as the mode Xthat \fIxfig\fP was started with. X.TP X.I Justification XThis button will bring up a sub-menu from which you may choose X\fIcenter\fP or \fIflush left\fP to justify the figure on the page. The Xdefault is \fIflush left\fP. X.TP X.I Printer XThis is an AsciiTextWidget which contains the printer to Xuse if output is directed to a printer. The name of the printer may Xbe set setting the X toolkit resource \fB*printer*string\fP. XIf no resource is set, the environment variable \fBPRINTER\fP is used. X.TP X.I Print Job Params XThis is an AsciiTextWidget which into which you may put any extra Xcommand-line parameters that your lpr or lp program needs for printing. X.TP X.I Figures in batch XThis indicator shows how many figures have been put in the batch file Xfor printing X.TP X.I Dismiss XPressing this button or \fI<Meta>c\fP will pop down the \fIPrint\fP menu. X.TP X.TP X.I Print FIGURE/BATCH to Printer XPressing this button or \fI<Meta>p\fP will send the current figure X(or the batch file if it is has any figures in it) to the printer, Xby passing it through \fIfig2dev\fP to convert it to PostScript Xthen to the unix \fIlpr\fP (on BSD equivalent Unixes) Xor \fIlp\fP (on SYSV systems) program. If the batch file is printed by this Xbutton then it is removed after printing. XThe message in the button changes to reflect whether the batch file Xwill be printed (when there are any figures in the batch file) Xor the current figure. X XNote that the figure that is printed is what you see on the canvas, Xnot necessarily the figure file. I.e., if you haven't saved the figure Xsince the last changes, the figure from the canvas is printed. X\fIXfig\fP writes the figure to a temporary file to do this. XThe name of the file is \fIXFIGTMPDIR\fB/xfig-print\fR\fIPID\fP, where X\fIXFIGTMPDIR\fP is the value of the environment variable by that name and X\fIPID\fP is the process ID of \fIxfig\fP. If the environment variable X\fIXFIGTMPDIR\fP is empty or not set, the \fB/tmp\fR directory is used. X.I Print FIGURE to Batch XPressing this button or \fI<Meta>b\fP will append the figure (in PostScript form) Xto a batch file. XThe \fIPrint to Printer\fP button will send the batch file to the printer. X.TP X.I Clear Batch XPressing this button or \fI<Meta>x\fP will erase the accumulated figures from Xthe batch file. X.PP X.po -.5i X.nr LL 6.5i X X.SH "INDICATOR PANEL COMMAND DESCRIPTIONS" X.PP XThe indicator panel contains buttons to set certain drawing parameters Xsuch as line thickness, canvas grid, rotation angle etc. XAll of the buttons use the same mouse buttons for setting values. XPressing mouse button 1 on the indicator will pop up a panel Xin which either a value may be typed (e.g. for a line thickness) or the Xmouse may be clicked on one of several buttons (e.g. for grid style or Xfont name). For those that expect a value, pressing return in the value Xpart of the window will set the new value and pop down the menu. X.PP XPressing mouse button 2 on an indicator will decrement the value X(e.g. for line thickness) Xor cycle through the options in one direction (e.g. font names), while pressing Xmouse button 3 will increment the value or cycle through the options Xin the other direction. X.TP X.I ZOOM SCALE XThe canvas zoom scale may be set/increased/decreased with this button. XThe zoom scale is displayed within the zoom button. Ruler, Xgrid and linewidth are scaled, too. XPressing mouse button 2 will decrease the zoom factor by 1.0 unless it Xis less than 1.0 already in which case it will reduce to the nearest 0.25. XPressing mouse button 3 will increase the zoom factor by 1.0 unless it Xis less than 1.0 in which case it will increase it to the nearest 0.25. XPressing the control key and mouse button 3 together will Xset the zoom scale to 1. X.sp XThe figure may also be zoomed by defining a zoom rectangle by pressing Xthe control key and mouse button 1 together. This will define one corner Xof the zoom rectangle. Move the mouse and click mouse button 1 again to Xdefine the opposite corner of the zoom rectangle. X.TP X.I GRID MODE XWith this button the user may select no grid, X1/4 inch (5mm in metric mode) grid or 1/2 inch (10mm) grid. X.TP X.I POINT POSITION XThis button controls the coarseness of object placement on the canvas. XThe options are exact (on pixel) placement, 1/16 inch (2mm in metric mode), 1/4 Xinch (5mm) or 1/2 inch (10mm). This allows the user to easily place objects Xin horizontal or vertical alignment. X XThis also restricts which objects may be "picked up" by the mouse when editing. XIf a corner of an object is not positioned on the canvas on a multiple Xof the point positioning resolution you may not be able to pick it. If this Xhappens, a black square will temporarily appear above the mouse cursor. XThis square will also appear anytime the user tries to pick a nonexistent Xobject. X.TP X.I ROTATION ANGLE XThe rotation angle for rotating objects may be set/increased/decreased Xwith this button. XNote that not all objects may be rotated, and certain objects Xmay only be rotated by certain angles. XPressing mouse button 2 will decrease the angle in steps of 15 degrees, Xwhile mouse button 3 will increase the angle the same amount. XTo select other angles, press mouse button 1 and Xenter the angle in the popup menu. X.TP X.I DEPTH XThe depth at which new objects will be created may be set/increased/decreased Xwith this button. X.TP X.I NUMBER OF POLYGON SIDES XThe number of sides used in creating a \fIREGULAR POLYGON\fP is set with Xthis button. X.TP X.I SMART-LINKS MODE XThis button controls the smart-links mode. When turned on, lines which Xlink box-like objects together (henceforth called \fIlinks\fP) are treated Xspecially when one of the box-like objects is moved. XWhen set to \fIMOVE\fP mode, the end point of the link which touches X(or is very near) the perimeter of the box is moved with the Xbox so that the box and the end point remain linked. XWhen set to \fISLIDE\fP mode, the end segment of the link slides so Xthat the box remains linked and the angle of the end segment is maintained. XThis is useful for keeping the last segment of a link horizontal or vertical. X X(At the moment, this mode only works for the \fIMOVE\fP and \fICOPY\fP Xfunctions and only works for \fIPOLYLINE\fP links and box-like objects. XAnother limitation at the moment is that if both ends of a link touch Xthe box being operated on, only one end of the link will be adjusted.) X.TP X.I VERTICAL ALIGN XThis sets the vertical alignment mode for the \fIALIGN\fP button in the Xediting mode panel. The choices are no vertical alignment, align to top edge, Xmiddle or bottom edge of compound. XThe \fIHORIZONTAL ALIGN\fP and \fIVERTICAL ALIGN\fP indicator settings are Xused together to align objects inside a compound or in canvas. X.TP X.I HORIZONTAL ALIGN XThis sets the horizontal alignment mode for the \fIALIGN\fP button in the Xediting mode panel. The choices are no horizontal alignment, align to left edge, Xmiddle or right edge of compound. XThe \fIHORIZONTAL ALIGN\fP and \fIVERTICAL ALIGN\fP indicator settings are Xused together to align objects inside a compound or in canvas. X.TP X.I ANGLE GEOMETRY XThe following settings are available to restrict the drawing angle of line Xsegments in \fIPOLYLINES\fP, \fIPOLYGONS\fP and \fISPLINES\fP. X.po +.5i X.nr LL 6i X.TP X.I UNRESTRICTED XAllow lines to be drawn with any slope. This is the default setting. X.TP X.I LATEX LINE XAllow lines to be drawn only at slopes which can be handled by \fILaTeX\fP picture Xenvironment lines: slope = x/y, where x,y are integers in the range [-6,6]. X.TP X.I LATEX VECTOR XAllow lines to be drawn only at slopes which can be handled by \fILaTeX\fP picture Xenvironment vectors: slope = x/y, where x,y are integers in the range [-4,4]. X.TP X.I MANHATTAN-MOUNTAIN XAllow lines to be drawn in the horizontal, vertical or diagonal direction only. X.TP X.I MANHATTAN XEnforce drawing of lines in the horizontal and vertical direction only. XThe name \fIManhattan\fP comes from the horizontal/vertical look of the Manhattan X(New York City) skyline. X.TP X.I MOUNTAIN XEnforce drawing of only diagonal lines. XThe name comes from the pointed shape of mountains. X.PP X.po -.5i X.nr LL 6.5i X.TP X.I FILL STYLE XThis button allows the user to select the area fill darkness (grey scale) Xfor all objects except \fITEXT\fP and \fIENCAPSULATED POSTSCRIPT\fP, Xor to turn off area fill altogether. X.TP X.I COLOR XThe user may select one of eight predefined colors to draw with, or select Xthat the \fIdefault\fP (-fg) color is to be used. The eight colors are black, Xblue, green, cyan, red, magenta, yellow and white. Note that \fITransFig\fP Xversions 2.1.4 and later support color output for \fIPostScript\fP. XOn monochrome screens the objects are created with the selected color, Xbut black is used to draw the objects on the canvas. X.TP X.I LINE WIDTH XThe width of lines may be selected with this button. Zero width lines may be Xdrawn for the purpose of having filled areas without outlines. X.TP X.I LINE STYLE XThe choices for line style are solid, dashed and dotted. Once created, Xa dashed or dotted line may be edited to change the length of dashes Xor the spacing of dots respectively. XThe dash length and dot gap can be changed from the default Xusing the popup menu. X.TP X.I BOX CURVE XThe radius of the corners on \fIARC-BOX\fP objects may be set with this Xbutton. X.TP X.I ARROW MODE XThis button selects the auto-arrow mode for drawing lines. The options are Xno arrow heads, backward-pointing arrow head, forward-pointing Xarrow head or both. If one or both arrow head modes are turned on, then Xarrow heads are automatically drawn when drawing X\fIPOLYLINE\fP, \fISPLINE\fP or \fIARC\fP objects. X.TP X.I TEXT JUSTIFICATION XThe adjustment of text may be set to \fIleft\fP, \fIcenter\fP or X\fIright justification\fP. X.TP X.I TEXT SIZE XThe text size may be set/increased/decreased with this button. The default Xis 12 points. X.TP X.I TEXT STEP XThe interline spacing of text may be set/increased/decreased with this button. XThe number displayed gives the multiple of the font height Xthat will be placed between lines on hitting \fI<return>\fP. The default Xis a factor of 1.2 times the current font size. X.TP X.I TEXT FONT XThis button allows a selection of 35 fonts available for most Apple X\fIPostScript\fP printers. XThere are two buttons at the top of the menu. The \fIcancel\fP button pops Xdown the menu without changing the current font. The \fIuse latex fonts\fP Xwill switch the menu to the \fILaTeX\fP font choices. XWhen the \fILaTeX\fP font menu is up, besides a \fIcancel\fP button Xthere is a button to switch back to the \fIPostScript\fP fonts. X XThe name of the font is printed in the font itself so that one may see Xwhat that font looks like. XIf a corresponding X11 font exists, new text is created Xon the canvas using that font. X\fIxfig\fP uses the size of X11 font closest to that selected Xby the font size button. XIf the X11 font doesn't exist, \fIxfig\fP uses the font Xselected by the "-normal" option. XTo abort selection of a font, click mouse button 1 on \fIcancel\fP. X.TP X.I TEXT FLAGS XThis button displays the current setting of the text flags. You may use Xmouse buttons 2 and 3 to step back and forth through the three flag settings: X\fIHidden\fP, \fIRigid\fP and \fISpecial\fP. To change any of the flags Xyou must use mouse button 1 to popup a menu from which you may change any Xor all of the flags. X XThe \fIHidden\fP and \fISpecial\fP attributes of text objects are Xused with figures that will be incorporated into LaTeX. Please see Xthe documentation for LaTeX for further information. The default for the X\fIHidden\fP flag is \fIoff\fP. XThe default for the \fISpecial\fP flag is \fIoff\fP unless xfig is started Xwith the command-line parameter \fI-specialtext\fP (resource specialtext). X XThe \fIRigid\fP attribute forces text to remain the same size even if Xinside a compound object that is scaled up or down. The default is \fIoff\fP. X X.SH "DRAWING AND EDITING MODE PANELS" XIcons in the drawing and editing mode panel windows represent Xobject manipulation functions, Xmodes and other drawing or modification aids. XManipulation functions are selected by positioning the cursor over the icon Xrepresenting the desired drawing/editing function and Xclicking mouse button 1. The selected icon is highlighted, and Xa message describing its function appears in the message window. XThe hilighting remains on until another function is selected. X.SH "DRAWING MODE PANEL COMMAND DESCRIPTIONS" X.PP XThe drawing mode panel contains buttons used to create the various \fIxfig\fP Xobjects. XOnce the drawing mode is selected, the object is created by moving Xthe mouse to the point on the canvas where the object is to be placed Xand pressing and releasing mouse button 1. XAfter that the mouse is moved to the second point and Xmouse button 1 is again pressed for the next point. XFor those objects which may have more than two points (e.g. a line), Xmouse button 1 may be pressed for each successive point, and Xmouse button 2 must be pressed to finish the object. XTo create a single point Xusing the \fIPOLYLINE\fP button, press and release mouse button 2. XFor the \fIARC\fP object, which requires exactly three Xpoints mouse button 1 is used for all three points. X.PP XAt any time mouse button 3 may be pressed to cancel the Xcreation of the object. X.TP X.I ARC XCreate an arc. Specify three points using mouse button 1. The first and Xlast points will form the endpoints of the arc and the second specifies Xany point on the arc. X.TP X.I BOX XCreate rectangular boxes. XStart by clicking mouse button 1 on any corner of the desired box and Xfinish with the same mouse button on the diagonally opposite corner of Xthe box. X.TP X.I ARC-BOX XCreate rectangular boxes with rounded corners. XStart and finish with mouse button 1 in the same way as \fIBOX\fP. XThe radius of the corners is selected by the \fIBOX CURVE\fP button. X.TP X.I CIRCLE XCreate circles by specifying their radii or diameters. XClick mouse button 1 on the center of the circle and drag the mouse Xuntil the desired radius or diameter is attained. Click Xmouse button 1 again to finish the circle. X.TP X.I ELLIPSE XCreate ellipses using the same procedure as for the drawing of circles. X.TP X.I ENCAPSULATED POSTSCRIPT OBJECT (EPS) XClick mouse button 1 on any corner Xfor the \fIEPS\fP object and finish by clicking mouse button 1 Xagain on the diagonally opposite corner. The \fIEDIT\fP Xpopup panel will appear and the file name of the \fIEPS\fP object Xmay be entered. After pressing \fIDONE\fP or \fIAPPLY\fP X(see the description of the EDIT panel for the difference between Xthe \fIDONE\fP and \fIAPPLY\fP buttons) the bitmap Xpart of the \fIEPS\fP object will appear in the box just created. If no X\fIEPS\fP file is available yet or no name is entered or there is no X\fIpreview bitmap\fP in the \fIEPS\fP file, pressing \fIDONE\fP Xwill pop down the edit panel and the word X\fI<empty>\fP or the \fIEPS\fP file name will remain in the \fIEPS\fP box. XLater, when the name of the \fIEPS\fP file is known or the file is available, Xyou may re-read the \fIEPS\fP file using the popup edit panel and the bitmap Xpart of the \fIEPS\fP file will replace the name in the box. X.sp XIf you want the original size of the \fIEPS\fP object, press the X"Use orig size" button and the eps bitmap will enlarge or shrink to Xthe size specified in the preview bitmap of the \fIEPS\fP file. XIf you want the \fIEPS\fP object to be approximately the size of Xthe rectangle specified with the mouse but want the aspect ratio Xto be same as the original, press either "Shrink to orig" or X"Enlarge to orig" buttons. You must press the APPLY button to Xsee these effects. X.sp XIf the \fIEPS\fP file has no preview bitmap, but has a \fI%%BoundingBox\fP Xcomment and xfig has been compiled \fIxfig\fP with the \fI-DGSBIT\fP flag and Xyou have \fIgs\fP (ghostscript) version 2.4 or newer then xfig will Xcall \fIgs\fP to produce a preview bitmap on the screen. XGhostscript is available from \fIprep.ai.mit.edu\fR. X.TP X.I INTERPOLATED SPLINE XCreate (cubic spline) spline objects. XEnter control vectors in the same way as for creation of a X\fIPOLYLINE\fP object. XAt least three points (two control vectors) must be entered. XThe spline will pass through the entered points. X.TP X.I POLYLINE XCreate polylines (line segments connecting a sequence of points). XEnter points by clicking mouse button 1 at the desired positions on the Xcanvas window. Click mouse button 2 to finish. X.TP X.I POLYGON XSame as \fIPOLYLINE\fP Xexcept that a line segment is drawn connecting the first and last Xpoints entered. X.TP X.I REGULAR POLYGON XThe number of sides is first selected with the \fINUM SIDES\fP Xbutton in the indicator panel. Then mouse button 1 is clicked on Xthe center and the mouse dragged to the desired size. The object Xmay be rotated as it is being created by moving the mouse up or down Xrelative to the starting point. Click mouse button 1 to finish. X.TP X.I CLOSED INTERPOLATED SPLINE XCreate closed or periodic splines. The function is similar Xto \fIPOLYGON\fP except that a closed interpolated spline is drawn. XThe spline will pass through the points (knots). X.TP X.I CLOSED SPLINE XCreate closed or periodic spline objects. XThe function is similar to \fIPOLYGON\fP Xexcept that a closed spline will be drawn instead of polygon. XThe entered points are just control points; i.e. the spline will Xnot pass any of these points. X.TP X.I SPLINE XCreate (quadratic spline) spline objects. XEnter control vectors in the same way as for creation of a X\fIPOLYLINE\fP object. XAt least three points (two control vectors) must be entered. XThe spline will only pass through the two end points. X.TP X.I TEXT XCreate text strings. Click mouse button 1 at the desired position on Xthe canvas window, then enter text from the keyboard. Text may be pasted Xfrom the PRIMARY cut buffer (xterm cut/paste buffer) by pressing the X\fIF18\fP function key (the \fIPaste\fP key on Sun keyboards) Xor any key/button defined in the translation Xtable for the canvas. See the default \fIFig.ad\fP file for example. XText is drawn using the current font, font size and justification settings. XA DEL or ^H (backspace) will delete a character, while a ^X will Xerase the entire line. XFinish by clicking mouse button 2 or typing the \fI<return>\fP key. XIf \fI<return>\fP is used, the text pointer automatically moves to the next "line", Xa distance of the font height times the value in the TEXT STEP button, Xand text input mode is re-entered. To finish text fully, click Xmouse button 2 or choose any panel button that changes Xmodes (e.g. box, save, etc). XTo edit text, click on an existing text string with mouse button 1. XInsertion of characters will take place at that point. Or, use the popup X\fIEDIT\fP mode to modify the text. X.sp XEight-bit characters may be entered using the meta (compose) key. XFor example, to create an "a umlaut", hold down the meta key while pressing Xthe letter "a", then press " (quote). To create a "c cedilla", use <meta>c Xfollowed by comma. XThe following is a list of all special characters available using the meta key: X X.nf X.ta .5i XKeys Character Name X X!! upside-down exclamation point X?? upside-down question mark XC/ cent sign XL\- British pound XOX currency XY\- yen X__ broken vertical bar XSO section X"" dieresis XCO copyright XRO registered trademark X_a ordfeminine X_o ordmasculine X<< guillemotleft X>> guillemotright X\-| notsign X\-\- hyphen X+\- plusminus X^\- macron X^* degree X^. periodcentered X^1 onesuperior X^2 twosuperior X^3 threesuperior X14 onequarter X12 onehalf X34 threequarters X\e\e acute X** multiply X\-: division X/u mu XP! paragraph XA` A accent grave XA' A accent acute XA^ A accent circumflex XA~ A accent tilde XA" A dieresis XA* A ring XAE AE Xa` a accent grave Xa' a accent acute Xa^ a accent circumflex Xa~ a accent tilde Xa" a dieresis Xa* a ring Xae ae XC, C cedilla Xc, c cedilla XD\- Eth Xd\- eth XE` E accent grave XE' E accent acute XE^ E accent circumflex XE" E dieresis Xe` e accent grave Xe' e accent acute Xe^ e accent circumflex Xe" e dieresis XI` I accent grave XI' I accent acute XI^ I accent circumflex XI" I accent dieresis Xi` i accent grave Xi' i accent acute Xi^ i accent circumflex Xi" i dieresis XN~ N tilde Xn~ n tilde XO` O accent grave XO' O accent acute XO^ O accent circumflex XO~ O accent tilde XO" O dieresis XO/ O slash Xo` o accent grave Xo/ o accent acute Xo^ o accent circumflex Xo~ o accent tilde Xo" o dieresis Xo/ o slash XP| Thorn Xp| thorn Xss German ss (s-zed) XU` U accent grave XU' U accent acute XU^ U accent circumflex XU" U dieresis Xu` u accent grave Xu' u accent acute Xu^ u accent circumflex Xu" u dieresis XY' Y accent acute Xy' y accent acute Xy" y dieresis X.fi X X.SH "EDITING MODE PANEL COMMAND DESCRIPTIONS" XWhen a button in the editing mode panel is pressed, any Xobjects that may be affected by that editing operation will show their Xcorner markers. Only those objects may be affected by the particular Xedit mode. In cases where two edit modes exist for one button, it Xmay be that the corner markers will appear for objects that may be Xaffected by one button but not the other. X X.SH "SELECTING OBJECTS" XWhen multiple objects have points in common, e.g. two boxes that Xtouch at one corner, only one object can be selected by clicking on Xthat point. To select other objects, hold down the shift key while Xpressing mouse button 1: the markers of one object will be Xtemporarily highlighted. By repeatedly clicking mouse button 1 while Xholding down the shift key, it is possible to cycle through all candidates for Xselection at that point. To perform the selected action, e.g. Xdeleting one box, click on the point without holding down the Xshift key. The operation will be performed on the highlighted object. X X\fBNote:\fP XIf the mouse is not clicked near enough to an object marker or for whatever Xreason \fIxfig\fP cannot "find" the object the user is trying to select, Xa black square will temporarily appear above the mouse cursor. X.TP X.I GLUE COMPOUND XCompound objects are created by first tagging the objects to be compounded Xand then pressing mouse button 3 to group the tagged Xobjects into a compound object. Single objects are tagged by clicking Xon them with mouse button 1. A number of objects can be tagged at Xonce by using mouse button 2 to define the upper-left and Xlower-right corners of a region enclosing the objects. XTagged objects are shown with highlighted markers. XTagged objects which are selected (see the SELECTING OBJECTS section above) Xwill be temporarily unhighlighted. XThere is currently no special command to tag or untag all of the objects Xwithin a figure. You can untag all of the objects by changing from XGLUE mode to some other mode (apart from BREAK) and back again. X.TP X.I BREAK COMPOUND XBreak a compound object to allow manipulation of its component parts. XClick mouse button 1 on one of the corner markers of the compound Xobject or along one of the imaginary lines defining the compound box. XClicking with mouse button 2 will achieve the same effect Xbut will also tag the component parts (although you will not see the Xtags until you change to the GLUE mode). You can use this feature Xto easily alter the objects within a compound. X.TP X.I SCALE OBJECT XAny object may be scaled. If mouse button 1 is pressed on a X\fIBOX\fP or \fIARC-BOX\fP object, then that object will be scaled Xproportionally to its aspect ratio. If mouse button 2 is pressed Xon any object, that object will be scaled up or down about its center. XText may only be scaled if inside a compound object and then only if Xits \fIRIGID\fP flag is set to \fINORMAL\fP (using the popup edit panel). XSee the \fITransFig\fP manual for description of text options. X.TP X.I ALIGN XAlign objects. Click mouse button 1 to align objects inside a compound object Xor mouse button 2 to align all objects on canvas according to the Xsetting in the \fIVERTICAL ALIGN\fP and \fIHORIZONTAL ALIGN\fP indicators. XThe choices are the cumulative effect of vertically aligning the objects Xto the \fITOP\fP, \fIMIDDL\fPE or \fIBOTTO\fPM edge and horizontally aligning Xto the \fILEF\fPT, \fIMIDDL\fPE or \fIRIGH\fPT edge of the compound. X.TP X.I MOVE POINT XModify the position of a point of any object except \fITEXT\fP and X\fICOMPOUND\fP objects. XFor unrestrained movement, click mouse button 1 over the desired Xpoint, reposition the point, and click the \fIleft\fP button again. XFor horizontally or vertically constrained move, click mouse button 2 Xon the desired point and move either horizontally or vertically. XNotice that once you choose the direction (horizontal or vertical), movement Xis constrained in that direction. If, after moving the mouse initially, it Xis moved in the other direction a greater distance than the current position Xof the mouse relative to the starting point, then that will be the new Xconstraint direction. In otherwords if you first move the mouse X\fIhorizontally\fP one inch (say) then move it \fIvertically\fP X1.3 inches, the direction will switch to \fIvertical\fP until any X\fIhorizontal\fP motion exceeds 1.3 inches. XWhen the object is positioned where desired, click mouse button 1 to Xplace it if that button was used to start the move (unconstrained), Xor mouse button 2 (constrained) if that button was used. X.TP X.I MOVE XMove object. Click mouse button 1 (unconstrained move) or mouse button 2 X(constrained move) on any corner marker of the object to be moved. XThe horizontal/vertical constrained movement (mouse button 2) works Xexactly as described for \fIMOVE POINT\fP. X.TP X.I ADD POINTS XAdd points to \fIPOLYLINE\fP, \fIPOLYGON\fP, \fISPLINE\fP, Xor \fICLOSED SPLINE\fP objects (points of a \fIBOX\fP can not be added Xor deleted). Note that a \fIREGULAR POLYGON\fP is really an ordinary X\fIPOLYGON\fP, so adding points to this object is allowed and does NOT keep Xthe polygon regular. X.TP X.I COPY / CUT TO CUT BUFFER XCopy object to canvas or cut buffer. Click mouse button 1 (unconstrained Xcopy) or mouse button 2 (constrained copy) on any corner marker of Xthe object to be copied (for \fICIRCLE\fP and \fIELLIPSE\fP Xobjects, mouse may also be clicked on their circumferences). XThe object will be duplicated and then moved exactly as in \fIMOVE\fP. XIf mouse button 3 is clicked on an object, that object is copied Xto the cut buffer for pasting into this or another figure. XThe file used for the cut buffer is called \f3.xfig\f1 Xin the user's \f3$HOME\f1 directory. This allows a user to run two or more Xxfig processes and cut/paste objects between them. XIf there is no \f3$HOME\f1, a file is created in a temporary directory Xcalled \f3xfig\f2PID\f1 where \f2PID\f1 is the xfig process ID. XThe temporary directory used is specified in the environment variable X\fIXFIGTMPDIR/\fR. If that variable is empty or not set then \fI/tmp\fP is used. X.TP X.I DELETE POINTS XDelete points from \fIPOLYLINE\fP, \fIPOLYGON\fP, \fISPLINE\fP, Xor \fICLOSED SPLINE\fP. Objects (points of a \fIBOX\fP or \fIARC-BOX\fP Xcan not be added or deleted). XNote that a \fIREGULAR POLYGON\fP is really an ordinary X\fIPOLYGON\fP, so deleting points from this object is allowed and does NOT Xkeep the polygon regular. X.TP X.I DELETE XClick mouse button 1 on an object to delete the object. XDelete a \fIregion\fP of the canvas by clicking mouse button 2 Xand dragging the mouse to define an area of objects to delete. XClicking mouse button 3 on an object will copy the object Xto the cut buffer (see \fICOPY/CUT TO CUT BUFFER\fP above). X.TP X.I EDIT OBJECT XEdit settings for an existing object. XClick mouse button 1 on the object and a pop-up menu will appear Xshowing existing settings for the object. Some of the menu entries Xmay be changed by typing new values in the appropriate windows. These Xare editable Ascii\%TextWidgets and allow cut and paste. XOthers pop up a sub-menu of multiple choices when pressed and held. XYet others are buttons which toggle a setting on or off (e.g. arrow Xheads on lines). X XPress the "done" button to apply the changes to the object and finish. XPress the "apply" button to apply the changes but keep the menu up for Xfurther changes. Press the "cancel" button to cancel the changes and Xpop down the menu. X XThe following table shows which settings are used for the different objects. X X.if n .RS -.1i X.nf X.TS Xl c 1 c 1 c 1 c 1 c 1 c 1 c 1 c 1 c. XObject Angle Area Line Line Box \(ddDepth Color Radius Text Font/ X Fill Width Style Curve Just./Size X_ XArc X X X X X X_ XArc-Box X X X X X X X_ XCircle X X X X X X X X_ XEllipse X X X X X X X X_ XEPS X X X_ XBox,Polygon, X X X X X XLine,Spline X_ XText \(dgX X X X X_ X.TE X.fi X.if n .RE X X\(dg The angle may be set, but the object will only be rotated on X\fIPostScript\fP output for angles other than 0, 90, 180 and 270 degrees. X X\(dd The depth defines how overlapping objects are displayed. Objects with Xa greater depth value are obstructed by objects with smaller depth value. XThe maximum depth allowed is 1000. X X.TP X.I UPDATE XBy pressing mouse button 1 on an object, the current settings for Xthe indicator buttons (line width, line style, area fill etc.) which Xhave been selected for update are copied into that object. XWhen \fIxfig\fP is started, all indicator buttons which are components of objects Xare selected for update. To unselect an indicator, click on the update button Xand click mouse button 1 on the small button in the upper-right Xcorner of the indicator. When that indicator is selected the foreground color X(default black) shows. When it is unselected the background color (default white) Xshows. X.sp XIf mouse button 2 is clicked on an object, the settings in the object Xthat are selected by the indicator buttons are copied into those indicator button Xsettings. Thus, one may copy selected attributes of one object to another. X.TP X.I FLIP VERTICALLY XFlip the object up/down (mouse button 1) or copy the object and flip it X(mouse button 2). Point to part of the object, click Xthe appropriate button. That object will be flipped vertically Xabout that point. X.TP X.I FLIP HORIZONTALLY XFlip the object left/right (mouse button 1) or copy the object and flip it X(mouse button 2). Point to part of the object, click Xthe appropriate button. That object will be flipped horizontally Xabout that point. X.TP X.I ROTATE CLOCKWISE XRotate the object (mouse button 1) or copy and rotate it X(mouse button 2) -N degrees (clockwise), where N is the amount Xset in the rotation indicator button. The object is rotated about Xthe chosen point. XNot all objects can be rotated, and not all can be rotated at arbitrary Xangles. For example, \fIBOX\fP, \fIARC-BOX\fP and \fIEPS\fP objects may Xonly be rotated by 90 degrees. XText objects may be rotated, although for angles other than 0, 90, 180 Xand 270 degrees only the markers are rotated on the screen Xbecause of the limitations of the X11 Window System. XText IS rotated correctly on \fIPostScript\fP output, however. X.TP X.I ROTATE COUNTER-CLOCKWISE XRotate the object (mouse button 1) or copy (mouse button 2) X+N degrees (counter-clockwise), where N is the amount set in the rotation Xindicator button. The object is rotated about the chosen Xpoint. X.TP X.I SPLINE <-> POLYLINE XTurn \fIPOLYGON\fP into a \fICLOSED INTERPOLATED SPLINE\fP object, or Xturn \fIPOLYLINE\fP into a \fIINTERPOLATED SPLINE\fP object. X.TP X.I ADD/DELETE ARROWS XAdd or delete arrow heads of \fIARC\fP, \fIPOLYLINE\fP or \fISPLINE\fP Xobjects. Add an arrow head by clicking mouse button 1 on the Xendpoint of the object. Delete an arrow head by clicking Xmouse button 2 on the endpoint or arrow head. The length and thickness Xof the arrowheads may be modified using the popup edit panel. X.SH "PANNING" XThe figure may be panned by clicking mouse button 1, 2 or 3 Xin the rulers. Clicking mouse button 1 in the top ruler Xwill pan the image to left the by 1/2 inch (1cm in metric mode), Xadjusted for zoom factor. Clicking mouse button 3 in the top ruler Xwill pan the image right by the same amount. XBy pressing and \fIholding\fP mouse button 2 the user may drag Xthe ruler by the amount desired, thus panning the image by that amount. X.PP XThe figure is panned up and down in the same way by clicking the mouse Xin the ruler on the right of the canvas. Also, the figure can be returned Xto its origin by clicking mouse button 1 in the units X(e.g. \fIcm\fP or \fIin\fP) box. X.PP XThe arrow keys may also be used to pan the image and the home key to Xreturn the figure to the origin. Also, pressing the Control Key and Xmouse button 2 will pan the figure to the origin. X X.SH X DEFAULTS XThe overall widget name(Class) is xfig(Fig). These Xresources correspond to the command line arguments: X.nf X.sp X.TS XL 1 L 1 L 1 L 1 L. XName Class Type Default Command-line X equivalent X_ Xjustify Justify boolean false -left (false) and X -right (true) Xlandscape Orientation boolean true -Landscape and X -Portrait Xpwidth Width float 10(8) -pwidth Xpheight Height float 8(9.5) -pheight XtrackCursor Track boolean on -track and -notrack Xinches Inches boolean true -inches, -imperial, X -centimeters and X -metric XreverseVideo ReverseVideo boolean off -inverse Xdebug Debug boolean off -debug Xlatexfonts Latexfonts boolean off -latexfonts XnormalFont NormalFont string fixed -normal XboldFont ButtonFont string 8x13bold -bold Xstartfontsize StartFontSize float 12 -startfontsize XstartpsFont StartpsFont string Times-Roman -startpsFont XstartlatexFont StartlatexFont string Default -startlatexFont Xshowallbuttons ShowAllButtons boolean false -showallbuttons Xinternalborderwidth InternalBorderWidth integer 1 -internalBW Xscalablefonts ScalableFonts boolean false -scalablefonts Xspecialtext SpecialText boolean false -specialtext Xmonochrome Monochrome boolean false -monochrome XkeyFile KeyFile string CompKeyDB -keyFile XexportLanguage ExportLanguage string eps -exportLanguage Xflushleft FlushLeft boolean false -flushleft Xtextoutline TextOutline boolean false -textoutline Xuserscale UserScale float 1.0 -userscale Xuserunit UserUnit string in(cm) -userunit Xcolor0 Color0 pixel black Xcolor1 Color1 pixel blue Xcolor2 Color2 pixel green Xcolor3 Color3 pixel cyan Xcolor4 Color4 pixel red Xcolor5 Color5 pixel magenta Xcolor6 Color6 pixel yellow Xcolor7 Color7 pixel white X_ X.TE XThe following are the default keyboard accelerators as distributed Xin the Fig.ad app-defaults file: X.TS Xl l. XKeys (Context) Function X(Main xfig panels) X<Meta>q Quit xfig X<Meta>d Delete all objects from canvas X<Meta>u Undo X<Meta>r Redraw X<Meta>t pasTe xfig cutbuffer onto canvas X<Meta>f popup File menu X<Meta>e popup Export menu X<Meta>p popup Print menu X<Meta>l (re)Load figure from current file X<Meta>s Save figure to current file X X(Popup file panel) X<Meta>r Rescan current directory X<Meta>c Cancel X<Meta>l Load figure X<Meta>s Save figure X<Meta>m Merge read into current figure X X(Popup export panel) X<Meta>r Rescan current dirctory X<Meta>c Cancel X<Meta>e Export figure X X(Popup print panel) X<Meta>c Cancel X<Meta>b print to Batch file X<Meta>p Print to printer X<Meta>x clear batch file X.TE X.fi X.SH WIDGET TREE XBelow is the widget structure of \fIxfig\fP. XThe widget class name is given first, followed by the widget instance name. X.nf X.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i X XFig xfig X Form form X Form commands X Command quit X Command delete_all X Command undo X Command redraw X Command paste X Command file X Command export X Command print X Form msg_form X Label file_name X Text message X Box mode_panel X Label label X Command button (one for each of the 16 drawing mode buttons) X Label label X Command button (one for each of the 18 editing mode buttons) X Label topruler X Label canvas X Label unitbox X Label sideruler X Viewport ind_viewport X Core clip X Scrollbar horizontal X Box ind_panel X Form button_form (one for each of the 22 indicator buttons) X Command button X Toggle update (only those indicators that affect creation X of objects have update toggles) X X TransientShell xfig_ps_font_menu X Box menu X Form buttons X Command cancel X Command use_latex_fonts X Command pane (one for each of the 35 Postscript font panes) X X TransientShell xfig_latex_font_menu X Box menu X Form buttons X Command cancel X Command use_postscript_fonts X Command pane (one for each of the 6 LaTeX font panes) X X TransientShell xfig_file_menu X Form file_panel X Label file_status X Label num_objects X Label cur_file_label X Text cur_file_name X Label file_label X Text file_name X Label file_alt_label X Viewport vport X Core clip X Scrollbar vertical X List file_list_panel X Label mask_label X Text mask X Label dir_label X Text dir_name X Label dir_alt_label X Command home X Viewport dirvport X Core clip X Scrollbar vertical X List dir_list_panel X Command rescan X Command cancel X Command save X Command load X Command merge X X TransientShell xfig_export_menu X Form export_panel X Label mag_label X Text magnification X Label orient_label X MenuButton orientation X SimpleMenu menu X SmeBSB Portrait X SmeBSB Landscape X Label just_label X MenuButton justify X SimpleMenu menu X SmeBSB Flush left X SmeBSB Centered X Label lang_label X MenuButton language X SimpleMenu menu X SmeBSB LaTeX box (figure boundary) X SmeBSB LaTeX picture X SmeBSB LaTeX picture + epic macros X SmeBSB LaTeX picture + eepic macros X SmeBSB LaTeX picture + eepicemu macros X SmeBSB PiCTeX macros X SmeBSB Encapsulated Postscript X SmeBSB Postscript X SmeBSB Combined PS/LaTeX (PS part) X SmeBSB Combined PS/LaTeX (LaTeX part) X SmeBSB Textyl \especial commands X SmeBSB TPIC X SmeBSB PIC X SmeBSB X11 Bitmap X Label export_mode_label X MenuButton export_mode X SimpleMenu menu X SmeBSB Overwrite X SmeBSB Append X Label def_file_label X Label def_file_name X Label out_file_name X Text file X Label file_alt_label X Viewport vport X Core clip X Scrollbar vertical X List file_list_panel X Label mask_label X Text mask X Label dir_label X Text dir_name X Label dir_alt_label X Command home X Viewport dirvport X Core clip X Scrollbar vertical X List dir_list_panel X Command rescan X Command cancel X Command export X X TransientShell xfig_print_menu X Form print_panel X Label printer_image X Label mag_label X Text magnification X Label orient_label X MenuButton landscape X SimpleMenu menu X SmeBSB portrait X SmeBSB landscape X Label just_label X MenuButton justify X SimpleMenu menu X SmeBSB flush left X SmeBSB centered X Label print_label X Text printer X Label num_batch_lab X Label num_batch_val X Command dismiss X Command print_batch X Command clear_batch X Command print X X TransientShell xfig_file_msg X Form file_msg_panel X Text file_msg_win X Command dismiss X X TransientShell query_popup X Form query_form X Label message X Command yes X Command no X Command cancel X X TransientShell xfig_set_unit_panel X Form form X Label Unit/Scale settings X Label Ruler Units = X MenuButton Imperial (in) X SimpleMenu menu X SmeBSB Metric (cm) X SmeBSB Imperial (in) X Label Figure units = X MenuButton Ruler units X SimpleMenu menu X SmeBSB Ruler units X SmeBSB User defined X Label user_units X Text Unit/Scale settings X Label Figure scale = X MenuButton User defined X SimpleMenu menu X SmeBSB Unity X SmeBSB User defined X Label scale_factor X Text 1.0 X Command cancel X Command set X X NOTE: The following is a \fItypical\fP popup edit panel (for \fIARC-BOX\fP) X The panel will be different for other objects. X X TransientShell xfig_edit_panel X Form form X Label POLYLINE:ArcBox X Label image X Command done X Command apply X Command cancel X Label X Label Width = X Text Width = X Label Color = X Text Color = X Label Depth = X Text Depth = X Label Area fill = X MenuButton No fill X SimpleMenu menu X SmeBSB No fill X SmeBSB Filled X Label Fill density % = X Text Fill density % = X Label Line style = X MenuButton Solid Line X SimpleMenu menu X SmeBSB Solid Line X SmeBSB Dashed Line X SmeBSB Dotted Line X Label Dash length/Dot gap = X Text Dash length/Dot gap = X Label Top Left: X Label Top Left: X Text Top Left: X Label Top Left: X Text Top Left: X Label Bottom Right: X Label Bottom Right: X Text Bottom Right: X Label Bottom Right: X Text Bottom Right: X Label Radius = X Text Radius = X.fi X.SH BUGS and RESTRICTIONS XPlease send bug reports, fixes, new features etc. to: X.br Xbvsmith@lbl.gov X(Brian V. Smith) X.PP XNot all operations employ smart redrawing of objects which are altered Xas a by product of the operation. You may need to use \fIRedraw\fP Xin these cases. X.PP XMust compile \fIxfig\fP with \fB-DOPENWIN\fP in order to make \fIxfig\fP handle XOpenWindows scalable fonts correctly. X.PP XSome servers do not allow bitmaps/pixmaps taller than the screen height Xor wider than the screen width. That is why there is a limit on the width Xof the top ruler and height of the side ruler. If you need wider/taller Xrulers AND your server allows bigger pixmaps, you may define MAX_TOPRULER_WD Xand/or MAX_SIDERULER_HT in your Imakefile in the DEFINES line. For example, Xto have a maximum top ruler width of 1160 pixels, add X-DMAX_TOPRULER_WD=1160 to your DEFINES line in the Imakefile. X.PP XThere is a bug in OpenWindows 2.0 which relates to pixmaps in widgets. XYou must compile \fIxfig\fP with the \fB-DOPENWIN_BUG\fP option for this problem. X.PP XIf the image is panned or the \fIxfig\fP window iconified and de-iconified Xduring the middle of an operation (e.g. while drawing a line), the picture Xwill be distorted. This can be corrected using \fIRedraw\fP after the Xoperation is complete. X.PP XRotated text will be displayed horizontally or vertically (i.e. angles Xof 0, 90, 180 and 270 degrees) on the screen. XThey will be rotated correctly when printed on \fIPostScript\fP output. X.PP XCorners of object scaled with point positioning in one of the grid Xmodes will not always fall on the grid line, but to the closest pixel. X.SH "SEE ALSO" XBrian W. Kernighan X.I "PIC - A Graphics Language for Typesetting User Manual" X.br Xfig2dev(1) (\fITransFig\fP package) X.SH ACKNOWLEDGEMENT XMany thanks goes to Professor Donald E. Fussell who inspired the Xcreation of this tool. X.SH COPYRIGHT XOriginal Copyright (c) 1985 by Supoj Sutanthavibul X.PP XPermission to use, copy, modify, distribute, and sell this software and its Xdocumentation for any purpose is hereby granted without fee, provided that Xthe above copyright notice appear in all copies and that both that Xcopyright notice and this permission notice appear in supporting Xdocumentation. No representations are made about suitability of this Xsoftware for any purpose. It is provided "as is" without express or Ximplied warranty. X.PP X\fIPostScript\fP is a trademark of Adobe Systems Incorporated. X.SH FILES X.TP XCompKeyDB - Data base of compose (meta) key sequences for 8-bit characters. XMust be installed in \fB$(XFIGLIBDIR)\fP with 'make install', or may be Xspecified with command line option -keyFile or X toolkit resource keyFile. XSee the \fIImakefile\fP. X.TP XDoc/FORMAT2.1 - Description of Fig file format. X.TP XCHANGES - Description of bug fixes/new features. X.SH AUTHORS XMany people have contributed to \fIxfig\fP. Here is a list of the people who Xhave contributed the most (in chronological order): X.sp XOriginal author: X.br XSupoj Sutanthavibul, University of Texas at Austin X.sp XThe \fILaTeX\fP line drawing modes were contributed by: X.br XFrank Schmuck, Cornell University X.sp XOriginal X11 port by: X.br XKen Yap, Rochester X.sp XVariable window sizes, cleanup of X11 port, right hand side panel: X.br XDana Chee, Bellcore X.sp XCleanup of color port to X11 by: X.br XJohn T. Kohl, MIT X.sp X\fBVersion 2.0:\fP X.br XArea fill, multiple line thicknesses, multiple fonts and font sizes, Xbottom panel, line style/thickness modification of objects by: X.br XBrian V. Smith, Lawrence Berkeley Laboratory X.br X(standard disclaimer applies) X.br X(bvsmith@lbl.gov) X.sp XPopup change-object menu by: X.br XJon Tombs X.br XFrank Schmuck X.sp XZooming and panning functions, shift key select mechanism by: X.br XDieter Pellkofer X.br XHenning Spruth X.sp XDepth feature by: X.br XMike Lutz X.sp X\fBVersion 2.1:\fP X.br XIndicator panel, file menu popup, print menu popup, Xpanning with rulers, mouse function window, regular polygon, Xrubberbanding of circles/ellipses, filled splines on canvas, Xdashed/dotted splines on canvas, update button, Xarbitrary angle rotation of objects, alignment in compound, Xobject scaling, constrained copy/move, corner markers for compound, Xcontext sensitive corner markers, smarter redraw, undo for compound Xand point move for boxes, cancel object creation, point positioning Xto three resolutions, \fITransFig\fP scalable text, hidden text, Xspecial text, save of figure on crash by: X.sp XPaul King (king@cs.uq.oz.au) X.br Xwith help from: X.br XBrian V. Smith (bvsmith@lbl.gov) Xand Micah Beck (beck@cs.cornell.edu) X.sp XEncapsulated \fIPostScript\fP importing by: X.br XBrian Boyter X.sp XColor implementation and pan/zoom with ctrl key/mouse by: X.br XHenning Spruth X.sp XInternational characters by: X.br XHerve Soulard X.sp XDirectory Browser based on XDir by: X.br XWin Treese, Digital Equipment Corporation X.sp XRotated ellipses by: X.br XJames Tough, Dept. of Computer Science, Heriot-Watt University, Scotland X.sp X(Vertically) Rotated text by: X.br XAlan Richardson, Space Science Centre, School of MAPS, XUniversity of Sussex X.sp XPopup scale menu and dynamic switching between inches and cm by: X.br XPaul King (king@cs.uq.oz.au) X.sp XMany bug fixes/cleanups etc. by a host of faithful users X.br XSee the CHANGES file for all the credits END_OF_FILE if test 65304 -ne `wc -c <'Doc/xfig.man'`; then echo shar: \"'Doc/xfig.man'\" unpacked with wrong size! fi # end of 'Doc/xfig.man' fi echo shar: End of archive 26 $of 27$. cp /dev/null ark26isdone MISSING="" for I in 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 ; do if test ! -f ark${I}isdone ; then MISSING="${MISSING} ${I}" fi done if test "${MISSING}" = "" ; then echo You have unpacked all 27 archives. rm -f ark[1-9]isdone ark[1-9][0-9]isdone else echo You still need to unpack the following archives: echo " " ${MISSING} fi ## End of shell archive. exit 0 exit 0 # Just in case... -- // chris@IMD.Sterling.COM | Send comp.sources.x submissions to: \X/ Amiga - The only way to fly! | sources-x@imd.sterling.com "It's intuitively obvious to the | most casual observer..." | GCS d+/-- p+ c++ l+ m+ s++/+ g+ w+ t+ r+ x+