NAME

       img-ps - Img, Adobe PostScript Format (ps)

SYNOPSIS

       package require Tk

       package require img::ps  ?1.4?

       image create photo ?name? ?options?

_________________________________________________________________________________________________

DESCRIPTION

       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 if 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.

NOTE

       This format handler must be loaded explicitly with package require img::ps.

POSTSCRIPT OPTIONS

       The handler is not able to write images in PostScript or PDF.  The  handler  provides  the
       following options:

       -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-dted, img-flir, img-gif, img-ico, img-intro, img-jpeg,  img-pcx,  img-pixmap,
       img-png,  img-ppm,  img-ps, img-raw, 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-2023 Jan Nijtmans <nijtmans@users.sourceforge.net>