home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / UTILITYS / PMEDIT29.ARC / PMEDIT.DOC next >
Text File  |  1991-11-17  |  7KB  |  202 lines
  1.         PMEDIT - a graphics editor for Microbee Printmaster files
  2.  
  3.              By    John Arnold
  4.             36 Victoria Road,
  5.             ROOTY HILL  2766
  6.  
  7.     Copyright (C) 1988 by John Arnold
  8.  
  9.     This version (2.9) is released as Shareware (if you like it and keep
  10.     it then a donation of $5 would be appreciated payable to the above)
  11.     and may be freely distributed so long as no charge is made for such
  12.     distribution and this documentation is included.
  13.         
  14.  
  15.         DISCLAIMER
  16.  
  17.     It is the responsibility of the purchaser to determine the
  18.     suitability of this software for his or her use.
  19.  
  20.  
  21.         TRADEMARKS
  22.  
  23.     Microbee is a trademark of Microbee Systems Limited.
  24.  
  25.     Printmaster is a trademark of Unison World Inc.
  26.  
  27.  
  28.         INTRODUCTION
  29.  
  30.     PRINTMASTER does not allow modification or creation of graphic shapes
  31.     on a Microbee computer.
  32.  
  33.     PMEDIT is a graphics editor for use with all MICROBEEs (64K, 128K 
  34.     standard and Premiums, and 256TC) and allows the user to Create new 
  35.     or Modify existing `graphics pictures' for use with PRINTMASTER. It 
  36.     is `user friendly', features extensive editing features including 
  37.     Line and Circle (including elipse) drawing, invert and flip picture, 
  38.     and allows input from keyboard as well as joystick.
  39.  
  40.     Associated files for graphic pictures as supplied on your PRINTMASTER    disk are SLIB.SDR and SLIB.SHP. ULIB.SDR and ULIB.SHP are supplied on 
  41.     PRINTMASTER ART GALLERY disks.   PMEDIT will create ART GALLERY files
  42.     (ULIB) on disks when no .SDR and .SHP files are found.
  43.  
  44.     NOTE - PRINTMASTER  expects to find ART GALLERY (ULIB) files when the
  45.     user attempts to `Choose a graphic from another disk'.
  46.  
  47.  
  48.         RUN INSTRUCTIONS
  49.  
  50.     To run PMEDIT either select PMEDIT from the SHELL or enter the 
  51.         command:
  52.             PMEDIT
  53.  
  54.     If your Microbee has 128K RAM or greater the system will prompt -
  55.         Enter drive for data disk A-M
  56.     to allow you to select which drive you want to use for retrieving and
  57.     saving Printmaster pictures. You must insert the disk containing your
  58.     `picture' files in the disk selected when directed to do so by PMEDIT.
  59.  
  60.  
  61.         RUN COMMANDS
  62.  
  63.     Most Commands are displayed on the right side of the screen.
  64.     The full list of commands are -
  65.  
  66.             ^E (CTRL E)    move cursor up.    } use 
  67.             ^S        move cursor left.  } `cursor control'
  68.             ^D        move cursor right. } keys on 
  69.             ^X        move cursor down.  } Premium series
  70.             T        toggle dot on/off.
  71.  
  72.                 E        Set ERASE mode
  73.                 D        Set DRAW mode
  74.                 M        Set MOVE mode
  75.             *  <BACK SPACE>    clear screen.
  76.             M        Set Marker - marker flashes on screen
  77.                         at double cursor flash rate.
  78.                         When Marker is set the screen
  79.                         is also saved for Undo.
  80.             L        Draw Line from Marker to cursor.
  81.             C        Draw Circle with centre at Marker.
  82.                     Note when the cursor in not 45 
  83.                     degrees from the Marker then an 
  84.                     elipse rather than a circle will be
  85.                     drawn.
  86.             I        Invert picture.
  87.             H        Flip picture horizontally.
  88.             U        Undo (return screen contents to what
  89.                                                 it was when last M or ^U).
  90.                ^U        Store current screen (for Undo).
  91.  
  92.                 S         Save picture to disk.
  93.             *   R        Retrieve existing picture from disk.
  94.  
  95.             *  <ESC>        Quit (also returns control to 
  96.                           previous action at any prompt).
  97.  
  98.     When  commands marked with an asterisk (*) are used  and  the screen
  99.     contains a picture which has been worked on and not Saved to disk 
  100.     the system will prompt the user -
  101.             Save changes?
  102.     thus preventing the accidental loss of a picture.
  103.  
  104.     Multiple `cursor direction' keys may be held down at the same time to
  105.     move diagonally and the `toggle key' may also be held down at the 
  106.     same time as the cursor is moved. A joystick may be used to move the
  107.     cursor and toggle points.
  108.  
  109.  
  110.         FILE ACCESSES (R and S)
  111.  
  112.     The files which contain the `graphic shape names' and associated 
  113.     shape data are SLIB.SDR and SLIB.SHP and were supplied on your 
  114.     original PRINTMASTER disk. ULIB.SDR and ULIB.SHP also contain 
  115.     similar data and are found on PRINTMASTER ART GALLERY disks.
  116.  
  117.     PMEDIT will ALWAYS attempt to access SLIB.SDR (and SLIB.SHP) before
  118.     attempting to access ULIB.SDR (and ULIB.SHP).
  119.  
  120.  
  121.         RETRIEVING PICTURES (R)
  122.  
  123.     On input of  R  the system prompts the user to  `Insert data disk in
  124.     drive * and press <CR>'  (*  is the disk initially selected).  The
  125.     system then searches the disk for SLIB.SDR or ULIB.SDR . If found
  126.     a menu of the `pictures' currently in the file  is displayed.  To
  127.     select a `picture' use the cursor `up' and `down' keys  to move the
  128.     `cursor' ( >    < ) up and down the columns and  <RETURN> to select
  129.     the `picture' required.  To view the  next screen full of `picture
  130.     names' select NEXT PAGE (last name on screen).
  131.  
  132.  
  133.         SAVING PICTURES (S)
  134.  
  135.     On input of   S   and an  existing picture was used to create the
  136.     current picture on the screen the system prompts -
  137.         <M>odify existing or <C>reate new picture
  138.       If  M  is  entered then the existing picture data in the file is
  139.       overwritten. If C is entered then the system prompts -
  140.         Enter graphic name
  141.       and then prompts -
  142.         Insert data disk into drive * and press <CR>  (return)
  143.       and then searches for a SLIB or ULIB file and adds the picture to
  144.       the file found (duplicate graphic names not permitted) or creates
  145.       ULIB files if no files are found.
  146.       Note the disk should NOT be changed if Modifying an existing 
  147.           `picture'.
  148.  
  149.     On input of  S  and an existing picture was NOT used to create the
  150.     current picture on the screen the system prompts for a graphic name
  151.     and to insert data disk into drive * (as above) and adds the picture
  152.     to the file found. ULIB files are created if no files are found.
  153.  
  154.  
  155.  
  156.     ERROR MESSAGES         ACTION
  157.  
  158.     Directory full        Save picture on another disk.
  159.  
  160.     Disk full        Save picture on another disk.
  161.  
  162.     File write error    Try another disk.
  163.  
  164.     Files write protected    `Create' picture on another disk.
  165.  
  166.     Name already exists    Enter a different name.
  167.  
  168.     No data files found    Try another disk.
  169.  
  170.     Picture not found    `Graphic' selected not found - due to
  171.                 corrupted .SHP file.
  172.  
  173.     Shape (.SHP) file    SLIB.SDR or ULIB.SDR found on disk without
  174.     not found        accompaning .SHP file.
  175.  
  176.     .SHP without .SDR    Save picture on another disk.
  177.  
  178.     .SDR without .SHP    Save picture on another disk.
  179.  
  180.     Unable to close file    Move disk write protect device (slide).
  181.  
  182.  
  183.  
  184.  
  185.     Modification history
  186.  
  187.     Version        Date    Details
  188.  
  189.       2.1          14-1-88  Original
  190.       2.3          18-4-88  Allow space in picture file name
  191.           2.4          26-4-88  Delay after toggle
  192.           2.5          28-4-88  Check for read only files
  193.                                 Allow use of cursor control keys
  194.                                 Check for 128K memory and allow selection
  195.                 of disk drive
  196.           2.6          15-5-88  HIRES picture added to screen
  197.                 Test for BIOS version 4
  198.           2.7          29-6-88  Variable cursor speed
  199.                 Fix keyboard scan for 256C model
  200.           2.8           1-8-88  Display X,Y coordinates of cursor
  201.       2.9           15-9-91  Released as ShareWare
  202.