home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / artprint / artprint.doc next >
Text File  |  1992-09-18  |  12KB  |  240 lines
  1.  
  2.                           ARTPRINT program.
  3.  
  4.  Clip Art printing program by Peter D Hibbs.  Version 1.2  Oct 1991.
  5.  
  6. There are hundreds of clip-art  pictures  in  the public domain which may
  7. require dozens of disks for  storage.  It  is obviously very difficult to
  8. remember every one  and  which  file  it  is  in,  this  program allows a
  9. complete disk of picture files to be printed out in one session.
  10.  
  11. The program works only in high resolution mode and with most 9 pin and 24
  12. pin parallel  or  serial  printers.  Note  also  that  the  resource file
  13. ARTPRINT.RSC should also  be  present  in  the  same  folder  as the main
  14. program. The ARTPRINT.INF  set-up  file  should  be  present  in the root
  15. directory, if required, and is  loaded  automatically when the program is
  16. first loaded. If no  ARTPRINT.INF  file  is  present  the program default
  17. values are used, see below for further information.
  18.  
  19. When the program is run a menu  is displayed with nine main options which
  20. function as follows :-
  21.  
  22. (1)  Load clip-art picture.
  23.  
  24. Clicking on this button will display  the  standard file selector for the
  25. current drive. Select a clip art picture  file to be loaded in the normal
  26. way.
  27.  
  28. The program can load seven different picture file formats as follows :-
  29.  
  30.    .PI3   Degas high resolution.
  31.    .PC3   Degas high resolution compressed.
  32.    .ART   ArtiST public domain drawing program.
  33.    .DOO   Dr Doodle public domain drawing program.
  34.    .IMG   High resolution image files.
  35.    .TN3   High resolution Tiny compressed files.
  36.    .TNY   High resolution Tiny compressed files.
  37.  
  38. If a file with some other  extension  is selected, the program warns that
  39. it is not a  recognised  file  format  and  gives  the  option to load it
  40. anyway. If the file is loaded  it  is  stored and displayed as a straight
  41. binary file, this may show  a  picture  or  may  not depending on how the
  42. picture was stored. Note that  the  file  should  not  be larger than 33K
  43. bytes. If a .IMG file is loaded which is larger than the screen size, the
  44. top left corner of the total image will be displayed.
  45.  
  46. The file selector can be used to change  to a different drive or select a
  47. different folder. Note that if the picture  files are in a folder (rather
  48. than in the root directory) this  facility  should  be used to select the
  49. required folder. A picture in  the  folder  should  be  loaded to set the
  50. path-name for the current folder. When the search or print facilities are
  51. used, only the current folder is used (see later).
  52.  
  53. When the picture has been  loaded  the  file  selector is replaced by the
  54. picture image. To return to the main menu press the right mouse button.
  55.  
  56.  
  57. (2) Find clip-art picture.
  58.  
  59. To search for a particular picture  on  the  disk click on this button. A
  60. new form will be displayed which shows  the current drive and the current
  61. folders path-name  (if  any).  Click  on  CONTINUE  to  start  the search
  62. sequence or CANCEL to return to the main menu.
  63.  
  64. The pictures on the disk will be  displayed  one after the other with the
  65. filename shown in inverse video at  the  bottom  of the screen. Press the
  66. SPACE-BAR (or left button) to pause on  a picture and then the RETURN key
  67. (or left button) to continue the search or press the ESCAPE key (or right
  68. button) to return to the main  menu.  Note  that if the mouse buttons are
  69. used they must be held down  longer  since  the operating system does not
  70. store the operation as it does for the keyboard.
  71.  
  72. If the pictures are being  loaded  from  a  hard  disk  (or RAM disk) the
  73. display time may be too short to see each picture properly. Pressing keys
  74. 0-9 will insert a delay between each picture load, 0 is the fastest and 9
  75. is the slowest.
  76.  
  77. If it is necessary to change  the  disk  during the search sequence first
  78. pause the scan (by  pressing  the  SPACE-BAR),  change  the disk and then
  79. press the RETURN key to resume the sequence.
  80.  
  81. If the pictures are in  a  folder,  the  folder path-name should first be
  82. initialised by loading a picture in, as mentioned above in option 1.
  83.  
  84. (3) Print current picture.
  85.  
  86. The current picture  can  be  printed  by  clicking  on  this button. The
  87. picture is printed out  four  times  actual  size,  that  is one pixel on
  88. screen is printed as four dots on the printer. If the PICTURE BORDER 'ON'
  89. button is highlighted, a border  is  drawn  around  the picture. See also
  90. options 7 and 8 for printer set ups.
  91.  
  92. (4) Print all pictures.
  93.  
  94. To print all or some  of  the  picture  files  click  on this button. The
  95. required drive should be first  selected  by  clicking on the appropriate
  96. drive button. A form  is  displayed  which  shows  the current drive (and
  97. path-name where appropriate). If the pictures are in a folder, the folder
  98. should be selected and  a  picture  loaded  in  as  described in option 1
  99. above. The title of the  disk  should  be  entered,  this name is printed
  100. (together with the filename) at the  top  of  each picture, this title is
  101. also displayed on the main menu for reference.
  102.  
  103. Now click on the 'SOME' or 'ALL' button, the screen is cleared and a form
  104. is displayed at the top of the screen together with all the valid picture
  105. files on the current disk. If 'SOME'  was selected, none of the files are
  106. ticked and if 'ALL' was  selected,  all  the  files are ticked. In either
  107. case, clicking on a filename will  display  or erase the tick against the
  108. file. Select (or deselect) the files required and then click on 'OK'. The
  109. pictures which have been ticked will  be  printed  out eight to a page in
  110. actual size, i.e. one pixel on screen  equals one dot on the printer. For
  111. 9 pin printers the pictures will  be  slightly distorted due to the lower
  112. resolution of these printers as compared with 24 pin printers.
  113.  
  114. The disk  title  and  the  filename  of  each  picture  will  be  printed
  115. immediately above each picture for easy  identification. Note that if the
  116. PICTURE BORDER 'ON' button is highlighted on the main menu, a border line
  117. will be drawn around  each  picture.  To  abort  the  print-out press the
  118. ESCAPE key. Note that not more than  100  pictures should be present on a
  119. disk (or in a folder) or the program may crash.
  120.  
  121. (5) Show current picture.
  122.  
  123. Click on this  button  to  remove  the  main  menu  and  show the current
  124. picture. Press the right mouse button to return to the main menu.
  125.  
  126. (6) Show in inverse video.
  127.  
  128. Click on this button to  invert  the  colours  black and white. This only
  129. works for the current picture in memory  and cannot be used when printing
  130. out all the picture files.
  131.  
  132. (7) Set up defaults.
  133.  
  134. To change the printer default settings  click  on  this button. A form is
  135. displayed showing the RS232, handshaking  and  printer type options. If a
  136. parallel printer is being used it is  not  necessary to change any of the
  137. RS 232 settings. If a serial  printer  is being used, the 'SERIAL' button
  138. should be clicked on together  with  the  required Baud rate, Parity mode
  139. and Handshaking mode buttons.
  140.  
  141. When printing out the pictures, the  left  margin and the gap between the
  142. pictures can be adjusted by entering new values into the form.
  143.  
  144. If these settings are  only  required  for  the current printing session,
  145. click on 'OK', if they are  to  be  used  every time the program is used,
  146. click on the 'SAVE' button. This  will  save  the current settings in the
  147. ARTPRINT.INF file which will  be  written  to  the  root directory of the
  148. current drive (first ensure that  the  disk with the ARTPRINT.PRG program
  149. is in the current  drive).  Note  that  if  an  ARTPRINT.INF file already
  150. exists, it will be over-written and  if  none  exists,  a new one will be
  151. created. When the program is first  loaded, the ARTPRINT.INF file is also
  152. loaded in to set up the defaults,  note  also that the printer codes (see
  153. next section) are also saved in the ARTPRINT.INF file.
  154.  
  155. The disk titles and filenames at the  top  of each picture are printed in
  156. condensed print and are in a fixed  position on the line. The position of
  157. the pictures beneath can be adjusted with 'Left margin' and 'Central gap'
  158. fields. These should be set  so  that  the  pictures are printed directly
  159. under the title text.
  160.  
  161. (8) Set up printer codes.
  162.  
  163. If the printer being used is not  a  Panasonic  KXP 1124 or 1624 click on
  164. this button  to  change  the  control  codes  sent  to  the  printer  (if
  165. necessary). Although the method  of  printing  text  and graphics data is
  166. fairly standard on most  printers,  the  actual  control  codes to set up
  167. various facilities may vary slightly.  Rather  than  use a printer driver
  168. system for every different printer  this  program  stores its own printer
  169. control codes which can be  configured  for  the printer being used. This
  170. does depend, however, on the standard  Epson  bit graphics mode for 9 and
  171. 24 pin printers, i.e. the graphics  code  followed by the number of bytes
  172. to be sent followed by the bit image  data for the current line. The user
  173. should consult his  printer  manual  for  the  relevant  control codes as
  174. described below.
  175.  
  176. Field 1 Printer name & number.
  177.  
  178. The printer type can be entered here  as  a reminder of which printer the
  179. program is configured for.
  180.  
  181. Field 2 Printer initialisation sequence.
  182.  
  183. These codes are sent to the printer at the start of each printing session
  184. and are used to initialise the printer, set the top of form and clear the
  185. printers internal print buffer if necessary. It could also be used to set
  186. the print style for the picture headings if required. Note that the codes
  187. must be in Hex format only,  this  and subsequent fields will only accept
  188. hex characters and the space character.  The  codes may be separated by a
  189. space for clarity although this is not necessary.
  190.  
  191. Field 3 Condensed print control code.
  192.  
  193. The text at the top of each picture is set to condensed type otherwise it
  194. would be larger than the picture width.
  195.  
  196. Field 4 Microline feed control code.
  197.  
  198. This code is used to move the paper  down  by a few lines after the title
  199. has been printed so that  the  picture  starts  just under the title. The
  200. code is followed by  the  distance  to  be  moved, (normally 5 microline-
  201. feeds).
  202.  
  203. Field 5 Unidirectional print control code.
  204.  
  205. This code sets the  printer  to  unidirectional  printing  to improve the
  206. print out quality and ensure that  the  lines are printed exactly beneath
  207. each other. It is sent to the printer at the start of each graphics line.
  208.  
  209. Field 6 Microline feed spacing code.
  210.  
  211. This sets the number of microline  feeds  that  is sent for each linefeed
  212. code and is always set to the number of pins, i.e. 24 (18 hex). For 9 pin
  213. printers the linefeed is set to 8 pins.
  214.  
  215. Field 7 Bit image control code.
  216.  
  217. This starts the bit image mode  in  180 dots/inch (24 pin Triple Density)
  218. and is followed by the number of rows of dots (640) and then the graphics
  219. data. For 9 pin printers the bit image mode should be set to quad density
  220. or else the image will be too big.
  221.  
  222. Some typical values for two printers  are shown below, if no ARTPRINT.INF
  223. file is present the Panasonic values are used.
  224.  
  225.              PRINTER- Panasonic KXP1124 (24 pin) Microline MP192 (9 pin)
  226.  
  227. Initialisation        18 1B 40                   18 1B 40
  228. Condensed print       0F                         0F
  229. Microline feed        1B 4A 05                   1B 4A 05
  230. Unidirectional        1B 55 01                   1B 55 31
  231. Microline feed space  1B 33 18                   1B 31
  232. Bit image control     1B 2A 27                   1B 5A
  233.  
  234. As described in the previous section, click on 'OK' to enable any changes
  235. or on 'SAVE' to save the changes to disk.
  236.  
  237. (9) Quit to desktop.
  238.  
  239. Click on this button to quit the program.
  240.