pdf2fax.1m
上传用户:weiyuanprp
上传日期:2020-05-20
资源大小:1169k
文件大小:6k
源码类别:

传真(Fax)编程

开发平台:

C/C++

  1. ." $Id: pdf2fax.1m,v 1.2 2008/01/09 06:40:35 faxguy Exp $
  2. ."
  3. ." HylaFAX Facsimile Software
  4. ."
  5. ." Copyright (c) 1990-1996 Sam Leffler
  6. ." Copyright (c) 1991-1996 Silicon Graphics, Inc.
  7. ." HylaFAX is a trademark of Silicon Graphics
  8. ." 
  9. ." Permission to use, copy, modify, distribute, and sell this software and 
  10. ." its documentation for any purpose is hereby granted without fee, provided
  11. ." that (i) the above copyright notices and this permission notice appear in
  12. ." all copies of the software and related documentation, and (ii) the names of
  13. ." Sam Leffler and Silicon Graphics may not be used in any advertising or
  14. ." publicity relating to the software without the specific, prior written
  15. ." permission of Sam Leffler and Silicon Graphics.
  16. ." 
  17. ." THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
  18. ." EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
  19. ." WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
  20. ." 
  21. ." IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  22. ." ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  23. ." OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  24. ." WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
  25. ." LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
  26. ." OF THIS SOFTWARE.
  27. ."
  28. .if n .po 0
  29. .ds Fx fIHylas-1FAXs+1fP
  30. .ds Ps Ps-2OSTs+2Ss-2CRIPTs+2
  31. .TH PDF2FAX ${MANNUM1_8} "March 08, 2001"
  32. .SH NAME
  33. pdf2fax - image Portable Document Format file for facsimile transmission 
  34. by *(Fx
  35. .SH SYNOPSIS
  36. .B ${SPOOL}/bin/pdf2fax
  37. [
  38. .I options
  39. ] [
  40. .IR files ...
  41. ]
  42. .SH DESCRIPTION
  43. .I pdf2fax
  44. takes Portable Document Format (PDF) input and generates a
  45. .SM TIFF
  46. Class F image file suitable for facsimile transmission.
  47. It is usually invoked by the *(Fx scheduler process,
  48. .IR faxq (${MANNUM1_8}).
  49. PDF imaging is typically done using the
  50. freely available
  51. .I Ghostscript
  52. software.
  53. .PP
  54. .I pdf2fax
  55. is actually a link (symbolic or otherwise) to the script
  56. appropriate for the PDF imaging tool.
  57. The link is setup when the
  58. .IR faxsetup (${MANNUM1_8})
  59. script is run to configure a *(Fx server machine for use.
  60. .PP
  61. Input files containing PDF may be specified on the
  62. command line.
  63. If none are given, then
  64. .I pdf2fax
  65. will read from standard input.
  66. .PP
  67. By default,
  68. .I pdf2fax
  69. will generate a 98 line/inch output document whose
  70. page width is 1728 pixels and page length is 297 mm
  71. (a standard A4 page at low resolution).
  72. Horizontal resolution is always 204 dpi.
  73. Command line options may be used to select alternate
  74. vertical resolution and page dimensions.
  75. .PP
  76. If no filename is given, 
  77. .I pdf2fax
  78. writes its output to a file named
  79. .BR pdf.fax ;
  80. the
  81. .B -o
  82. option can be used to specify an alternate filename.
  83. .PP
  84. By default, output is compressed using the standard
  85. Group 3 1D-encoding scheme, with
  86. .SM EOL
  87. codes padded to byte boundaries.
  88. If the
  89. .B -2
  90. option is specified, output is encoded with the optional
  91. Group 3 2D-encoding scheme (c
  92. .SM EOL
  93. codes are still padded to byte boundaries).
  94. .PP
  95. This script can modify outgoing facsimile, such as watermarking,
  96. To do this create a shell script
  97. .B etc/FaxModify
  98. in the spooling area that alters the document.
  99. .PP
  100. Note that
  101. .B bin/pdf2fax
  102. is usually just a link to a shell script that invokes the
  103. appropriate PDF
  104. .SM RIP
  105. to do the work.
  106. .SH OPTIONS
  107. The following operations are recognized:
  108. .TP 10
  109. .B -1
  110. Write Group 3 1D-encoded data to the output file.
  111. .TP 10
  112. .B -2
  113. Write Group 3 2D-encoded data to the output file.
  114. .TP 10
  115. .B -3
  116. Write Group 4 MMR-encoded data to the output file.
  117. .TP 10
  118. .BI -i " jobid"
  119. How the server references the associated Job ID number 
  120. .TP 10
  121. .BI -m " pages"
  122. Set the maximum number of pages that are permitted in the
  123. output file.
  124. If more pages are present in the input document then
  125. abort processing.
  126. .TP 10
  127. .BI -o " file"
  128. Write output to the specified
  129. .I file
  130. instead of the default
  131. .B pdf.fax
  132. filename.
  133. .TP 10
  134. .BI -w " width"
  135. Set the output page
  136. .IR width ,
  137. in pixels.
  138. By default, pages are 1728 pixels wide.
  139. .TP 10
  140. .BI -l " length"
  141. Set the output page
  142. .IR length
  143. in millimeters.
  144. By default, pages are 297 millimeters long.
  145. .TP
  146. .BI -r " vres"
  147. Set the vertical resolution,
  148. in lines/inch, at which to image the PDF.
  149. .SH "RUNTIME ENVIRONMENT"
  150. Before user-supplied PDF is passed
  151. to the PDF interpreter, a limited number of
  152. operators are defined.
  153. These operators are operators commonly found in a
  154. LaserWriter printer and (sometimes) generated by Macintosh-based
  155. applications.
  156. .PP
  157. The default Display PDF-based execution
  158. environment includes support for the following fonts:
  159. .sp .5
  160. .ta w'AvantGarde-DemiOblique    'u +w'Helvetica-Narrow-BoldOblique    'u
  161. .nf
  162. AvantGarde-Book Helvetica-Bold Palatino-BoldItalic
  163. AvantGarde-BookOblique Helvetica-BoldOblique Palatino-Italic
  164. AvantGarde-Demi Helvetica-Narrow Palatino-Roman
  165. AvantGarde-DemiOblique Helvetica-Narrow-Bold StoneSerif
  166. Bookman-Demi Helvetica-Narrow-BoldOblique Symbol
  167. Bookman-DemiItalic Helvetica-Narrow-Oblique Tekton
  168. Bookman-Light Helvetica-Oblique Times-Bold
  169. Bookman-LightItalic Lithos-Bold Times-BoldItalic
  170. Courier NewCenturySchlbk-Bold Times-Italic
  171. Courier-Bold NewCenturySchlbk-BoldItalic Times-Roman
  172. Courier-BoldOblique NewCenturySchlbk-Italic ZapfChancery-MediumItalic
  173. Courier-Oblique NewCenturySchlbk-Roman ZapfDingbats
  174. Helvetica Palatino-Bold
  175. .fi
  176. .sp .5
  177. Note that this is the same set of fonts supported by the
  178. .SM DPS
  179. extension to the X server.
  180. .PP
  181. The default Ghostscript-based environment is more uncertain;
  182. consult the Ghostscript documentation for information on
  183. what fonts are available.
  184. .SH BUGS
  185. Output from the Display PDF version of this command
  186. is encoded according to the Display PDF binary encoding
  187. protocol.
  188. .PP
  189. Ghostscript-based versions of this program fail to exit with
  190. non-zero status when an invalid PDF document is processed;
  191. this makes it problematic for the *(Fx queue manager to
  192. determine when a problem arises when preparing a job for
  193. transmission.
  194. .SH "SEE ALSO"
  195. .IR sendfax (1),
  196. .IR faxq (${MANNUM1_8}),
  197. .IR hylafax-server(${MANNUM4_5})