home *** CD-ROM | disk | FTP | other *** search
/ SDN¹ Plus / SDN1_.cdr / sdn / grap / art2wp.sdn / ART2WP.DOC next >
Text File  |  1989-02-13  |  8KB  |  250 lines
  1.  
  2. ART2WP V1.3 First Publisher ClipArt to  Word Processor Image File Translator
  3.                      Copyright 1989 by William J. Hinkle
  4.  
  5.                             === User's Guide === 
  6.  
  7. The ART2WP program was created to allow clip art files created through the 
  8. PFS:First Publisher desktop publishing program to be used by word processing 
  9. programs that handle graphics, and in other graphics programs.  To do this, 
  10. ART2WP translates these ART files into any of several other graphics file 
  11. formats.  You can translate to:
  12.  
  13. * .WPG files (Word Perfect 5 graphics format)
  14. * .TIF files (Aldus/Microsoft TIFF format)
  15. * .BIT or .RLE files (Lotus Manuscript graphics format)
  16. * .IMG files (GEM Paint format)
  17. * .GIF files (CompuServe Graphics Interchange Format)
  18.  
  19. The translator is a single file: ART2WP.EXE.  The default translation is to 
  20. Word Perfect 5 (.WPG) format
  21.  
  22. ==============
  23. COPYRIGHT INFO
  24. ==============
  25. This utility program ART2WP.EXE was written by
  26.  
  27.     William J. Hinkle
  28.  
  29. who retains the copyright.  Copy and use the program freely.  Distribute
  30. it to whomever you want.  But:
  31.  
  32. === Do NOT distribute modified versions.
  33. === Do NOT remove the copyright notice.
  34. === ALWAYS distribute with the documentation.
  35.  
  36. If you feel that this program has been of some utility, please seriously 
  37. consider sending a contribution of up to $5.00 to help defray the CompuServe
  38. costs run up in developing this utility.  Please indicate if you desire a 
  39. written receipt.
  40.  
  41. William J. Hinkle
  42. 420 E.Boston Mills Rd.
  43. Hudson, OH 44236-1111
  44.  
  45.  
  46.  
  47. ===============
  48. BASIC OPERATION
  49. ===============
  50.  
  51. First create a PFS:First Publisher clip art file, which should have a .ART 
  52. extension on the filename.  These can be clipped from the .MAC art library 
  53. files, or perhaps obtained from local BBSs and other sources.
  54.  
  55. To create a .WPG file (the default), type in:
  56.  
  57. ART2WP fname1
  58. or
  59. ART2WP fname1.ART
  60. or
  61. ART2WP fname1.ART fname2.WPG
  62.  
  63. from the DOS command prompt.
  64.  
  65. * For "fname1", substitute the name of your clip art file, of course!
  66.  
  67. * The .ART and .WPG extensions are assumed if something else is not specified.
  68.  
  69. * The .WPG file name is made the same as the .ART file name if not otherwise 
  70. specified.  Specify a different "fname2" if desired.
  71.  
  72. * Full DOS pathnames can be specified.  If you enter a directory (ending in \) 
  73. or a drive (ending in :) for the second ("fname2") filename, the output file 
  74. will be placed on that path with the default filename; i.e, the input filename 
  75. with a .WPG extension.
  76.  
  77. The .ART file will be translated to a .WPG file.
  78.  
  79. The .ART file will not be erased.  You can also specify scaling factors, but
  80. the defaults work the best (see below).
  81.  
  82.  
  83.  
  84. ==================
  85. OTHER FILE FORMATS
  86. ==================
  87.  
  88. To create a new graphics file in one of the other supported formats, you must 
  89. specify the other format.  You have two ways to do this.  One way is to 
  90. specify the output filename ("fname2") with the appropriate extension.  The 
  91. other is to specify the special /f option switch that selects the desired
  92. format.  The second method is usually the best, because the .ART file's 
  93. filename is then automatically used for the output file.
  94.  
  95. Some examples:
  96.  
  97. ---
  98. * To get a Aldus/Microsoft TIFF file:
  99.  
  100. ART2WP fname1 /ft
  101. or
  102. ART2WP fname1.ART fname2.TIF
  103.  
  104. gives you a TIFF file.
  105.  
  106. ---
  107. * To get a Lotus Manuscript graphics file:
  108.  
  109. ART2WP fname1 /fb
  110. or
  111. ART2WP fname1.ART fname2.BIT
  112.  
  113. or, for RLE files, which are often smaller:
  114.  
  115. ART2WP fname1 /fr
  116. or
  117. ART2WP fname1.ART fname2.RLE
  118.  
  119. ---
  120. * To get a GEM Paint graphics file:
  121.  
  122. ART2WP fname1 /fi
  123. or
  124. ART2WP fname1.ART fname2.IMG
  125.  
  126. ---
  127. * To get a CompuServe GIF file:
  128.  
  129. ART2WP fname1 /fg
  130. or
  131. ART2WP fname1.ART fname2.GIF
  132.  
  133. ---
  134.  
  135.  
  136.  
  137. ==============
  138. COMPLEAT USAGE
  139. ==============
  140.  
  141. If you invoke ART2WP from DOS without any other parameters, it will display 
  142. the following help message.  This illustrates some of the other options you 
  143. can select with command line switches.
  144.  
  145. -----
  146. PFS:FP ART-to-WP Image File Translator: V1.3 ... Copyright 1989 by W.J.Hinkle
  147.  
  148.  
  149. Press a key to get a little help...
  150.  
  151. (...you press a key here, naturally!)
  152.  
  153. Usage: ART2WP fname1 [fname2] [option] [option] ...
  154. where: fname1.ART ... PFS: First Publisher ART input file
  155.        fname2.WPG ... Word Perfect 5 WPG output file (default: fname1.WPG)
  156.    or  fname2.TIF ... Aldus/Microsoft TIFF format output file
  157.    or  fname2.BIT ... Lotus Manuscript BIT format output file
  158.    or  fname2.RLE ... Lotus Manuscript RLE format output file
  159.    or  fname2.IMG ... GEM IMG format output file
  160.    or  fname2.GIF ... CompuServe GIF format output file
  161.        /xN        ... option: x density = N pixels-per-inch (default: 100)
  162.        /yN        ... option: y density = N lines-per-inch (default: per x)
  163.        /v         ... option: reverse video
  164.        /ft        ... option: force TIFF output file
  165.        /fb        ... option: force BIT (Lotus Manuscript) output file
  166.        /fr        ... option: force RLE (Lotus Manuscript) output file
  167.        /fi        ... option: force IMG (GEM) output file
  168.        /fg        ... option: force GIF (CompuServe) output file
  169.  
  170. Press a key to continue...
  171.  
  172. ART2WP is a translator from First Publisher ART image files
  173. to various word processor image file formats:
  174.  
  175. To Word Perfect 5 WPG files (this is the default)
  176. or Microsoft/Aldus TIFF files (fname2.TIF, or use /ft option),
  177. or Lotus Manuscript BIT/RLE files (fname2.BIT/RLE, or use /fb, /fr options).
  178. or GEM IMG files (fname2.IMG, or use /fi option).
  179. or CompuServe GIF files (fname2.GIF, or use /fg option).
  180.  
  181. PFS: First Publisher is a trademark of the Software Publishing Corporation.
  182. Word Perfect is a trademark of the Word Perfect Corporation.
  183. Manuscript is a trademark of the Lotus Development Corporation.
  184. GEM is a trademark of the Digital Research Corporation.
  185. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc.
  186.  
  187. Shareware by: William J. Hinkle CIS [71121,3211]
  188.  
  189. (followed by some shareware info...)
  190.  
  191. -----
  192.  
  193.  
  194.  
  195. =============
  196. REVERSE VIDEO
  197. =============
  198.  
  199. Normally ART2WP keeps black and white the same between the ARTfile and the
  200. output file.  If you want a reverse video effect, use the /v option switch.
  201.  
  202. ==================
  203. SIZING AND DENSITY
  204. ==================
  205.  
  206. Normally ART2WP make a output file with an image density of 100x100 pixels (or 
  207. lines) per inch.  This lets your program compute the "natural" size of the 
  208. graphics image.  You can specify a different density by specifying it with 
  209. either the /x or /y option switches (e.g. /x200 is 200 pixels and lines per 
  210. inch).  You can also alter the aspect ratio (to "stretch" the image one way or 
  211. the other) by specifying both the /x and the /y option switches, with 
  212. different density values.
  213.  
  214. Of course, you can usually scale the image in your other application program.
  215.  
  216.  
  217.  
  218. ======
  219. HELP?!
  220. ======
  221.  
  222. Should you have any difficulties using this program, please 
  223. contact me via Compuserve EasyPlex (or on the CompuServe PICS forum):
  224.  
  225. William J. Hinkle [71121,3211]
  226.  
  227. ======
  228. THANKS
  229. ======
  230.  
  231. Thanks to:
  232.  
  233. Tom Pfau, for his public domain LZW compression/decompression code
  234. Bruce Philp, for his help in testing this program
  235.  
  236. ==========
  237. LEGALITIES
  238. ==========
  239. PFS: First Publisher is a trademark of the Software Publishing Corporation.
  240.  
  241. Word Perfect is a trademark of the Word Perfect Corporation.
  242.  
  243. Manuscript and Lotus Manuscript are trademarks of the
  244. Lotus Development Corporation.
  245.  
  246. GEM is a trademark of the Digital Research Corporation.
  247.  
  248. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc., an
  249. H & R Block Company.
  250.