home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 126-150 / scopedisk137 / amigraph21 / amigraph_ii.doc < prev    next >
Text File  |  1992-10-27  |  13KB  |  394 lines
  1.                 AmiGraph 2.1
  2.               "Electronic Graph Paper"
  3.             ----------------------------
  4.                Written and Copyright (c) 1990
  5.                        All Rights Reserved
  6.                 By Thomas C. DeVeau
  7.  
  8.  
  9.  
  10. Special Thanks to:
  11.     Khalid Aldoseri for the use of his File Requester.
  12.     All the good folks on Compuserve's AmigaTech Forum for interesting 
  13.     Sunday mornings.
  14.     And to Commodore for putting out a great computer.
  15.  
  16.     ************************ SHAREWARE NOTICE *************************
  17.     AmiGraph 2.1 IS Shareware. If you like and use AmiGraph 2.1, please
  18.     send a donation of $5.00 (U.S.) to the address below. When you send
  19.     me your shareware donation, you will then become a registered user.
  20.     As a registered user, you will be notified of any upgrades and very 
  21.     reduced donations for the upgrade, BEFORE it is put out to the public.
  22.     *******************************************************************
  23.  
  24. What Is AmiGraph?
  25.     AmiGraph is a unique type of CAD program. It is unique because it 
  26.     incoporates a number of tools specially created for the Do-It-Yourselfer,
  27.     the Fantasy Gamer, and anyone that needs graph paper for their design
  28.     needs. AmiGraph also offers users a large number of user definable grid 
  29.     sizes for a variety of uses.
  30.  
  31.       At this point in AmiGraph's history, it uses one drawing pen color
  32.     (i.e. Black). Future versions will hopefully have a better selection.
  33.     See section "What Lies Ahead:".
  34.  
  35. Starting AmiGraph:
  36.     
  37.     To start AmiGraph from the CLI, enter (without quotes) "AmiGraph".
  38.     You will then be presented with a requester informing you that the
  39.     AmiGraph uses an interlaced screen and gives instructions for dealing
  40.     with the flicker. 
  41.     Command line options:
  42.          The "-q" or "-Q" option when specified will bypass the 
  43.         information  requester. File Opening is also possible.
  44.  
  45.         Example:
  46.             AmiGraph -q dungeon.pic
  47.  
  48.     To start AmiGraph from the WorkBench, double click on its Icon.
  49.  
  50. Inside AmiGraph:
  51.  
  52.     Inside AmiGraph you are presented with an 8 pixel by 8 pixel 
  53.     grid on a 640x400 interlaced screen. This is your working area.
  54.     The title bar shows the program name, the Current Tool (Tool:),
  55.     Grid Snap status (GS:), Door Snap status (DS:), and the Fill status
  56.     (FILL:).
  57.  
  58. AmiGraph Menus:        
  59.     
  60.     KEYS: [A] = Right Amiga, F = Function Key, KP = Numerical Key Pad.
  61.  
  62.     Project:
  63.     ------------------------------------------------------------------
  64.     NEW        ->    Clears the work area, redraws the grid, and
  65.                 resets the default tool (LINE).
  66.                 Keyboard Shortcut: [A] N.
  67.  
  68.     OPEN        ->    Opens a file requester for filename input.
  69.                 Restores a drawing for editing.
  70.                 Keyboard Shortcut: [A] O.
  71.  
  72.     SAVE        ->    Saves the current drawing under the current
  73.                 filename. Default filename is "Untitled".
  74.                 Keyboard Shortcut: [A] S.
  75.  
  76.     SAVE AS        ->    Opens a file requester for filename input.
  77.                 Saves current drawing under entered filename.
  78.                 Keyboard Shortcut: [A] A.
  79.  
  80.     PRINT        ->    Dumps current drawing to printer.
  81.                 NOTE: See "Suggested Printer Setup" below.
  82.                 Keyboard Shortcut: [A] P.
  83.  
  84.     SAVE/EXIT    ->    Saves current drawing under current filename,
  85.                 then exits the program.
  86.                 Keyboard Shortcut: [A] E.
  87.  
  88.     QUIT        ->     Quit program no questions asked.
  89.                 Keyboard Shortcut: [A] Q.
  90.  
  91.     ABOUT        ->    Copyright information.
  92.                 Keyboard Shortcut: NONE.
  93.  
  94.  
  95.     Tools:
  96.     ------------------------------------------------------------------
  97.     UNDO        ->    Undo last mistake.
  98.                 Keyboard Shortcut: U.
  99.  
  100.     DRAW        ->    Allows freehand drawing.
  101.                 Keyboard Shortcut: F1.
  102.  
  103.     LINE        ->    Allows drawing of straight lines.
  104.                 Keyboard Shortcut: F2.
  105.                 
  106.     BOX        ->    Allows drawing of rectangles.
  107.                 Keyboard Shortcut: F3.
  108.                 
  109.     CIRCLE        ->    Allows drawing of circles.
  110.                 Keyboard Shortcut: F4.
  111.                 
  112.     OVAL        ->    Allows drawing of Ellipses.
  113.                 Keyboard Shortcut: F5.
  114.                 
  115.     NOTE: For triangles the first two letters describe the orientation.
  116.          (i.e. UL = Upper-Left. Right Angle points to upper-left of screen).
  117.          
  118.     ULTRI        ->    Upper Left Triangle.
  119.                 Keyboard Shortcut: F6.
  120.                 
  121.     LLTRI        ->    Lower Left Triangle.
  122.                 Keyboard Shortcut: F7.
  123.                 
  124.     URTRI        ->    Upper Right Triangle.
  125.                 Keyboard Shortcut: F8.
  126.                 
  127.     LRTRI        ->    Lower Right Triangle.
  128.                 Keyboard Shortcut: F9.
  129.                 
  130.     FILL        ->    Toggles the fill option ON or OFF.
  131.                 Keyboard Shortcut: F10.
  132.                 
  133.     TEXT        ->    This displays a requester for entering text.
  134.                 After entering text hit RETURN twice for OKAY,
  135.                 or select CANCEL. If CANCEL is selected, the
  136.                 current tool will be reset to the default.
  137.                 Keyboard Shortcut: T.
  138.                 
  139.     ERASER        ->    Allows erasure of variable sized areas.
  140.                 Keyboard Shortcut: DEL.
  141.  
  142.     PAINT        ->    Allows filling of odd shaped areas.
  143.                 Keyboard Shortcut: F.
  144.  
  145.     ZOOM        ->    Allow magnifying and area for fine editing.
  146.                 Keyboard Shortcut: Z.
  147.  
  148.  
  149.     Fantasy:
  150.     -------------------------------------------------------------------
  151.     NOTE: Select Symbol Definitions from the Extras Menu for imagery.
  152.  
  153.     STAIR        ->    Stair symbol.
  154.                 Keyboard Shortcut: KP 0.
  155.                 
  156.     VD        ->    Vertical door symbol.
  157.                 Keyboard Shortcut: KP 1.
  158.                 
  159.     HD        ->    Horizontal door symbol.
  160.                 Keyboard Shortcut: KP 2.
  161.                 
  162.     LRUD        ->    Diagonal door symbol.
  163.                 Keyboard Shortcut: KP 3.
  164.                 
  165.     LRDD        ->    Diagonal door symbol.
  166.                 Keyboard Shortcut: KP 4.
  167.                 
  168.     VSD        ->    Vertical secret door symbol.
  169.                 Keyboard Shortcut: KP 5.
  170.                 
  171.     HSD        ->    Horizontal secret door symbol.
  172.                 Keyboard Shortcut: KP 6.
  173.                 
  174.     LRUSD        ->    Diagonal secret door symbol.
  175.                 Keyboard Shortcut: KP 7.
  176.                 
  177.     LRDSD        ->    Diagonal secret door symbol.
  178.                 Keyboard Shortcut: KP 8.
  179.                 
  180.     DOOR SNAP    ->    Toggle Door Snap ON or OFF.
  181.                 Keyboard Shortcut: KP 9.
  182.                 
  183.  
  184.     Extras:
  185.     --------------------------------------------------------------
  186.     GRID SNAP    ->    Toggles Grid Snap ON or OFF.
  187.                 Keyboard Shortcut: ESC.
  188.                 
  189.     GRID ON/OFF    ->    Toggles Grid ON or OFF.
  190.                 Keyboard Shortcut: TAB.
  191.                 
  192.     PALETTE        ->    Opens Palette requester for modifying colors.
  193.                 Keyboard Shortcut: P.
  194.                 
  195.     SYMBOL DEFINITIONS  ->    Opens Symbol Definition window for visual
  196.                   reference.
  197.                 Keyboard Shortcut: HELP.
  198.                 
  199.     MODIFY GRID    ->    Opens Modify Grid requester.
  200.                 Keyboard Shortcut: CTRL.
  201.                 
  202.  
  203.  
  204. Using AmiGraph:
  205.     General Tools:
  206.     ---------------------------------------------------------------------
  207.     For drawing Freehand, click the left mouse button and do your drawing.
  208.     When drawing is to your likeing, click the left mouse button again.
  209.  
  210.     For drawing Lines, Boxes, Circles and Ovals, and Triangles,
  211.     click the left mouse button. When you are satisfied with the final
  212.     position, click the left mouse button again. If you are not satisfied,
  213.     click the right mouse button to abort the operation.
  214.  
  215.     When using the OVAL and the CIRCLE tools, a cross-hair will appear
  216.     where the mouse is first clicked. This is a center point indicator.
  217.     Also, a box will be drawn when the mouse is moved. This shows the
  218.     x,y diameter of the oval or circle to be drawn.
  219.     
  220.     Fantasy Tools:
  221.     ---------------------------------------------------------------------
  222.     For drawing Stairs, move the pointer to a grid intersection, and click 
  223.     the left mouse button.
  224.  
  225.     Drawing Doors with Door Snap ON:
  226.         This function puts a door on a grid intersection. Move the 
  227.         pointer to a grid intersection and click the left mouse button
  228.         twice.
  229.  
  230.     Drawing Doors with Door Snap OFF:
  231.         This function puts a door BETWEEN grid intersections on grid 
  232.         lines. 
  233.  
  234.         If you have a horizontal wall that you wish to put a door on, 
  235.         move the pointer to the immediate left grid intersection of 
  236.         the desired door location, press the left mouse button, draw 
  237.         a one (1) grid square length line toward the bottom of the 
  238.         screen and release the mouse button.
  239.  
  240.         If you have a vertical wall that you wish to put a door on, 
  241.         move the pointer to the grid intersection immediately above 
  242.         the desired door location, click the left mouse button, draw 
  243.         a one (1) grid square length line toward the right of the 
  244.         screen and click the mouse button again.
  245.  
  246.         If you have a diagonal wall that you wish to put a door on, 
  247.         click the left mouse button,draw a one (1) square box around 
  248.         (moving the pointer toward the lower-right of the screen) 
  249.         the desired door location and click the mouse button again.
  250.  
  251.         These methods will work for both normal and secret doors.
  252.  
  253. Using The Zoom Function:
  254.  
  255.     Select Zoom from the Tools screen. Position the box that is attached 
  256.     to the pointer and click the left mouse button. Inside the Zoom window,
  257.     drawing will be allowed after the 'scanning phase'. The Zoom window
  258.     opens in 4x magnification. Current implemented magnification powers
  259.     are 4x, 8x, 16x. To change the power setting, click on the ZOOM gadget.
  260.     Scrolling is done using the cursor keys.
  261.     To select a new color, click the mouse Menu button. Note: This feature
  262.     is provided in case of mistakes.
  263.  
  264.     When finished with the Zoom, click on the close window gadget.
  265.  
  266. Using The Palette Requester:
  267.  
  268.     The palette requester that is used is unique, in that there are no
  269.     sliders. What I have used in thier place are simple boolean gadgets 
  270.     (i.e. on or off). Modifying the palette to colors more to your liking 
  271.     is easy. You are presented with a number of gadgets. The description 
  272.     of the requester is as follows:
  273.  
  274.     R    ->     Indicates current Red Intensity.
  275.     G    ->     Indicates current Green Intensity.
  276.     B    ->     Indicates current Blue Intensity.
  277.     
  278.     The three "+" gadgets and the three "-" gadget are for increasing or
  279.     decreasing the color intensity by one (1). The intensity values are 
  280.     displayed in Hexadecimal.
  281.  
  282.     The long, thin block (at the top of the requester) of color is the 
  283.     current color indicator.
  284.  
  285.     On the right side of the requester, are the main color selection 
  286.     gadgets. Click one of these to select the current color to be modified 
  287.     (NOTE: These gadgets do not highlight in any way.).
  288.  
  289.     OKAY!    ->    Means that you are happy with your choices.
  290.     RESET    ->    Resets the default colors.
  291.     CANCEL  ->    Resets the default colors and returns to the main 
  292.             program.
  293.     
  294. Using The Modify Grid Requester:
  295.     
  296.     This is where you can change the grid size. All functions in this 
  297.     requester can be accessed by either the mouse or keyboard.
  298.     Entry in the X or Y gadgets is in pixels.
  299.     
  300.     The Gadgets include:
  301.             X    ->    For modifying the left-right size.
  302.             Y    ->    For modifying the up-down size.
  303.             MODIFY    ->    This puts your changes into effect,
  304.                     and set the grid to the new values.
  305.             CANCEL    ->    This cancels whatever changes you have
  306.                     made, and resets the grid.
  307.  
  308.     The Keyboard Shortcuts are:
  309.             X    ->    Selects the X gadget.
  310.             Y    ->    Selects the Y gadget.
  311.             M    ->     Selcets the MODIFY gadget.
  312.             C    ->    Selects the CANCEL gadget.
  313.  
  314. Using The File Requester:
  315.     See the file "FileReq.doc".
  316.  
  317. File Format:
  318.  
  319.     AmiGraph 2.1 generates two (2) file:
  320.  
  321.         1: The first file created is the ".agp" file. This file is
  322.            a standard IFF bitmap. This means that they can be loaded 
  323.            into paint program that uses this format.
  324.  
  325.         2: The second file created is the ".dat" file. This file
  326.            contains the grid size information that was used when
  327.            saving the IFF drawing.
  328.  
  329.     NOTE: AmiGraph 2.1 loads IFF pictures, yet it is suggested that you
  330.           do not use pictures from other paint programs, the results can 
  331.           be unpredictable.
  332.  
  333. Suggested Printer Setup:
  334.  
  335.     This printer configuation works well on "Narrow Tractor" printers (i.e.
  336.     OkiData MicroLine 292). For "Wide Tractor" printers some experimentation
  337.     may be required. Use version 1.3 Preferences or higher.
  338.  
  339.     Setup:
  340.         Graphic 1:
  341.             Aspect:    Vertical
  342.             Shade.:    Gray Scale
  343.             Image.:    Positive
  344.         
  345.         Graphic 2:
  346.             Smoothing:    ON
  347.             Center...:    ON
  348.             Density..:    Use highest density for your printer.
  349.             Dithering:    ORDERED
  350.             Scaling..:    INTEGER
  351.             Limits:
  352.                 Absolute
  353.                 Width Limit.:    7.0
  354.                 Height Limit:    0.0
  355.  
  356.  
  357. Trouble Shooting:
  358.  
  359.     PROBLEM.......:    When opening a file all I get is garbage.
  360.     PROBABLE CAUSE: Too many programs running in the background.
  361.             This will happen on an Amiga with 512K memory.
  362.             AmiGraph 2.1 IS a memory hog.
  363.     SOLUTION......:    Close all background tasks, try operation again.
  364.             NOTE: Amiga 1000 users, if a loaded file comes up
  365.                   as garbage, you will mose probably have to 
  366.                   reset the machine instead of exiting AmiGraph.
  367.                   Exiting AmiGraph the normally COULD crash 
  368.                   the machine down to the KickStart level.
  369.  
  370.     PROBLEM.......:    Undo function doesn't work.
  371.     CAUSE.........:    The file "agud" is not in the same directory as 
  372.             AmiGraph. This file is an IFF pic that is loaded when 
  373.             AmiGraph starts. It MUST be in the same directory.
  374.     SOLUTION......:    If the file "agud" is not available, it can be made by
  375.             starting AmiGraph, and saving the screen BEFORE any 
  376.             drawing is done. Than exit and start AmiGraph again.
  377.  
  378.     
  379. Technical Support #:    315-682-2805 at times listed below.
  380.  
  381.     If you find any bugs or have any problems with AmiGraph 2.1, please call
  382.     at the following times (Eastern Time) Monday-Friday:
  383.     
  384.         January,  April, July,      October.: 5:00pm - 9:00pm
  385.         February, May,   August,    November: 9:00am - 2:00pm
  386.         March,    June,  September, December: 10:00am - 2:00pm
  387.  
  388.     Send Shareware Donation To:    ( Check or Money Order: $5.00 (US) )
  389.  
  390.         T. C. DeVeau
  391.         P.O. Box 594
  392.         Manlius, N.Y. 13104-0594
  393.         USA
  394.