home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / screen / hermit.lha / HERMiT.doc < prev    next >
Text File  |  1989-06-14  |  14KB  |  290 lines
  1.  
  2.                           HERMES' HERMiT (Version 1.2)
  3.  
  4.                      Copyright (c) 1988-89 A. G. Kartsatos
  5.  
  6.       (Saves/Cycles The Front Screen And Saves The Front Screen's Font)
  7.  
  8.                                *** Shareware ***
  9.  
  10.                  (Please See Below Distribution Requirements)
  11.  
  12.      NEW:  HERMiT will now save the screen faster.  Some of the users have
  13.            already seen this in Version 1.1.
  14.            It will save the front screen's font.
  15.            It contains its own font.  You do not have to have the TOPAZ 11
  16.            font on your disk anymore.  Thus, you can run the program from
  17.            anywhere since it uses no AmigaDos commands from your c directory
  18.            except RUN of course.
  19.            It does not use the sound beep anymore.  It uses the built in
  20.            beep function (sunning of the screen).
  21.            It will save the screen after a user-defined amount of time in
  22.            seconds.
  23.            It does not lose any memory.
  24.  
  25.      Here is a new version of HERMiT.  It will SAVE and CYCLE your FRONT
  26. SCREEN by using HOT KEYS.  Very useful when you need a copy of a screen of
  27. a word processor, a game, a utility, etc.  It will cycle IFF pictures which
  28. have from 8 to 32 colors.  It will save OVERSCAN front screens too.
  29. The files are saved sequentially like GRABBiT to a directory/volume path
  30. that you specify when the HERMiT requester asks you for it.  Just enter a
  31. volume/directory where you want your pictures saved.  No actual filenames
  32. are needed and they will not work.  The saving format: HR_3MED.000 = HERMiT,
  33. 3 Planes, Medium Resolution, File Number 0.  Another example: HR_6LACE.007 
  34. = HERMiT, 6 Planes, INTERLACE Mode, 8th File Saved.  Whenever HERMiT is run,
  35. the numbering of the pictures starts from 000.  This means that the user 
  36. should make sure that he/she does not overwrite older pictures with the same
  37. number, resolution and planes as new ones.
  38.  
  39.      This version of HERMiT will save your fornt screen in about half the
  40. time of the previous version.
  41.  
  42.      HERMiT will also SAVE THE FRONT SCREEN FONT.  Well, all these Front-
  43. Screen saving operations are of course possible only when the running
  44. program allows you to do them.  When the running program uses the "Disable(),
  45. Forbid()" combinations (e.g., in the C Language), you cannot save the 
  46. FrontScreen.
  47.  
  48.      To SAVE THE FONT, just PRESS: CTRL+LALT+F.  The program will check first
  49. to see if the font is just the TOPAZ one.  If it is, the program will notify
  50. you accordingly, and it will not save the font.  Let us assume that the font
  51. has the name HELLO and has size 11.  The program will try to see if a 
  52. directory exists in the assigned HERMiT path (above) with the name fonts.
  53. If it exists, HERMiT will try to save the font in there.  It will put a file
  54. called HELLO.font in that fonts directory, it will then open a directory
  55. in there with the name HELLO, and, finally, it will place into the HELLO
  56. directory a file with the name "11".
  57.  
  58.      If the fonts directory cannot be found in the assigned HERMiT path,
  59. HERMiT will create it and continue as above.
  60.  
  61.      The program WILL NOT CREATE A FONT IF THE FONT NAME ALREADY EXISTS IN
  62. THE HERMiT PATH/FONTS DIRECTORY.  This means that if there is a HELLO font
  63. already in that fonts directory, HERMiT will not create a font with the
  64. name HELLO even if the new font has a different size.
  65.  
  66.      If you do want to get that font anyway, just change the names of the
  67. three files of the HELLO font that are already there (HELLO.font, HELLO
  68. and 11), or delete them.
  69.  
  70.      Now, I do not really want to play with your current "fonts" directory.
  71. So, when you enter a path into the HERMiT gadget, please avoid entering
  72. a volume/directory that contains your valuable "fonts" directory.  This of
  73. course applies only when you want to save the screen font.
  74.  
  75.      It works from the Workbench or the CLI.  To run it from the CLI, Press:
  76. RUN HERMiT (not just HERMiT).  Just click into its icon when you want it on
  77. the Workbench screen.  LALT denotes the Left ALT KEY on your keyboard.  
  78.  
  79.      IN what follows, "BEEP" means "sunning of the screen."
  80.  
  81.      COMMANDS:
  82.  
  83.     (I)  CTRL+LALT+H:  Checks whether HERMiT has been activated (BEEP)
  84.  
  85.    (II)  CTRL+LALT+S:  Saves the front screen. (BEEP before and after)
  86.  
  87.   (III)  CTRL+LALT+Q:  Stop HERMiT from running in the background. (BEEP)
  88.  
  89.    (IV)  CTRL+LALT+1, CTRL+LALT+2, CTRL+LALT+3: will cycle the colors of the
  90. front screen at three different speeds, respectively.  The only un-cycled 
  91. color is the color in register 0.  It is usually the color outside the 
  92. picture frame and it does not look good when you include it in the cycling.
  93.          Press the TAB KEY to stop the cycling.     
  94.  
  95.     (V)  CTRL+LALT+F:  Will save the front screen's font. 
  96.                        (BEEP before and after)
  97.      
  98.      Now, remember that it is still possible that HERMiT can be blocked from
  99. operation because another running program may be using some of the above
  100. key combinations.  So, if you get stuck trying to save a picture with HERMiT,
  101. have this fact in mind.  You might be able to still save a picture though.
  102. HERMiT will save the screen after a user-defined number of seconds.  
  103.  
  104.      If you want to save the screen of a program 30 seconds after you run 
  105. HERMiT, just run HERMiT as follows: RUN HERMiT 30.
  106.  
  107.      The program will notify you that it is waiting about 30 seconds before
  108. it saves the front screen.  This will give you plenty of time to get to
  109. the desired screen.  After it saves the screen, HERMiT will be operating as
  110. usual.  If you specify any number of seconds less than 20 (and > 0), the
  111. program will default to 20 seconds.
  112.  
  113.      One of the main reasons for not being able to save certain screens, is
  114. that the programs creating those screens block your keyboard and prohibit
  115. you from interfering with their respective tasks.  This can be done in 
  116. the C language by using instructions like "Disable(); Forbid();".
  117.  
  118.      I have tried to cover a lot of cases of possible ... misuse of the
  119. program.  However, if you come across any situations at all where HERMiT
  120. does not work properly, please let me know.  I would appreciate it.
  121.  
  122.      I would like to express my thanks to Robert Miles (Excalibur BBS,
  123. Dallas) for sharing his knowledge with me on the hunks of executable files.
  124.  
  125.      Have fun!!!
  126.  
  127.                  @@-->>> HERMES
  128.  
  129.  
  130.      Programs By HERMES:
  131.  
  132.      ICONLAB2.ARC   (The Definitive Work On Icons For The Amiga Computer.
  133.                     It Supports:
  134.  
  135.                                        CUT/SAVE ICONS, 
  136.                                        ICON->BRUSH, 
  137.                                        BRUSH->ICON, 
  138.                                        CUT/SAVE BRUSHES, 
  139.                                        8-COLOR ICONS, 
  140.                                        SPLIT ICONS, 
  141.                                        JOIN ICONS,
  142.                                        MODIFYING OF ICON DATA,
  143.                                        CHANGING RESOLUTION ON THE FLY, etc)
  144.  
  145.                     [This Is The Demo Version Of The Commercial Program
  146.                     ICONLAB Available Now From The Address Below At $30.00]
  147.  
  148.      DISKoLAB.ARC   (One Of The Greatest Utilities Ever!
  149.  
  150.                          Among Other Capabilities,
  151.  
  152.                          It Supports 1200 files.
  153.                          It has A Built In IFF Viewer For All IFF's Including
  154.                      Brushes And Overscans.  
  155.                          It Has A Built In Icon Viewer For Icons Of Any Size
  156.                      And Any Colors Up To 16.  
  157.                          It Has A Built In Fast File Reader Which Is Also
  158.                      Used By Numerous Other Functions.
  159.                          It Will Find A File Anywhere On The Current Di-
  160.                      rectory/Drive (Including Subdirectories).
  161.                          It Will Compute The Size Of The Current Directory/
  162.                      Volume.
  163.                          It Will Search Every ASCII File In The Current Di-
  164.                      rectory For A String.  
  165.                          It Will Show You All Your Mountlist Data From
  166.                      Memory.
  167.                          It Will Fix An ASCII File That Contains Binary
  168.                      Characters.
  169.                          It Will Extract All ASCII Characters From A Bi-
  170.                      nary File.
  171.                          It Will Highlight All Files Whose Name Contains
  172.                      A given Pattern.   
  173.                          It Will Save The Currently Displayed List Into 
  174.                      A File.
  175.                          It Will Isolate All The Directories In The Current
  176.                      Directory In Order To Be Able To Perform Four Diffe-
  177.                      rent Functions On Them.
  178.                          It Will Allow You To Display Nicely A File's
  179.                      Information (Protection Bits And Comment), And Change
  180.                      It On The Fly.
  181.                          It Will Allow You To Save The Entire Contents Of
  182.                      A Drive Into A File.  This Catalogue Will Contain the
  183.                      Exact Paths Of All The Files On It, The Creation Dates
  184.                      And The Sizes.  Hard Disk Drives Are Included.)
  185.  
  186.                     [This Is The Demo Version Of The Commercial Program
  187.                     DISKoLAB Available Now From The Address Below At $30.00]
  188.  
  189.      COLORLAB.ARC   (This Is A Nice Update To The PALETTA program.  It Allows
  190.                      The User To Identify All Color Shades Of The Amiga
  191.                      Computer, Mix Colors, Get Hex Values For The Colors, and
  192.                      Get Random Colors.  It Also Allows The User To Load An
  193.                      IFF Picture And Modify It At Will (If It Is Of 32 Colors
  194.                      Or Less) By Throwing On The Screen A Nice Palette.  This
  195.                      IFF Picture Can Also Be Reduced To One In Black & White.
  196.                      This Last Feature Can Be Accomplished In 13 Different
  197.                      Ways.  All These Pictures Can Be Saved To A File Or
  198.                      To A Printer)
  199.  
  200.      CALCULA.ARC    (An Expression Parser And A Function Evaluator.  A Really
  201.                      Great Calculator For Your Amiga.  It Will Evaluate 
  202.                      Millions Of Functions F(x,y,z) (Of Up To Three Vari-
  203.                      ables).  Any Depth Of Parentheses!!!)
  204.  
  205.      OUTCOMM.ARC    (This Little Utility Will Actually Eliminate All Com-
  206.                     ments From Your C Programs.  These Are Statements Be-
  207.                     tween /* And */.  It Will Also Delete Any Lines That
  208.                     Lie Entirely Within These Comments.  I Have Found It
  209.                     Pretty Useful.)
  210.  
  211.      LISTA11.ARC    (Very Useful Directory Lister.  Alpha, Bytes, Patterns,
  212.                      CLI, Refresh.  Opens Its Own Window)
  213.  
  214.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy Online! Script Files!)
  215.  
  216.      FORMULA!.ARC   (FORMIDABLE 3D-Grapher In C. It graphs z = f(x,y).  
  217.                      Choice Of Colors.  17 Functions Supported.  An Artist's
  218.                      Tool)
  219.  
  220.      FINANCA.ARC    (Mortgage, Compound Interest And Annuity In Color!)
  221.  
  222.      CONTOURA.ARC   (SPECTACULAR Contour Grapher.  Definitely An Artist's
  223.                     Tool.  CENTER, ZOOM IN, ZOOM OUT, FLOWING PALETTE,
  224.                     SCALING.  An Important Artist's Tool!)
  225.  
  226.      ARCHA12.ARC    (ARC-PAK-ZOO Utility.  It Also Has Another 12 Utility
  227.                     Gadgets And 7 Drive Gadgets.  Only 35K, It Can Be Used
  228.                     As An Efficient Directory Utility.
  229.  
  230.      CYCLER1.ARC    (This Program Will Cycle Your IFF Pictures (<=32 Colors)
  231.                     In Two Different Modes (Straight And Reverse) And Three
  232.                     Different Speeds.  Great For Creating Motion Via 
  233.                     Cycling!)
  234.  
  235.      DUHERM28.ARC   (This Is Version 2.8 Of DU-HERMES.  This Beautiful dire-
  236.                     ctory Utility Can Afford A Total Of 72 Gadgets, Out Of
  237.                     Which 48 Are User-definable!  One Of The Major Utilities
  238.                     For The Amiga Computer.  Very Popular And Very Useful.)
  239.  
  240.      SIMPLIC1.ARC   (The Simplex Method Of Linear Programming. The
  241.                     Complete Program Handles Simplexes Of Up To 30 Un-
  242.                     knowns And Up To 30 Constraints.  It Will Also Load
  243.                     And Save Simplexes.  The Best Simplex Program For
  244.                     Your Amiga.  
  245.                     [This Is The Demo Version Of The Commercial Program
  246.                     SIMPLICA Available From The Address Below At $30.00]
  247.    
  248.      TAPRiSKA.ZOO   (This Program Allows You To List All The Current Tasks
  249.                     And Their Priorities.  It Also Allows You To Change The
  250.                     Priorities On The Fly.  Very Useful And Convenient.)
  251.  
  252.      This is a SHAREWARE program.  If you use this program, please send 
  253.      $15.00 to the address below.
  254.  
  255.      FOR SUPPORT, please write to:
  256.  
  257.      A. G. Kartsatos            (PLink = HERMES)
  258.      8524 Caladesi Island Drive
  259.      Temple Terrace, FL 33637-7310, USA
  260.  
  261.      (Telephone 813-985-7624)
  262.  
  263.  
  264. DISTRIBUTION
  265. ============
  266.  
  267.      Feel free to distribute this version of HERMiT, with this doc
  268. intact, to any bulletin boards and non-profit establishments in the US
  269. and abroad.
  270.      You are also allowed to upload this version to major electronic boards
  271. like BIX, Compuserve, Delphi, GEnie, PLink, etc.
  272.      The inclusion of HERMiT or any part of it, in any form, in a commercial 
  273. package, or its use for any commercial purposes, is illegal without the 
  274. explicit permission of the author.
  275.      All nationally and internationally sold disks with Amiga software are
  276. considered commercial packages by this author.  Only The Amiga User Group
  277. "Disk Of The Month" disks are excluded.
  278.      *** If you are planning to use this program commercially, you may 
  279. call me using the phone number above. ***
  280.     
  281. DISCLAIMER:
  282. ===========
  283.  
  284.      The usual disclaimers concerning computer software apply to this
  285. product.
  286.      Although this program has been tested extensively for its accuracy and
  287. reliability, the author will accept no liability whatsoever for damage
  288. resulting from the use, misuse, or excessive use of it.
  289.  
  290.