poppler 2.2.4-x64-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (185) hide show
  1. checksums.yaml +7 -0
  2. data/README +35 -0
  3. data/Rakefile +75 -0
  4. data/ext/poppler/depend +6 -0
  5. data/ext/poppler/extconf.rb +70 -0
  6. data/ext/poppler/poppler.def +2 -0
  7. data/ext/poppler/rbpoppler-action.c +372 -0
  8. data/ext/poppler/rbpoppler-annotation-callout-line.c +127 -0
  9. data/ext/poppler/rbpoppler-annotation-free-text.c +46 -0
  10. data/ext/poppler/rbpoppler-annotation-mapping.c +72 -0
  11. data/ext/poppler/rbpoppler-annotation-markup.c +98 -0
  12. data/ext/poppler/rbpoppler-annotation-text.c +53 -0
  13. data/ext/poppler/rbpoppler-annotation.c +74 -0
  14. data/ext/poppler/rbpoppler-attachment.c +124 -0
  15. data/ext/poppler/rbpoppler-button-field.c +56 -0
  16. data/ext/poppler/rbpoppler-choice-field.c +131 -0
  17. data/ext/poppler/rbpoppler-color.c +107 -0
  18. data/ext/poppler/rbpoppler-document.c +224 -0
  19. data/ext/poppler/rbpoppler-font-info.c +59 -0
  20. data/ext/poppler/rbpoppler-fonts-iter.c +127 -0
  21. data/ext/poppler/rbpoppler-form-field-mapping.c +44 -0
  22. data/ext/poppler/rbpoppler-form-field.c +98 -0
  23. data/ext/poppler/rbpoppler-image-mapping.c +48 -0
  24. data/ext/poppler/rbpoppler-index-iter.c +128 -0
  25. data/ext/poppler/rbpoppler-link-mapping.c +47 -0
  26. data/ext/poppler/rbpoppler-page-transition.c +59 -0
  27. data/ext/poppler/rbpoppler-page.c +322 -0
  28. data/ext/poppler/rbpoppler-private.h +77 -0
  29. data/ext/poppler/rbpoppler-ps-file.c +66 -0
  30. data/ext/poppler/rbpoppler-rectangle.c +92 -0
  31. data/ext/poppler/rbpoppler-text-field.c +91 -0
  32. data/ext/poppler/rbpoppler.c +111 -0
  33. data/ext/poppler/rbpoppler.h +61 -0
  34. data/ext/poppler/rbpopplerconversions.h +105 -0
  35. data/extconf.rb +49 -0
  36. data/lib/2.0/poppler.so +0 -0
  37. data/lib/2.1/poppler.so +0 -0
  38. data/lib/2.2/poppler.so +0 -0
  39. data/lib/poppler.rb +105 -0
  40. data/sample/number-pdf.rb +32 -0
  41. data/sample/pdf2.rb +132 -0
  42. data/sample/pdf2svg.rb +26 -0
  43. data/sample/pdf2text.rb +16 -0
  44. data/sample/pdfcrop.rb +32 -0
  45. data/sample/pdfdiv.rb +36 -0
  46. data/test/fixtures/image.pdf +0 -0
  47. data/test/fixtures/image.png +0 -0
  48. data/test/poppler-test-utils.rb +58 -0
  49. data/test/run-test.rb +32 -0
  50. data/test/test_annotation.rb +86 -0
  51. data/test/test_color.rb +26 -0
  52. data/test/test_constants.rb +30 -0
  53. data/test/test_document.rb +41 -0
  54. data/test/test_page.rb +42 -0
  55. data/vendor/local/bin/cjpeg.exe +0 -0
  56. data/vendor/local/bin/djpeg.exe +0 -0
  57. data/vendor/local/bin/jpegtran.exe +0 -0
  58. data/vendor/local/bin/libjpeg-9.dll +0 -0
  59. data/vendor/local/bin/libpoppler-48.dll +0 -0
  60. data/vendor/local/bin/libpoppler-cpp-0.dll +0 -0
  61. data/vendor/local/bin/libpoppler-glib-8.dll +0 -0
  62. data/vendor/local/bin/libsqlite3-0.dll +0 -0
  63. data/vendor/local/bin/pdfdetach.exe +0 -0
  64. data/vendor/local/bin/pdffonts.exe +0 -0
  65. data/vendor/local/bin/pdfimages.exe +0 -0
  66. data/vendor/local/bin/pdfinfo.exe +0 -0
  67. data/vendor/local/bin/pdfseparate.exe +0 -0
  68. data/vendor/local/bin/pdftocairo.exe +0 -0
  69. data/vendor/local/bin/pdftohtml.exe +0 -0
  70. data/vendor/local/bin/pdftoppm.exe +0 -0
  71. data/vendor/local/bin/pdftops.exe +0 -0
  72. data/vendor/local/bin/pdftotext.exe +0 -0
  73. data/vendor/local/bin/pdfunite.exe +0 -0
  74. data/vendor/local/bin/rdjpgcom.exe +0 -0
  75. data/vendor/local/bin/sqlite3.exe +0 -0
  76. data/vendor/local/bin/wrjpgcom.exe +0 -0
  77. data/vendor/local/include/jconfig.h +60 -0
  78. data/vendor/local/include/jerror.h +304 -0
  79. data/vendor/local/include/jmorecfg.h +446 -0
  80. data/vendor/local/include/jpeglib.h +1180 -0
  81. data/vendor/local/include/poppler/cpp/poppler-document.h +104 -0
  82. data/vendor/local/include/poppler/cpp/poppler-embedded-file.h +55 -0
  83. data/vendor/local/include/poppler/cpp/poppler-font.h +91 -0
  84. data/vendor/local/include/poppler/cpp/poppler-global.h +111 -0
  85. data/vendor/local/include/poppler/cpp/poppler-image.h +71 -0
  86. data/vendor/local/include/poppler/cpp/poppler-page-renderer.h +66 -0
  87. data/vendor/local/include/poppler/cpp/poppler-page-transition.h +82 -0
  88. data/vendor/local/include/poppler/cpp/poppler-page.h +76 -0
  89. data/vendor/local/include/poppler/cpp/poppler-rectangle.h +84 -0
  90. data/vendor/local/include/poppler/cpp/poppler-toc.h +74 -0
  91. data/vendor/local/include/poppler/cpp/poppler-version.h +39 -0
  92. data/vendor/local/include/poppler/glib/poppler-action.h +316 -0
  93. data/vendor/local/include/poppler/glib/poppler-annot.h +296 -0
  94. data/vendor/local/include/poppler/glib/poppler-attachment.h +87 -0
  95. data/vendor/local/include/poppler/glib/poppler-date.h +30 -0
  96. data/vendor/local/include/poppler/glib/poppler-document.h +299 -0
  97. data/vendor/local/include/poppler/glib/poppler-enums.h +116 -0
  98. data/vendor/local/include/poppler/glib/poppler-features.h +88 -0
  99. data/vendor/local/include/poppler/glib/poppler-form-field.h +111 -0
  100. data/vendor/local/include/poppler/glib/poppler-layer.h +43 -0
  101. data/vendor/local/include/poppler/glib/poppler-media.h +73 -0
  102. data/vendor/local/include/poppler/glib/poppler-movie.h +42 -0
  103. data/vendor/local/include/poppler/glib/poppler-page.h +377 -0
  104. data/vendor/local/include/poppler/glib/poppler-structure-element.h +357 -0
  105. data/vendor/local/include/poppler/glib/poppler.h +250 -0
  106. data/vendor/local/include/sqlite3.h +7494 -0
  107. data/vendor/local/include/sqlite3ext.h +487 -0
  108. data/vendor/local/lib/girepository-1.0/Poppler-0.18.typelib +0 -0
  109. data/vendor/local/lib/libjpeg.a +0 -0
  110. data/vendor/local/lib/libjpeg.dll.a +0 -0
  111. data/vendor/local/lib/libjpeg.la +41 -0
  112. data/vendor/local/lib/libpoppler-cpp.a +0 -0
  113. data/vendor/local/lib/libpoppler-cpp.dll.a +0 -0
  114. data/vendor/local/lib/libpoppler-cpp.la +41 -0
  115. data/vendor/local/lib/libpoppler-glib.a +0 -0
  116. data/vendor/local/lib/libpoppler-glib.dll.a +0 -0
  117. data/vendor/local/lib/libpoppler-glib.la +41 -0
  118. data/vendor/local/lib/libpoppler.a +0 -0
  119. data/vendor/local/lib/libpoppler.dll.a +0 -0
  120. data/vendor/local/lib/libpoppler.la +41 -0
  121. data/vendor/local/lib/libsqlite3.a +0 -0
  122. data/vendor/local/lib/libsqlite3.dll.a +0 -0
  123. data/vendor/local/lib/libsqlite3.la +41 -0
  124. data/vendor/local/lib/pkgconfig/poppler-cairo.pc +9 -0
  125. data/vendor/local/lib/pkgconfig/poppler-cpp.pc +13 -0
  126. data/vendor/local/lib/pkgconfig/poppler-glib.pc +13 -0
  127. data/vendor/local/lib/pkgconfig/poppler-splash.pc +9 -0
  128. data/vendor/local/lib/pkgconfig/poppler.pc +11 -0
  129. data/vendor/local/lib/pkgconfig/sqlite3.pc +13 -0
  130. data/vendor/local/share/gir-1.0/Poppler-0.18.gir +8281 -0
  131. data/vendor/local/share/gtk-doc/html/poppler/PopplerAnnot.html +3221 -0
  132. data/vendor/local/share/gtk-doc/html/poppler/PopplerAttachment.html +267 -0
  133. data/vendor/local/share/gtk-doc/html/poppler/PopplerDocument.html +3328 -0
  134. data/vendor/local/share/gtk-doc/html/poppler/PopplerFormField.html +1403 -0
  135. data/vendor/local/share/gtk-doc/html/poppler/PopplerLayer.html +307 -0
  136. data/vendor/local/share/gtk-doc/html/poppler/PopplerMedia.html +381 -0
  137. data/vendor/local/share/gtk-doc/html/poppler/PopplerMovie.html +197 -0
  138. data/vendor/local/share/gtk-doc/html/poppler/PopplerPage.html +3002 -0
  139. data/vendor/local/share/gtk-doc/html/poppler/PopplerStructureElement.html +3781 -0
  140. data/vendor/local/share/gtk-doc/html/poppler/annotation-glossary.html +63 -0
  141. data/vendor/local/share/gtk-doc/html/poppler/api-index-0-12.html +123 -0
  142. data/vendor/local/share/gtk-doc/html/poppler/api-index-0-14.html +102 -0
  143. data/vendor/local/share/gtk-doc/html/poppler/api-index-0-16.html +180 -0
  144. data/vendor/local/share/gtk-doc/html/poppler/api-index-0-18.html +72 -0
  145. data/vendor/local/share/gtk-doc/html/poppler/api-index-0-20.html +39 -0
  146. data/vendor/local/share/gtk-doc/html/poppler/api-index-0-22.html +64 -0
  147. data/vendor/local/share/gtk-doc/html/poppler/api-index-deprecated.html +39 -0
  148. data/vendor/local/share/gtk-doc/html/poppler/api-index-full.html +1830 -0
  149. data/vendor/local/share/gtk-doc/html/poppler/ch01.html +74 -0
  150. data/vendor/local/share/gtk-doc/html/poppler/home.png +0 -0
  151. data/vendor/local/share/gtk-doc/html/poppler/index.html +85 -0
  152. data/vendor/local/share/gtk-doc/html/poppler/index.sgml +557 -0
  153. data/vendor/local/share/gtk-doc/html/poppler/left-insensitive.png +0 -0
  154. data/vendor/local/share/gtk-doc/html/poppler/left.png +0 -0
  155. data/vendor/local/share/gtk-doc/html/poppler/poppler-PDF-Utility-functions.html +107 -0
  156. data/vendor/local/share/gtk-doc/html/poppler/poppler-PopplerAction.html +796 -0
  157. data/vendor/local/share/gtk-doc/html/poppler/poppler-PopplerColor.html +201 -0
  158. data/vendor/local/share/gtk-doc/html/poppler/poppler-Version-and-Features-Information.html +254 -0
  159. data/vendor/local/share/gtk-doc/html/poppler/poppler-poppler.html +169 -0
  160. data/vendor/local/share/gtk-doc/html/poppler/poppler.devhelp2 +470 -0
  161. data/vendor/local/share/gtk-doc/html/poppler/right-insensitive.png +0 -0
  162. data/vendor/local/share/gtk-doc/html/poppler/right.png +0 -0
  163. data/vendor/local/share/gtk-doc/html/poppler/style.css +476 -0
  164. data/vendor/local/share/gtk-doc/html/poppler/up-insensitive.png +0 -0
  165. data/vendor/local/share/gtk-doc/html/poppler/up.png +0 -0
  166. data/vendor/local/share/license/poppler/AUTHORS +5 -0
  167. data/vendor/local/share/license/poppler/COPYING +339 -0
  168. data/vendor/local/share/man/man1/cjpeg.1 +387 -0
  169. data/vendor/local/share/man/man1/djpeg.1 +252 -0
  170. data/vendor/local/share/man/man1/jpegtran.1 +293 -0
  171. data/vendor/local/share/man/man1/pdfdetach.1 +86 -0
  172. data/vendor/local/share/man/man1/pdffonts.1 +119 -0
  173. data/vendor/local/share/man/man1/pdfimages.1 +260 -0
  174. data/vendor/local/share/man/man1/pdfinfo.1 +152 -0
  175. data/vendor/local/share/man/man1/pdfseparate.1 +49 -0
  176. data/vendor/local/share/man/man1/pdftocairo.1 +295 -0
  177. data/vendor/local/share/man/man1/pdftohtml.1 +107 -0
  178. data/vendor/local/share/man/man1/pdftoppm.1 +170 -0
  179. data/vendor/local/share/man/man1/pdftops.1 +217 -0
  180. data/vendor/local/share/man/man1/pdftotext.1 +137 -0
  181. data/vendor/local/share/man/man1/pdfunite.1 +33 -0
  182. data/vendor/local/share/man/man1/rdjpgcom.1 +63 -0
  183. data/vendor/local/share/man/man1/sqlite3.1 +279 -0
  184. data/vendor/local/share/man/man1/wrjpgcom.1 +103 -0
  185. metadata +254 -0
@@ -0,0 +1,152 @@
1
+ .\" Copyright 1999-2011 Glyph & Cog, LLC
2
+ .TH pdfinfo 1 "15 August 2011"
3
+ .SH NAME
4
+ pdfinfo \- Portable Document Format (PDF) document information
5
+ extractor (version 3.03)
6
+ .SH SYNOPSIS
7
+ .B pdfinfo
8
+ [options]
9
+ .RI [ PDF-file ]
10
+ .SH DESCRIPTION
11
+ .B Pdfinfo
12
+ prints the contents of the \'Info' dictionary (plus some other useful
13
+ information) from a Portable Document Format (PDF) file.
14
+ .PP
15
+ The \'Info' dictionary contains the following values:
16
+ .PP
17
+ .RS
18
+ title
19
+ .RE
20
+ .RS
21
+ subject
22
+ .RE
23
+ .RS
24
+ keywords
25
+ .RE
26
+ .RS
27
+ author
28
+ .RE
29
+ .RS
30
+ creator
31
+ .RE
32
+ .RS
33
+ producer
34
+ .RE
35
+ .RS
36
+ creation date
37
+ .RE
38
+ .RS
39
+ modification date
40
+ .RE
41
+ .PP
42
+ In addition, the following information is printed:
43
+ .PP
44
+ .RS
45
+ tagged (yes/no)
46
+ .RE
47
+ .RS
48
+ form (AcroForm / XFA / none)
49
+ .RE
50
+ .RS
51
+ javascript (yes/no)
52
+ .RE
53
+ .RS
54
+ page count
55
+ .RE
56
+ .RS
57
+ encrypted flag (yes/no)
58
+ .RE
59
+ .RS
60
+ print and copy permissions (if encrypted)
61
+ .RE
62
+ .RS
63
+ page size
64
+ .RE
65
+ .RS
66
+ file size
67
+ .RE
68
+ .RS
69
+ linearized (yes/no)
70
+ .RE
71
+ .RS
72
+ PDF version
73
+ .RE
74
+ .RS
75
+ metadata (only if requested)
76
+ .RE
77
+ .SH OPTIONS
78
+ .TP
79
+ .BI \-f " number"
80
+ Specifies the first page to examine. If multiple pages are requested
81
+ using the "\-f" and "\-l" options, the size of each requested page (and,
82
+ optionally, the bounding boxes for each requested page) are printed.
83
+ Otherwise, only page one is examined.
84
+ .TP
85
+ .BI \-l " number"
86
+ Specifies the last page to examine.
87
+ .TP
88
+ .B \-box
89
+ Prints the page box bounding boxes: MediaBox, CropBox, BleedBox,
90
+ TrimBox, and ArtBox.
91
+ .TP
92
+ .B \-meta
93
+ Prints document-level metadata. (This is the "Metadata" stream from
94
+ the PDF file's Catalog object.)
95
+ .TP
96
+ +.B \-js
97
+ +Prints all JavaScript in the PDF.
98
+ +.TP
99
+ .B \-rawdates
100
+ Prints the raw (undecoded) date strings, directly from the PDF file.
101
+ .TP
102
+ .BI \-enc " encoding-name"
103
+ Sets the encoding to use for text output. This defaults to "UTF-8".
104
+ .TP
105
+ .B \-listenc
106
+ Lits the available encodings
107
+ .TP
108
+ .BI \-opw " password"
109
+ Specify the owner password for the PDF file. Providing this will
110
+ bypass all security restrictions.
111
+ .TP
112
+ .BI \-upw " password"
113
+ Specify the user password for the PDF file.
114
+ .TP
115
+ .B \-v
116
+ Print copyright and version information.
117
+ .TP
118
+ .B \-h
119
+ Print usage information.
120
+ .RB ( \-help
121
+ and
122
+ .B \-\-help
123
+ are equivalent.)
124
+ .SH EXIT CODES
125
+ The Xpdf tools use the following exit codes:
126
+ .TP
127
+ 0
128
+ No error.
129
+ .TP
130
+ 1
131
+ Error opening a PDF file.
132
+ .TP
133
+ 2
134
+ Error opening an output file.
135
+ .TP
136
+ 3
137
+ Error related to PDF permissions.
138
+ .TP
139
+ 99
140
+ Other error.
141
+ .SH AUTHOR
142
+ The pdfinfo software and documentation are copyright 1996-2011 Glyph &
143
+ Cog, LLC.
144
+ .SH "SEE ALSO"
145
+ .BR pdfdetach (1),
146
+ .BR pdffonts (1),
147
+ .BR pdfimages (1),
148
+ .BR pdftocairo (1),
149
+ .BR pdftohtml (1),
150
+ .BR pdftoppm (1),
151
+ .BR pdftops (1),
152
+ .BR pdftotext (1)
@@ -0,0 +1,49 @@
1
+ .\" Copyright 2011 The Poppler Developers - http://poppler.freedesktop.org
2
+ .TH pdfseparate 1 "15 September 2011"
3
+ .SH NAME
4
+ pdfseparate \- Portable Document Format (PDF) page extractor
5
+ .SH SYNOPSIS
6
+ .B pdfseparate
7
+ [options]
8
+ .I PDF-file PDF-page-pattern
9
+ .SH DESCRIPTION
10
+ .B pdfseparate
11
+ extract single pages from a Portable Document Format (PDF).
12
+ .PP
13
+ pdfseparate reads the PDF file
14
+ .IR PDF-file ,
15
+ extracts one or more pages, and writes one PDF file for each page to
16
+ .IR PDF-page-pattern ,
17
+ PDF-page-pattern should contain
18
+ .BR %d .
19
+ %d is replaced by the page number.
20
+ .TP
21
+ The PDF-file should not be encrypted.
22
+ .SH OPTIONS
23
+ .TP
24
+ .BI \-f " number"
25
+ Specifies the first page to extract. If \-f is omitted, extraction starts with page 1.
26
+ .TP
27
+ .BI \-l " number"
28
+ Specifies the last page to extract. If \-l is omitted, extraction ends with the last page.
29
+ .TP
30
+ .B \-v
31
+ Print copyright and version information.
32
+ .TP
33
+ .B \-h
34
+ Print usage information.
35
+ .RB ( \-help
36
+ and
37
+ .B \-\-help
38
+ are equivalent.)
39
+ .SH EXAMPLE
40
+ pdfseparate sample.pdf sample-%d.pdf
41
+ .TP
42
+ extracts all pages from sample.pdf, if i.e. sample.pdf has 3 pages, it produces
43
+ .TP
44
+ sample-1.pdf, sample-2.pdf, sample-3.pdf
45
+ .SH AUTHOR
46
+ The pdfseparate software and documentation are copyright 1996-2004 Glyph
47
+ & Cog, LLC and copyright 2005-2011 The Poppler Developers - http://poppler.freedesktop.org
48
+ .SH "SEE ALSO"
49
+ .BR pdfunite (1),
@@ -0,0 +1,295 @@
1
+ .TH pdftoppm 1
2
+ .SH NAME
3
+ pdftocairo \- Portable Document Format (PDF) to PNG/JPEG/TIFF/PDF/PS/EPS/SVG using cairo
4
+ .SH SYNOPSIS
5
+ .B pdftocairo
6
+ [options]
7
+ .IR PDF-file
8
+ .RI [ output-file ]
9
+ .SH DESCRIPTION
10
+ .B pdftocairo
11
+ converts Portable Document Format (PDF) files, using the cairo output device of the poppler PDF library, to any of the following output formats:
12
+ .IP \(bu
13
+ Portable Network Graphics (PNG)
14
+ .IP \(bu
15
+ JPEG Interchange Format (JPEG)
16
+ .IP \(bu
17
+ Tagged Image File Format (TIFF)
18
+ .IP \(bu
19
+ Portable Document Format (PDF)
20
+ .IP \(bu
21
+ PostScript (PS)
22
+ .IP \(bu
23
+ Encapsulated PostScript (EPS)
24
+ .IP \(bu
25
+ Scalable Vector Graphics (SVG)
26
+ .IP \(bu
27
+ Windows Printer
28
+ .PP
29
+ .B pdftocairo
30
+ reads the PDF file,
31
+ .IR PDF-file ,
32
+ and writes to
33
+ .IR output-file .
34
+ The image formats (PNG, JPEG, and TIFF) generate one file per page with the page number and file type appended to
35
+ .IR output-file
36
+ (except when \-singlefile is used).
37
+ When the output format is a vector format (PDF, PS, EPS, and SVG) or when \-singlefile is used,
38
+ .IR output-file
39
+ is the full filename.
40
+
41
+ If the
42
+ .IR PDF-file
43
+ is \*(lq\-\*(rq , the PDF is read from stdin.
44
+ If the
45
+ .IR output-file
46
+ is \*(lq\-\*(rq , the output file will be written to stdout. Using stdout is not valid with image formats unless \-singlefile is used.
47
+ If
48
+ .IR output-file
49
+ is not used, the output filename will be derived from the
50
+ .IR PDF-file
51
+ filename.
52
+ .PP
53
+ Not all options are valid with all output formats. One (and only one) of the output format options (\-png, \-jpeg, \-tiff, \-pdf, \-print, \-ps, \-eps, or \-svg) must be used.
54
+ .PP
55
+ The resolution options (\-r, \-rx, \-ry) set the resolution of the
56
+ image output formats. The image dimensions will depend on the PDF page
57
+ size and the resolution. For the vector outputs, regions of the page
58
+ that can not be represented natively in the output format (eg
59
+ translucency in PS) will be rasterized at the resolution specified by
60
+ the resolution options.
61
+ .PP
62
+ The \-scale-to options may be used to set a fixed image size. The
63
+ image resolution will vary with the page size.
64
+ .PP
65
+ The cropping options (\-x, \-y, \-W, and \-H) use units of pixels with
66
+ the image formats and PostScript points (1/72 inch) with the vector
67
+ formats. When cropping is used with vector output the cropped region is
68
+ centered unless \-nocenter is used in which case the cropped region is
69
+ at the top left (SVG) or bottom left (PDF, PS, EPS).
70
+ .PP
71
+ .SH OPTIONS
72
+ .TP
73
+ .BI \-png
74
+ Generates a PNG file(s)
75
+ .TP
76
+ .BI \-jpeg
77
+ Generates a JPEG file(s)
78
+ .TP
79
+ .BI \-tiff
80
+ Generates a TIFF file(s)
81
+ .TP
82
+ .BI \-pdf
83
+ Generates a PDF file
84
+ .TP
85
+ .BI \-ps
86
+ Generate a PS file
87
+ .TP
88
+ .BI \-eps
89
+ Generate an EPS file. An EPS file contains a single image, so if you
90
+ use this option with a multi-page PDF file, you must use \-f and \-l
91
+ to specify a single page. The page size options (\-origpagesizes,
92
+ \-paper, \-paperw, \-paperh) can not be used with this option.
93
+ .TP
94
+ .BI \-svg
95
+ Generate a SVG (Scalable Vector Graphics) file
96
+ .TP
97
+ .BI \-print
98
+ (Windows only) Prints to a system printer. See also \-printer and \-printeropt.
99
+ If an output file is not specified, the output will be sent to the printer.
100
+ The output file '-' can not be used with this option.
101
+ .TP
102
+ .BI \-printdlg
103
+ (Windows only) Prints to a system printer. Displays the print dialog to allow
104
+ the print options to be modified before printing.
105
+ .TP
106
+ .BI \-f " number"
107
+ Specifies the first page to convert.
108
+ .TP
109
+ .BI \-l " number"
110
+ Specifies the last page to convert.
111
+ .TP
112
+ .B \-o
113
+ Generates only the odd numbered pages.
114
+ .TP
115
+ .B \-e
116
+ Generates only the even numbered pages.
117
+ .TP
118
+ .BI \-singlefile
119
+ Writes only the first page and does not add digits.
120
+ .TP
121
+ .BI \-r " number"
122
+ Specifies the X and Y resolution, in pixels per inch of image files (or rasterized regions in vector output). The default is 150 PPI.
123
+ .TP
124
+ .BI \-rx " number"
125
+ Specifies the X resolution, in pixels per inch of image files (or rasterized regions in vector output). The default is 150 PPI.
126
+ .TP
127
+ .BI \-ry " number"
128
+ Specifies the Y resolution, in pixels per inch of image files (or rasterized regions in vector output). The default is 150 PPI.
129
+ .TP
130
+ .BI \-scale-to " number"
131
+ Scales the long side of each page (width for landscape pages, height
132
+ for portrait pages) to fit in scale-to pixels. The size of the short
133
+ side will be determined by the aspect ratio of the page (PNG/JPEG/TIFF only).
134
+ .TP
135
+ .BI \-scale-to-x " number"
136
+ Scales each page horizontally to fit in scale-to-x pixels. If
137
+ scale-to-y is set to -1, the vertical size will determined by the
138
+ aspect ratio of the page (PNG/JPEG/TIFF only).
139
+ .TP
140
+ .BI \-scale-to-y " number"
141
+ Scales each page vertically to fit in scale-to-y pixels. If scale-to-x
142
+ is set to -1, the horizontal size will determined by the aspect ratio
143
+ of the page (PNG/JPEG/TIFF only).
144
+ .TP
145
+ .BI \-x " number"
146
+ Specifies the x-coordinate of the crop area top left corner in pixels (image output) or points (vector output)
147
+ .TP
148
+ .BI \-y " number"
149
+ Specifies the y-coordinate of the crop area top left corner in pixels (image output) or points (vector output)
150
+ .TP
151
+ .BI \-W " number"
152
+ Specifies the width of crop area in pixels (image output) or points (vector output) (default is 0)
153
+ .TP
154
+ .BI \-H " number"
155
+ Specifies the height of crop area in pixels (image output) or points (vector output) (default is 0)
156
+ .TP
157
+ .BI \-sz " number"
158
+ Specifies the size of crop square in pixels (image output) or points (vector output) (sets \-W and \-H)
159
+ .TP
160
+ .B \-cropbox
161
+ Uses the crop box rather than media box when generating the files (PNG/JPEG/TIFF only)
162
+ .TP
163
+ .B \-mono
164
+ Generate a monochrome file (PNG and TIFF only).
165
+ .TP
166
+ .B \-gray
167
+ Generate a grayscale file (PNG, JPEG, and TIFF only).
168
+ .TP
169
+ .B \-transp
170
+ Use a transparent page color instead of white (PNG and TIFF only).
171
+ .TP
172
+ .BI \-icc " icc-file"
173
+ Use the specified ICC file as the output profile (PNG only). The profile will be embedded in the PNG file.
174
+ .TP
175
+ .B \-level2
176
+ Generate Level 2 PostScript (PS only).
177
+ .TP
178
+ .B \-level3
179
+ Generate Level 3 PostScript (PS only). This enables all Level 2 features plus
180
+ shading patterns and masked images. This is the default setting.
181
+ .TP
182
+ .B \-origpagesizes
183
+ This option is the same as "\-paper match".
184
+ .TP
185
+ .BI \-paper " size"
186
+ Set the paper size to one of "letter", "legal", "A4", or "A3"
187
+ (PS,PDF,SVG only). This can also be set to "match", which will set
188
+ the paper size of each page to match the size specified in the PDF
189
+ file. If none the \-paper, \-paperw, or \-paperh options are
190
+ specified the default is to match the paper size.
191
+ .TP
192
+ .BI \-paperw " size"
193
+ Set the paper width, in points (PS,PDF,SVG only).
194
+ .TP
195
+ .BI \-paperh " size"
196
+ Set the paper height, in points (PS,PDF,SVG only).
197
+ .TP
198
+ .B \-nocrop
199
+ By default, printing output is cropped to the CropBox specified in the PDF
200
+ file. This option disables cropping (PS,PDF,SVG only).
201
+ .TP
202
+ .B \-expand
203
+ Expand PDF pages smaller than the paper to fill the paper (PS,PDF,SVG only). By
204
+ default, these pages are not scaled.
205
+ .TP
206
+ .B \-noshrink
207
+ Don't scale PDF pages which are larger than the paper (PS,PDF,SVG only). By default,
208
+ pages larger than the paper are shrunk to fit.
209
+ .TP
210
+ .B \-nocenter
211
+ By default, PDF pages smaller than the paper (after any scaling) are
212
+ centered on the paper. This option causes them to be aligned to the
213
+ lower-left corner of the paper instead (PS,PDF,SVG only).
214
+ .TP
215
+ .B \-duplex
216
+ Adds the %%IncludeFeature: *Duplex DuplexNoTumble DSC comment to the
217
+ PostScript file (PS only). This tells the print manager to enable duplexing.
218
+ .TP
219
+ .BI \-printer " printer-name"
220
+ (Windows only). When used with \-print, specifies the name of the printer to be used, instead of the system default.
221
+ .TP
222
+ .BI \-printopt " printer-options"
223
+ (Windows only). When used with \-print, takes a list of options to be used to configure the printer. See
224
+ .B WINDOWS PRINTER OPTIONS
225
+ for the available options.
226
+ .TP
227
+ .BI \-setupdlg
228
+ (Windows only). When used with \-print, the printer properties dialog is displayed
229
+ allowing the print settings to be modified before printing. The paper size selected
230
+ in the print properties dialog will be used except when -origpagesizes is specified.
231
+ .TP
232
+ .BI \-opw " password"
233
+ Specify the owner password for the PDF file. Providing this will
234
+ bypass all security restrictions.
235
+ .TP
236
+ .BI \-upw " password"
237
+ Specify the user password for the PDF file.
238
+ .TP
239
+ .B \-q
240
+ Don't print any messages or errors.
241
+ .TP
242
+ .B \-v
243
+ Print copyright and version information.
244
+ .TP
245
+ .B \-h
246
+ Print usage information.
247
+ .RB ( \-help
248
+ and
249
+ .B \-\-help
250
+ are equivalent.)
251
+ .SH EXIT CODES
252
+ The poppler tools use the following exit codes:
253
+ .TP
254
+ 0
255
+ No error.
256
+ .TP
257
+ 1
258
+ Error opening a PDF file.
259
+ .TP
260
+ 2
261
+ Error opening an output file.
262
+ .TP
263
+ 3
264
+ Error related to PDF permissions.
265
+ .TP
266
+ 4
267
+ Error related to ICC profile.
268
+ .TP
269
+ 99
270
+ Other error.
271
+ .SH WINDOWS PRINTER OPTIONS
272
+ In Windows, you can use the \-print option to print directly to a system printer. Additionally, you can use the \-printopt
273
+ option to configure the printer. It takes a string of the form "<opt>=<val>[,<opt>=<val>]". Currently the available options are:
274
+ .TP
275
+ .BI source
276
+ Selects the source paper tray to be used (bin). The possible values are "upper", "onlyone", "lower", "middle", "manual", "envelope",
277
+ "envmanual", "auto", "tractor", "smallfmt", "largefmt", "largecapacity", "formsource", or a numeric value to choose a driver specific source.
278
+ .TP
279
+ .BI duplex
280
+ Sets the duplex mode of the printer. The possible values are "off", "short" or "long",
281
+ indicating no duplexing, short-edge binding, or long-edge binding, respectively.
282
+ General option \-duplex is a synonym of "duplex=long". If both options are specified,
283
+ \-printopt has priority.
284
+ .SH AUTHOR
285
+ The pdftocairo software and documentation are copyright 1996-2004 Glyph
286
+ & Cog, LLC and copyright 2005-2011 The Poppler Developers.
287
+ .SH "SEE ALSO"
288
+ .BR pdfdetach (1),
289
+ .BR pdffonts (1),
290
+ .BR pdfimages (1),
291
+ .BR pdfinfo (1),
292
+ .BR pdftohtml (1),
293
+ .BR pdftoppm (1),
294
+ .BR pdftops (1),
295
+ .BR pdftotext (1)