home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / pic3a / README.TXT < prev    next >
Encoding:
Text File  |  1995-01-15  |  15.0 KB  |  436 lines

  1.                      PROGRAM LICENSE
  2.                      ===============
  3.  
  4. PicPoc 2.2a is owned and 
  5.  
  6.    (c)Copyright 1994,1995 by Berthold Daum.
  7.  
  8. All Rights Reserved.
  9.  
  10. This program is a shareware program. The future development
  11. of this program depends on the number of people registering.
  12.  
  13.          -------------------------------------
  14.          !           Warning !               !
  15.          ! The unregistered version of this  !
  16.          ! program cannot store bitmaps      !
  17.          ! larger than 48*48 pixels.         !
  18.          -------------------------------------
  19.  
  20. Disclaimer
  21. ----------
  22.  
  23. Although PicPoc has been extensively tested, the author shall not be
  24. responsible for any loss of any kind due to its use. It is the
  25. user's responsibility to establish the suitability of this
  26.      software for any particular purpose.
  27.  
  28.  
  29. Registration
  30. ------------
  31.                     
  32. Please use ORDER.FRM.
  33. The registration fee is A$49.95 plus postage and handling.
  34.  
  35. Please send your registration to:
  36.  
  37.                         Berthold Daum
  38.             lichtbild p/l
  39.                         21 Margate St.
  40.                         Beaumaris, Vic. 3193
  41.                         Australia
  42.  
  43.             CompuServe 100026,3365
  44.             INTERNET: 100026.3365@compuserve.com
  45.  
  46.  
  47. We supply you with a registration number via e-mail or by mail.
  48.  
  49.  
  50. NEW!!! Recommendation program
  51. -----------------------------
  52.  
  53. We distribute our programs directly to offer you the lowest prices as
  54. possible. Direct distribution depends very much on mouth-to-mouth recommendation.
  55. We would like to acknowledge this fact by honouring the recommenation of our
  56. products. If you are a registered user of any of our products, and another
  57. user quotes your name when he registers, we will send you a floppy disc with
  58. the newest versions of the products you had registered absolutely free !
  59.  
  60.  
  61.  
  62.  
  63.                PicPoc Version 2.2a - Release Notes
  64.                ===================================
  65.  
  66. Program Description
  67. -------------------
  68.  
  69. Advanced painting tool for PSION Series 3a computers.
  70.  
  71. Includes features such as:
  72.  Polyline, Rectangle, Rhomb, Ellipse, Text, Pen, Eraser, Fill,
  73.  Spray, Lupe, Undo, Copy, Cut, Paste, adjustable pen, eraser,
  74.  and spray size, different text fonts and styles, different and user
  75.  definable fill patterns, scrolling in large bitmaps.
  76.  
  77.  
  78. Platforms
  79. ---------
  80.  
  81.  This program runs on PSION S3a and ACORN PocketBook II computers.
  82.  
  83.  
  84. Requirements
  85. ------------
  86.  
  87.  The installation routine informs of the size of each option. 
  88.  A full installation needs approx. 40k disk space.
  89.  
  90.  When active, the system requires >11k of memory depending on 
  91.  the size of the image.
  92.  
  93.  
  94. New in Version 2.1
  95. ------------------
  96.  
  97.         - A new shape: rhomb
  98.         - Selectable and user definable shapes for pen, eraser and spray
  99.         - The lupe has now a separate menu.
  100.         - Pattern clusters can now be of any size.
  101.           pattern height and size is a third of cluster height and width.
  102.           This allows a lower pattern frequency.
  103.         - Pressing the Shift key when using the cursor keys for scrolling
  104.           tilts the cursor direction by 45 degrees against the clock. 
  105.           This makes it easy to 
  106.           draw diagonals, squares, "square" rhombs, and circles.
  107.         - Definable background colour.
  108.         - Insertion mode : set,delete,invert,replace.
  109.         - view clipboard, clear clipboard (to save memory)
  110.         - Undo can be switched off (to save memory)
  111.         - extensive help system
  112.  
  113.         - Series 3a support
  114.             - big screen size
  115.             - support of colour grey in all operations
  116.             - support of all internal fonts of Series 3a
  117.             - S3a like user interface
  118.             
  119. New in Version 2.15
  120. -------------------
  121.  
  122.         - Place operation (PSION-Shift-O)
  123.           reads a new bitmap from a selected file and insert
  124.           it at the cursor position. The place operation uses
  125.           the insertion mode settings (set,delete,invert,replace)
  126.           in "Preferences".
  127.  
  128. New in Version 2.2
  129. ------------------
  130.  
  131.         - Print function (PSION-Shift-H)
  132.             Prints graphic on Epson or HP compatible printers (see below)
  133.         - Print setup (PSION-Shift-Y)
  134.         - Save clipboard as bitmap file (PSION-Shift-A)
  135.         - Use clipboard content as fill pattern
  136.         - Apply filter (PSION-K) (see below)
  137.         - Apply filter to clipboard (PSION-Shift-K)
  138.         - Modifiable cursor size
  139.         - Modifiable step width for PSION-key
  140.         - Place operation can load single planes (black, grey)
  141.           When a black/grey bitmap is placed into a black-only
  142.           bitmap, grey will be simulated with a pattern.
  143.         - New key combination: PSION-ENTER
  144.           Positions cursor to top left corner
  145.           Selects whole image for copy, cut, clear, filter.
  146.  
  147. Printing graphics
  148. -----------------
  149.  
  150.   Graphics can be printed on Epson, HP, or compatible printers.
  151.   
  152.   Do not print graphical data through MCPRINT, as output may be garbled !
  153.   Instead print through MCLINK:
  154.   - Start RemoteLink on the palmtop.
  155.   - Assign the host printer port as a printfile via PSION-Y (e.g. REM::LPT1 on a PC)
  156.  
  157.   Other platforms:
  158.   - Set the printfile to a local file
  159.   - after printing transfer this file to the host
  160.   - then print the transferred file out (e.g. file type "Printout" on Acorn).
  161.  
  162.   However, you can also print to a directly connected printer.
  163.   
  164.  
  165. Filters
  166. -------
  167.  
  168.   Picpoc allows to apply predefined or user written filters to bitmap
  169.   areas or to the clipboard.
  170.   
  171.   The following filters are delivered with PicPoc:
  172.   
  173.      ROTATE  : Rotation 90, 180, 270 degree
  174.      FLIP    : Flip horizontal or vertical
  175.      ENLARG  : Enlarges or stretch by factor 2-8
  176.                Useful to convert S3 icons into S3a icons.
  177.                Copy icon into clipboard, apply ENLARG filter to
  178.                clipboard, and insert into new bitmap.
  179.      REDUCE  : Reduce by factor 2-8
  180.      SKEW    : Skew to the left, right, upwards, downwards in angles from 0-45 degree.
  181.      SHADOW  : Create grey shadows (pixel distance can be specified)
  182.  
  183.   To write user filters is quite simple. Each filter module must contain
  184.   a procedure
  185.  
  186.             proc filter%:(indrw%,planes%)
  187.  
  188.                     indrw% = handle of drawable containing input bitmap
  189.                     planes% = number of planes of drawable
  190.  
  191.                     The filter procedure must create a new drawable
  192.                     with the same number of planes. The new drawable
  193.                     contains the modified bitmap. The handle of this
  194.                     drawable is returned as the result of filter%:.
  195.  
  196.                     If you had created other drawables during the
  197.                     filter operation make sure to close them before
  198.                     leaving the filter.
  199.  
  200.    Then translate the filter and install the resulting OPO-module
  201.    into folder \APP\PICPOC\FILTER\ .
  202.    
  203.    Examples: FLIP.OPL and SHADOW.OPL
  204.           
  205.  
  206.  
  207.  
  208.                                 Installation
  209.                                 ============
  210.  
  211. Host platforms
  212. --------------
  213.  
  214.         We deliver our products via email or on 3.5" floppy discs (1.44 MB IBM Format)
  215.         On request we can send out 720 kB floppy discs.
  216.         These formats can be read by PC, Mac, Amiga, Atari, Acorn.
  217.  
  218.         If you received the software via email or downloaded it from an electronic
  219.         network you will received it in compressed format (PKZIPF). You will need
  220.         the latest version of PKUNZIP to decompress the software.
  221.  
  222.         On the Macintosh do not use the standard UNZIP utility. Instead, use
  223.         the ZIPIT utility which you will find on your network.
  224.         In ZIPIT uncheck the box that says: "By default, smart-strip line feeds
  225.         from text files."
  226.  
  227.         As a rule of thumb avoid options containing the word "smart".
  228.  
  229.  
  230. Installation from PC or Mac
  231. ---------------------------
  232.  
  233. 1. Decompress the software (see above).
  234.  
  235. 2. Connect your Series3 computer to your PC or Mac. Start MCLINK
  236.    and activate "Remote link" from the PSIONs system screen.
  237.  
  238. 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and
  239.    press TAB. When the file selection screen appears, press TAB again.
  240.    In the first line of the dialog box specify the name of the installation
  241.    directory (where the new software is stored), e.g. REM::C:\CSERVE\DOWNLOAD\
  242.    A file selection list appears.
  243.  
  244. 4. Select the file !setup3.opa (first file). Press ENTER. 
  245.    SetUp3 now takes control. The screen goes blank for a few seconds. Don't panic.
  246.    A file selector box appears.
  247.  
  248. 5. If the file selector box shows the product name, just press ENTER.
  249.    If the file selector box shows a language, choose a language of your choice.
  250.    If your language is not mentioned, select "international", which is English.
  251.  
  252. 6. The file transfer starts. If the product was installed before,
  253.    SetUp3 will start a dialog asking you if you want to
  254.      (Continue)     = Overwrite existing version
  255.      (Other drive)  = Install new version on different drive
  256.      (Options only) = Install options you did not install the first time.
  257.  
  258. 7. SetUp3 asks you on which drive you want to install the software
  259.    and on which drive you usually keep your data.
  260.    We recommend flash memory for the system and usually RAM for data.
  261.  
  262. 9. SetUp3 will ask you about optional modules. You can decide to install
  263.    them now, or you can leave it for later.
  264.  
  265. 10.SetUp3 will give instructions on how to proceed after the successful
  266.    transfer.
  267.  
  268.  
  269. Installation from other platforms
  270. ---------------------------------
  271.  
  272. On other platforms than PC or Mac there are two possibilities:
  273.  
  274. A) You have enough free memory, preferably on internal memory, RAM or a spare Flash pack.
  275.    Proceed as follows:
  276.  
  277. 1. Decompress the software (see above).
  278.    
  279. 2. Transfer the whole installation folder to a new installation folder on
  280.    the palmtop (M:\INSTAL\ for instance).
  281.    However, there is no need to tranfer *.ZIP, *.TXT, and *.FRM files, so you may
  282.    leave these ones out.
  283.  
  284. 3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and
  285.    press TAB. When the file selection screen appears, navigate to the new
  286.    installation folder on the palmtop.
  287.    Continue as described above under (4).
  288.    After installation is completed remove the installation folder from the palmtop.
  289.  
  290.  
  291. B) If you do not have so much memory an assisted manual installation is still possible.
  292.    Proceed as follows:
  293.  
  294. 1. Decompress the software (see above).
  295.  
  296. 2. Connect your Series3 computer to your host computer. Start the host
  297.    communications software and activate "Remote link" from the PSIONs system screen.
  298.  
  299. 3. Copy !setup3.opa into M:\APP\ .
  300.    Copy a *.ipf file of your choice into M:\APP\ .
  301.    Install !setup3 to the system screen (see user manual).
  302.  
  303. 4. Activate !setup3 by positioning the highlight under it and pressing ENTER.
  304.    A file selector box appears.
  305.  
  306. 5. Acknowledge the file selector box by pressing ENTER.
  307.  
  308. 6. The installation begins. If the product was installed before,
  309.    SetUp3 will start a dialog asking you if you want to
  310.      (Continue)     = Overwrite existing version
  311.      (Other drive)  = Install new version on different drive
  312.      (Options only) = Install options you did not install the first time.
  313.  
  314. 7. SetUp3 asks you on which drive you want to install the software
  315.    and on which drive you usually keep your data.
  316.    We recommend flash memory for the system and usually RAM for data.
  317.  
  318. 9. SetUp3 will ask you about optional modules. You can decide to install
  319.    them now, or you can leave it for later.
  320.  
  321. 10.SetUp3 will ask you to copy files from the installation directory
  322.    on the host computer to a target destination on the PSION.
  323.    Start the file transfer from your host computer. When the file has
  324.    been transmitted, acknowledge be pressing ENTER on the PSION.
  325.  
  326. 11.SetUp3 will give instructions on how to proceed after the successful
  327.    transfer.
  328.  
  329.  
  330. When things go wrong
  331. --------------------
  332.  
  333. If the installation does not run smoothly, do not try to install
  334. manually. The chance is, that if Setup3 or the installation control (IPF)
  335. file was corrupted, that other modules are corrupted, too.
  336.  
  337. Please read the instructions again and repeat installation.
  338.  
  339. You could also try to use a lower transmission speed between host and PSION.
  340.  
  341. If the problem should persist, check for data corruption.
  342. Order another floppy disc, or download again.
  343.  
  344. If the problem still persists, please seek our advice.
  345.  
  346.  
  347. Morpheus
  348. --------
  349.  
  350. Please do not send us questions "What is Morpheus". Instead read this:
  351.  
  352. One of the tricky things when writing OPL-applications is the HELP-key.
  353. For instance, it is not possible to react to the HELP-key when a menu
  354. or a dialog box is on the screen, which is not very nice, because you
  355. may want help to fill out that dialog box.
  356.  
  357. That is the reason why we created Morpheus. Morpheus is a independent
  358. application which runs in the background and intercepts the HELP-key.
  359. Morpheus checks which application is in the foreground and will then
  360. display the appropriate help texts.
  361.  
  362. The other function of Morpheus is to handle alarms (for the products
  363. ProPoc and HyperPoc). It can do this better than the Agenda.
  364.  
  365. Morpheus is launched automatically by any application that uses Morpheus'
  366. services. Morpheus will stay active as long as a client application is
  367. active or any Morpheus-alarms are scheduled. (The actual shutdown may
  368. be delayed for 1 minute). So, usually you don't have to shutdown
  369. Morpheus manually.
  370.  
  371. One of the beauties of the system is that Morpheus can serve many masters.
  372. So if you use some of our products simultanously, still only one
  373. copy of Morpheus will be active.
  374.  
  375. All our installations install Morpheus to the internal drive even if
  376. you have chosen another system drive, because that is the best place.
  377. Installing Morpheus to an SSD would cause later problems, because you
  378. would not be able to reformat that disk without stopping Morpheus manually.
  379.  
  380. If you must, here is the way:
  381.  
  382.           Install Morpheu2 to the system screen (see user manual)
  383.           Then press PSION-Z(S3) or SHIFT-PSION-X(S3a) to kill Morpheus.
  384.           If Morpheus was running it will respond with a beep and will die.
  385.           Deinstall Morpheus (see user manual).
  386.  
  387. Deinstallation
  388. --------------
  389.  
  390. To deinstall the application from you palmtop proceed as follows.
  391.  
  392. 1. First backup your system.
  393.  
  394. 2. If you don't have other applications that use Morpheus:
  395.    Stop Morpheus as described above.
  396.    Remove MORPHEU2.OPA and folder \MORPHEU2 from the folder M:\APP.
  397.  
  398. 3. n.a.
  399.  
  400. 4. If you do not have other applications from us (POC-appications)
  401.    remove the folder \APP\COMMON from the system drive.
  402.  
  403. 5. Remove the file PICPOC.OPA and the folder PICPOC from 
  404.    the folder APP on the system drive.
  405.  
  406. 6. Remove the datafolders PIC from the data drive(s).
  407.  
  408. 7. Remove the license file PICPOC.$$$ from the root directory M:\
  409.  
  410.  
  411.  
  412.  
  413. Documentation
  414. -------------
  415.  
  416. An extensive help file is supplied. A printed manual comes with
  417. registration.
  418.  
  419. A printer manual is send on registration.
  420.  
  421.  
  422.  
  423. Acknowledgements
  424. ----------------
  425. Thanks to Lonnie Dworkin for PATTERN2.
  426. Thanks to Eberhard Rompf for PATTERN3-9.
  427.                         
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.