home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / hyperansi-1.08.lha / HyperANSI / HyperANSI.DOC < prev    next >
Text File  |  1994-01-30  |  35KB  |  851 lines
  1.                         H y p e r A N S I
  2.  
  3.                           Version 1.08
  4.                 Copyright (C) 1993 Mike D. Nelson
  5.                        All rights reserved
  6.  
  7. Introduction
  8.  
  9.    HyperANSI is a program which allows you to easily create ANSI
  10.    graphics   with   minimum  effort.  HyperANSI  is  SHAREWARE,
  11.    copyrighted (c) by Michael D. Nelson. You are entitled to use
  12.    this  program  (evaluation  purposes only) for a period of 30
  13.    days.    If  you  find  the  program  useful please send in a
  14.    donation.
  15.  
  16.    The  registered  version  will  also  include a laser-printed
  17.    manual   with  manual  in  half-page  format  for  convenient
  18.    storage, for a minumum donation of $25US ($30 CAN)
  19.  
  20.    NOTE: Unlike previous releases of HyperANSI, this version has
  21.          no "crippled"  features, and  no longer  displays  that
  22.          annoying delay screen.
  23.  
  24. Installing
  25.  
  26.    HyperANSI  requires that you have Hyperansi.font installed in
  27.    your FONTS: directory. Use Copy HyperANSI/FONTS ALL FONTS: to
  28.    properly install the font. HyperANSI/FONTS is the location of
  29.    the  FONTS  directory from the HyperANSI.LHA archive file. It
  30.    is  also  advisable  to  use  Workbench  2.x for the ASL file
  31.    requester,  which  is  MUCH  better  than  the file requester
  32.    included for 1.3 users.
  33.  
  34. HyperANSI menus
  35.  
  36.    This  portion  of  the  manual follows the same format as the
  37.    program's  menus.  Functions  not available through the menus
  38.    will  be  described  seperately.  If any key shortcuts exist,
  39.    they   will  be  listed  after  KEYS:  in  the  descriptions.
  40.    Additional  features  are  described  in the section entitled
  41.    "Other Stuff."
  42.  
  43.    Project Menu
  44.  
  45.       New
  46.  
  47.          Erase  all  pages,  and  return  to page 1. You will be
  48.          asked if you are sure first.
  49.  
  50.          KEYS: Alt-N, RA-N
  51.  
  52.          There  is  no way to get your data back after executing
  53.          this Function! Be careful!
  54.  
  55.       Load
  56.  
  57.          Load  a  file.  Select  the file you want to load using
  58.          the  file  requester. You can load ANSI, ASCII or HYPER
  59.          files.  The  file  requester  is  the ASL requester for
  60.          2.04+ users, and a custom file requester for 1.3 users.
  61.  
  62.          KEYS: Alt-L, RA-L
  63.  
  64.          Future  versions  may support the ARP requester instead
  65.          of the custom requester.
  66.  
  67.       Save
  68.  
  69.          Save  Project.  You  will  be  presented  with the Save
  70.          Format  requester.  Choose whether you want to save the
  71.          file  as  ANSI,  ASCII  or in the HYPER format. You can
  72.          also  specify  the  page  range  to  use. Pages falling
  73.          outside  the  selected  range will not be saved. If you
  74.          select the HYPER format the page range has no effect --
  75.          every page in use will be saved.
  76.  
  77.          KEYS: Alt-S, RA-S
  78.  
  79.       Print
  80.  
  81.          This  will  print everything to PRT:. The program first
  82.          applies  IBM to AMIGA remapping, as the printer drivers
  83.          are  expecting  the  Amiga's character set, not the IBM
  84.          character  set. Use the Workbench's Preferences program
  85.          to change your printer settings.
  86.  
  87.       Screen Title
  88.  
  89.          Toggles the screen's title bar on and off.
  90.  
  91.       About
  92.  
  93.          Displays  information  about  the  program. This window
  94.          closes when you hit a key or mouse button.
  95.  
  96.       Commands
  97.  
  98.          Displays  a  summary of all HyperANSI commands, and the
  99.          keys  needed  to  activate  them.  While  the list only
  100.          displays  the  ALT  key  combinations,  many  also have
  101.          corresponding Right Amiga key combinations. This window
  102.          closes when you hit a key or mouse button.
  103.  
  104.          KEYS: Alt-Z, RA-Z
  105.  
  106.       Quit
  107.  
  108.          Quit  the  program.  You  will be asked if you are sure
  109.          first.  If  you  select OKAY, the program will exit and
  110.          any  unsaved  pages  will be lost. Select CANCEL if you
  111.          don't want to exit.
  112.  
  113.          KEYS: Alt-X, RA-X
  114.  
  115.    Modes Menu
  116.  
  117.       Block
  118.  
  119.          Block  is  the  most  important  function of HyperANSI.
  120.          Selecting  Block  will result in a prompt asking you to
  121.          select  one  corner of the blocked area. Use the cursor
  122.          keys to move the onscreen cursor and hit RETURN to lock
  123.          it in, or use the mouse button and click on the corner.
  124.          The  cursor will now turn into a rubber band, which you
  125.          can  drag with either the cursor keys or the mouse (the
  126.          mouse  button  should  not be held down), enclosing the
  127.          area  you want to block. Hit RETURN (or a mouse button)
  128.          to  set  the  blocked  area. You will now see the first
  129.          level of the available block options.
  130.  
  131.          KEYS: Alt-B, RA-B
  132.  
  133.          The Blocking functions are described in detail later in
  134.          this document. (see Blocking Functions)
  135.  
  136.          A  faster  method  of blocking uses the double clicking
  137.          function,  without having to select Block from the menu
  138.          or  use  the  keyboard  selection  keys.  To activate a
  139.          block,  simply  double  click  on a corner and you will
  140.          immediately get the rubber band. If you cannot get this
  141.          to work, then you should change you preferences on your
  142.          machine.  Users  with  1.3  machines  should have their
  143.          double-click  preference set to about 75% (the vertical
  144.          prop  gadget  on  the  right  side  of  the preferences
  145.          screen)   and   2.04+   users  should  have  the  Input
  146.          preferences  set to about 1.5 seconds for Double-Click.
  147.          These  settings are not specifically required, but they
  148.          work. Use whatever you find comfortable.
  149.  
  150.          When  selecting  Block  from  keyboard  or menu (not by
  151.          double clicking) you will have an option to 'Use Last',
  152.          If  you press 'L' the last blocking coordinates will be
  153.          restored.
  154.  
  155.       Draw
  156.  
  157.          This  will  cause cursor movements to leave a line. The
  158.          program  will  follow  where  you  go and what you draw
  159.          over, trying to map the proper characters onscreen. The
  160.          characters used depend on the current Function key set.
  161.          Function  sets  greater  than  4  will  use  the  Set 1
  162.          characters.  More  information on Functions sets can be
  163.          found in the EDIT menu descriptions under Function Keys.
  164.  
  165.          KEYS: Alt-D, RA-D
  166.  
  167.       Half
  168.  
  169.          The  IBM font has two 'half' characters, one is the top
  170.          half and the other is the bottom. This mode will change
  171.          the  cursor  to  the  half size, and then calculate (in
  172.          real  time) whether to use the top or bottom half while
  173.          still retaining the color of existing half characters.
  174.  
  175.          The  submenu  has two selections; Normal and Lines. The
  176.          Normal  mode  will only draw when the left mouse button
  177.          is  being held down. The Lines mode will 'draw' between
  178.          any  mouse  button  clicks,  which allows you to create
  179.          straight  lines  (well,  as  straight  as possible with
  180.          ANSI).  The  Normal and Lines modes both use a tweening
  181.          function,  meaning  the  program will not leave gaps if
  182.          you move the mouse faster than the program can kept up.
  183.  
  184.          KEYS: Alt-H, RA-H (Normal), Alt-J, RA-J (Lines)
  185.  
  186.          ANSI  only allows HIGH INTENSITY (The brightest colors)
  187.          for  the  foreground color, therefore if you attempt to
  188.          draw  a  High Intensity color on another High Intensity
  189.          color,  the  existing  color  will  be  changed  to the
  190.          equivalent  Low  Intensity color. This problem will not
  191.          occur, with High on Low or Low on High.
  192.  
  193.       Macro
  194.  
  195.          Selects one of two Submenu options. The first option is
  196.          record.  When  you  select this, a red R will appear in
  197.          the  status window indicating that everything you do is
  198.          being  recorded.  You  are  limited to macros less than
  199.          4000  characters  (which  is quite a lot of room). When
  200.          you  reach  the  limit, the R in the status window will
  201.          turn  off.  When  recording,  the mouse input is turned
  202.          off,  and any requester will have to be manually closed
  203.          w