Amiga Survival Kit (Disk 80) (Feb 1988) : Clipit / ClipIt.doc

   ClipIt 1.1                            Copyright (c) 1987 by Mike Scalora


   This program is shareware.   Freely distributable as long as this 
   notice stays in.

   This program was originally uploaded to PeopleLink's Amiga Zone.  The 
   Amiga Zone has well over 3000 members, and a library of thousands of 
   public domain files.  If you're interested in joining us, call 
      800-524-0100 (voice) 
   or 800-826-8855 (modem).

  This program is shareware.  If you use it, please send me $10 so I can
  continue to not work at McDonald's so that I will have the free time
  to write program for you, the Amiga community.  Please give ClipIt
  to all the Amgia users you know.

  Non-distributable source code is available (on disk) for $20 (Includes 
  shareware fee!).  The source code for this is Benchmark Modula-2 and 
  assembler.  To compile the source you must have Benchmark Modula-2.  
  If you want to re-assemble the InputHandler, you must also have an
  assembler. (Asm68K, the PD assembler, will NOT work, sorry.  It does 
  not work with the Benchmark Modula-2 include files.)  A make file will 
  also be included.  Free updates with SASMw/3.5"disk.
  Source shows how to:
    - write an InputHandler (in ASM) and interface it with Modula-2
    - write simple ILBM files (1.4K routine vs. 5K for library routine)
    - do window iconification.

  Send your contribution to:

  Mike SCARY Scalora
  342 Hurley Ave
  Kingston, NY  12401

  NOTE to PLink users: Shareware fees can be paid using a PLink gift!  Save
                       time and stamps!

 ---------------------------------------------------------------------------

  ClipIt is a utility for the Amiga that lets you take 'clips' of graphics
  from any screen.  The 'clips' are 'clipped' into a window and can then
  be saved in IFF format.  You can have up to 5 'clips' at any one time.  
  You can have 'clips' on any screen**.

  ** 1)  Some screens don't like windows on them (i.e. DPaintII) and 'clip'
         windows will erase what is under them.

  ** 2)  If you close a screen while there is a 'clip' window on it, you
         stand a good chance of meeting the guru or locking up ClipIt.  I
         tried this a few times to see what would happen.  I never got the 
         guru, but I locked up ClipIt every time.

  How to use ClipIt:
  
  To take a clip, just hold down the LEFT-Alt key and drag out an 
  imaginary box with the mouse and the LEFT-Button.  That was
  LEFT-Alt - LEFT-Button-drag.  Got it?  Good!

  NOTES: You can only clip from the front screen, and to get good results,
  you should have this screen pulled all the way up.

  The ClipIt window.  When you run ClipIt, it opens a control window on
  the Workbench screen.  This window is used to select options and 
  save 'clips'.  There are 5 number gadgets that select the 'clip' to
  be saved.  The SAVE AS gadgets is used to save the 'clips'.  Next to it
  is a string gadgets that is used to specify the file name to save the
  'clip' under.  The default file name is 'RAM:Clip.iff'.  There is
  also a gadget labeled 'Clip to Workbench'.  When this gadget is on,
  all 'clip' windows will be opened on the Workbench screen.  When the
  'Color' gadget is on, 'clip' windows will be opened with the border
  in color 3 instead of color 1.  'Kill HOT-KEYS' turns off ClipIt.
  While this gadget is selected, any LEFT-Alt - LEFT-Button events will
  be passed on to intuition. The last gadget is 'Iconify', this gadget
  closes the control window and opens a small 'icon' window.  To open the
  control window back up, just click in the non-border area of the 'icon' 
  window.

  ClipIt will run from both CLI and Workbench.  If you run ClipIt from 
  Workbench, a small, I'm talking small here, window will be opened in
  the very top left corner.  How small you ask?  1 by 1!

  ClipIt will refuse to make clips that are too large or too small.

  NOTE: If you need to use Alt and the LEFT-Button on the mouse and you 
  don't want to use 'Kill HOT-KEYS', use the RIGHT-Alt.  RIGHT-Alt is NOT
  used by ClipIt.

  I was thinking of making the clip windows sizable.  It would take a bit
  of code.  Is it needed?  Wadda ya thin?  I was also thinking about 
  putting in a 'save-screen' feature.  Is this needed with all the PD
  screen savers around?  If I did that, I think I would have to go to a
  packed ILBM file.  That could turn out to be a lot of code also.

  If you find a bug, OR you thing you have a good idea of something else
  that could be put into ClipIt, please let me know.

  I can be reached at:

  People Link: SCARY
  Internet   : SCALOR01@SNYNEWBA.bitnet
  CI$        : 73717,2334    (every other cold day in hell)

  OR

  - ] Mike SCARY Scalora [ -
  342 Hurley Ave 7-12
  Kingston, NY  12401