home *** CD-ROM | disk | FTP | other *** search
/ Computer Buyer 1996 January / buyer-0196.iso / pfs / utils.lib / ART2WP.TXT < prev    next >
Text File  |  1993-08-20  |  7KB  |  216 lines
  1. ART2WP V2.2 PFS:First Publisher Clipart to TIFF File Translator
  2. Copyright 1989-92 by William J. Hinkle
  3. Licensed to Spinnaker Software Corporation
  4.  
  5.  
  6. === User's Guide === 
  7.  
  8.  
  9. The ART2WP program was created to allow clip art files created through the 
  10. PFS:First Publisher desktop publishing program to be used by word processing 
  11. programs that handle graphics, and in other graphics programs.  To do this, 
  12. ART2WP translates these ART files into any of several other graphics file 
  13. formats.  ART2WP now handles the high-resolution ART files introduced in First
  14. Publisher Version 3, as well as MAC (MacPaint) files and some FP PUB files.
  15. You can translate to:
  16.  
  17. * .WPG files (Word Perfect 5 graphics format)
  18. * .TIF files (Aldus/Microsoft TIFF format)
  19. * .BIT or .RLE files (Lotus Manuscript graphics format)
  20. * .IMG files (GEM Paint format)
  21. * .PCX files (PC Paintbrush PCX Format)
  22.  
  23. The translator is a single file: ART2WP.EXE.  The default translation is to 
  24. TIFF (.TIF) format (Intel uncompressed variety).
  25.  
  26. ==============
  27. COPYRIGHT INFO
  28. ==============
  29. This utility program ART2WP.EXE was written by William J. Hinkle
  30. who retains the copyright.  This version is licensed to Spinnaker Software
  31. Corporation for distribution and is subject to sub-licensing agreements by
  32. that corporation.
  33.  
  34. ===============
  35. BASIC OPERATION
  36. ===============
  37.  
  38. First create a PFS:First Publisher clip art file, which should have a .ART 
  39. extension on the filename.
  40.  
  41. To create a .TIF file (the default), type in:
  42.  
  43. ART2WP fname1
  44. or
  45. ART2WP fname1.ART
  46. or
  47. ART2WP fname1.ART fname2.TIF
  48.  
  49. from the DOS command prompt.
  50.  
  51. * For "fname1", substitute the name of your clip art file.
  52.  
  53. * The .ART and .TIF extensions are assumed if something else is not specified.
  54.  
  55. * The .TIF file name is made the same as the .ART file name if not otherwise 
  56. specified.  Specify a different "fname2" if desired.
  57.  
  58. * Full DOS pathnames can be specified.  If you enter a directory (ending in \) 
  59. or a drive (ending in :) for the second ("fname2") filename, the output file 
  60. will be placed on that path with the default filename; i.e, the input filename 
  61. with a .TIF extension.
  62.  
  63. The .ART file will be translated to a .TIF file.
  64.  
  65. The .ART file will not be erased.  Other options may be specified; see below.
  66.  
  67. ==================
  68. WILDCARD FILENAMES
  69. ==================
  70.  
  71. ART2WP can handle wildcard filenames, like *.ART.  To convert all of the ART
  72. files in the current directory to TIF, for example, type this command at the
  73. DOS command prompt:
  74.  
  75. ART2WP *.ART
  76.  
  77. If you are converting to something other than TIF, use the /fN "format" command
  78. to set the output format, rather than an output file extension.
  79.  
  80. ==================
  81. OTHER FILE FORMATS
  82. ==================
  83.  
  84. To create a new graphics file in one of the other supported formats (other 
  85. than the default TIF format), you must specify the other format.  You have two 
  86. ways to do this.  One way is to specify the output filename ("fname2") with 
  87. the appropriate extension.  The other is to specify the special /fN option 
  88. switch that selects the desired format.  The second method is usually the 
  89. best, because the .ART file's filename is then automatically used for the 
  90. output file.
  91.  
  92. Some examples:
  93.  
  94. ---
  95. * To get a Word Perfect WPG file:
  96.  
  97. ART2WP fname1 /fw
  98. or
  99. ART2WP fname1.ART fname2.WPG
  100.  
  101. gives you a WPG file.
  102.  
  103. ---
  104. * To get a Lotus Manuscript graphics file:
  105.  
  106. ART2WP fname1 /fb
  107. or
  108. ART2WP fname1.ART fname2.BIT
  109.  
  110. or, for RLE files (NOT Windows 3 RLE!), which are often smaller:
  111.  
  112. ART2WP fname1 /fr
  113. or
  114. ART2WP fname1.ART fname2.RLE
  115.  
  116. ---
  117. * To get a GEM Paint graphics file:
  118.  
  119. ART2WP fname1 /fi
  120. or
  121. ART2WP fname1.ART fname2.IMG
  122.  
  123. ---
  124.  
  125. * To get a ZSoft PC Paintbrush PCX file
  126.  
  127. ART2WP fname1 /fp
  128. or
  129. ART2WP fname1.ART fname2.PCX
  130.  
  131. ==============
  132. COMPLEAT USAGE
  133. ==============
  134.  
  135. If you invoke ART2WP from DOS without any other parameters, it will display 
  136. the following help message.  This illustrates some of the other options you 
  137. can select with command line switches.
  138.  
  139. -----
  140. PFS:FP ART-to-WP Image Translator: V2.2 ... Copyright 1989-92 by W.J.Hinkle
  141. Licensed to Spinnaker Software Corporation.
  142.  
  143. Usage: ART2WP fname1 [fname2] [options] ...
  144. where: fname1.ART ... PFS: First Publisher ART input file
  145.    or  fname1.MAC ... PFS: First Publisher MAC input file
  146.        fname2.TIF ... TIFF format output file (default: fname1.TIF)
  147.    or  fname2.WPG ... Word Perfect 5 WPG output file (default: fname1.WPG)
  148.    or  fname2.BIT ... Lotus Manuscript BIT output file
  149.    or  fname2.IMG ... GEM IMG format output file
  150.    or  fname2.PCX ... PC Paintbrush PCX format output file
  151.  
  152. Command Line Options:
  153.        /xN        ... x density = N pixels-per-inch (default: 72)
  154.        /yN        ... y density = N lines-per-inch (default: per x)
  155.        /v         ... reverse video
  156.        /ft        ... format TIFF output file -- Intel/IBM
  157.        /ftm       ... format TIFF output file -- Motorola/Mac
  158.        /fw        ... format WPG (Word Perfect) output file
  159.        /fb        ... format BIT (Lotus Manuscript) output file
  160.        /fr        ... format RLE (Lotus Manuscript) output file
  161.        /fi        ... format IMG (GEM) output file
  162.        /fp        ... format PCX (PC Paintbrush) output file
  163.  
  164. ART2WP is a translator from First Publisher ART and MAC image files
  165. to various word processor image file formats:
  166.  
  167. To Microsoft/Aldus TIFF files (default, or fname2.TIF, or use /ft option),
  168. or Word Perfect 5 WPG files (fname2.WPG, or use /fw option)
  169. or Lotus Manuscript BIT/RLE files (fname2.BIT/RLE, or use /fb, /fr options),
  170. or GEM IMG files (fname2.IMG, or use /fi option),
  171. or PC Paintbrush PCX files (fname2.PCX, or use /fp option).
  172.  
  173. (followed by license and trademark information...)
  174.  
  175. =============
  176. REVERSE VIDEO
  177. =============
  178.  
  179. Normally ART2WP keeps black and white the same between the ART file and the
  180. output file.  If you want a reverse video effect, use the /v option switch.
  181.  
  182. ==================
  183. SIZING AND DENSITY
  184. ==================
  185.  
  186. Normally ART2WP make a output file with an image density of 72x72 pixels (or 
  187. lines) per inch, the same as First Publisher uses for low resolution ART
  188. files, MAC and PUB files.  When translating high-resolution ART files, the
  189. indicated resolution is used (usually this is 300 pixels per inch).  This lets
  190. your program compute the "natural" size of the graphics image.  You can specify
  191. a different density by specifying it with either the /x or /y option switches
  192. (e.g. /x200 is 200 pixels and lines per inch).  You can also alter the aspect
  193. ratio (to "stretch" the image one way or the other) by specifying both the /x
  194. and the /y option switches, with different density values.
  195.  
  196. Of course, you can usually scale the image in your other application program.
  197.  
  198. NOTE! The /x and /y commands do NOT rescale the image in any way -- they 
  199. simply inform your word processing or graphics program of the desired 
  200. resolution in each direction.
  201.  
  202. ==========
  203. LEGALITIES
  204. ==========
  205.  
  206. PFS:First Publisher is a trademark of Spinnaker Software Corporation.
  207.  
  208. Word Perfect is a trademark of the Word Perfect Corporation.
  209.  
  210. Manuscript and Lotus Manuscript are trademarks of the
  211. Lotus Development Corporation.
  212.  
  213. GEM is a trademark of the Digital Research Corporation.
  214.  
  215. PC Paintbrush is a trademark of ZSoft Corporation.
  216.