home *** CD-ROM | disk | FTP | other *** search
- PROGRAM LICENSE
- ===============
-
- PicPoc 2.2a is owned and
-
- (c)Copyright 1994,1995 by Berthold Daum.
-
- All Rights Reserved.
-
- This program is a shareware program. The future development
- of this program depends on the number of people registering.
-
- -------------------------------------
- ! Warning ! !
- ! The unregistered version of this !
- ! program cannot store bitmaps !
- ! larger than 48*48 pixels. !
- -------------------------------------
-
- Disclaimer
- ----------
-
- Although PicPoc has been extensively tested, the author shall not be
- responsible for any loss of any kind due to its use. It is the
- user's responsibility to establish the suitability of this
- software for any particular purpose.
-
-
- Registration
- ------------
-
- Please use ORDER.FRM.
- The registration fee is A$49.95 plus postage and handling.
-
- Please send your registration to:
-
- Berthold Daum
- lichtbild p/l
- 21 Margate St.
- Beaumaris, Vic. 3193
- Australia
-
- CompuServe 100026,3365
- INTERNET: 100026.3365@compuserve.com
-
-
- We supply you with a registration number via e-mail or by mail.
-
-
- NEW!!! Recommendation program
- -----------------------------
-
- We distribute our programs directly to offer you the lowest prices as
- possible. Direct distribution depends very much on mouth-to-mouth recommendation.
- We would like to acknowledge this fact by honouring the recommenation of our
- products. If you are a registered user of any of our products, and another
- user quotes your name when he registers, we will send you a floppy disc with
- the newest versions of the products you had registered absolutely free !
-
-
-
-
- PicPoc Version 2.2a - 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.
-
-
- Requirements
- ------------
-
- The installation routine informs of the size of each option.
- A full installation needs approx. 40k disk space.
-
- When active, the system requires >11k of memory depending on
- the size of the image.
-
-
- New in Version 2.1
- ------------------
-
- - A new shape: rhomb
- - Selectable and user definable shapes for pen, eraser and spray
- - The lupe has now a separate menu.
- - Pattern clusters can now be of any size.
- pattern height and size is a third of cluster height and width.
- This allows a lower pattern frequency.
- - Pressing the Shift key when using the cursor keys for scrolling
- tilts the cursor direction by 45 degrees against the clock.
- This makes it easy to
- draw diagonals, squares, "square" rhombs, and circles.
- - Definable background colour.
- - Insertion mode : set,delete,invert,replace.
- - view clipboard, clear clipboard (to save memory)
- - Undo can be switched off (to save memory)
- - extensive help system
-
- - Series 3a support
- - big screen size
- - support of colour grey in all operations
- - support of all internal fonts of Series 3a
- - S3a like user interface
-
- New in Version 2.15
- -------------------
-
- - Place operation (PSION-Shift-O)
- reads a new bitmap from a selected file and insert
- it at the cursor position. The place operation uses
- the insertion mode settings (set,delete,invert,replace)
- in "Preferences".
-
- New in Version 2.2
- ------------------
-
- - Print function (PSION-Shift-H)
- Prints graphic on Epson or HP compatible printers (see below)
- - Print setup (PSION-Shift-Y)
- - Save clipboard as bitmap file (PSION-Shift-A)
- - Use clipboard content as fill pattern
- - Apply filter (PSION-K) (see below)
- - Apply filter to clipboard (PSION-Shift-K)
- - Modifiable cursor size
- - Modifiable step width for PSION-key
- - Place operation can load single planes (black, grey)
- When a black/grey bitmap is placed into a black-only
- bitmap, grey will be simulated with a pattern.
- - New key combination: PSION-ENTER
- Positions cursor to top left corner
- Selects whole image for copy, cut, clear, filter.
-
- Printing graphics
- -----------------
-
- Graphics can be printed on Epson, HP, or compatible printers.
-
- Do not print graphical data through MCPRINT, as output may be garbled !
- Instead print through MCLINK:
- - Start RemoteLink on the palmtop.
- - Assign the host printer port as a printfile via PSION-Y (e.g. REM::LPT1 on a PC)
-
- Other platforms:
- - Set the printfile to a local file
- - after printing transfer this file to the host
- - then print the transferred file out (e.g. file type "Printout" on Acorn).
-
- However, you can also print to a directly connected printer.
-
-
- Filters
- -------
-
- Picpoc allows to apply predefined or user written filters to bitmap
- areas or to the clipboard.
-
- The following filters are delivered with PicPoc:
-
- ROTATE : Rotation 90, 180, 270 degree
- FLIP : Flip horizontal or vertical
- 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.
- REDUCE : Reduce by factor 2-8
- SKEW : Skew to the left, right, upwards, downwards in angles from 0-45 degree.
- SHADOW : Create grey shadows (pixel distance can be specified)
-
- To write user filters is quite simple. Each filter module must contain
- a procedure
-
- proc filter%:(indrw%,planes%)
-
- indrw% = handle of drawable containing input bitmap
- planes% = number of planes of drawable
-
- 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%:.
-
- 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
-
-
-
-
- Installation
- ============
-
- Host platforms
- --------------
-
- We deliver our products via email or on 3.5" floppy discs (1.44 MB IBM Format)
- On request we can send out 720 kB floppy discs.
- These formats can be read by PC, Mac, Amiga, Atari, Acorn.
-
- If you received the software via email or downloaded it from an electronic
- network you will received it in compressed format (PKZIPF). You will need
- the latest version of PKUNZIP to decompress the software.
-
- On the Macintosh do not use the standard UNZIP utility. Instead, use
- the ZIPIT utility which you will find on your network.
- In ZIPIT uncheck the box that says: "By default, smart-strip line feeds
- from text files."
-
- As a rule of thumb avoid options containing the word "smart".
-
-
- Installation from PC or Mac
- ---------------------------
-
- 1. Decompress the software (see above).
-
- 2. Connect your Series3 computer to your PC or Mac. Start MCLINK
- and activate "Remote link" from the PSIONs system screen.
-
- 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and
- press TAB. When the file selection screen appears, press TAB again.
- In the first line of the dialog box specify the name of the installation
- directory (where the new software is stored), e.g. REM::C:\CSERVE\DOWNLOAD\
- A file selection list appears.
-
- 4. Select the file !setup3.opa (first file). Press ENTER.
- SetUp3 now takes control. The screen goes blank for a few seconds. Don't panic.
- A file selector box appears.
-
- 5. If the file selector box shows the product name, just press ENTER.
- If the file selector box shows a language, choose a language of your choice.
- If your language is not mentioned, select "international", which is English.
-
- 6. The file transfer starts. If the product was installed before,
- SetUp3 will start a dialog asking you if you want to
- (Continue) = Overwrite existing version
- (Other drive) = Install new version on different drive
- (Options only) = Install options you did not install the first time.
-
- 7. SetUp3 asks you on which drive you want to install the software
- and on which drive you usually keep your data.
- We recommend flash memory for the system and usually RAM for data.
-
- 9. SetUp3 will ask you about optional modules. You can decide to install
- them now, or you can leave it for later.
-
- 10.SetUp3 will give instructions on how to proceed after the successful
- transfer.
-
-
- Installation from other platforms
- ---------------------------------
-
- On other platforms than PC or Mac there are two possibilities:
-
- A) You have enough free memory, preferably on internal memory, RAM or a spare Flash pack.
- Proceed as follows:
-
- 1. Decompress the software (see above).
-
- 2. Transfer the whole installation folder to a new installation folder on
- the palmtop (M:\INSTAL\ for instance).
- However, there is no need to tranfer *.ZIP, *.TXT, and *.FRM files, so you may
- leave these ones out.
-
- 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and
- press TAB. When the file selection screen appears, navigate to the new
- installation folder on the palmtop.
- Continue as described above under (4).
- After installation is completed remove the installation folder from the palmtop.
-
-
- B) If you do not have so much memory an assisted manual installation is still possible.
- Proceed as follows:
-
- 1. Decompress the software (see above).
-
- 2. Connect your Series3 computer to your host computer. Start the host
- communications software and activate "Remote link" from the PSIONs system screen.
-
- 3. Copy !setup3.opa into M:\APP\ .
- Copy a *.ipf file of your choice into M:\APP\ .
- Install !setup3 to the system screen (see user manual).
-
- 4. Activate !setup3 by positioning the highlight under it and pressing ENTER.
- A file selector box appears.
-
- 5. Acknowledge the file selector box by pressing ENTER.
-
- 6. The installation begins. If the product was installed before,
- SetUp3 will start a dialog asking you if you want to
- (Continue) = Overwrite existing version
- (Other drive) = Install new version on different drive
- (Options only) = Install options you did not install the first time.
-
- 7. SetUp3 asks you on which drive you want to install the software
- and on which drive you usually keep your data.
- We recommend flash memory for the system and usually RAM for data.
-
- 9. SetUp3 will ask you about optional modules. You can decide to install
- them now, or you can leave it for later.
-
- 10.SetUp3 will ask you to copy files from the installation directory
- on the host computer to a target destination on the PSION.
- Start the file transfer from your host computer. When the file has
- been transmitted, acknowledge be pressing ENTER on the PSION.
-
- 11.SetUp3 will give instructions on how to proceed after the successful
- transfer.
-
-
- When things go wrong
- --------------------
-
- If the installation does not run smoothly, do not try to install
- manually. The chance is, that if Setup3 or the installation control (IPF)
- file was corrupted, that other modules are corrupted, too.
-
- Please read the instructions again and repeat installation.
-
- You could also try to use a lower transmission speed between host and PSION.
-
- If the problem should persist, check for data corruption.
- Order another floppy disc, or download again.
-
- If the problem still persists, please seek our advice.
-
-
- Morpheus
- --------
-
- Please do not send us questions "What is Morpheus". Instead read this:
-
- One of the tricky things when writing OPL-applications is the HELP-key.
- For instance, it is not possible to react to the HELP-key when a menu
- or a dialog box is on the screen, which is not very nice, because you
- may want help to fill out that dialog box.
-
- That is the reason why we created Morpheus. Morpheus is a independent
- application which runs in the background and intercepts the HELP-key.
- Morpheus checks which application is in the foreground and will then
- display the appropriate help texts.
-
- The other function of Morpheus is to handle alarms (for the products
- ProPoc and HyperPoc). It can do this better than the Agenda.
-
- Morpheus is launched automatically by any application that uses Morpheus'
- services. Morpheus will stay active as long as a client application is
- active or any Morpheus-alarms are scheduled. (The actual shutdown may
- be delayed for 1 minute). So, usually you don't have to shutdown
- Morpheus manually.
-
- One of the beauties of the system is that Morpheus can serve many masters.
- So if you use some of our products simultanously, still only one
- copy of Morpheus will be active.
-
- All our installations install Morpheus to the internal drive even if
- you have chosen another system drive, because that is the best place.
- Installing Morpheus to an SSD would cause later problems, because you
- would not be able to reformat that disk without stopping Morpheus manually.
-
- If you must, here is the way:
-
- Install Morpheu2 to the system screen (see user manual)
- Then press PSION-Z(S3) or SHIFT-PSION-X(S3a) to kill Morpheus.
- If Morpheus was running it will respond with a beep and will die.
- Deinstall Morpheus (see user manual).
-
- Deinstallation
- --------------
-
- To deinstall the application from you palmtop proceed as follows.
-
- 1. First backup your system.
-
- 2. If you don't have other applications that use Morpheus:
- Stop Morpheus as described above.
- Remove MORPHEU2.OPA and folder \MORPHEU2 from the folder M:\APP.
-
- 3. n.a.
-
- 4. If you do not have other applications from us (POC-appications)
- remove the folder \APP\COMMON from the system drive.
-
- 5. Remove the file PICPOC.OPA and the folder PICPOC from
- the folder APP on the system drive.
-
- 6. Remove the datafolders PIC from the data drive(s).
-
- 7. Remove the license file PICPOC.$$$ from the root directory M:\
-
-
-
-
- Documentation
- -------------
-
- An extensive help file is supplied. A printed manual comes with
- registration.
-
- A printer manual is send on registration.
-
-
-
- Acknowledgements
- ----------------
- Thanks to Lonnie Dworkin for PATTERN2.
- Thanks to Eberhard Rompf for PATTERN3-9.
-
-
-
-
-
-
-
-
-
-