"Fossies" - the Fresh Open Source Software Archive

Member "brlcad-7.32.4/doc/old-mged.tr" (29 Jul 2021, 32699 Bytes) of package /linux/misc/brlcad-7.32.4.tar.bz2:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 .in .5i
    2 .sp 3
    3 .NH
    4 INTRODUCTION
    5 .PP
    6 MGED is the latest BRL graphics editor and is similar in operation
    7 to its predecessors, GED and VGED.
    8 This booklet is intended to serve as a guide to MGED users and assumes
    9 some general knowledge of the GED environment.
   10 For further GED background, read BRL report ARBRL-TR-02480.
   11 This booklet will cover the major differences between MGED and VGED/GED.
   12 All the commands will be discussed and a command summary table presented.
   13 Also, a section will be devoted to the hardware interfaces for each
   14 major class of workstations which MGED supports.
   15 .NH
   16 GENERAL OVERVIEW
   17 .PP
   18 MGED is presently installed on the VAX and GOULD class of computers at BRL.
   19 Workstations supported by MGED are the Vector General 3300 3DI, the Megatek
   20 7250, the Raster Tech One/80, and the Tektronix 4014 class.
   21 MGED can also be executed on any terminal by attaching the NULL (nu) processor
   22 as an option.
   23 One uses MGED by simply entering "mged file", where 'file' is a mged data file.
   24 You will be asked which processor you wish to use:
   25 .nf
   26                       attach <vg|mg|rat|tek|nu>  (mg) ?
   27 .fi
   28 To use the Megatek (default) enter a "CR".
   29 To use the Vector General enter "vg", "rat" for Raster Tech, "tek" for
   30 Tektronix 4014, or "nu" for any alphanumeric terminal.
   31 During the editing process the processor being used can be dropped by
   32 entering "release".
   33 At this point the present processor is dropped and the null one is put into use.
   34 To use another processor, enter "attach type" where type is vg, mg, rat, or tek.
   35 .NH
   36 DATA STRUCTURE DIFFERENCES AND CONVERSIONS
   37 .PP
   38 The data file structure for MGED has changed some.
   39 An "ident" record has been added which contains a title for the description, the
   40 units of the description, and a version identification.
   41 All numerical information in the new data file is stored in a fixed base
   42 unit and all work (input and output) is done in a user-selected local unit.
   43 The user can change his local unit at ANY time by using the "units" command.
   44 This command is discussed later.
   45 This way of handling units was selected to "free" the user from worrying
   46 about producing targets with the units he needs for different applications.
   47 .PP
   48 At the present time, there are quite a few "different" GED data files
   49 floating around BRL.
   50 To end any questions about which GED file you may have, simply run the
   51 "cv" conversion code:      "cv oldfile newfile"   .
   52 The cv code will look at the input file (oldfile), determine its type,
   53 then convert it to the new type GED file (newfile), asking you for
   54 any needed information.
   55 You will then be ready to run MGED on "newfile".
   56 .NH
   57 SOLID EDITING DIFFERENCES
   58 .PP
   59 The actual editing process for solids has not changed.
   60 The "selection" of which solid to edit has changed slightly, however.
   61 To select a solid for editing, first press the "solid pick" button.
   62 Then as before, the tablet is used to select the solid, except now
   63 it is a one-step process with the solid at the bottom of the
   64 illuminated path being selected.
   65 As before, the parameters of the solid record is listed on the
   66 screen during solid editing.
   67 However, in addition, the parameters of that solid as it exists
   68 at the bottom of the path is also listed and these are the
   69 values you will be changing.
   70 As before, the only way out of solid editing is to accept or
   71 reject what you have done (see Figure 1).
   72 .bp
   73 .sp 6i
   74 This page saved for figure 1.
   75 .bp
   76 .sp 5
   77 .NH
   78 OBJECT EDITING DIFFERENCES
   79 .PP
   80 As with solid editing, the actual process of object editing has not changed.
   81 In fact, the selection process is still a two step process (first select
   82 the path, then select an object in the path).
   83 The difference is that a KEY point is now selected, and all object editing
   84 is done about this point.
   85 This KEY point is the vertex of the solid at the bottom of the path
   86 selected for editing.
   87 This solid at the bottom of the path is the KEY solid, and its parameters
   88 are listed and continually updated on the screen, and it parameters are
   89 labeled on the display (see Figure 2).
   90 Three commands for precise editing in this mode have been added (like the
   91 "p" command in solid editing).
   92 These commands are: rotobj, scale, translate and do what one would expect.
   93 These commands will be discussed in detail later.
   94 If no KEY solid exists at the bottom of the selected path (i.e. the object has
   95 been "E'd"), then the center of the region at the bottom of the path becomes
   96 the KEY point.
   97 .bp
   98 .sp 4i
   99 This page reserved for Figure 2.
  100 .bp
  101 .sp 5i
  102 In the following section, the commands of MGED will be discussed.
  103 First, a summary table will be presented, then each command will be
  104 discussed in detail.
  105 .bp
  106 .in .5i
  107 .sp 5
  108 .TS
  109 box;
  110 c s s
  111 c s s
  112 c s s
  113 c|c|c
  114 l|l|l.
  115 
  116 MGED COMMAND SUMMARY
  117 
  118 =
  119 Key	Argument[s]	Description
  120 _
  121   e	obj1 obj2 ... objn	display objects on the screen
  122   E	obj1 obj2 ... objn	display objects evaluating regions
  123   B	obj1 obj2 ... objn	Zap screen, display objects
  124   d	obj1 obj2 ... objn	delete objects from screen
  125   cp	oldobj newobj	copy 'oldobj' to 'newobj'
  126   Z	-none-	Zap (clear) the screen
  127   g	groupname obj1 obj2....objn	group objects
  128   r	region op1 sol1....opn soln	create/modify a region
  129   i	object instname brname	create instance of an object
  130   mv	oldname newname	rename object
  131   l	object	list object information
  132   kill	obj1 obj2 ,,, objn	remove objects from the file
  133   t	-none-	table of contents
  134   mirror	oldobj newobj axis	mirror image of an object
  135   mirface	#### axis	mirror face #### about an axis
  136   extrude	#### distance	extrude an arb face
  137   item	region item air	change region item/air codes
  138   mater	region material los	change region mat/los codes
  139   rm	comb mem1 mem2....memn	delete members from combination
  140   units	<mm|cm|m|in|ft>	change the units of the objectfile
  141   title	new title	change the title of the description
  142   p	dx [dy dz]	precise commands for solid editing
  143   rotobj	xdeg ydeg zdeg	rotate(absolute) an edited object
  144   scale	factor	scale(absolute) an edited object
  145   translate	x y z	translate an edited object
  146   arb	name rot fb	make arb8 with rot and fb
  147   analyze	<solid>	print much info about a solid
  148   summary	<s|r|g>	solid/region/group summary
  149   tops	-none-	list all top level objects
  150   make	name type	create a primitive
  151   fix	-none-	restart the display after hangup
  152   rt	[options]	raytrace view onto framebuffer
  153   release	-none-	release current display processor
  154   attach	<mg|vg>	attach new display processor
  155   ted	-none-	text edit a solids parameters
  156   vrot	xdeg ydeg zdeg	rotate view
  157   ill	name	illuminate object
  158   sed	solidname	solid edit the named solid
  159   center	x y z	set view center
  160   press	button-label	emulate button press
  161   knob	id value	emulate knob twist
  162   size	value	set view size
  163   x	-none-	debug list of objects displayed
  164   status	-none-	print view status
  165   refresh	-none-	send new control list
  166   edcomb	comb flag item air mat los	edit comb record info
  167   q	-none-	quit
  168   %	-none-	escape to shell
  169   ?	-none-	help message
  170 .TE
  171 .bp
  172 .sp 10
  173 .ce
  174 ------------------------------------------------------------------------------------------------------
  175 .sp 3
  176 .ce
  177 cp oldobj newobj
  178 .sp 2
  179 This command is used to produce a copy of an object (solid or comb).  In this case, the
  180 object "oldobj" will be copied into an object called "newobj".
  181 NOTE: in VGED one could only copy solids.
  182 .sp 2
  183 Examples:
  184               cp arb8 hullbot.s
  185               cp tgc wheelrim.s
  186               cp torso.r driver_torso
  187               cp proto.man driver
  188 .sp 5
  189 .ce
  190 ------------------------------------------------------------------------------------------------------
  191 .sp 3
  192 .ce
  193 Z
  194 .sp 2
  195 This is the Zap command and clears all objects from the screen.
  196 .sp 5
  197 .ce
  198 ------------------------------------------------------------------------------------------------------
  199 .sp 3
  200 .ce
  201 d obj1 obj2 ... objn
  202 .sp 2
  203 This command allows one to remove objects from the display screen.  In
  204 this case "obj1" thru "objn" will be removed from the display.
  205 .bp
  206 .sp 10
  207 .ce
  208 ------------------------------------------------------------------------------------------------------
  209 .sp 3
  210 .ce
  211 mv old new
  212 .sp 2
  213 This command is used to rename objects in the data file.  In this
  214 case, the object "old" will be renamed "new".
  215 A note of caution:  the name is changed only in the object record itself, not
  216 in any member records.  Thus if the object "old" appears as a member
  217 of any other object, the name will not be changed there.
  218 .sp 2
  219 Examples:
  220               mv test hull
  221               mv g00 air
  222               mv g1 turret
  223 .sp 5
  224 .ce
  225 ------------------------------------------------------------------------------------------------------
  226 .sp 3
  227 .ce
  228 units ab
  229 .sp 2
  230 This command allows one to change the local or working units at ANY time.
  231 The only allowable values for "ab" are "mm", "cm", "m", "in", or "ft".
  232 
  233 
  234 Examples:
  235            units mm
  236            units in
  237 .bp
  238 .sp 10
  239 .ce
  240 -----------------------------------------------------------------------------------------------------
  241 .sp 3
  242 .ce
  243 g group obj1 obj2 ..... objn
  244 .sp 2
  245 This command creates or appends to a combination record and
  246 is used to group objects together either for editing or displaying
  247 purposes.  In this case, "obj1" through "objn" are added as members
  248 to the combination "group".  If "group" does not exist, it is
  249 created and "obj1" through "objn" are added as members.
  250 NOTE: no checking if "obji" is already a member of "group".
  251 .sp 2
  252 Examples:
  253             g shell hull turret
  254             g tank wheels engine crew shell
  255             g tank track
  256 .sp 5
  257 .ce
  258 ------------------------------------------------------------------------------------------------------
  259 .sp 3
  260 .ce
  261 r region op1 sol1 op2 sol2 .... opn soln
  262 .sp 2
  263 This command is used to create regions or append to regions.
  264 If "region" exists, then solids "sol1" through "soln" are
  265 added as members with "op1" through "opn" as the defining operations.
  266 If "region" does not exist, then it is created and solids "sol1" through
  267 "soln" are added as members with "op1" through "opn" as the
  268 defining operations.  A region is merely a combination
  269 record with a flag set and is distinguished from other combinations (groups)
  270 since it has meaning to the COMGEOM solid modeling system.
  271      When a region is created, the item and air codes are set equal to zero.  To change
  272 the item and air codes use the "item" command.
  273 Note:  In the past all members of a region had to be solids, but
  274 recently regions have been allowed as members of regions.  Hence,
  275 the names "soli" can also be regions now.
  276 Also...as in grouping, no checking for members already in a region.
  277 .sp 2
  278 Examples:
  279              r hulltop.r + hulltop.s - hullleft.s - hullright.s
  280              r gun + gun.s - gunin.s
  281              r gunair + gunin.s
  282 .bp
  283 .sp 10
  284 .ce
  285 ------------------------------------------------------------------------------------------------------
  286 .sp 3
  287 .ce
  288 i object combname brname
  289 .sp 2
  290 This command is used to make an instance of an object.
  291 An instance of an object is produced by creating a combination
  292 and making the object a member.
  293 In this case, an instance of "object" is made by
  294 creating the combination record "combname" (if "combname" does not
  295 already exist) and adding "object" as a member.  This member also
  296 has a second name "brname" added to the member record, which can be
  297 thought of as the name of this branch in the hierarchical data structure.
  298 If "combname" already exists, then "object" is added as the next member
  299 and "brname" is added as the branch name.
  300 
  301 An instance is used to refer to an object, without making actual copies
  302 of the object.  Instances are useful when one is adding a certain
  303 component to a target description many times.
  304 Furthermore, any modifications to an object which has been instanced need only be
  305 done in the original (prototype) object.
  306 These modifications will then be automatically reflected in all the
  307 instances of the object.
  308 .sp 2
  309 Examples:
  310                 i heround he1 .he1.
  311                 i heround he2 .he2.
  312                 i heat heat1 .heat1.
  313                 i heat heat2 .heat2.
  314 .sp 5
  315 .ce
  316 ------------------------------------------------------------------------------------------------------
  317 .sp 3
  318 .ce
  319 title newtitle
  320 .sp 2
  321 This command allows one to change the title of the target at any time.
  322 The string "newtitle" will become the new title and is limited to 72
  323 characters including blanks.
  324 
  325 
  326 Examples:
  327           title XM89A - New version of tank
  328           title M345 (groups are m345 and m345a)
  329 .bp
  330 .sp 10
  331 .ce
  332 ------------------------------------------------------------------------------------------------------
  333 .sp 3
  334 .ce
  335 extrude #### distance
  336 .sp 2
  337 This command allows the user to project
  338 a face(####) of an arb being edited a normal distance to create a new arb.
  339 The value of "face" is 4 digits such as 1256. If the face is projected
  340 in the wrong direction use a negative "distance".  One use for this command is
  341 for producing armor plates of a desired thickness.
  342 .sp 2
  343 .nf
  344 Examples:
  345               extrude 1234 20
  346               extrude 2367 34.75
  347               extrude 2367 -34.75
  348 .fi
  349 .sp 5
  350 .ce
  351 ------------------------------------------------------------------------------------------------------
  352 .sp 3
  353 .ce
  354 rm comb mem1 mem2 .... memn
  355 .sp 2
  356 This command allows one to delete members from a combination (group or region) record.
  357 In this case, members "mem1" through "memn" will be deleted from
  358 the combination "comb".
  359 .sp
  360 Examples:
  361               rm tank hull wheels
  362               rm region1 solid8 solid112
  363               rm turtop.r tursidel.s tursider.s
  364 .bp
  365 .sp 10
  366 .ce
  367 ------------------------------------------------------------------------------------------------------
  368 .sp 3
  369 .ce
  370 l object
  371 .sp 2
  372 This command is used to list information about objects in the data file.
  373 The information listed depends on what type of record "object" is.
  374 If "object" is a combination record, then the members are listed.
  375 If "object" is a solid record, then the GED general solid type and
  376 the parameters as presently in the data file are listed.
  377 Note:  only the solid parameters as they exist in the solid record are
  378 listed, no transformation matrix is applied.
  379 Hence, if the solid was edited as a member of a combination, the "l"
  380 command will not reflect the editing in the listed parameters.
  381 .sp 2
  382 Examples:
  383                l hull
  384                l turret
  385                l turtop.s
  386                l arb8
  387 .sp 5
  388 .ce
  389 ------------------------------------------------------------------------------------------------------
  390 .sp 3
  391 .ce
  392 analyze <solid>
  393 .sp 2
  394 This command produces information about a solid(all except ars).
  395 The information includes surface area(s) and volume.
  396 Also, in the case of arbs, edge lengths and rot and fallback angles
  397 and plane equations are given for each face.
  398 If "solid" is present that solid name will be used and analyzed.
  399 If "solid" is absent, the solid at the bottom of the present path
  400 being edited will be analyzed.
  401 .bp
  402 .sp 10
  403 .ce
  404 ------------------------------------------------------------------------------------------------------
  405 .sp 3
  406 .ce
  407 mirror oldobj newobj axis
  408 .sp 2
  409 This command is used to create a new object which is
  410 the mirror image of an existing object about an axis.
  411 In this case, a mirror image of the object "oldobj" will created
  412 about the axis indicated by "axis" and the new object record will
  413 be called "newobj".
  414 The only acceptable values for the parameter "axis" are "x", "y", and "z".
  415 Note:  in VGED one could only mirror solids.
  416 .sp
  417 Examples:
  418               mirror tur.left.s tur.right.s y
  419               mirror tur.top.s tur.bot.s z
  420               mirror tur.front.s tur.back.s x
  421               mirror lt_gun rt_gun y
  422 .sp 3
  423 CONSIDERATIONS:
  424 
  425               When to mirror regions?  groups?
  426 .sp 5
  427 .ce
  428 ------------------------------------------------------------------------------------------------------
  429 .sp 3
  430 .ce
  431 arb name rot fb
  432 .sp 2
  433 This command allows one to create an arb8 with desired rot and fallback angles.
  434 In this case, an arb8 with name = "name" will be created with the desired
  435 rotation angle of "rot" degrees and the fallback angle of "fb" degrees.
  436 .sp
  437 Examples:
  438            arb top1.s 0 90
  439            arb sidelt.s 90 0
  440            arb upglacis.s 0 60
  441 .bp
  442 .sp 10
  443 .ce
  444 ------------------------------------------------------------------------------------------------------
  445 .sp 3
  446 .ce
  447 item region ident air
  448 .sp 2
  449 This command allows one to change the item or
  450 air code numbers of a region.  If the air code ("air") is not included,
  451 a zero is assumed.
  452 To change the air code, a zero item code must be used (see second
  453 example below).
  454 .sp 2
  455 Examples:
  456             item region1 105
  457             item region7 0 2
  458             item region11 129 0
  459 .sp 5
  460 .ce
  461 ------------------------------------------------------------------------------------------------------
  462 .sp 3
  463 .ce
  464 mater region material los
  465 .sp 2
  466 This command is used to change the material and/or the los percent for
  467 a region.
  468 .sp 1
  469 Examples:
  470                  mater hull.r1 1 100
  471                  mater turret.r34 2 88
  472 .bp
  473 .sp 10
  474 .ce
  475 ------------------------------------------------------------------------------------------------------
  476 .sp 3
  477 .ce
  478 e obj1 obj2 ... objn
  479 .sp 2
  480 This command allows one to display objects on the screen.
  481 In this case, "obj1" thru "objn" will be displayed on the screen.
  482 .sp 5
  483 .ce
  484 ------------------------------------------------------------------------------------------------------
  485 .sp 3
  486 .ce
  487 E obj1 obj2 ... objn
  488 .sp 2
  489 This command is the same as the "e" command, except the regions will
  490 be evaluated before being displayed.
  491 .sp 5
  492 .ce
  493 ------------------------------------------------------------------------------------------------------
  494 .sp 3
  495 .ce
  496 B obj1 obj2 ... objn
  497 .sp 2
  498 This command is the same as the "e" command, except that the screen
  499 is cleared (Zap) before the objects are displayed.
  500 .bp
  501 .sp 10
  502 .ce
  503 ------------------------------------------------------------------------------------------------------
  504 .sp 3
  505 .ce
  506 kill obj1 obj2 ... objn
  507 .sp 2
  508 This command allows one to remove objects from the file itself.
  509 Only the object records themselves are removed, any references made
  510 to these objects still will exist.
  511 .sp 5
  512 .ce
  513 ------------------------------------------------------------------------------------------------------
  514 .sp 3
  515 .ce
  516 t
  517 .sp 2
  518 This is the table of contents command, and will produce a list of all
  519 objects presently included in the file.
  520 .sp 5
  521 .ce
  522 ------------------------------------------------------------------------------------------------------
  523 .sp 3
  524 .ce
  525 tops
  526 .sp 2
  527 This command will search the target file hierarchy, and list all "top level"
  528 objects (objects which are not members of any other object).
  529 This command is useful to make sure objects have been grouped properly.
  530 .bp
  531 .sp 10
  532 .ce
  533 ------------------------------------------------------------------------------------------------------
  534 .sp 3
  535 .ce
  536 make name type
  537 .sp 2
  538 This command will create a solid of a specified type.
  539 This solid will be named "name" and the solid type will be "type".
  540 The acceptable types are: arb8, arb7, arb6, arb5, arb4, tor, tgc, tec,
  541 rec, trc, rcc, ellg, ell, sph.
  542 This new solid will be drawn at the center of the screen.
  543 This command should be used instead of the old "cp" command to create
  544 solids for editing.
  545 .sp 5
  546 .ce
  547 ------------------------------------------------------------------------------------------------------
  548 .sp 3
  549 .ce
  550 mirface #### axis
  551 .sp 2
  552 This command allows one to mirror a face of an edited arb about an axis.
  553 This command is quite useful for adding air to a "symmetric" target.
  554 .sp 5
  555 .ce
  556 ------------------------------------------------------------------------------------------------------
  557 .sp 3
  558 .ce
  559 summary <s|r|g>
  560 .sp 2
  561 This command will produce a summary of objects in the target file.
  562 If the options s, r, or g are entered a listing of the solids, regions,
  563 or groups will also be presented.
  564 .bp
  565 .sp 10
  566 .ce
  567 ------------------------------------------------------------------------------------------------------
  568 .sp 3
  569 .ce
  570 p dx [dy dz]
  571 .sp 2
  572 This is the parameter modification command and is used during solid
  573 editing to make precise changes.
  574 The actual meaning of the values typed after the "p", depend on what
  575 editing option is being performed.
  576 If one were translating a solid, then the values would be the x,y,z
  577 coordinates of the vertex of the solid.
  578 .sp 5
  579 .ce
  580 ------------------------------------------------------------------------------------------------------
  581 .sp 3
  582 .ce
  583 release
  584 .sp 2
  585 This command releases the current display device (attaches the null device).
  586 .sp 5
  587 .ce
  588 ------------------------------------------------------------------------------------------------------
  589 .sp 3
  590 .ce
  591 attach device
  592 .sp 2
  593 This command allows one to attach a display device (the present display device
  594 is released first).
  595 The present acceptable values for "device" are vg, mg, tek, rat, and nu.
  596 .bp
  597 .sp 10
  598 .ce
  599 ------------------------------------------------------------------------------------------------------
  600 .sp 3
  601 .ce
  602 rotobj xdeg ydeg zdeg
  603 .sp 2
  604 This command allows one to make precise rotations of an object during
  605 object editing.
  606 The "object rotation" option must be in effect for this command to mean
  607 anything.
  608 The object will be rotated "xdeg" about the x-axis, "ydeg" about the
  609 y-axis, and "zdeg" about the z-axis.
  610 The rotation is "absolute"....the total rotation since the beginning
  611 of object editing will be equal to the input values.
  612 The rotation is done about the "KEY" point for the object being edited.
  613 .sp 5
  614 .ce
  615 ------------------------------------------------------------------------------------------------------
  616 .sp 3
  617 .ce
  618 scale xxx.xx
  619 .sp 2
  620 This command allows one to make precise scaling changes to an object
  621 during object editing.
  622 The "object scale" option must be in effect for this command to have meaning.
  623 The object will be scaled by a TOTAL amount equal to the input value.
  624 The scaling is done about the "KEY" point of the object being edited.
  625 .sp 5
  626 .ce
  627 ------------------------------------------------------------------------------------------------------
  628 .sp 3
  629 .ce
  630 translate xxx.xx yyy.yy zzz.zz
  631 .sp 2
  632 This command allows one to make precise translation changes to an object
  633 during object editing.
  634 The "object translation" option must be in effect for this command to have
  635 meaning.
  636 The "KEY" point of the object being edited will move to the input coordinates.
  637 .bp
  638 .sp 10
  639 .ce
  640 ------------------------------------------------------------------------------------------------------
  641 .sp 3
  642 .ce
  643 fix
  644 .sp 2
  645 This command will "fix" (restart) the display device after a hardware error.
  646 .sp 5
  647 .ce
  648 ------------------------------------------------------------------------------------------------------
  649 .sp 3
  650 .ce
  651 rt <-fxxx>
  652 .sp 2
  653 This command will produce a color shaded image of objects on the display.
  654 This color shaded image will appear on a framebuffer (IKONAS).
  655 The resolution of the image (number of rays) is equal to xxx from the "-f"
  656 option.
  657 If the -f option is absent, 64x64 ray resolution will be used.
  658 .bp
  659 .sp 10
  660 .ce
  661 ------------------------------------------------------------------------------------------------------
  662 .sp 3
  663 .ce
  664 knob id value
  665 .sp 2
  666 This command is used to emulate a "knob twist".
  667 Generally this command is used for display devices which have no actual
  668 knob peripherals (e.g. tek).
  669 Any non-zero number entered for "value" is converted to 1 (if "value" is
  670 greater than zero) or is converted to -1 (if "value is less than zero).
  671 The user must enter the same command with "value" equal to zero to
  672 stop the action invoked by the knob twist.
  673 
  674 The "id" defines which knob is to be "twisted" :
  675 .nf
  676 	x	rotates about x-axis
  677 	y	rotates about y-axis
  678 	z	rotates about z-axis
  679 	X	slew view in x direction
  680 	Y	slew view in y direction
  681 	Z	zoom the view
  682 
  683 
  684 Examples:
  685        knob x 1
  686        knob x 0
  687        knob Z -1
  688        knob Z 0
  689 .fi
  690 .sp 5
  691 .ce
  692 ------------------------------------------------------------------------------------------------------
  693 .sp 3
  694 .ce
  695 sed name
  696 .sp 2
  697 This command allows one to immediately enter the solid edit mode
  698 with the solid "name" as the edited solid.
  699 .bp
  700 .sp 10
  701 .ce
  702 ------------------------------------------------------------------------------------------------------
  703 .sp 3
  704 .ce
  705 ill name
  706 .sp 2
  707 This command is used to illuminate an object ... a path containing this
  708 object ("name") will be illuminated.
  709 This command is primarily used with display devices which do not have
  710 a tablet to pick objects for editing.
  711 .sp 5
  712 .ce
  713 ------------------------------------------------------------------------------------------------------
  714 .sp 3
  715 .ce
  716 vrot xdeg ydeg zdeg
  717 .sp 2
  718 This command rotates the VIEW "xdeg" degrees about the screen x-axis,
  719 "ydeg" degrees about the screen y-axis, and "zdeg" degrees about the
  720 screen z-axis.
  721 .sp 5
  722 .ce
  723 ------------------------------------------------------------------------------------------------------
  724 .sp 3
  725 .ce
  726 center xx.xx yy.yy zz.zz
  727 .sp 2
  728 This command moves the screen center to (xx.xx, yy.yy, zz.zz).
  729 Using this command is one way of slewing the view.
  730 .bp
  731 .sp 10
  732 .ce
  733 ------------------------------------------------------------------------------------------------------
  734 .sp 3
  735 .ce
  736 size xx.xx
  737 .sp 2
  738 This command sets the view size to xx.xx and is one way of zooming
  739 the display.
  740 Making the view size smaller has the effect of zooming in on the view.
  741 .sp 5
  742 .ce
  743 ------------------------------------------------------------------------------------------------------
  744 .sp 3
  745 .ce
  746 x
  747 .sp 2
  748 This command produces a list of all objects displayed, listing the center
  749 of the object, its size, and if it is in the present view.
  750 .sp 5
  751 .ce
  752 ------------------------------------------------------------------------------------------------------
  753 .sp 3
  754 .ce
  755 refresh
  756 .sp 2
  757 This command will send a new display list to the display device.
  758 .sp 5
  759 .ce
  760 ------------------------------------------------------------------------------------------------------
  761 .sp 3
  762 .ce
  763 status
  764 .sp 2
  765 This is a debug command which prints the status of the current view, including all
  766 editing matrices.
  767 .bp
  768 .sp 10
  769 .ce
  770 ------------------------------------------------------------------------------------------------------
  771 .sp 3
  772 .ce
  773 press button-label
  774 .sp 2
  775 This command allows one to emulate a button press and is generally used
  776 on display devices which do not have actual button peripherals.
  777 The following are the strings allowed for "button-label" and all produce
  778 the indicated view on the device screen:
  779 .nf
  780         top, bottom, right, left, front, rear, 90,90, 35,25
  781 .fi
  782 
  783 The following is a listing of the remaining acceptable strings for
  784 "button-label" and the resulting action:
  785 .nf
  786 
  787        reset          reset the view
  788        save           save the present view
  789        restore        restore the saved view
  790        adc            display the angle-distance cursor
  791        oill           begin object illumination (pick)
  792        sill           begin solid illumination (pick)
  793        oscale         object scale
  794        ox             object translation in x direction only
  795        oy             object translation in y direction only
  796        oxy            object translation
  797        orot           object rotation
  798        sedit          put up solid parameter menu
  799        srot           solid rotation
  800        sxy            solid translation
  801        sscale         solid scale
  802        accept         accept editing done
  803        reject         reject editing done
  804 
  805 
  806 Examples:
  807          press 90,90
  808          press front
  809          press oill
  810          press orot
  811          press reject
  812 
  813 .fi
  814 .bp
  815 .sp 10
  816 .ce
  817 ------------------------------------------------------------------------------------------------------
  818 .sp 3
  819 .ce
  820 %
  821 .sp 2
  822 This command allows one to escape to the shell.
  823 To return to mged, enter a control-d.
  824 .sp 5
  825 .ce
  826 ------------------------------------------------------------------------------------------------------
  827 .sp 3
  828 .ce
  829 ?
  830 .sp 2
  831 This is the help command and produces a listing of all the available commands.
  832 .sp 5
  833 .ce
  834 ------------------------------------------------------------------------------------------------------
  835 .sp 3
  836 .ce
  837 q
  838 .sp 2
  839 This is the normal quit (halt) command.
  840 
  841 .bp
  842 
  843 .sp 10
  844 .PP
  845 Using the Vector General terminals has changed very little.
  846 The buttons have changed slightly while the knobs have remained
  847 the same.
  848 The pen, in the viewing state, slews the view in a somewhat different
  849 manner.
  850 When pressed, the point which it is pointing at will be drawn at
  851 the center of the screen.
  852 .bp
  853 .sp 10
  854 .PP
  855 The Megatek terminals may be new to most VGED/GED users.
  856 The "buttons" and "knobs" of the Megateks are located in the same box.
  857 There are not enough buttons or knobs to have ONE assigned meaning, hence
  858 most buttons and three knobs have dual functions.
  859 .PP
  860 To toggle the functions of the buttons, use the upper right button (toggle button).
  861 When the light on this button is ON, the functions listed on the RIGHT above
  862 each button is the current function.
  863 When the light on the "toggle" button is OFF, the functions labeled on the
  864 LEFT are then in effect.
  865 The left/right meaning of these buttons is grouped generally according to
  866 viewing functions on the left and editing functions on the right.
  867 .PP
  868 A similar situation is in effect in the case of the Megatek knobs.
  869 The second function of the first three knobs is only in effect when
  870 the angle-distance cursor (ADC) is on the screen.
  871 .PP
  872 The Megatek tablet has a mouse instead of a pen.
  873 This mouse has four buttons on it.
  874 The yellow (top) button is used during illumination and editing just as the
  875 pen on the Vector General terminals.
  876 However, in the viewing mode, when pushed, the point which it was pointing
  877 at will be drawn at the center of the screen.
  878 The blue (bottom) button has this same function at ALL times and is used
  879 to "slew" the display during editing.
  880 The white (left) and the green (right) buttons on the mouse are used for
  881 zooming the display at a fixed rate.
  882 The white button will zoom out and the green button will zoom in.
  883 .bp
  884 .sp 10
  885 .PP
  886 To run MGED on the tek4014 class of terminals one needs to have TWO
  887 terminals - the graphics terminal (4014 or one which emulates a 4014) and
  888 another terminal to enter commands on.
  889 .nf
  890 The procedure is as follows:
  891 
  892      1.  login on the graphics terminal
  893      2.  enter "tty" to find out which terminal number has been assigned
  894      3.  enter "sleep 32000" to put the graphics terminal in sleep mode
  895      4.  login on the other terminal
  896      5.  enter "mged file" to execute MGED
  897      6.  enter "tek" to select the tek4014 device processor
  898      7.  enter the tty value found in step 2.
  899      8.  perform editing
  900      9.  enter "q" to quit MGED
  901     10.  enter control-c on the graphics terminal to end the sleep mode
  902     11.  logout on both terminals
  903 .fi
  904 
  905 Since there are no knobs or buttons on the tek4014 class of terminals, one
  906 is forced to use the "press" and "knob" commands to emulate these peripherals.
  907 Other commands which can/should be used are:
  908 
  909 .nf
  910            ill     put up a desired path
  911            center  slew the display
  912            size    zoom the display
  913            sed     solid edit immediately
  914 .fi
  915 
  916 
  917 
  918 .PP
  919 The main force behind the writing of a driver for the tek4014 terminals, was
  920 to allow the use of the Teletype 5620 terminals.
  921 These graphic terminals have an internal processor and different windows
  922 can be set up which represent different terminals.
  923 Hence two terminals are NOT necessary.
  924 The use of the Teletype 5620 terminals is then the same as the procedure
  925 outlined above, except each window represents a terminal.
  926 
  927 .PP
  928 The button box layout for the SGI Iris is as below.
  929 Note that the "right" button shows you the right side of the
  930 model, as if you were looking in from the left.
  931 To achieve the customary draftsman views, this function
  932 goes on the left.
  933 .nf
  934 .cs
  935                |----------|----------|----------|----------|
  936                |          |          |          |   Zero   |
  937                |   Help   |    ADC   |  Reset   |   Knobs  |
  938     |----------|----------|----------|----------|----------|----------|
  939     |    Obj   |    Obj   |    Obj   |    Obj   |          |   Save   |
  940     |   Scale  |  ScaleX  |  ScaleY  |  ScaleZ  |  empty   |   View   |
  941     |----------|----------|----------|----------|----------|----------|
  942     |    Obj   |    Obj   |    Obj   |    Obj   |          |  Restore |
  943     |  TransX  |  TransY  |  TransXY |  Rotate  |  empty   |   View   |
  944     |----------|----------|----------|----------|----------|----------|
  945     |   Solid  |   Solid  |   Solid  |   Solid  |    Obj   |  Solid   |
  946     |   Trans  |    Rot   |   Scale  |   Menu   |   Pick   |  Pick    |
  947     |----------|----------|----------|----------|----------|----------|
  948     |  REJECT  |  Bottom  |   Top    |   Rear   |   90,90  |  ACCEPT  |
  949     |----------|----------|----------|----------|----------|----------|
  950                |   Right  |   Front  |   Left   |   35,25  |
  951                |----------|----------|----------|----------|