                     IMPORTANT INFORMATION
                     =====================

     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
     !  Before unzipping the application files in PRODUCT.ZIP  !
     !  please read LICENS.TXT.                                !
     !  You must not unzip PRODUCT.ZIP only if you do not      !
     !  agree with the contents of LICENS.TXT                  !                                      !
     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

     Installation
     ------------
     Please see INSTALL.TXT.

     
         -------------------------------------
         !           Warning !               !
         ! The unregistered version of this  !
         ! program cannot store bitmaps      !
         ! larger than 48*48 pixels.         !
         -------------------------------------

     
     Registration
     ------------

     The registration fee is A$49.95 plus A$6.00 for shipping and handling.
     
     Please use ORDER.TXT and send to

            Berthold Daum
            lichtbild pty ltd
            21 Margate St.
            LPO Box 6011
            Cromer, Vic 3193
            Australia

            CompuServe 100026,3365
            INTERNET: 100026.3365@compuserve.com
            HomePage: http://ourworld.compuserve.com/homepages/lichtbild
            fax: +61-3-9584 9638


or you can register via CompuServe (US$39.95) GO SWREG.


 Author:            Berthold Daum
 CompuServe ID:     [100026,3365]

 Program Title:     PICPOC S3A V2.5 PICTURES IN MY POCKET
 Program name:      PIC3A.ZIP
 Registration ID:   4498
 Fee (US$):         39.95

 Shipping & Handling Fees:  US$ 4.00

We supply you with a registration number via e-mail or by mail.



Entering the registration number
--------------------------------

   Press MENU, / , ENTER, ENTER
   then enter name and the registration number.

   Note: The entered name must be part of the machines owner name.
         The registration number must be issued on the entered name.





               PicPoc Version 2.5a - Release Notes
               ===================================

Program Description
-------------------

Advanced painting tool for PSION Series 3a computers.

Includes features such as:
 Polyline, Rectangle, Rhomb, Ellipse, Text, Pen, Eraser, Fill,
 Spray, Lupe, Undo, Copy, Cut, Paste, adjustable pen, eraser,
 and spray size, different text fonts and styles, different and user
 definable fill patterns, scrolling in large bitmaps.


Platforms
---------

 This program runs on PSION S3a and ACORN PocketBook II computers.

 S3a-emulator:
 The program runs on S3a-emulator. Images up to 640x400 pixels can
 be printed and can be edited full screen by running the emulator
 with large screen setting.
 Some multiple key operations (like B,W,G-cursorkey) are not supported
 and the system freezes sometimes. Save your work frequently.


Requirements
------------

 The installation routine informs of the size of each option. 
 Depending on options an installation needs between 48k and 92k disk space.


 When active, the system requires >12k of memory 
 (+ 3-5 times the size of the bitmap).

Related products
----------------
 PocView is a viewer for PIC,PCX, and GIF files. PocView is able
 to open very large files in reduced form or to select parts of
 a large file for detailed viewing.
 It also offers convenient screen snapshot viewing and printing.

New in PicPoc 2.56
------------------
   - Support for interlaced GIF

New in PicPoc 2.53
------------------
   - A title line can be specified for printouts.
   - Margins and scale for printing.

New in PicPoc 2.52
------------------
   - GIF filter now accepts all GIFLITE files
     (not only the ones created with the registered product).

New in PicPoc 2.51
------------------

   - GIF import/export filter.

   - PCX and GIF import interruptable with ESC key.
   
   - CROP filter. Selected area is cropped.
     The cropped area can be placed on a larger canvas.
     The new canvas will replace the current drawing.

   - SAVE filter. The selected area is saved
     into the specified bitmap file.

   - PRINT filter. The selected area is printed.

   - help text for filters.


New in V2.5
------------
   - Printer setup has been harmonized with the system printer setup.
   
   - Support for PCX file format.
   	 Bitmapped files are converted pixel by pixel, but 24-bit colour,
   	 greyscale, and indexed colour files are converted to PicPoc's
   	 5 colour model using dithering.(see Import/Export filters)
   	 
   - Object drawing (rhomb, ellipse) now with approximated
     outline instead of size box.
     
   - Faster and more accurate ellipse drawing.
   
   - Confirm rectangle, rhomb, ellipse with PSION-F or PSION-Shift-G
     to immediately fill the area.
     
   - Two more fill borders to fill white areas or white enclosed areas.
   
   - Magic selection. PicPoc now remembers the last five selections.
     When selecting an area (copy, cut, clear, filter, etc.),
     use TAB/Shift-TAB to flip through the last five selections!

   - A new V2.5 manual is now available (A$6.00 + A$4.00 postage)
     

New in V2.43
------------

   - Revised setup procedure saves some flash memory when multiple applications
     are installed on one disk.

   - Improved speed for bitmap printing

   - New clipbord function "Swap" swaps clipboard with current image

New in 2.4:
-----------
   - PicPoc now supports 1 shade of grey in one-plane-bitmaps (black only)
     and 3 shades of grey (greyB, grey, greyW) in two-plane-bitmaps (black&grey).
     Note: The new colours are not solid colours but dithered. They can be used
     in all drawing operations but not with the lupe.

   - Filling can now take place in 4 different modi:
     1. Fill within black outline
     2. Fill within grey/greyB outline
     3. Fill black area
     4. Fill grey/greyB area
     These options are set in the filling preferences (PSION-Shift-F).
     Use the diamond key to set the diamond to the option wanted.
		  
     The info panel shows the active mode by drawing a black or grey frame
     around the fill pattern - thin for frame fill, thick for area fill.

   - The tool settings (shape selection) and the fill pattern selection
     now have a own menu. The *-key is used to load
     any bitmap as a custom shape or fill pattern (only the black plane).
     The default directory for shapes is ..:\APP\PICPOC\SHAPES\
     The default directory for patterns is ..:\APP\PICPOC\PATTERNS\
		  
   - To modify the tool settings immediately before using a tool,
     invoke the tool with PSION-CONTROL-toolkey.

   - New tool: Brush. Brush has an independent shape. Unlike Pen, the cursor
     can be moved around without drawing. ENTER makes one imprint of the brush
     shape.
	  
   - all inserting operations like "Insert","Place","Filter" now place the
     insertion as a floating object. You can move the object around using
     the cursor keys. ESC aborts the insertion, ENTER confirms the insertion,
     CONTROL-ENTER lets you overwrite the default insertion mode.
     As long as the insertion is floating, a message flashes in the right bottom
     of the screen. A frame around the floating object is optional (Preferences.)

   - The operations Copy, Cut, Paste have been moved to the Clipboard title.

   - Two new operations in the Edit title:
     Move: cuts an area and makes it floating (see above) without changing the clipboard.
     Duplicate: copies an area and makes the copy floating without changing the clipboard.

   - The new revert function (PSION-Shift-U) works similar to Clear but
     replaces the content of the selected area with the content from
     the original file. If not original file exists, the function clears the area.

   - Use the DEL key in the text tool to delete up to 50 characters.
     (Undo must be enabled).

   - Use a letter key in the file finder to position to the next entry
     starting with that letter.

New in 2.3
----------
	- Font logic redesigned:
	  Fonts are now loaded from the following folders
	  	1. system_drive:\app\picpoc\
	  	2. m:\fon\
	  	3. a:\fon\
	  	4. b:\fon\
	  The maximum number of custom fonts has been increased to 32.

	- New filters: INVERT, EMBOSS

	- The lupe has now a own set of preferences. While in the lupe
	  press PSION-Q to change lupe size (24x24 or 48x48) and grid (none,black,grey)

	- The preferences are now saved until the next session.

    - The new Position function (PSION-*) informs about and can modify
      the cursor position, or if an area is selected the position and
      size of the selection area.

    - When CAPS is set, the selection area is moved by the cursor keys, not dragged.

    - The info window was improved and doesn't hide vital system information any more.

    - Home, End, Page up, Page down, and numeric key recognized
      during shape selection and fill pattern selection.

    - A function to find and preview files has been included into the Place
      function. (PSION-Shift-O). This function is especially useful to scan
      through image libraries. A quick shortcut is PSION-Spacebar.
      Use the usual cursor keys to scroll through the file list, use ESC to
      cancel, ENTER to place file. TAB lets you redefine the search criteria.

		  
Handy hints
-----------
        - You can't find a needed function in the menu?
          You may find the functionality in the collection filters!
          Select the filter function and browse through the filters.
          
        - Where is the cursor?
          Press the spacebar. The lupe area shown encloses the cursor.
          Press ESC to abort lupe.

        - Draw dotted line.
          Define the distance between dots via Preferences as step width.
          Then switch to the pen tool and move pen while keeping the PSION key
          pressed.
          You can also make a line dotted, by drawing a solid line, setting
          the fill border to solid area, and filling the line with an appropriate
          fill pattern.

        - Making a screen hardcopy.
          Use the internal PSION function: PSION-SHift-CNTRL-S. The screen
          is written to m:\screen.pic. Rename this file before making the next
          snapshot.
          
		- Converting a two-plane (black&grey) bitmap into a one-plane bitmap
		  Create a new Black-only bitmap of the same size.
		  Place the old bitmap on the new one. They grey tones will be
		  converted into a black/white pattern.


Import/Export-filters:
----------------------

    Please see document FILTERS.TXT
    

Printing:
---------

    Please see document PRINTING.TXT
     

Effect-Filters:
---------------

  Picpoc allows to apply predefined or user written filters to
  selected image areas or to the clipboard.
  
  The following filters are delivered with PicPoc:

     CROP    : Crop selected area and place into (larger) canvas
     EMBOSS  : Emboss selected area.
               Define edge thickness in X- and Y-direction
     ENLARG  : Enlarges or stretch by factor 2-8
               Useful to convert S3 icons into S3a icons.
               Copy icon into clipboard, apply ENLARG filter to
               clipboard, and insert into new bitmap.
     FLIP    : Flip horizontal or vertical
     INVERT  : Invert selected area (black only, grey only, both planes)
     PRINT   : Print selected area.
     REDUCE  : Reduce by factor 2-8.
     ROTATE  : Rotation 90, 180, 270 degree
     SAVE    : Save selected area into bitmap file.
     SHADOW  : Create grey shadows (X- and Y-offset can be specified)
     SKEW    : Skew to the left, right, upwards, downwards in angles from 0-45 degree.

  To write user defined filters is simple:
  Each filter module must contain a procedure

	proc filter%:(indrw%,planes%)

			indrw% = handle of drawable containing input bitmap
			planes% = number of planes of input drawable
			          (1=black only, 2=black&grey)

			The filter procedure must create a new drawable
			with the same number of planes. The new drawable
			contains the modified bitmap. The handle of this
			drawable is returned as the result of filter%:.
			Return 0 for no result.

			If you had created other drawables during the
			filter operation make sure to close them before
			leaving the filter.

   Then translate the filter and install the resulting OPO-module
   into folder \APP\PICPOC\FILTER\ .
   
   Examples: FLIP.OPL and SHADOW.OPL

   To add help pages to filters:

         Simply add new records to the help file (PICPOC.HLP).
         These files are Database files and can be edited with
         the inbuilt DATA application.
         The title line must contain the help hook and the
         actual title:

               :name@title

         where name is the name of the filter module.

         Example:

               :flip@Using the flip filter

            would be an appropriate title line for the flip filter.

         The following lines can contain text or references to other
         help pages. References are prefixed with "." .


Troubleshooting:
----------------

    Graphic applications are memory hungry. A black&grey image in screen size
    needs 19kb of memory.
    Multiply the images size by 5 to have a rough estimate what PicPoc will need for
    some operations (especially Fill and Filters).
    You can save memory by switching off UNDO and emptying the clipboard.

    When memory becomes short, strange things can happen. Usually an error message
    is given, but if memory becomes so short that even this is no longer possible,
    the system will panic - the drawing is lost.

	In such environments it is a good idea to save from time to time. Choose "Save as..",
	press ENTER, and answer Yes.

	In case of insufficient memory, PicPoc automatically clears the clipboard and
	UNDO buffer, before prompting the user with an error message.
	Choose "Continue" and save your work immediately.
	

Documentation
-------------

An extensive help file is supplied.

A printed manual is shipped on registration.



Acknowledgements
----------------
Thanks to Lonnie Dworkin for PATTERN2.
Thanks to Eberhard Rompf for PATTERN3-9.
The portrait in Examp1.PIC was taken by Johanna Hechfellner.
                        








