From 87e4386b7b52856a3b79d5e70780a96e1fbfdb65 Mon Sep 17 00:00:00 2001 From: Andrew Murray Date: Tue, 12 Sep 2023 21:49:44 +1000 Subject: [PATCH] Document gs_binary property --- docs/handbook/image-file-formats.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst index 2a42bdacba7..a0fcb87aba3 100644 --- a/docs/handbook/image-file-formats.rst +++ b/docs/handbook/image-file-formats.rst @@ -88,8 +88,14 @@ in ``L``, ``RGB`` and ``CMYK`` modes. Loading ~~~~~~~ +To use Ghostscript, Pillow searches for the "gs" executable. On Windows, it +also searches for "gswin32c" and "gswin64c". If you would like to customise +this behaviour, `EpsImagePlugin.gs_binary = "gswin64"` will set the name of the +executable to use. `EpsImagePlugin.gs_binary = False` will prevent Ghostscript +from being used altogether. + If Ghostscript is available, you can call the :py:meth:`~PIL.Image.Image.load` -method with the following parameters to affect how Ghostscript renders the EPS +method with the following parameters to affect how Ghostscript renders the EPS. **scale** Affects the scale of the resultant rasterized image. If the EPS suggests