blob: 96b4a6b70cf08e02277641151ced420fbdebaa0c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
[comment {-*- tcl -*- doctools}]
[vset FORMATNAME ps]
[vset FORMATFULLNAME {Adobe PostScript Format}]
[include format-header.inc]
This handler provides new additional configuration options. See
section [sectref {PostScript OPTIONS}] for more detailed explanations.
[para]
Note that this package provides a [const pdf] handler too, i.e. a
handler for the Adobe Portable Document Format. That handler accepts
the same options as the [const [vset FORMATNAME]] handler.
[para]
The package delegates the actual conversion of data in PostScript and
PDF format into a raster image to the [syscmd ghostscript]
application. It therefore depends upon the presence of said
application and is non-functional is [syscmd ghostscript] is not
present.
[para]
All of the above means that in a call like
[list_begin definitions]
[call [cmd image] [method {create photo}] [opt [arg name]] [opt [arg options]]]
[list_end]
[list_begin enum]
[enum]
Image data in [vset FORMATNAME] and PDF format (options [option -data]
and [option -file]) is detected automatically.
[enum]
The format names [const [vset FORMATNAME]] and [const pdf] are
recognized by the option [option -format].
In addition the value for the option is treated as list and may
contain any of the special options listed in section
[sectref {PostScript OPTIONS}].
[list_end]
[section {PostScript OPTIONS}]
The handler provides two options, both influencing the reading of
PostScript or PDF images. The handler is [emph not] able to write
images in PostScript or PDF.
[list_begin definitions]
[lst_item "[option -index] [arg n]"]
This option is for reading from PostScript/PDF data containing more
than one page. When specified it will read the [arg n]'th page in the
data. The first page is at index [const 0] and will be read by
default, i.e. when the option is not specified.
[nl]
[emph Note:] This option is not yet implemented.
[lst_item "[option -zoom] [arg X] [arg Y]"]
Multiply image size by the given scale factors. If [arg Y] is missing,
the default is the same as [arg X]. [arg X] and [arg Y] are allowed to
be in floating point format, but they are rounded to the nearest
practically possible value. For postscript this means the zoom factors
should be multiples of 1/72.
[list_end]
[section REQUIREMENTS]
The code provided by Img does not perform the interpretation and
rasterizing of the input by itself but delegates this to the
[syscmd gs] application. This is the GhostScript implementation
of PostScript (and PDF).
[para]
If [syscmd gs] is not installed this format handler cannot be used.
[see_also img-intro img-bmp img-gif img-ico img-jpeg img-pcx img-pixmap img-png img-ppm img-ps img-sgi img-sun img-tga img-tiff img-window img-xbm img-xpm]
[keywords {image handling} tk [vset FORMATNAME] pdf postscript gs ghostscript]
[manpage_end]
|