XFIG(1) XFIG(1) NNAAMMEE xfig - Facility for Interactive Generation of figures under X11 SSYYNNOOPPSSIISS xxffiigg [_o_p_t_i_o_n_s] [_f_i_l_e] DDEESSCCRRIIPPTTIIOONN _X_f_i_g is a menu-driven tool that allows the user to draw and manipulate objects interactively in an X window. IItt rruunnss uunnddeerr XX vveerrssiioonn 1111 rreelleeaassee 44 oorr hhiigghheerr and requires a three-button mouse. _f_i_l_e specifies the name of a file to be edited. The description of objects in the file will be read at the start of _x_f_i_g. The _T_r_a_n_s_F_i_g package is used to print the output from _x_f_i_g. Note for previous _x_f_i_g users: The _f_2_p and _f_2_p_s translators have been phased out because the _T_r_a_n_s_F_i_g package from Micah Beck is a more general purpose translator for more graphics languages. The _T_r_a_n_s_F_i_g package can be used as a back-end processor to xfig to produce various types of output: LaTeX - _f_i_g_2_d_e_v _-_L _l_a_t_e_x translates _x_f_i_g to _L_a_T_e_X pic- ture environment commands which can be pro- cessed along with other _L_a_T_e_X commands. Postscript - _f_i_g_2_d_e_v _-_L _p_s produces a postscript output. Pic - _f_i_g_2_d_e_v _-_L _p_i_c produces a pic output. PiCTeX - _f_i_g_2_d_e_v _-_L _p_i_c_t_e_x produces _P_i_C_T_e_X output. This contains macros that can be used with the _P_i_C_T_e_X environment under _T_e_X or _L_a_T_e_X_. Others - _f_i_g_2_d_e_v has options for these other languages: _b_o_x, _e_p_i_c, _e_e_p_i_c, and _e_e_p_i_c_e_m_u. The _T_r_a_n_s_F_i_g package is available from the contributed software on the distribution tapes of X11 Release 5 from MIT and from ftp.cs.cornell.edu (directory /pub/fig) and sun.soe.clarkson.edu (directory /pub/transfig) via anony- mous ftp. It is also available by mail from the Clarkson archive server. To find out about using the server, send the one-line message "help" to archive- server@sun.soe.clarkson.edu. OOPPTTIIOONNSS --rrii[[gghhtt]] Change the position of the side panel window to the Release 2.1 (Protocol 2.1) 1 XFIG(1) XFIG(1) right of the canvas window (default: left). --llee[[fftt]] Change the position of the side panel window to the left of the canvas window. --LL[[aannddssccaappee]] Make _x_f_i_g come up in landscape mode (10" x 8"). This is the default. --PP[[oorrttrraaiitt]] Make _x_f_i_g come up in portrait mode (8" x 9"). --ppww[[iiddtthh]] _u_n_i_t_s Make _x_f_i_g come up _u_n_i_t_s wide (where units are either cm or in). --pphh[[eeiigghhtt]] _u_n_i_t_s Make _x_f_i_g come up _u_n_i_t_s high (where units are either cm or in). --ttrr[[aacckk]] Turn on cursor (mouse) tracking arrows (default). --nnoott[[rraacckk]] Turn off cursor (mouse) tracking arrows. --iinncc[[hheess]] Make inches the unit of choice (default). --mmee[[ttrriicc]] Make centimeters the unit of choice. --iinnvv[[vveerrssee]] Use inverse video (white on black). --ddee[[bbuugg]] Turn on debugging mode. --nnoorr[[mmaall]] _f_o_n_t Cause the font used for the message panel and ruler numbers to be _f_o_n_t. This font is also used on the canvas when the selected font is not available in an X11 font (default = fixed). --bbuu[[ttttoonn]] _f_o_n_t Cause the font used for most buttons to be _f_o_n_t (default = 6x13). --bbooll[[dd]] _f_o_n_t Cause the font used for displaying confirmation messages to be _f_o_n_t (default = 8x13bold). Release 2.1 (Protocol 2.1) 2 XFIG(1) XFIG(1) --ssttaarrttff[[oonnttssiizzee]] _p_o_i_n_t_s_i_z_e Set the default font size for text objects (default = 12pt). --sshh[[oowwaallllbbuuttttoonnss]] Show all the xfig indicator buttons instead of only those relevant to the current drawing mode. Nor- mally, the buttons _l_i_n_e _w_i_d_t_h, _a_r_e_a_-_f_i_l_l, _g_r_i_d _m_o_d_e, _t_e_x_t _s_i_z_e, etc. are only visible when they are relevant to the current drawing mode. The --sshhoowwaallllbbuuttttoonnss option makes all of the indicator buttons visible at all times. This takes up more screen real estate, but allows the user to see all settable parameters. --iinntteerrnnaallBBWW _w_i_d_t_h Use lines of width _w_i_d_t_h between all buttons and panels (default = 1). GGRRAAPPHHIICCAALL OOBBJJEECCTTSS The objects in _x_f_i_g are divided into pprriimmiittiivvee oobbjjeeccttss and ccoommppoouunndd oobbjjeeccttss. The primitive objects are: _A_R_C, _C_I_R_C_L_E, _C_L_O_S_E_D _S_P_L_I_N_E, _E_L_L_I_P_S_E, _P_O_L_Y_L_I_N_E, _P_O_L_Y_G_O_N, _E_N_C_A_P_S_U_L_A_T_E_D _P_O_S_T_S_C_R_I_P_T, _B_O_X, _A_R_C_-_B_O_X, _S_P_L_I_N_E, and _T_E_X_T. A primitive object can be moved, rotated, flipped verti- cally or horizontally, scaled, copied, aligned within a compound object or erased. The TEXT primitive cannot be rotated (on-screen) or flipped. The attributes of any primitive object can be edited using a popup panel (dis- cussed below), so you can, for instance, set the rotation angle for printed TEXT primitives. A compound object is composed of primitive objects. The primitive objects that constitute a compound can not be individually modified, but they can be manipulated as an entity; a compound can be moved, rotated, flipped verti- cally or horizontally, scaled, copied or erased. _R_e_g_u_l_a_r polygons may be created using a special drawing mode, but a general _P_O_L_Y_G_O_N is created as a result, which may then be modified, i.e. the individual vertices may be moved if desired. DDIISSPPLLAAYY WWIINNDDOOWWSS Nine regions comprise the display area of _x_f_i_g: the com- mand region, top ruler, side ruler, drawing mode region, editing mode region, message region, indicator region with buttons to set and show current line thickness, line style, area-fill gray color and several other settings, mouse function indicator region and canvas region. (The mouse function indicator region was inspired by the UPS debugger from the University of Kent.) The drawing and editing mode regions may be placed (together) to the left Release 2.1 (Protocol 2.1) 3 XFIG(1) XFIG(1) or right of the the canvas window (default: left). CCOOMMMMAANNDD PPAANNEELL FFUUNNCCTTIIOONNSS _Q_u_i_t Exit from _x_f_i_g, discarding the figure. If the fig- ure has been modified and not saved, the user will be asked to confirm the action, by clicking the _l_e_f_t button on a confirm/cancel popup menu. _D_e_l_e_t_e _A_L_L Delete all objects from the canvas window (may be undone). _U_n_d_o Undo the last object creation, deletion or modifi- cation. _R_e_d_r_a_w Redraw the canvas. _P_a_s_t_e Paste the object previously copied into the cut/paste file into the current figure (at its original position). _F_i_l_e Left mouse button pops up a menu which contains several file-related functions: _D_i_r_e_c_t_o_r_y This is an editable AsciiTextWidget which contains the current directory. _F_i_l_e This is an editable AsciiTextWidget which contains the current filename. _C_a_n_c_e_l This pops down the file panel without making any changes to the directory or file name. _S_a_v_e Save the current contents of the canvas in the file specified in the _F_i_l_e menu item. If the file already exists a confirmation popup menu will appear asking the user to confirm or cancel the save. _L_o_a_d The current contents of the canvas are cleared and the figure is read from the filename specified in the _F_i_l_e menu item. This file will become the cur- rent file. _M_e_r_g_e _R_e_a_d Read figure from the filename specified in the _F_i_l_e menu item and merge it with the figure already shown on the canvas. The filename in the _F_i_l_e will revert to the previous filename after this function is completed. Right mouse button invokes _S_a_v_e function without popping Release 2.1 (Protocol 2.1) 4 XFIG(1) XFIG(1) up the file panel. _E_x_p_o_r_t Will let you export the figure to an output file in one of several formats. Left mouse button pops up a menu with several export-related functions: _M_a_g_n_i_f_i_c_a_t_i_o_n This is an editable AsciiTextWidget which contains the magnification to use when translating figure to the output language. _O_r_i_e_n_t_a_t_i_o_n This button will toggle the output orientation between Landscape (horizontal) and Portrait (verti- cal). The default orientation is the same as the mode that xfig was started with. _L_a_n_g_u_a_g_e The translation language to use for xfig output when output is directed to a file. The default is Postscript. The figure may be saved as an X11 bitmap by choosing _X_b_i_t_m_a_p as the output language. The bitmap is created from the figure, the size of which is determined by the enclosing rectangle of all the figure plus a small border. _D_e_f_a_u_l_t _O_u_t_p_u_t _F_i_l_e This is read-only AsciiTextWidget which contains the filename that will be used to write output to a file _i_f _t_h_e_r_e _i_s _n_o _n_a_m_e _s_p_e_c_i_f_i_e_d _i_n Output File. The default is the figure name plus an extension that reflects the output language used. _O_u_t_p_u_t _F_i_l_e This is an editable AsciiTextWidget which contains the filename to use to write output to a file. _C_a_n_c_e_l This button will pop down the print menu without doing any print operation. _E_x_p_o_r_t This button writes the figure to the file using the selected language. If the file already exists, a confirmation window will popup to ask the user to confirm the write or cancel. Right mouse button invokes _E_x_p_o_r_t function without popping up the export panel. _P_r_i_n_t Left mouse button pops up a menu with several print-related functions: Release 2.1 (Protocol 2.1) 5 XFIG(1) XFIG(1) _M_a_g_n_i_f_i_c_a_t_i_o_n This is an AsciiTextWidget which contains the mag- nification to use when translating figure to the output language. _O_r_i_e_n_t_a_t_i_o_n This button will toggle the output orientation between Landscape (horizontal) and Portrait (verti- cal). The default orientation is the same as the mode that xfig was started with. _J_u_s_t_i_f_i_c_a_t_i_o_n This button will bring up a sub-menu from which you may choose _c_e_n_t_e_r or _f_l_u_s_h _l_e_f_t to justify the fig- ure on the page. The default is _f_l_u_s_h _l_e_f_t. _P_r_i_n_t_e_r This is an AsciiTextWidget which contains the printer to use if output is directed to a printer. The name of the printer may be set using the resource _*_p_r_i_n_t_e_r_*_s_t_r_i_n_g_: _C_a_n_c_e_l This button will pop down the print menu without doing any print operation. _P_r_i_n_t This button sends the figure to the printer. Note that the figure that is printed is what you see on the canvas, not necessarily the figure file. I.e., if you haven't saved the figure since the last changes, the figure from the canvas is printed. _X_f_i_g writes the figure to a temporary file to do this. The name of the file is //ttmmpp//xxffiigg--pprriinntt_P_I_D, where _P_I_D is the process ID of _x_f_i_g. Right mouse button invokes _P_r_i_n_t function without popping up the print panel. IINNDDIICCAATTOORR PPAANNEELL CCOOMMMMAANNDD DDEESSCCRRIIPPTTIIOONNSS The indicator panel contains buttons to set certain draw- ing parameters, such as line thickness, canvas grid, rota- tion angle etc. All of the buttons use the same mouse buttons for setting values. Pressing the _l_e_f_t mouse but- ton on the indicator will pop up a panel in which either a value may be typed (e.g. for a line thickness) or the mouse may be clicked on one of several buttons (e.g. for grid style or font name). Pressing the _m_i_d_d_l_e mouse button on an indicator will decrement the value (e.g. for line thickness) or cycle through the options in one direction (e.g. font names), while pressing the _r_i_g_h_t mouse button will increment the value or cycle through the options in the other direction. Release 2.1 (Protocol 2.1) 6 XFIG(1) XFIG(1) _Z_O_O_M _S_C_A_L_E The canvas zoom scale may be set/increased/decreased with this button. The integer zoom scale is displayed within the zoom button. Ruler, grid and linewidth are scaled, too. _R_O_T_A_T_I_O_N _A_N_G_L_E The rotation angle for rotating objects may be set/increased/decreased with this button. Note that not all objects may be rotated, and certain objects may only be rotated by certain angles. Pressing the _m_i_d_d_l_e or _r_i_g_h_t button will decrease(increase) the angle in steps of 15 degrees. To select other angles, press the _l_e_f_t button and enter the angle in the popup menu. _N_U_M_B_E_R _O_F _P_O_L_Y_G_O_N _S_I_D_E_S The number of sides used in creating a _R_E_G_U_L_A_R _P_O_L_Y_G_O_N is set with this button. _G_R_I_D _M_O_D_E With this button the user may select no grid, 1/4 inch (5mm in metric mode) grid or 1/2 inch (10mm) grid. _P_O_I_N_T _P_O_S_I_T_I_O_N This button controls the coarseness of object placement on the canvas. The options are arbitrary placement, 1/16 inch (2mm in metric mode), 1/4 inch (5mm) or 1/2 inch (10mm). This allows the user to easily place objects in horizontal or vertical alignment. This also restricts which objects may be "picked up" by the mouse when editing. If a corner of an object is not positioned on the canvas on a multi- ple of the point positioning resolution you may not be able to pick it. If this happens, a black square will temporarily appear above the mouse cur- sor. This square will also appear anytime the user tries to pick a nonexistent object. _V_E_R_T_I_C_A_L _A_L_I_G_N This sets the vertical alignment mode for the _A_L_I_G_N button in the editing mode panel. The choices are no vertical alignment, align to top edge, middle or bottom edge of compound. The _H_O_R_I_Z_O_N_T_A_L _A_L_I_G_N and _V_E_R_T_I_C_A_L _A_L_I_G_N indicator settings are used together to align objects inside a compound. _H_O_R_I_Z_O_N_T_A_L _A_L_I_G_N This sets the horizontal alignment mode for the _A_L_I_G_N button in the editing mode panel. The choices are no horizontal alignment, align to left Release 2.1 (Protocol 2.1) 7 XFIG(1) XFIG(1) edge, middle or right edge of compound. The _H_O_R_I_- _Z_O_N_T_A_L _A_L_I_G_N and _V_E_R_T_I_C_A_L _A_L_I_G_N indicator settings are used together to align objects inside a com- pound. _A_N_G_L_E _G_E_O_M_E_T_R_Y The following settings are available to restrict the drawing angle of line segments in _P_O_L_Y_L_I_N_E_S, _P_O_L_Y_G_O_N_S and _S_P_L_I_N_E_S. _U_N_R_E_S_T_R_I_C_T_E_D Allow lines to be drawn with any slope. _L_A_T_E_X _L_I_N_E Allow lines to be drawn only at slopes which can be handled by _L_a_T_e_X picture environment lines: slope = x/y, where x,y are integers in the range [-6,6]. _L_A_T_E_X _V_E_C_T_O_R Allow lines to be drawn only at slopes which can be handled by _L_a_T_e_X picture environment vectors: slope = x/y, where x,y are integers in the range [-4,4]. _M_A_N_H_A_T_T_A_N_-_M_O_U_N_T_A_I_N Allow lines to be drawn in the horizontal, vertical or diagonal direction only. _M_A_N_H_A_T_T_A_N Enforce drawing of lines in the horizontal and ver- tical direction only. _M_O_U_N_T_A_I_N Enforce drawing of only diagonal lines. _A_R_E_A _F_I_L_L This button allows the user to select the area fill darkness (grey scale) for all objects except _T_E_X_T and _E_N_C_A_P_S_U_L_A_T_E_D _P_O_S_T_S_C_R_I_P_T, or to turn off area fill altogether. _L_I_N_E _W_I_D_T_H The width of lines may be selected with this but- ton. Zero width lines may be drawn for the purpose of having filled areas without outlines. _L_I_N_E _S_T_Y_L_E The choices for line style are solid, dashed and dotted. Once created, a dashed or dotted line may be edited to change the length of dashes or the spacing of dots respectively. The dash length and dot gap can be changed from the default using the popup menu. Release 2.1 (Protocol 2.1) 8 XFIG(1) XFIG(1) _B_O_X _C_U_R_V_E The radius of the corners on _A_R_C_-_B_O_X objects may be set with this button. _A_R_R_O_W _M_O_D_E This button selects the auto-arrow mode for drawing lines. The options are no arrow heads, backward- pointing arrow head, forward-pointing arrow head or both. If one or both arrow head modes are turned on, then arrow heads are automatically drawn when drawing _P_O_L_Y_L_I_N_E, _S_P_L_I_N_E or _A_R_C objects. _T_E_X_T _J_U_S_T_I_F_I_C_A_T_I_O_N The adjustment of text may be set to _l_e_f_t, _c_e_n_t_e_r or _r_i_g_h_t _j_u_s_t_i_f_i_c_a_t_i_o_n. _T_E_X_T _S_I_Z_E The text size may be set/increased/decreased with this button. _T_E_X_T _S_T_E_P The interline spacing of text may be set/increased/decreased with this button. The num- ber displayed gives the multiple of the font height that will be placed between lines on hitting _<_r_e_t_u_r_n_>. _T_E_X_T _F_O_N_T This button allows a selection of 35 fonts avail- able for most Apple Postscript printers. There are two buttons at the top of the menu. The _c_a_n_c_e_l button pops down the menu without changing the cur- rent font. The _u_s_e _l_a_t_e_x _f_o_n_t_s will switch the menu to the _L_a_T_e_X font choices. When the _L_a_T_e_X font menu is up, besides a _c_a_n_c_e_l button there is a button to switch back to the Postscript fonts. The name of the font is printed in the font itself so that one may see what that font looks like. If a corresponding X11 font exists, new text is cre- ated on the canvas using that font. _x_f_i_g uses the size of X11 font closest to that selected by the font size button. If the X11 font doesn't exist, _x_f_i_g uses the font selected by the "-normal" option. To abort selection of a font, click the _l_e_f_t mouse button on _c_a_n_c_e_l. DDRRAAWWIINNGG AANNDD EEDDIITTIINNGG MMOODDEE PPAANNEELLSS Icons in the drawing and editing mode panel windows repre- sent object manipulation functions, modes and other draw- ing or modification aids. Manipulation functions are selected by positioning the cursor over it and clicking the _l_e_f_t mouse button. The selected icon is highlighted, Release 2.1 (Protocol 2.1) 9 XFIG(1) XFIG(1) and a message describing its function appears in the mes- sage window. DDRRAAWWIINNGG MMOODDEE PPAANNEELL CCOOMMMMAANNDD DDEESSCCRRIIPPTTIIOONNSS The drawing mode panel contains buttons used to create the various xfig objects. Once the drawing mode is selected, the object is created by moving the mouse to the point on the canvas where the object is to be placed and pressing and releasing the _l_e_f_t button. After that the mouse is moved to the second point and the _l_e_f_t button is again pressed for the next point. For those objects which may have more than two points (e.g. a line), the _l_e_f_t button may be pressed for each successive point, and the _m_i_d_d_l_e button must be pressed to finish the object. To create a single point using the _P_O_L_Y_L_I_N_E button, press and release the _m_i_d_d_l_e button. For the _A_R_C object, which requires exactly three points the _l_e_f_t button is used for all three points. At any time the _r_i_g_h_t button may be pressed to cancel the creation of the object. _A_R_C Create an arc. Specify three points using the _l_e_f_t button. _B_O_X Create rectangular boxes. Start and finish with the _l_e_f_t button. _A_R_C_-_B_O_X Create rectangular boxes with rounded corners. Start and finish with the _l_e_f_t button. The radius of the corners is selected by the _B_O_X _C_U_R_V_E button. _C_I_R_C_L_E Create circles by specifying their radii or diame- ters. Click the _l_e_f_t button on the center of the circle and drag the mouse until the desired radius or diameter is attained. Click the _l_e_f_t button again to finish the circle. Note: if xfig has been compiled with the _-_D_F_A_S_T_- _S_E_R_V_E_R flag the circle will be drawn as the user is creating it (dragging the mouse). Otherwise a rectangular outline will show the user the size of the circle until the object is compete. _E_L_L_I_P_S_E Create ellipses using the same procedure as for the drawing of circles. _E_N_C_A_P_S_U_L_A_T_E_D _P_O_S_T_S_C_R_I_P_T _O_B_J_E_C_T _(_E_P_S_) Click the _l_e_f_t button on either the upper-left or lower-right corner for the _E_P_S object and finish by clicking the _l_e_f_t button again on the opposite cor- ner. The _E_D_I_T popup panel will appear and the file Release 2.1 (Protocol 2.1) 10 XFIG(1) XFIG(1) name of the _E_P_S object may be entered. After pressing _D_O_N_E or _A_P_P_L_Y the bitmap part of the _E_P_S object will appear in the box just created. If no _E_P_S file is available yet or no name is entered or there is no _p_r_e_v_i_e_w _b_i_t_m_a_p in the _E_P_S file, press- ing _D_O_N_E will pop down the edit panel and the word _<_e_m_p_t_y_> or the _E_P_S file name will remain in the _E_P_S box. Later, when the name of the _E_P_S file is known or the file is available, you may re-read the _E_P_S file using the popup edit panel and the bitmap part of the _E_P_S file will replace the name in the box. _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E Create (cubic spline) spline objects. Enter con- trol vectors in the same way as for creation of a _P_O_L_Y_L_I_N_E object. At least three points (two con- trol vectors) must be entered. The spline will pass through the entered points. _P_O_L_Y_L_I_N_E Create polylines (line segments connecting a sequence of points). Enter points by clicking the _l_e_f_t button at the desired positions on the canvas window. Click the _m_i_d_d_l_e button to finish. _P_O_L_Y_G_O_N Same as _P_O_L_Y_L_I_N_E except that a line segment is drawn connecting the first and last points entered. _R_E_G_U_L_A_R _P_O_L_Y_G_O_N The number of sides is first selected with the _N_U_M _S_I_D_E_S button in the indicator panel. Then the _l_e_f_t button is clicked on the center and the mouse dragged to the desired size. The object may be rotated as it is being created by moving the mouse up or down relative to the starting point. Click the _l_e_f_t button to finish. _C_L_O_S_E_D _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E Create closed or periodic splines. The function is similar to _P_O_L_Y_G_O_N except that a closed interpo- lated spline is drawn. The spline will pass through the points (knots). _C_L_O_S_E_D _S_P_L_I_N_E Create closed or periodic spline objects. The function is similar to _P_O_L_Y_G_O_N except that a closed spline will be drawn instead of polygon. The entered points are just control points; i.e., the spline will not pass any of these points. _S_P_L_I_N_E Create (quadratic spline) spline objects. Enter control vectors in the same way as for creation of a _P_O_L_Y_L_I_N_E object. At least three points (two Release 2.1 (Protocol 2.1) 11 XFIG(1) XFIG(1) control vectors) must be entered. The spline will only pass through the two end points. _T_E_X_T Create text strings. Click the _l_e_f_t button at the desired position on the canvas window, then enter text from the keyboard. Text is drawn using the current font, font size and justification settings. A DEL or ^H (backspace) will delete a character, while a ^U or ^X will erase the entire line. Fin- ish by clicking the _m_i_d_d_l_e button or typing the _<_r_e_t_u_r_n_> key. If _<_r_e_t_u_r_n_> is used, the text pointer automatically moves to the next "line", a distance of the font height times the value in the TEXT STEP button, and text input mode is re- entered. To finish text fully, click the middle button or choose any panel button that changes modes (e.g. box, save, etc). To edit text, click on an existing text string with the _l_e_f_t button. Insertion of characters will take place at that point. Or, use the popup _E_D_I_T mode to modify the text. EEDDIITTIINNGG MMOODDEE PPAANNEELL CCOOMMMMAANNDD DDEESSCCRRIIPPTTIIOONNSS When a button in the editing mode panel is pressed, any objects that may be affected by that editing operation will show their corner markers. Only those objects may be affected by the particular edit mode. In cases where two edit modes exist for one button, it may be that the corner markers will appear for objects that may be affected by one button but not the other. SSEELLEECCTTIINNGG OOBBJJEECCTTSS When multiple objects have points in common, e.g. two boxes that touch at one corner, only one object can be selected by clicking on that point. To select other objects, hold down the shift key while pressing the _l_e_f_t mouse button: the markers of one object will be highlighted. By repeatedly clicking the _l_e_f_t button while holding down the shift key, it is possible to cycle through all candidates for selection at that point. To perform the selected action, e.g. deleting one box, click on the point without holding down the shift key. The operation will be performed on the highlighted object. NNoottee:: If the mouse is not clicked near enough to an object marker or for whatever reason _x_f_i_g cannot "find" the object the user is trying to select, a black square will temporarily appear above the mouse cursor. Release 2.1 (Protocol 2.1) 12 XFIG(1) XFIG(1) _G_L_U_E _C_O_M_P_O_U_N_D Create a compound object by clicking the _l_e_f_t mouse button near the upper-left area to enclose then drag the mouse to the lower-right area and click the _l_e_f_t button again. The rubber-band rectangle will disappear and four corner markers will appear, marking the boundaries of the compound object. _B_R_E_A_K _C_O_M_P_O_U_N_D Break a compound object to allow manipulation of its component parts. Click the _l_e_f_t button on the one of the corner markers of the compound object or along one of the imaginary lines defining the com- pound box. _S_C_A_L_E _O_B_J_E_C_T Any object may be scaled. If the _l_e_f_t button is pressed on a _B_O_X or _A_R_C_-_B_O_X object, then that object will be scaled proportionally to its aspect ratio. If the _m_i_d_d_l_e button is pressed on any object, that object will be scaled up or down about its center. Text may only be scaled if inside a compound object and then only if its _R_I_G_I_D flag is set to _N_O_R_M_A_L (using the popup edit panel). See the _T_r_a_n_s_F_i_g manual for description of text options. _A_L_I_G_N This button will align objects inside a compound object according to the setting in the _V_E_R_T_I_C_A_L _A_L_I_G_N and _H_O_R_I_Z_O_N_T_A_L _A_L_I_G_N indicators. The choices are the cumulative effect of vertically aligning the objects to the _T_O_P, _M_I_D_D_LE or _B_O_T_T_OM edge and horizontally aligning to the _L_E_FT, _M_I_D_D_LE or _R_I_G_HT edge of the compound. _M_O_V_E _P_O_I_N_T Modify the position of a point of any object except _T_E_X_T and _C_O_M_P_O_U_N_D objects. For unrestrained move- ment, click the _l_e_f_t button over the desired point, reposition the point, and click the _l_e_f_t button again. For horizontally or vertically constrained move, click the _m_i_d_d_l_e button on the desired point and move either horizontally or vertically. Notice that once you choose the direction (horizontal or vertical), movement is constrained in that direc- tion. If, after moving the mouse initially, it is moved in the other direction a greater distance than the current position of the mouse relative to the starting point, then that will be the new con- straint direction. In otherwords if you first move the mouse _h_o_r_i_z_o_n_t_a_l_l_y one inch (say) then move it _v_e_r_t_i_c_a_l_l_y 1.3 inches, the direction will switch to _v_e_r_t_i_c_a_l until any _h_o_r_i_z_o_n_t_a_l motion exceeds 1.3 inches. When the object is positioned where Release 2.1 (Protocol 2.1) 13 XFIG(1) XFIG(1) desired, click the _l_e_f_t to place it if the _l_e_f_t button was used to start the move (unconstrained), or the _m_i_d_d_l_e button (constrained) if that button was used. _M_O_V_E Move object. Click the _l_e_f_t (unconstrained move) or _m_i_d_d_l_e (constrained move) button on any corner marker of the object to be moved. The horizon- tal/vertical constrained movement (_m_i_d_d_l_e button) works exactly as described for _M_O_V_E _P_O_I_N_T. _A_D_D _P_O_I_N_T_S Add points to _P_O_L_Y_L_I_N_E, _P_O_L_Y_G_O_N, _S_P_L_I_N_E, or _C_L_O_S_E_D _S_P_L_I_N_E objects (points of a _B_O_X can not be added or deleted). Note that a _R_E_G_U_L_A_R _P_O_L_Y_G_O_N is really an ordinary _P_O_L_Y_G_O_N, so adding points to this object is allowed and does NOT keep the polygon regular. _C_O_P_Y _/ _C_U_T _T_O _C_U_T _B_U_F_F_E_R Copy object to canvas or cut buffer. Click the _l_e_f_t (unconstrained copy) or _m_i_d_d_l_e (constrained copy) button on any corner marker of the object to be copied (for _C_I_R_C_L_E and _E_L_L_I_P_S_E objects, mouse may also be clicked on their circumferences). The object will be duplicated and then moved exactly as in _M_O_V_E. If the _r_i_g_h_t button is clicked on an object, that object is copied to the cut buffer for pasting into this or another figure. The file used for the cut buffer is called ..xxffiigg in the user's $$HHOOMMEE directory. This allows a user to run two or more xfig processes and cut/paste objects between them. If there is no $$HHOOMMEE, a file is created in //ttmmpp, called xxffiigg_P_I_D where _P_I_D is the xfig process ID. _D_E_L_E_T_E _P_O_I_N_T_S Delete points from _P_O_L_Y_L_I_N_E, _P_O_L_Y_G_O_N, _S_P_L_I_N_E, or _C_L_O_S_E_D _S_P_L_I_N_E. Objects (points of a _B_O_X or _A_R_C_-_B_O_X can not be added or deleted). Note that a _R_E_G_U_L_A_R _P_O_L_Y_G_O_N is really an ordinary _P_O_L_Y_G_O_N, so deleting points from this object is allowed and does NOT keep the polygon regular. _D_E_L_E_T_E Click the _l_e_f_t button on an object to delete the object. Delete a _r_e_g_i_o_n of the canvas by clicking the _m_i_d_d_l_e button and dragging the mouse to define an area of objects to delete. Clicking the _r_i_g_h_t button on an object will copy the object to the cut buffer (see _C_O_P_Y_/_C_U_T _T_O _C_U_T _B_U_F_F_E_R above). _E_D_I_T _O_B_J_E_C_T Edit settings for an existing object. Click the _l_e_f_t button on the object and a pop-up menu will appear showing existing settings for the object. Release 2.1 (Protocol 2.1) 14 XFIG(1) XFIG(1) Some of the menu entries may be changed by typing new values in the appropriate windows. These are editable AsciiTextWidgets and allow cut and paste. Others pop up a sub-menu of multiple choices when pressed and held. Press the "done" button to apply the changes to the object and finish. Press the "apply" button to apply the changes but keep the menu up for further changes. Press the "cancel" button to cancel the changes and pop down the menu. The following table shows which settings are used for the different objects. center,box; C | C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C 1 S 1 S ^ | C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C 1 C 1 C L | C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C | 1 C 1 | C 1 | C. Object |- Angle Area Line Line Box |= Depth * Color Radius Text Fill Width Style Curve Font Just. Size = Arc \/ \/ \/ \/ \/ _ Arc-Box \/ \/ \/ \/ \/ \/ _ Circle \/ \/ \/ \/ \/ \/ \/ _ Ellipse \/ \/ \/ \/ \/ \/ \/ _ EPS \/ \/ _ Box, Line, Polygon, Spline \/ \/ \/ \/ \/ _ Text \/ \/ \/ \/ \/ \/ |- The angle may be set, but the object will only be rotated on Postscript output. The angle may only be set with the popup edit menu. |= The depth defines how overlapping objects are displayed. Objects with a greater depth value are obstructed by objects with smaller depth value. This may only be changed in the popup edit menu. * Although the color of objects is not yet sup- ported by xfig or any of the output translators, the color value (integer) may be edited in objects using the popup edit menu. _U_P_D_A_T_E By pressing the _l_e_f_t button on an object, the cur- rent settings for the indicator buttons (line width, line style, area fill etc.) are copied into that object. If the _m_i_d_d_l_e button is clicked on an object, the settings in the object are copied into the indicator button settings. Thus, one may copy attributes of one object to another. The _d_e_p_t_h and _c_o_l_o_r attributes are not copied when updating objects. Release 2.1 (Protocol 2.1) 15 XFIG(1) XFIG(1) _F_L_I_P _V_E_R_T_I_C_A_L_L_Y Flip the object up/down (_l_e_f_t button) or copy the object and flip it (_m_i_d_d_l_e button). Point to part of the object, click the appropriate button. That object will be flipped vertically about that point. _F_L_I_P _H_O_R_I_Z_O_N_T_A_L_L_Y Flip the object left/right (_l_e_f_t button) or copy the object and flip it (_m_i_d_d_l_e button). Point to part of the object, click the appropriate button. That object will be flipped horizontally about that point. _R_O_T_A_T_E _C_L_O_C_K_W_I_S_E Rotate the object (_l_e_f_t button) or copy and rotate it (_m_i_d_d_l_e button) -N degrees (clockwise), where N is the amount set in the rotation indicator button. The object is rotated about the chosen point. Not all objects can be rotated, and not all can be rotated at arbitrary angles. For example, _B_O_X, _A_R_C_-_B_O_X and _E_P_S objects may only be rotated by mul- tiples of 90 degrees, and _T_E_X_T objects may not be rotated at all. If a _C_O_M_P_O_U_N_D object contains any _T_E_X_T objects, the texts are moved but not rotated. _R_O_T_A_T_E _C_O_U_N_T_E_R_-_C_L_O_C_K_W_I_S_E Rotate the object (_l_e_f_t button) or copy (_m_i_d_d_l_e button) +N degrees (counter-clockwise), where N is the amount set in the rotation indicator button. The object is rotated about the chosen point. _S_P_L_I_N_E _<_-_> _P_O_L_Y_L_I_N_E Turn _P_O_L_Y_G_O_N into a _C_L_O_S_E_D _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E object, or turn _P_O_L_Y_L_I_N_E into a _I_N_T_E_R_P_O_L_A_T_E_D _S_P_L_I_N_E object. _A_D_D_/_D_E_L_E_T_E _A_R_R_O_W_S Add or delete arrow heads of _A_R_C, _P_O_L_Y_L_I_N_E or _S_P_L_I_N_E objects. Add an arrow head by clicking the _l_e_f_t button on the endpoint of the object. Delete an arrow head by clicking _m_i_d_d_l_e button on the end- point or arrow head. PPAANNNNIINNGG The figure may be panned by clicking the left, middle or right mouse button in the rulers. Clicking the _l_e_f_t but- ton in the top ruler will pan the image to left the by 1/2 inch (1cm in metric mode), adjusted for zoom factor. Clicking the _r_i_g_h_t button in the top ruler will pan the image right by the same amount. By pressing and _h_o_l_d_i_n_g the _m_i_d_d_l_e button the user may drag the ruler by the amount desired, thus panning the image by that amount. The figure is panned up and down in the same way by Release 2.1 (Protocol 2.1) 16 XFIG(1) XFIG(1) clicking the mouse in the ruler on the right of the can- vas. Also, the figure can be returned to it's origin by clicking the left mouse button in the unit's box. The arrow keys may also be used to pan the image and the home key to return the figure to the origin. XX DDEEFFAAUULLTTSS The overall widget name(Class) is xfig(Fig). These resources correspond to the command line arguments: L L L L L. Name Class Type Default Command-line equiva- lent _ justify Justify boolean false -left (false) and -right (true) landscape Orientation boolean true -Landscape and -Portrait pwidth Width integer 10(8) -pwidth pheight Height integer 8(9.5) -pheight trackCursor Track boolean on -track and -notrack inches Inches boolean true T{ -inches, -imperial, -centimeters and -metric T} reverseVideo ReverseVideo boolean off -inverse debug Debug boolean off -debug normalFont NormalFont string fixed -normal boldFont ButtonFont string 8x13bold -bold startfontsize StartFontSize integer 12 -startfont- size showallbuttons ShowAllButtons boolean false -showall- buttons internalborderwidth InternalBorderWidth integer 1 -inter- nalBW WWIIDDGGEETT TTRREEEE Below is the widget structure of _x_f_i_g. The widget class name is given first, followed by the widget instance name. Fig xfig Form form Form commands Label message Command button (one for each of the 8 buttons) Label mouse_panel Box mode_panel Label label Command button (one for each of the 16 drawing mode buttons) Label label Command button (one for each of the 18 editing mode buttons) Label topruler Label canvas Label unitbox Label sideruler Box ind_panel Command button (one for each of the 17 indicator buttons) TransientShell xfig: ps font menu Box menu Release 2.1 (Protocol 2.1) 17 XFIG(1) XFIG(1) Form buttons Command cancel Command use latex fonts Command pane (one for each of the 35 Postscript font panes) TransientShell xfig: latex font menu Box menu Form buttons Command cancel Command use postscript fonts Command pane (one for each of the 6 LaTeX font panes) TransientShell xfig: file menu Form file_panel Label dir label Text directory Label file label Text file Label file status Command cancel Command save Command load Command merge TransientShell xfig: export menu Form export_panel Label mag label Text magnification Label orient label MenuButton landscape SimpleMenu menu SmeBSB portrait SmeBSB landscape Label lang label MenuButton ps SimpleMenu menu SmeBSB box SmeBSB epic SmeBSB eepic SmeBSB eepicemu SmeBSB latex SmeBSB null SmeBSB pic SmeBSB pictex SmeBSB ps SmeBSB pstex SmeBSB pstex_t SmeBSB textyl SmeBSB tpic SmeBSB Xbitmap Label file label Label file label Label file label Text file Command cancel Command export TransientShell xfig: print menu Release 2.1 (Protocol 2.1) 18 XFIG(1) XFIG(1) Form print_panel Label printer image Label mag label Text magnification Label orient label MenuButton landscape SimpleMenu menu SmeBSB portrait SmeBSB landscape Label just label MenuButton flush left SimpleMenu menu SmeBSB flush left SmeBSB centered Label dir label Text printer Command cancel Command print NOTE: The following is a _t_y_p_i_c_a_l popup edit panel (for _A_R_C_-_B_O_X) The panel will be different for other objects. TransientShell xfig: edit panel Form form Label POLYLINE:ArcBox Label image Command done Command apply Command cancel Label Label Width = Text Width = Label Color = Text Color = Label Depth = Text Depth = Label Area fill = MenuButton No fill SimpleMenu menu SmeBSB No fill SmeBSB Filled Label Fill density % = Text Fill density % = Label Line style = MenuButton Solid Line SimpleMenu menu SmeBSB Solid Line SmeBSB Dashed Line SmeBSB Dotted Line Label Dash length/Dot gap = Text Dash length/Dot gap = Label Top Left: Label Top Left: Text Top Left: Release 2.1 (Protocol 2.1) 19 XFIG(1) XFIG(1) Label Top Left: Text Top Left: Label Bottom Right: Label Bottom Right: Text Bottom Right: Label Bottom Right: Text Bottom Right: Label Radius = Text Radius = BBUUGGSS aanndd RREESSTTRRIICCTTIIOONNSS Please send bug reports, fixes, new features etc. to: bvsmith@lbl.gov (Brian V. Smith) Not all operations employ smart redrawing of objects which are altered as a by product of the operation. You may need to use _R_e_d_r_a_w in these cases. Must compile xfig with --DDOOPPEENNWWIINN in order to make xfig handle OpenWindows scalable fonts correctly. There is a bug in OpenWindows 2.0 which relates to pixmaps in widgets. You must compile xfig with the --DDOOPPEENNWWIINN__BBUUGG option for this problem. If the image is panned or the xfig window iconified and de-iconified during the middle of an operation (e.g. while drawing a line), the picture will be distorted. This can be corrected using _R_e_d_r_a_w after the operation is complete. Rotated text and ellipses will be displayed horizontally on the screen. They will be rotated only when printed on Postscript output. Corners of object scaled with point positioning in one of the grid modes will not always fall on the grid line, but to the closest pixel. SSEEEE AALLSSOO Brian W. Kernighan _P_I_C _- _A _G_r_a_p_h_i_c_s _L_a_n_g_u_a_g_e _f_o_r _T_y_p_e_s_e_t_- _t_i_n_g _U_s_e_r _M_a_n_u_a_l fig2dev(1) (_T_r_a_n_s_F_i_g package) AACCKKNNOOWWLLEEDDGGEEMMEENNTT Many thanks goes to Professor Donald E. Fussell who inspired the creation of this tool. CCOOPPYYRRIIGGHHTT Original Copyright (c) 1985 by Supoj Sutanthavibul Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright Release 2.1 (Protocol 2.1) 20 XFIG(1) XFIG(1) notice and this permission notice appear in supporting documentation, and that the name of M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. M.I.T. makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. AAUUTTHHOORRSS Many people have contributed to _x_f_i_g. Here is a list of the people who have contributed the most: Original author: Supoj Sutanthavibul, University of Texas at Austin The _L_a_T_e_X line drawing modes were contributed by: Frank Schmuck, Cornell University (schmuck@svax.cs.cornell.edu) Original X11 port by: Ken Yap, Rochester (ken@cs.rochester.edu) Variable window sizes, cleanup of X11 port, right hand side panel: Dana Chee, Bellcore (dana@bellcore.com) Cleanup of color port to X11 by: John T. Kohl, MIT (jtkohl@athena.mit.edu) Area fill, multiple line thicknesses, multiple fonts and font sizes, bottom panel, line style/thickness modifica- tion of objects by: Brian V. Smith, Lawrence Berkeley Laboratory (standard disclaimer applies) (bvsmith@lbl.gov) Popup change-object menu by: Jon Tombs (jon%robots.oxford.ac.uk@nsfnet-relay.ac.uk), and Frank Schmuck (schmuck@svax.cs.cornell.edu) Zooming and panning functions, shift key select mechanism by: Dieter Pellkofer (dip@regent.e-technik.tu-muenchen.de), and Henning Spruth (hns@regent.e-technik.tu-muenchen.de) Depth feature by: Mike Lutz (mjl@cs.rit.edu) VVeerrssiioonn 22..11 eexxtteennssiivvee mmooddiiffiiccaattiioonnss:: Indicator panel, file menu popup, print menu popup, panning with rulers, mouse function window, regular polygon, rubberbanding of cir- cles/ellipses, filled splines on canvas, dashed/dotted Release 2.1 (Protocol 2.1) 21 XFIG(1) XFIG(1) splines on canvas, update button, arbitrary angle rotation of objects, alignment in compound, object scaling, con- strained copy/move, corner markers for compound, context sensitive corner markers, smarter redraw, undo for com- pound and point move for boxes, cancel object creation, point positioning to three resolutions, _T_r_a_n_s_F_i_g scalable text, hidden text, special text, save of figure on crash by: Paul King (king@cs.uq.oz.au) with help from: Brian V. Smith (bvsmith@lbl.gov) and Micah Beck (beck@cs.cornell.edu) Encapsulated Postscript importing by: Brian Boyter (root@fstc-chville.army.mil) Release 2.1 (Protocol 2.1) 22