NAME¶
img-ps - Img, Adobe PostScript Format (ps)
SYNOPSIS¶
package require
Tk
package require
img::ps ?1.4?
image create photo ?
name? ?
options?
DESCRIPTION¶
The package
img::ps is a sub-package of
Img. It can be loaded as a
part of the complete Img support, via
package require Img, or on its
own, via
package require img::ps.
Like all packages of
Img it does
not provide new commands, but
extends the existing
Tk command
image so that it supports files
containing raster images in the Adobe PostScript Format (ps). More
specifically
img::ps extends
Tk's
photo image type.
The name of the new format handler is
ps. This handler provides new
additional configuration options. See section
PostScript OPTIONS for
more detailed explanations.
Note that this package provides a
pdf handler too, i.e. a handler for the
Adobe Portable Document Format. That handler accepts the same options as the
ps handler.
The package delegates the actual conversion of data in PostScript and PDF format
into a raster image to the
ghostscript application. It therefore
depends upon the presence of said application and is non-functional is
ghostscript is not present.
All of the above means that in a call like
- image create photo ?name? ?options?
- [1]
- Image data in ps and PDF format (options -data and -file) is
detected automatically.
- [2]
- The format names ps and pdf are recognized by the option
-format. In addition the value for the option is treated as list
and may contain any of the special options listed in section PostScript
OPTIONS.
POSTSCRIPT OPTIONS¶
The handler provides two options, both influencing the reading of PostScript or
PDF images. The handler is
not able to write images in PostScript or
PDF.
- -index n
- This option is for reading from PostScript/PDF data containing more than
one page. When specified it will read the n'th page in the data.
The first page is at index 0 and will be read by default, i.e. when
the option is not specified.
Note: This option is not yet implemented.
- -zoom X Y
- Multiply image size by the given scale factors. If Y is missing,
the default is the same as X. X and 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.
REQUIREMENTS¶
The code provided by Img does not perform the interpretation and rasterizing of
the input by itself but delegates this to the
gs application. This is
the GhostScript implementation of PostScript (and PDF).
If
gs is not installed this format handler cannot be used.
SEE ALSO¶
img-bmp, img-gif, img-ico, img-intro, 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¶
ghostscript, gs, image handling, pdf, postscript, ps, tk
COPYRIGHT¶
Copyright (c) 1995-2009 Jan Nijtmans <nijtmans@users.sourceforge.net>