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 10/17/86 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 10/17/86 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
Printed 10/17/86 3
GED(1G) COMMAND REFERENCE GED(1G)
[-x] pivot destination )
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,text,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.
Printed 10/17/86 4
GED(1G) COMMAND REFERENCE GED(1G)
graphtext When true, use hardware text (4100 series
only).
heightn Height of text is n universe-units
(0<n<1280).
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
Printed 10/17/86 5
GED(1G) COMMAND REFERENCE GED(1G)
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 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.
Printed 10/17/86 6
GED(1G) COMMAND REFERENCE GED(1G)
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
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.
Printed 10/17/86 7
GED(1G) COMMAND REFERENCE GED(1G)
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
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.
Printed 10/17/86 8
GED(1G) COMMAND REFERENCE GED(1G)
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),
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 10/17/86 9
%%index%%
na:72,58;
sy:130,159;
de:289,2992;3425,2504;6073,2518;8735,2211;11090,2069;13303,2968;16415,2283;18842,1283;
op:20125,384;
va:20509,111;
ca:20620,278;
se:20898,168;21210,1492;
%%index%%000000000209