home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 2140.dms / in.adf / Docs / PictSaver.doc / PictSaver.doc
Encoding:
Text File  |  1993-03-12  |  10.0 KB  |  278 lines
  1.  
  2.                              //
  3.                          \\ // PictSaver V2.0
  4.                           \//
  5.  
  6.                                1991
  7.                                 by
  8.                           Preben Nielsen
  9.  
  10.  
  11.  
  12. PICTSAVER ?
  13.  
  14.     Up to this version the name used to be 'PicSaver' - I have now changed
  15.   it to 'PictSaver'.
  16.  
  17.  
  18.  
  19. WHAT'S NEW SINCE V1.1 ?
  20.  
  21.     PictSaver V2.0 has a completely new way of interacting with the user.
  22.   It now features auto-numbering (automatic changing of filename) to help
  23.   you when saving a series of pictures. It also features optional compression
  24.   of pictures (ByteRun1 or not). I have corrected a few minor and major bugs,
  25.   and I believe that PictSaver now saves all screen-modes and sizes correctly.
  26.   Furthermore it is now possible to save pictures as large as 2400 bit wide and
  27.   32 bit deep (haven't actually tried that yet). Finally I have implemented
  28.   buffered output which means that PictSaver will be able to save the pictures
  29.   many times faster than before.
  30.  
  31.  
  32.  
  33. WHAT IS PICTSAVER ?
  34.  
  35.     PictSaver is a small utility that allows you to take snapshots
  36.   of windows, screens or only part of screens and store them on disk
  37.   as IFF-ILBM files, which can then be used in almost any paint-program.
  38.  
  39.  
  40.  
  41. HOW TO START PICTSAVER
  42.  
  43.     From CLI      : Type 'PictSaver' and press RETURN.
  44.                     There is NO need to use RUN, RUNBACK, ARUN etc.
  45.                     PictSaver is auto-detaching when run from CLI (It
  46.                     will not prevent you from closing the CLI-window).
  47.  
  48.     From Workbench: Double-click on the 'PictSaver' icon.
  49.  
  50.  
  51.  
  52. HOW TO END PICTSAVER
  53.  
  54.     To remove PictSaver simply run it again as explained above.
  55.     An easier way to remove PictSaver will be explained below.
  56.  
  57.  
  58.  
  59. HOW TO USE PICTSAVER
  60.  
  61.     Lets first of all agree on some terms.
  62.  
  63. When I write:              Then I mean:
  64. =====================================================================
  65.  
  66. LMB                        The left mouse-button.
  67.  
  68. Press CTRL-LALT-LSHIFT     Press the CTRL-key AND the left
  69.                            ALT-key AND the left SHIFT-key
  70.                            and keep them pressed.
  71.  
  72. Press CTRL-LALT-'w'        Press the CTRL-key AND left
  73.                            ALT-key and keep them pressed
  74.                            while pressing the 'w' key.
  75.  
  76. Press CTRL-LALT-'a'        Press the CTRL-key AND left
  77.                            ALT-key and keep them pressed
  78.                            while pressing the 'a' key.
  79.  
  80. Press CTRL-LALT-'f'        Press the CTRL-key AND left
  81.                            ALT-key and keep them pressed
  82.                            while pressing the 'f' key.
  83.  
  84. Press CTRL-LALT-'ESC'      Press the CTRL-key AND left
  85.                            ALT-key and keep them pressed
  86.                            while pressing the 'ESC' key.
  87.  
  88. Press CTRL-LALT-'HELP'     Press the CTRL-key AND left
  89.                            ALT-key and keep them pressed
  90.                            while pressing the 'HELP' key.
  91.  
  92.  
  93.  
  94.     Pressing CTRL-LALT-'HELP' pops up a window looking something like this:
  95.  
  96.                ------------------------------
  97.                |  PictSaver V2.0            |
  98.                |----------------------------|
  99.                |       -------------------  |
  100.                | File |               <---|-|---\
  101.                |       -------------------  |    \
  102.                |        ------------        |     \
  103.                |       |     Ok     |       |      \
  104.                |        -----^------        |       \
  105.                --------------|---------------    Here you write the
  106.                              |                   name of the file to
  107.                              |                   create.
  108.             Click here to make
  109.             the window go away.
  110.             The next time you
  111.             open the window, it
  112.             will appear on its
  113.             current position on
  114.             the screen.
  115.  
  116.  
  117.     While the window is open, it has two menus by which you can control
  118.   PictSavers way of saving pictures.
  119.  
  120.     The 'Special' menu contains two menu-items - 'Auto-numbering' and
  121.   'Compression'.
  122.  
  123.     If Auto-numbering is on, then every file saved will get an extension
  124.   added to its name. The extension will be of the form '.###', e.g. '.001'.
  125.   Turning auto-numbering on will add such an extension to the filename if
  126.   it doesn't already have one. For every picture saved while auto-numbering
  127.   is on, the extension will be incremented to '.002', '.003' etc. Suppose
  128.   you have typed 'filename.023' and use auto-numbering - the next saved file
  129.   will be named 'filename.023' and the next again 'filename.024' and so on.
  130.   If auto-numbering if off, you will have to open the window every time to
  131.   change the name yourself.
  132.  
  133.     PictSaver will allow you to make the path/filename combination 120 bytes
  134.   long, but you have to be careful not to make the filename part longer than
  135.   30 bytes (Amigados don't use more). When using auto-numbering, you have to
  136.   remember that the extension is 4 bytes, and that the rest of the filename
  137.   shouldn't be longer than 26 bytes.
  138.  
  139.  
  140.     If Compression is on then pictures will be saved using the usual 'ByteRun1'
  141.   compression method (the one every paint-program can use). Otherwise, pictures
  142.   will be saved uncompressed (this is sometimes better if you wan't to pack
  143.   the picture-file with e.g. PowerPacker).
  144.  
  145.  
  146.     The 'Bitplane' menu contains seven menu-items. This menu lets you control
  147.   the maximum number of bitplanes to be saved from a screen. You can choose
  148.   '1', '2', '3', '4', '5', '6' or 'All'. If you e.g. are about to save a 5
  149.   bitplane picture and but only need to save the two lowest bitplanes, then
  150.   just select '2' before saving the picture. Lets on the other hand suppose
  151.   that you have chosen '3' and then want to save a picture which only has two
  152.   bitplanes - PictSaver will then ignore the '3' choice and save only two
  153.   bitplanes. If you select 'All' then PictSaver will just save the number of
  154.   bitplanes that the actually screen has. If you save pictures from HAM or EHB
  155.   screens and have specified a bitplane number less than '6', then the saved
  156.   pictures will no longer be HAM or EHB pictures, but just plain ones.
  157.  
  158.  
  159.     When started, PictSaver defaults to Auto-numbering off, Compression on
  160.   and All bitplanes.
  161.  
  162.  
  163.  
  164. SAVING PICTURES !
  165.  
  166.     PictSaver will let you save images from screen i three ways:
  167.  
  168.     1. You can save the whole screen
  169.     2. You can save a window
  170.     3. You can cut out a rectangle just as you do in e.g. Deluxe Paint.
  171.  
  172.     If PictSaver, for some reason, can't save the picture (e.g. because
  173.   of disk-errors), then it will tell you using a requester. Otherwise
  174.   PictSaver will flash the screen to indicate that all went well.
  175.  
  176.  
  177.  
  178. HOW TO SAVE AN ENTIRE SCREEN
  179.   
  180.     To save the active screen (screen containing an active window) simply
  181.   Press CTRL-LALT-'a'. Pressing CTRL-LALT-'f' will save the frontmost screen
  182.   instead of the active one (very useful because screens can't become active
  183.   if they contain no windows).
  184.  
  185.  
  186.  
  187. HOW TO SAVE A WINDOW
  188.   
  189.     To save a window you have to make it the active one (e.g. by clicking
  190.   the mouse in it), and then press CTRL-LALT-'w'.
  191.  
  192.  
  193.  
  194. HOW TO SAVE A RECTANGULAR AREA OF A SCREEN
  195.   
  196.     This can only be done with screens that contain windows - so first
  197.   activate it (e.g. by clicking the mouse in a window on the screen).
  198.   When the screen is active you have to:
  199.  
  200.   1. Press CTRL-LALT-LSHIFT.
  201.      A cross-hair will now appear.
  202.  
  203.   2. Use the cross-hair to position the mouse in one corner of the
  204.      rectangular area you want to save.
  205.  
  206.   3. When the mouse is in place press the LMB and hold it down (don't
  207.      release CTRL-LALT-LSHIFT). The cross-hair is now replaced by a
  208.      rubber-band (Yes, just like re-sizing windows).
  209.  
  210.   4. Now move the the mouse until you have framed the area you want
  211.      to save.
  212.  
  213.   5. Release the LMB.
  214.      The rubber-band dissapears and the area will be written to a file.
  215.  
  216. NOTE: Cutting out rectangular parts of HAM screen practically never
  217.       produces useful results due to the nature of HAM.
  218.  
  219.  
  220.  
  221. WHAT IF I HAVE STARTED TO STRETCH THE RUBBER-BAND AND I FIND OUT
  222. THAT I DON'T WANT TO SAVE THE AREA ANYWAY ??
  223.  
  224.     Just release the CTRL-LALT-LSHIFT keys (one or all) BEFORE releasing
  225.   the LMB. This will erase the rubber-band (or the cross-hair) and you can
  226.   start over.
  227.  
  228.  
  229.  
  230. ONE MORE WAY TO END PICTSAVER AND REMOVE IT FROM MEMORY
  231.  
  232.     Simply press CTRL-LALT-'ESC'.
  233.  
  234.  
  235.  
  236. HOW DOES PICTSAVER WORK ?
  237.  
  238.     PictSaver works by installing an input-handler at priority 55. This
  239.   handler then signals the program (10 different signals actually) which
  240.   then takes action.
  241.  
  242.  
  243.  
  244. COMPATABILITY !
  245.  
  246.     PictSaver has been tested under kickstart 1.2, 1.3 and 2.x on a
  247.   2.5 MB 68000 based Amiga 1000 (0.5 MB chip-ram). Let me know if
  248.   any problems is encountered with other configurations.
  249.  
  250.  
  251.  
  252. COPYRIGHT NOTICE !!
  253.  
  254.     I haven't yet decided whether future versions of PictSaver will be
  255.   Public Domain, Freeware, Shareware or what ever. For this reason there
  256.   is no source-code accompanying this release. However, this version 2.0
  257.   of PictSaver is Freeware. This means that it can be freely distributed
  258.   as long as you don't ask for more than a nominal fee for copying. This
  259.   documentation file must always be distributed along with the PictSaver
  260.   program.
  261.  
  262.  
  263.  
  264. =====================================================================
  265.  
  266.    Please send me any kind of bug-reports, suggestions, comments etc.
  267.   If I get no response to this version of PictSaver, then this will be
  268.   the last and final version.
  269.   
  270.  
  271.         ///
  272.        ///  Preben Nielsen
  273.  \\\  ///  Oehlenschlægersgade 72 st. T.V.
  274.   \\\///  1663 Copenhagen V.
  275.    \///  Denmark
  276.     Phone: (009 45) 31 21 55 09
  277.  
  278.