home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 1 / Amiga Tools.iso / aga-tools / quickgrab / quickgrab.doc < prev    next >
Encoding:
Text File  |  1994-06-06  |  9.4 KB  |  266 lines
  1.  
  2.  
  3.     QuickGrab V1.1 by Steve Hines
  4.  
  5.  
  6.     QuickGrab is a program I wrote to fill a (small) gap in
  7.     software for 2.0/3.0 (especially the Amiga 4000). Most screen
  8.     grabbers do not even run under 2.0. The ones that do fail miserably
  9.     (9 times out of 10) under 3.0. With the Interleaved Workbench and
  10.     the AA Chipset, almost every grabber was gone. I didn't even need
  11.     a screen grabber for years until I bought my 4000 and got a Viewer
  12.     called Viewtek, which translates among other things, J-Peg/24bit into
  13.     AGA resolutions (like Hires-Interlaced HAM :-) I wanted to grab
  14.     those converted images and make them Workbench backdrops, but to
  15.     no avail: there exists not a single screen grabber that saves
  16.     screen modes in a 2.0/3.0 compatible way. Hence QuickGrab.
  17.  
  18.  
  19.     NOTE: QuickGrab V1.1 is COMPLETELY Freely Distributable. This
  20.     means that you can use it free of charge and pass it around free
  21.     of charge. I grant EXCLUSIVE disk-for-$ distribution rights to
  22.     Fred Fish. Anyone else, ask me FIRST. I claim all copyrights
  23.     on QuickGrab V1.1, intellectual and otherwise.
  24.  
  25.     That being said:
  26.  
  27.     New additions to V1.1:
  28.  
  29.     Ability to set "Grab Delay" up to 99 seconds after grabkey pressed.
  30.     Can now save pictures that are changing during the grab.
  31.     Grabbing is now about 2 times faster (depending on where you save).
  32.     The grab delay plus an enhancement in V1.1 allows grabbing of
  33.         pull-down menus, dragging windows, etc.
  34.     For technical users: Can now grab pictures from screens with the
  35.         Layers locked.
  36.  
  37.     Brief summary of features:
  38.  
  39.     1) Grabs and saves ALL graphics modes, including 8 bits.
  40.  
  41.     2) Saves the screen display modes properly. Old grabbers filter
  42.        out modes like DoubleNTSC, NTSC-Super-Hires, Super72.
  43.  
  44.     3) Properly grabs and saves new-for-3.0 Interleaved bitmaps.
  45.  
  46.     4) Uses the Commodities Exchange routines in 2.0, so that
  47.        Hotkeys/popkeys don't contend with other programs. This is
  48.        certainly not true of non-2.0 grabbers.
  49.  
  50.     5) Loads from Workbench with a full complement of ToolTypes,
  51.        so that QuickGrab can be installed in WBStartup easily.
  52.  
  53.     6) Has gadget interface that allows you to set save directory,
  54.        base filename, and grab hotkey.
  55.  
  56.     7) Is able to successfully grab screens even if they are closed
  57.        DURING the grab.
  58.  
  59.     8) Small and efficient. Totally 2.0/3.0 compatible.
  60.  
  61.     9) I don't worry about making it 1.3 compatible (this IS a feature :-)
  62.  
  63.  
  64.     The program's operation is really very simple: at any time,
  65.     press the Grab hotkey (it defaults to "control lcommand s") and the
  66.     frontmost screen is grabbed and saved in the destination directory
  67.     (defaults to "RAM:") under the base filename (defaults to "QuickGrab")
  68.     with extension added (extension counts from .000 to .999).
  69.     All three of the above defaults can be changed through either
  70.     the icon's ToolTypes or through the program's gadget interface. (These
  71.     are explained below.)
  72.  
  73.  
  74.  
  75.     ToolTypes:
  76.  
  77.     CX_POPUP:
  78.     CX_POPKEY:
  79.     CX_PRIORITY:
  80.         See the Amiga User Guide for info on these ToolTypes.
  81.  
  82.     HOTKEY:
  83.         Sets the Grab hotkey to any legal key combination.
  84.         Qualifiers allowed include: control, lalt, ralt, alt,
  85.         lcommand,rcommand, lshift, rshift, shift.
  86.         Keys allowed include: esc, space, f1, return, a-z, A-Z 1-10
  87.  
  88.         Examples: HOTKEY=control lalt rshift esc
  89.               HOTKEY=alt f8
  90.  
  91.         Default: HOTKEY=control lcommand s
  92.  
  93.         See the Amiga User Guide for more information.
  94.  
  95.     SAVEDIR:
  96.         Sets the directory where the grabbed pictures will be saved.
  97.         This can be any valid EXISTING directory anywhere.
  98.  
  99.         Example: SAVEDIR=df0:pictures
  100.  
  101.         Default: SAVEDIR=RAM:
  102.  
  103.     BASEFILE:
  104.         Set the base filename for all pictures grabbed. For example,
  105.         if SAVEDIR=RAM: and BASEFILE=QuickGrab, any picture grabbed
  106.         would be saved as RAM:QuickGrab.xxx, where xxx is 000-999.
  107.  
  108.         28 characters is the maximum length for the base filename.
  109.  
  110.         Example: BASEFILE=GrabbedPic
  111.  
  112.         Default: BASEFILE=QuickGrab
  113.  
  114.     MESSAGE:
  115.         The message is the window that opens up while QuickGrab is
  116.         grabbing a screen. If this is checked, a window will open on
  117.         the public screen informing you when a picture is being
  118.         grabbed. The window is open only while QuickGrab is grabbing.
  119.  
  120.         One of the few reason you might want to turn this off is
  121.         if you are grabbing the current public screen (i.e. the
  122.         Workbench screen) and you do NOT want the message window to
  123.         appear in the picture grabbed.
  124.  
  125.         This value can be set to "YES" or "NO".
  126.  
  127.         Default: MESSAGE=YES
  128.  
  129.     DELAY:
  130.         This sets the Grab Delay in seconds. The Grab Delay is the
  131.         amount of time that QuickGrab will wait AFTER the Grab hotkey
  132.         has been pressed. This allows you to rearrange screens, move
  133.         windows, etc. in preparation for the grab. In addition, this
  134.         allows you to, for example, grab pull-down menus, dragging
  135.         windows, etc.
  136.  
  137.         NOTE: With DELAY set for any value greater than 0, the message
  138.         window (if turned on) may not update to say "Grabbing Screen
  139.         and Saving..." while the screen is being grabbed. This will
  140.         ONLY occur if you are trying to grab pull-down menus, or other
  141.         Intuition features that prevent screen updating while active.
  142.         This DOES NOT affect the operation of QuickGrab.
  143.  
  144.     Gadget window:
  145.  
  146.     Save Directory:
  147.         This string gadget allows you to set the directory where
  148.         grabbed pictures will be saved.
  149.  
  150.         The gadget to the far right of the Save Directory gadget is
  151.         a GetFile gadget. Clicking on this will allow you to
  152.         specify the save directory interactively through the
  153.         standard Amiga File Requester.
  154.  
  155.     Base Filename:
  156.         See BASENAME above for a description of this gadget's function.
  157.  
  158.     Grab Hotkey:
  159.         Specifies the Hotkey used to grab a picture. See HOTKEY above
  160.         for possible values of this Hotkey.
  161.  
  162.     Delay Before Grabbing (seconds): This sets the number of seconds
  163.         that QuickGrab will wait before grabbing the screen. See
  164.         DELAY above for implications of this feature.
  165.  
  166.     Show message when grabbing:
  167.         When checked, a message window will open on the current
  168.         public screen when QuickGrab is grabbing a picture.
  169.  
  170.         You may want to turn the message window off when grabbing
  171.         the current public screen (i.e. the Workbench screen).
  172.         Otherwise the message window will appear in the saved picture.
  173.  
  174.     Hide:
  175.         Will hide the Gadget Window. It can be reopened four ways:
  176.         1) Click on Show Interface in the Commodities Exchange
  177.             program (see the Amiga User Guide on how to use this.)
  178.  
  179.         2) Press the CX_POPKEY key combination. This can be set
  180.             in the ToolTypes (see above). The default CX_POPKEY
  181.             is "control lcommand x".
  182.  
  183.         3) Double click on the QuickGrab icon.
  184.  
  185.         4) run QuickGrab from the CLI.
  186.  
  187.     Quit:
  188.         Closes the QuickGrab window and removes QuickGrab from the
  189.         system. QuickGrab will no longer be available to grab screens.
  190.  
  191.         You can also quit QuickGrab through the Commodities Exchange
  192.         program (see the Amiga User Guide for info on using this.)
  193.  
  194.  
  195.     In case you were still wondering, QuickGrab is 2.0 ONLY.
  196.  
  197.     That's all there is to it.
  198.  
  199.     By the way, if you own an Amiga with the AA Chipset, (currently
  200.     only the 4000), I suggest that you get Viewtek by Thomas Krehbiel.
  201.     It's fast, very useful, and it renders some beautiful Hires HAM
  202.     images from J-Pegs and 24 bit IFFs. This program was tested by
  203.     grabbing Viewtek's screens (among others). I got Viewtek.lha from
  204.     PORTAL. I also suggest (for pure graphics entertainment)
  205.     WindowBlender by Fred Mitchell. It renders some beautiful formulae.
  206.     It also lacks an IFF Save routine, so it's great practice for
  207.     QuickGrab :-) I got WindowBlender.lha from Portal as well.
  208.  
  209.     If you have any questions about the operation of QuickGrab, or
  210.     any bug reports (bugs???) please feel free to mail me at one
  211.     of the electronic addresses below.
  212.  
  213.     If you are interested in the source code to QuickGrab, I will
  214.     E-Mail it to you for free, you just have to ask. The code is written
  215.     in Manx C 5.2, but it should compile with SAS/C just fine, there
  216.     is nothing complex in it.
  217.  
  218.  
  219.     The source code for QuickGrab is Copyright 1992 Steve Hines.
  220.     Portions of this program include code from:
  221.     Jerry Morrison and Steve Shaw, Electronic Arts
  222.     Jim Kent (Dancing Flame)
  223.     The Amiga Rom Kernal Manual, Commodore Amiga
  224.  
  225.     Everyone above still retains copyrights on their code.
  226.  
  227.     QuickGrab's interface was generated using GadToolsBox v1.3 by
  228.     Jan van den Baard. GTB does a great job of designing interfaces,
  229.     I recommend it to anyone wanting to use GadTools. (I just wish
  230.     it didn't have so many darned Enforcer hits!!)
  231.  
  232.  
  233.  
  234.  
  235.     My E-Mail Addresses:
  236.  
  237.     HOLOSOFT            (Portal)
  238.     HOLOSOFT@cup.Portal.com     (USENET & InterNet)
  239.     shines@ucsd.edu         (USENET)
  240.  
  241.  
  242.         Thanks for using QuickGrab.
  243.  
  244.             Steve Hines
  245.  
  246.  
  247.     Revision History:
  248.  
  249.     V1.1: IFF code now sets NOSIZEYET instead of precalculating
  250.         the compression. This allows me to save bitmaps that
  251.         are changing while I'm grabbing. This also speeded up the
  252.         saving routine.
  253.           Added Grab Delay feature.
  254.           Added code to check the Layer locks on the public screen
  255.         and the screen-to-grab so that the message window does
  256.         not try to open or update if the public screen is locked,
  257.         and so that if the screen-to-grab is locked, I don't try
  258.         to lock it and halt the grabbing of the screen. This also
  259.         means that the user can grab bitmaps from disappearing
  260.         screens :-( Unfortunately, there is no way around this
  261.         (that I know of)
  262.  
  263.     V1.0: Original release.
  264.  
  265.  
  266.