GED(1G) COMMAND REFERENCE GED(1G) NAME ged - graphical editor SYNOPSIS ged [ -euRrn ] [ GPS file ... ] DESCRIPTION Ged is an interactive graphical editor used to display, construct, and edit GPS files on Tektronix 4010 series and 4100 series display terminals. To use color, hardware text and markers, and to erase selectively on the 4100 series terminal, the $TERM environment variable must be set appropriately. If GPS file(s) are given, ged reads them into an internal display buffer and displays the buffer. The GPS in the buffer can then be edited. If - is given as a file name, ged reads a GPS from the standard input. A GPS file is composed of instances of three types of graphical objects: lines, arc, and text. Arc and lines objects have a start point, or object-handle, followed by zero or more points, or point-handles. Text has only an object-handle. The objects are positioned within a Cartesian plane, or universe, having 64K (-32K to +32K) points, or universe-units, on each axis. The universe is divided into 25 equal sized areas called regions. Regions are arranged in five rows of five squares each, numbered 1 to 25 from the lower left of the universe to the upper right. Ged maps rectangular areas, called windows, from the universe onto the display screen. Windows allow the user to view pictures from different locations and at different magnifications. The universe-window is the window with minimum magnification, i.e., the window that views the entire universe. The home-window is the window that completely displays the contents of the display buffer. COMMANDS Ged commands are entered in stages. Typically you end each stage by pressing the <Return> key. Prior to the final <Return> the command may be aborted by pressing <Rubout> (or your interrupt key, if different). The input of a stage may be edited during the stage using your erase and kill keys. The prompt * indicates that ged is waiting at stage 1. Each command consists of a subset of the following stages: 1. Command line A command line consists of a command name followed by argument(s) followed by a <Return>. A command name is a single character. Command arguments are either option(s) or a file-name. Printed 4/6/89 1
GED(1G) COMMAND REFERENCE GED(1G) Options are indicated by a leading -. 2. Text Text is a sequence of characters terminated by an unescaped <Return>. (120 lines of text maximum.) 3. Points Points is a sequence of one or more screen locations (maximum of 30) indicated either by the terminal crosshairs or by name. The prompt for entering points is the appearance of the crosshairs. When the crosshairs are visible, typing: <Space> (space bar) enters the current location as a point. The point is identified with a number. $n enters the previous point numbered n. >x labels the last point entered with the upper case letter x. $x enters the point labeled x. . establishes the previous points as the current points. At the start of a command the previous points are those locations given with the previous command. = echoes the current points. $.n enters the point numbered n from the previous points. # erases the last point entered. @ erases all of the points entered. 4. Pivot The pivot is a single location, entered by typing <Return> or by using the $ operator, and indicated with a *. 5. Destination The destination is a single location entered by typing <Return> or by using $. Command Summary In the summary, characters typed by the user are printed in bold. Command stages are printed in italics. Arguments surrounded by brackets ``[]'' are optional. Parentheses Printed 4/6/89 2
GED(1G) COMMAND REFERENCE GED(1G) ``()'' surrounding arguments separated by ``or'' means that exactly one of the arguments must be given. Construct Commands Arc [-color,echo,style,weight] points Box [-color,echo,style,weight] points Circle [-color,echo,style,weight] points Hardware [-echo] text points Lines [-color,echo,style,weight] points Text [-angle,color,echo,height,mid-point,right-point,text,weight] text points Edit Commands Delete ( - (universe or view) or points ) Edit [-angle,color,echo,height,style,weight] ( - (universe or view) or points ) Kopy [-echo,points,x] points pivot destination Move [-echo,points,x] points pivot destination Rotate [-angle,echo,kopy,x] points pivot destination Scale [-echo,factor,kopy,x] points pivot destination View Commands coordinates points erase new-display object-handles ( - (universe or view) or points ) point-handles ( - (labelled-points or universe or view) or points ) view ( - (home or universe or region) or [-x] pivot destination ) Printed 4/6/89 3
GED(1G) COMMAND REFERENCE GED(1G) x [-view] points zoom [-out] points Other Commands quit or Quit read [-angle,echo,height,mid-point,right-point,text,weight file-name [destination] set [-angle,color,echo,factor,graphtext,height, kopy,mid-point,points,right-point,style,t ext,weight,x] write file-name !command ? Options Options specify parameters used to construct, edit, and view graphical objects. If a parameter used by a command is not specifed as an option, the default value for the parameter will be used (see set below). The format of command options is: -option[,option] where option is keyletter[value]. Flags take on the values of true or false indicated by + and - respectively. If no value is given with a flag, true is assumed. Object options: anglen Angle of n degrees. colorc Color (4100 series only) is c, where c may be a color index (0<c<8), or white, red, green, or blue, assuming the factory default color map. echo When true, echo additions to the display buffer. factorn Scale factor is n percent. graphtext When true, use hardware text (4100 series only). heightn Height of text is n universe-units (0<n<1280). Printed 4/6/89 4
GED(1G) COMMAND REFERENCE GED(1G) kopy When true, copy rather than move. mid-point When true, mid-point is used to locate text string. points When true, operate on points otherwise operate on objects. right-point When true, right-point is used to locate text string. styletype Line style set to one of following types: so solid da dashed dd dot-dashed do dotted ld long-dashed text When false, text strings are outlined rather than drawn. weighttype Sets line weight to one of following types: n narrow m medium b bold Area options: home Reference the home-window. out Reduce magnification. regionn Reference region n. universe Reference the universe-window. view Reference those objects currently in view. x Indicate the center of the referenced area. Command Descriptions Construct Commands Arc and Lines behave similarly. Each consists of a command line followed by points. The first point entered is the object-handle. Successive points are point-handles. Lines connect the handles in numerical order. Arc fits a curve to the handles (currently a maximum of 3 points will be fit with a circular arc; splines will be added in Printed 4/6/89 5
GED(1G) COMMAND REFERENCE GED(1G) a later version). Box and Circle are special cases of Lines and Arc, respectively. Box generates a rectangle with sides parallel to the universe axes. A diagonal of the rectangle would connect the first point entered with the last point. The first point is the object-handle. Point-handles are created at each of the vertices. Circle generates a circular arc centered about the point numbered zero and passing through the last point. The circle's object-handle coincides with the last point. A point-handle is generated 180 degrees around the circle from the object- handle. Text and Hardware generate text objects. Each consists of a command line, text and points. Text is a sequence of characters delimited by <Return>. Multiple lines of text may be entered by preceding a <Return> with a backslash (i.e., \<Return>). The Text command creates software generated characters. Each line of software text is treated as a separate text object. The first point entered is the object-handle for the first line of text. The Hardware command sends the characters in text uninterpreted to the terminal. Edit Commands Edit commands operate on portions of the display buffer called defined areas. A defined area is referenced either with an area option or interactively. If an area option is not given, the perimeter of the defined area is indicated by points. If no point is entered, a small defined area is built around the location of the <Return>. This is useful to reference a single point. If only one point is entered, the location of the <Return> is taken in conjunction with the point to indicate a diagonal of a rectangle. A defined area referenced by points will be outlined with dotted lines. Delete removes all objects whose object-handle lies within a defined area. The universe option removes all objects and erases the screen. Edit modifies the parameters of the objects within a defined area. Parameters that can be edited are: angle angle of text color color of lines, arc, and text. height height of text Printed 4/6/89 6
GED(1G) COMMAND REFERENCE GED(1G) style style of lines and arc weight weight of lines, arc, and text. Kopy (or Move) copies (or moves) object- and/or point-handles within a defined area by the displacement from the pivot to the destination. Rotate rotates objects within a defined area around the pivot. If the kopy flag is true then the objects are copied rather than moved. Scale For objects whose object handles are within a defined area, point displacements from the pivot are scaled by factor percent. If the kopy flag is true then the objects are copied rather than moved. View Commands coordinates prints the location of point(s) in universe- and screen- units. erase clears the screen (but not the display buffer). new-display erases the screen then displays the display buffer. object-handles (or point-handles) labels object-handles (and/or point-handles) that lie within the defined area with O (or P). Point-handles identifies labeled points when the labelled-points flag is true. view moves the window so that the universe point corresponding to the pivot coincides with the screen point corresponding to the destination. Options for home, universe, and region display particular windows in the universe. x indicates the center of a defined area. Option view indicates the center of the screen. zoom decreases (zoom out) or increases the magnification of the viewing window based on the defined area. For increased magnification, the window is set to circumscribe the defined area. For a decrease in Printed 4/6/89 7
GED(1G) COMMAND REFERENCE GED(1G) magnification the current window is inscribed within the defined area. Other Commands quit or Quit exit from ged. quit responds with ? if the display buffer has not been written since the last modification. read inputs the contents of a file. If the file contains a GPS it is read directly. If the file contains text it is converted into text object(s). The first line of a text file begins at destination. set when given option(s) resets default parameters, otherwise it prints current default values. write outputs the contents of the display buffer to a file. ! escapes ged to execute a UTek system command. ? lists ged commands. OPTIONS Ged accepts the following command-line options: -e Do not erase the screen before the initial display. -rn Display region number n. -u Display the entire GPS universe. -R Restricted shell invoked on use of !. VARIABLES TERM The user's terminal type. CAVEATS See Appendix A of the Tektronix 4014 Computer Display Terminal User's Manual for the proper terminal strap options. SEE ALSO The Graphics Editor in UTek Tools, Volume 2. abs(1g), af(1g), bar(1g), bel(1g), bucket(1g), ceil(1g), cor(1g), cusum(1g), cvrtopt(1g), dtoc(1g), erase(1g), exp(1g), floor(1g), gamma(1g), gas(1g), gd(1g), Printed 4/6/89 8
GED(1G) COMMAND REFERENCE GED(1G) graphics(1g), gtop(1g), hardcopy(1g), hilo(1g), hist(1g), hpd(1g), intro(1g), label(1g), list(1g), log(1g), lreg(1g), mean(1g), mod(1g), pair(1g), pd(1g), pie(1g), plot(1g), point(1g), power(1g), prime(1g), prod(1g), ptog(1g), qsort(1g), quit(1g), rand(1g), rank(1g), remcom(1g), root(1g), round(1g), siline(1g), sin(1g), subset(1g), td(1g), tekset(1g), title(1g), total(1g), ttoc(1g), var(1g), vtoc(1g), whatis(1g), yoo(1g), and gps(5g) in the UTek Command Reference. Printed 4/6/89 9
%%index%% na:240,74; sy:314,223; de:537,3148;3997,2647;6956,3026;10294,2424;13030,2413;15755,2973;19040,2333;21685,1122; op:22807,465; va:23272,147; ca:23419,306; se:23725,560;24597,1131; %%index%%000000000211