| Extracted from Pike v7.8 release 866 at 2018-02-09.

[Top]
Image
Image.PS

# Method Image.PS.decode()

Method decode

  `object decode(string data, mapping|void options)`

Description

  Decodes the postscript data into an image object using Ghostscript.

Parameter `options`

  Optional decoding parameters.

  `"dpi" : int` | The resolution the image should be rendered in. Defaults to 100.
  `"device" : string` | The selected Ghostscript device. Defaults to "ppmraw".
  `"binary" : string` | Path to the Ghostscript binary to be used. If missing the environment paths will be searched for a file "gs" to be used instead.
  `"force_gs" : int(0..1)` | Forces use of Ghostscript for EPS files instead of Pikes native support.
  `"eps_crop" : int(0..1)` | Use -dEPSCrop option to Ghostscript to crop the BoundingBox for a EPS file.
  `"cie_color" : int(0..1)` | Use -dUseCIEColor option to Ghostscript for mapping color values through a CIE color space.
  `"file" : string` | Filename to read. If this is specified, it will be passed along to the `gs` binary, so that it can read the file directly. If this is specified data may be set to `0` (zero).

Note

  Some versions of `gs` on MacOS X have problems with reading files on stdin. If this occurrs, try writing to a plain file and specifying the `file` option.

Note

  `gs` versions 7.x and earlier don't support rendering of EPSes if they are specified with the `file` option. If this is a problem, upgrade to `gs` version 8.x or later.