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>