
HELP:
This interactive 2-D layout offers three main utilities:

     (1) Command format oriented layout in COMMAND mode.
     (2) Entry format oriented layout in ENTRY mode.
     (3) Graphics INput (GIN) oriented layout in GIN mode.

Enter "HELP MODES" to get started.
More information is available in the following HELP keywords:

     FILE    LETTERING    TRANSFORM    KEYPAD    FKEYS

Defined Layout Commands:

     CLEAR          CODE           COLOR          COPY
     DELETE         ENTRY          EXIT,QUIT      FILL
     GIN            HARDCOPY/PF3   HELP/PF2       OVERLAY/INCLUDE
     MOVE           PICK,SELECT    PLOT           REFRESH
     RELEASE        ROTATE         SAVE/PF1       SET
     VISION         ZOOM           DCL/PF4

Enter "HELP command-name" or "HELP keyword" to get more information.
Note: parameters in square brackets [ ] in a command syntax are optional.


MODES:
COMMAND mode: The prompt "LAYOUT_COM>" signifies layout in COMMAND mode.
You can do the following in COMMAND mode:

1) Manipulate layout files using layout commands like PLOT, OVERLAY, SAVE, ...
2) Set layout attributes such as layout scale,... using layout command SET.
3) Enable ENTRY mode or GIN mode using layout command ENTRY or GIN
   to perform interactive layout other than from a layout file.
4) Transform existing layout using layout commands like MOVE, ROTATE,
   ZOOM, COLOR, FILL, COPY, ... with the function keys and the keypad.

ENTRY mode: The prompt "LAYOUT_ENTRY_...>" signifies layout in ENTRY mode,
which is enabled using ENTRY command in COMMAND mode. Enter "HELP ENTRY"
to see how to use ENTRY command. In ENTRY mode, you can draw new layout
entries by specifying detail entry parameters from keyboard input.

GIN mode: The prompt "LAYOUT_GIN> " signifies layout in GIN mode,
which is enabled using GIN command in COMMAND mode. Enter "HELP GIN"
to see how to use GIN command. In GIN mode, you can manipulate the 
existing layout entries, draw lines and curves, do text annotation
etc., using GIN crosshair cursor combined with simple key strokes.
More information on using GIN is available in GIN mode.


FKEYS:
The F1,F2,...,F8 keys in COMMAND and GIN modes are defined as follows:

    F1 ==> Flip the visibility of picked layout entries.
    F2 ==> Release the picked layout entries.
    F3 ==> Refresh the screen.
    F4 ==> Enable or disable GIN.
    F5 ==> Set keypad in MOVE mode for layout transform.
    F6 ==> Set keypad in ROTATE mode for layout transform.
    F7 ==> Set keypad in ZOOM mode for layout transform.
    F8 ==> Set keypad in COLOR mode for layout transform.

Use "SET FKEYS" in COMMAND mode to enable or disable the function keys.


FILE:
A layout file is created normally by the layout to store the layout made
in layout session and is an ASCII file you can edit. During the layout 
session, nothing is saved until you save it using SAVE command to create
a layout file. It is therefore a safe practice to save what you have drawn
on screen now and then in case of layout interruption. When you exit from
the layout session, you will be prompted with the option for writing a 
layout file. The layout is stored in the file with keywords identifying 
each of layout entries and followed by the entry parameters. When editing
the layout file, you can add or delete an entry or change its parameters
but not alter the keyword. The I/O file extension of a layout file defaults
to ".DES".


TRANSFORM:
To transform layout entries using MOVE, ROTATE, ZOOM, COLOR, CODE, FILL,
COPY, VISION commands, the entries must be picked or selected first by 
PICK or SELECT command. When picked, the entries are highlighted with blink.
Issue a SET BLINK command to stop the blink if highlighting is undesired or
time consuming. If a subsequent transform of different nature applies to the
same entries, you need not pick them again.
If a transform translates the entry pivots(x,y) beyond the screen boundaries,
the entries are reflected from the boundaries, or in other words, the 
boundaries serve as the mirror planes perpendicular to the screen surface 
for layout transform. Multiple reflections are carried out if necessary
to bring the entry pivots back into the screen.
To perform zoom or rotation transform about the individual entry pivots,
specify transform pivot px/py=99; about the working origin, leave the 
pivot blank.
If you issue a MOVE,ROTATE,ZOOM,COLOR,CODE,FILL command without any
parameter other than the pivot, you can then press the number keys on
the keypad to transform the entries in different directions or increments 
bit by bit. Repeat pressing the keys for further transform. 
Enter HELP KEYPAD to see keypad definition for layout transform.
To release the picked layout entries from transform, enter RELEASE.


LETTERING:
Lettering or text annotation in layout is implemented only in GIN mode.

Following control sequences can be embedded in layout lettering:

     { --- Convert the next non-blank character to superscript.
     } --- Convert the next non-blank character to subscript.

     \sTEXT_STRING^s  --- TEXT_STRING to be italics.
     \bTEXT_STRING^b  --- TEXT_STRING to be boldface.
     \#TEXT_STRING^p  --- TEXT_STRING to be colored in pen code #.


KEYPAD:
Keypad for layout transform is defined as follows:

MOVE  : 2=>down,      8=>up,         4=>left,   6=>right,
        1=>down+left, 3=>down+right, 7=up+left, 9=up+right

ROTATE: 1=>1, 4=>2, 7=>5, 2=>10 (degrees,counter clockwise)
        3=>-1, 6=>-2, 9=>-5, 8=>-10 (degrees, clockwise).

ZOOM  : 2=>1.00,0.99, 4=>0.99,1.00, 6=>1.02,1.00, 8=>1.00,1.02;
        1=>0.99,0.99, 3=>1.02,0.99, 7=>0.99,1.02, 9=>1.02,1.02;
        (the 2 numbers are scale factors in x,y directions).

0,5: flip keypad between low and high speed transform.
In high speed gear, 5 sets keypad 25 times faster, and 0 sets keypad
10 times faster. The default status of keypad is in low speed gear.


CLEAR:
Command syntax: CLEAR 

    Clear the screen (the layout will be gone for ever !!!).


CODE:
Command syntax: CODE [N]

    Change the pattern of the picked entries to that designated by N.
    For entries that allow for hatching or area-fill, N is the pattern code. 
    For symbol entries, N is the symbol code. For line/curve entries, N is 
    the line type for the non-fill and the pattern code for the fill entries. 
    For entries with no pattern code, the command has no effect on them. 
    If no parameter is given, keypad is set in CODE mode.
    Example: LAYOUT_COM> CODE 3


COLOR:
Command syntax: COLOR [color-code]

    Change the colors of the picked entries to that designated by the color 
    code. The color code can be specified either in a pen number (1-7) or 
    in a color keyword: WHITE, RED, GREEN, BLUE, CYAN, PURPLE, YELLOW.
    If no parameter is given, keypad is set in COLOR mode.
    Example: LAYOUT_COM> COLOR blue


COPY:
Command syntax: COPY #,px,py,Angle1,Angle2

    Make # copies of the picked entries. #=0 implies 1 copy. If Angle1=0.0, 
    px, py are the offsets in inches in x, y between copies, or else copies 
    are generated in circular manner with incremental Angle1 around the pivot 
    (px,py) and Angle2 specifies the entry rotation about its own pivot.
    Example: LAYOUT_COM> COPY 3 1 1 90 90


DELETE:
Command syntax: DELETE

    Delete the picked layout entries.


ENTRY:
Command syntax: ENTRY [keyword]

    This command enables ENTRY mode which allows for input of new layout 
    entries. The valid keywords are:

        ARC --------- layout arcs,circles,ellipse,pies;
        ARROWHEAD --- layout arrowheads;
        BAR --------- layout bars;
        BOX --------- layout boxes;
        OBLIQUE ----- layout obliques;
        POLYGON ----- layout polygons;
        SYMBOL ------ layout marker symbols;

    The difference between a bar and a box here is in that a box has round
    corners. Line, curve and text layouts are implemented only in GIN mode.
    All defined layout commands are disabled in ENTRY mode except for DELETE
    command which allows for deleting of the last entry.
    Example: LAYOUT_COM> ENTRY ARC


EXIT, QUIT:
Command syntax: EXIT, QUIT

    In ENTRY mode, EXIT or ^Z command terminates ENTRY mode and loops
    you back to COMMAND mode. In COMMAND mode, EXIT or ^Z command exits
    from the layout; QUIT aborts the layout.


QUIT, EXIT:
Command syntax: QUIT, EXIT

    In ENTRY mode, EXIT or ^Z command terminates ENTRY mode and loops
    you back to COMMAND mode. In COMMAND mode, EXIT or ^Z command exits
    from the layout; QUIT aborts the layout.


FILL:
Command syntax: FILL [pattern-code]

    Fill the picked entries with a fill pattern "pattern-code". 
    Once filled, the picked entries are treated as a single entity,
    called a fill-group, and assigned with a sequence number.
    To decompose a fill-group, pick it up by its number or using
    the crosshair cursor, and de-fill it with a pattern of 0.
    If no parameter is given, keypad is set in FILL mode.
    Example: LAYOUT_COM> FILL 1


GIN:
Command syntax: GIN [color-code]

    Invoke the Graphics INput (GIN) utility. The prompt "LAYOUT_GIN>" reminds
    you that you are in GIN mode. A crosshair cursor of specified color is
    displayed in GIN mode. You can draw, delete, zoom, move, rotate, copy,
    change colors of any layout entries, or select them for transform by 
    manipulating the cursor and certain keyboard keys. More on-line help
    is available in GIN mode. All layout commands are disabled in GIN mode.
    Example: LAYOUT_COM> GIN green


HARDCOPY:
Command syntax: PF3 or HARDCOPY

    Invoke hardcopy utility to make a hardcopy of the current layout,
    where PF3 is the function key on the keypad.
          HARDCOPY presents the hardcopy page setup menu.
          PF3      bypasses the hardcopy page setup menu.


HELP:
Command syntax: PF2 or HELP [keyword]

    In COMMAND mode, HELP command invokes on-line help on layout command
    definitions and their syntaxs. In ENTRY mode, HELP command invokes
    on-line help on entry parameter definitions.
    PF2 is the function key on the keypad.


OVERLAY:
Command syntax: OVERLAY or INCLUDE [layout-file]

    Overlay a layout from the layout file on screen. If you do not give 
    a filename, it will be requested. If a layout file has never been given, 
    the file given here will be used to save the layout upon final exit.
    OVERLAY cumulates layout entries on screen and can be issued as many
    times as you wish before the max number of layout entries is hit.
    Example: LAYOUT_COM> OVERLAY JUNK.DES


INCLUDE:
Command syntax: OVERLAY or INCLUDE [layout-file]

    Overlay a layout from the layout file on screen. If you do not give 
    a filename, it will be requested. If a layout file has never been given, 
    the file given here will be used to save the layout upon final exit.
    OVERLAY cumulates layout entries on screen and can be issued as many
    times as you wish before the max number of layout entries is hit.
    Example: LAYOUT_COM> OVERLAY JUNK.DES


MOVE:
Command syntax: MOVE [px,py]

    Move the picked entries by "px" inches in x direction,
    by "py" inches in y direction.
    If no parameter is given, keypad is set in MOVE mode.
    Example: LAYOUT_COM> MOVE -1.5 2


PICK:
Command syntax: PICK or SELECT [keyword]

    Pick or select layout entries for transform.
    You will be prompted with a keyword if you don't specify one.
    When picked, the entries are highlighted with blink (enter SET BLINK
    to flip the blink). The valid keywords for PICK or SELECT are:

    1) 2 numbers specify the range of entry number.
         #1=0 implies the last entry.
        -#1   implies the #1th entry from the last.
         #2   is an additive number to #1.
       Example: PICK 1 5   ----> pick entries 1,2,3,4,5,6
    2) Color keywords (see COLOR command for valid color keywords):
       Example: PICK BLUE  ----> pick all blue entries.
    3) Entry keywords (see ENTRY command for valid entry keywords):
       Example: PICK BOX   ----> pick all boxes.
    4) FILL N: pick a fill group of number N.
       Example: PICK FILL 2 ----> pick the 2nd fill group.
    5) ALL: Pick the whole layout.


SELECT:
Command syntax: PICK or SELECT [keyword]

    Pick or select layout entries for transform.
    You will be prompted with a keyword if you don't specify one.
    When picked, the entries are highlighted with blink (enter SET BLINK
    to flip the blink). The valid keywords for PICK or SELECT are:

    1) 2 numbers specify the range of entry number.
         #1=0 implies the last entry.
        -#1   implies the #1th entry from the last.
         #2   is an additive number to #1.
       Example: PICK 1 5   ----> pick entries 1,2,3,4,5,6
    2) Color keywords (see COLOR command for valid color keywords):
       Example: PICK BLUE  ----> pick all blue entries.
    3) Entry keywords (see ENTRY command for valid entry keywords):
       Example: PICK BOX   ----> pick all boxes.
    4) FILL N: pick a fill group of number N.
       Example: PICK FILL 2 ----> pick the 2nd fill group.
    5) ALL: Pick the whole layout.


PLOT:
Command syntax: PLOT [layout-file]

    Start a new layout plot stored in the layout file.
    A filename is requested if you don't enter it after PLOT.
    The current layout on screen if any will be erased.
    A PLOT command is equivalent to a CLEAR command followed
    by an OVERLAY command.


REFRESH:
Command syntax: REFRESH

    Refresh the screen to restore the segments of layout mangled 
    by layout transform.


RELEASE:
Command syntax: RELEASE

    Release the picked layout entries.


ROTATE:
Command syntax: ROTATE [Angle,px,py]

    Rotate the picked entries from the current orientation 
    by incremental "Angle" in degrees around a pivot (px,py)
    which is specified relative  to the working origin.
    If no parameter is given, keypad is set in ROTATE mode.
    Example: LAYOUT_COM> ROTATE -90 1.0 1.0


SAVE:
Command syntax: PF1 or SAVE [layout-file]

    Save the current layout into a layout file. If you do not give a 
    filename, it will be requested. If a layout file has never been given, 
    the file given here will be used to save the layout upon final exit.
    PF1 is the function key on the keypad.
    Example: LAYOUT_COM> SAVE JUNK.DES


SET:
Command syntax: SET keyword [p1,p2,...]

    Set layout attributes where the valid keywords are:

         APERTURE  BLINK     CHORD     DALINE    FKEYS
         FRAME     HARDCOPY  LINE      ORIGIN    SCALE

    and p1,p2,p3,... are the pertinent attribute parameters.
    Enter "HELP SET keyword" to get HELP on a specific keyword
    or "HELP SET ALL" to display HELP on all the keywords.
    If no parameter is given, default attribute is assumed.


VISION:
Command syntax: VISION

    Flip the visibility of the picked layout entries. 
    The default status is visible.


ZOOM:
Command syntax: ZOOM [x-scale,y-scale,px,py]

    Zoom the picked entries by x-scale and y-scale factors in x,y
    directions about a pivot (px,py) which is specified relative to
    the working origin. The scale factors must be greater than 0.0
    and a scale factor of 1.0 means unchanged.
    If no parameter is given, keypad is set in ZOOM mode.
    Example: LAYOUT_COM> ZOOM 1.25 0.75


DCL:
Command syntax: PF1 or DCL [command]

    Spawn a system subprocess, where PF1 is the function key on the 
    keypad. If no command is given, control is set to command prompt.

    Example: LAYOUT_COM> DCL
             LAYOUT_COM> DCL EDIT JUNK.DES

