Ghostscript

https://ghostscript.readthedocs.io/en/latest
Admin
Ghostscript is an interpreter for PostScript and PDF files that consists of a PostScript interpreter...
Tokens:148,667
Snippets:2,097
Trust Score:8.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### Build self-extracting installer

Source: https://ghostscript.readthedocs.io/en/latest/Make.html

Create an NSIS-based installer for 64-bit Windows.

```batch
nmake -f psi/msvc.mak WIN64= nsis
```

--------------------------------

### Execute Ghostscript with a setup file

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Use this command-line pattern to include a PostScript setup file for device configuration.

```bash
gs ... setup.ps ...
```

--------------------------------

### Build and Install Ghostscript on Unix

Source: https://ghostscript.readthedocs.io/en/latest/Install.html

Standard commands to configure, build, and install Ghostscript from source.

```bash
./configure
make
```

```bash
make install
```

--------------------------------

### Page-per-file Naming Examples

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Examples of using printf-style templates to generate sequential filenames for multi-page output.

```bash
-sOutputFile=ABC-%d.png
   produces 'ABC-1.png', ... , 'ABC-10.png', ..
-sOutputFile=ABC-%03d.pgm
   produces 'ABC-001.pgm', ... , 'ABC-010.pgm', ...
-sOutputFile=ABC_p%04d.tiff
   produces 'ABC_p0001.tiff', ... , 'ABC_p0510.tiff', ... , 'ABC_p5238.tiff'
```

--------------------------------

### Run gsviewer on Linux

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Make the start script executable and run the application.

```bash
chmod +x start_linux.sh
./start_linux.sh
```

--------------------------------

### Run gsviewer on MacOS

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Make the start script executable and run the application.

```bash
chmod +x start_darwin.sh
./start_darwin.sh
```

--------------------------------

### Decompress and Install Ghostscript Snap

Source: https://ghostscript.readthedocs.io/en/latest/Install.html

Steps to extract the Snap archive before installation.

```bash
gunzip gs_N.NN.N_amd64_snap.tgz
tar xvf gs_N.NN.N_amd64_snap.tar
```

--------------------------------

### Build Ghostscript with make

Source: https://ghostscript.readthedocs.io/en/latest/Make.html

Standard make commands for building, cleaning, and installing Ghostscript.

```bash
make
```

```bash
make debug
```

```bash
make pg
```

```bash
make install
```

```bash
make (debug)clean
```

```bash
make so
```

```bash
make sanitize
```

```bash
make libgs
```

```bash
make libgpcl6
```

```bash
make libgxps
```

```bash
make libgpdl
```

--------------------------------

### Install build dependencies on macOS

Source: https://ghostscript.readthedocs.io/en/latest/Make.html

Command to install autoconf and automake using Homebrew.

```bash
brew install autoconf automake
```

--------------------------------

### Object Dependent Color Configuration File Example

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Example of a tab-delimited configuration file used with the -sSourceObjectICC parameter to define color profiles and settings for different object types.

```text
Vector_CMYK     cmyk_src_cyan.icc       0   1   0     0
Image_CMYK      cmyk_src_magenta.icc    0   1   0     0
Text_CMYK       cmyk_src_yellow.icc     0   1   0     0
Vector_RGB      rgb_source_red.icc      0   1   0
Image_RGB       rgb_source_green.icc    0   1   0
Text_RGB        rgb_source_blue.icc     0   1   0
```

--------------------------------

### Begin string execution

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsCSharp.html

Starts the execution of a string command sequence.

```csharp
public static extern int gsapi_run_string_begin(IntPtr instance,
                                                   int usererr,
                                               ref int exitcode);
```

--------------------------------

### Set X Device Parameters via Command Line

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Example of setting X driver parameters using the -d switch.

```bash
-dMaxBitmap=10000000
```

--------------------------------

### Implement DistillPS Method

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsCSharp.html

Example of setting up a parameter payload for a PostScript distillation task.

```csharp
public gsStatus DistillPS(String fileName, int resolution)
{
    gsParamState_t gsparams = new gsParamState_t();
    gsparams.args = new List<string>();

    gsparams.inputfile = fileName;
    gsparams.args.Add("gs");
    gsparams.args.Add("-sDEVICE=pdfwrite");
    gsparams.outputfile = Path.GetTempFileName();
    gsparams.args.Add("-o" + gsparams.outputfile);
    gsparams.task = GS_Task_t.PS_DISTILL;

    return RunGhostscriptAsync(gsparams);
}
```

--------------------------------

### Configure X Resources in .Xdefaults

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Example format for defining Ghostscript X resources in a configuration file.

```text
Ghostscript*geometry: 595x842-0+0
Ghostscript*xResolution: 72
Ghostscript*yResolution: 72
```

--------------------------------

### Install Ghostscript Snap in Devmode

Source: https://ghostscript.readthedocs.io/en/latest/Install.html

Command to install the Ghostscript snap package with required devmode permissions.

```bash
sudo snap install --devmode gs_N.NN.N_amd64.snap
```

--------------------------------

### Begin string execution

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Starts the execution of a string within the interpreter.

```java
public static native int gsapi_run_string_begin(long instance,
                                                 int userErrors,
                                  Reference<Integer> pExitCode);
```

--------------------------------

### Content of parameter file

Source: https://ghostscript.readthedocs.io/en/latest/VectorDevices.html

Example content for a parameter file used with the @ syntax.

```bash
-c '<</AlwaysEmbed [/Helvetica /Times-Roman]>> setdistillerparams' -f in.ps
```

--------------------------------

### Install Ghostscript via RPM

Source: https://ghostscript.readthedocs.io/en/latest/Install.html

Commands to upgrade or install Ghostscript using precompiled RPM files.

```bash
rpm -U ghostscript-N.NN.N-1.i386.rpm
rpm -U ghostscript-fonts-N.NN.N-1.noarch.rpm
```

--------------------------------

### Define default X Windows driver

Source: https://ghostscript.readthedocs.io/en/latest/Make.html

Example of setting the default device driver to X11.

```makefile
DEVICE_DEVS=$(DD)x11.dev
```

--------------------------------

### Install subclassing device in open method

Source: https://ghostscript.readthedocs.io/en/latest/DeviceSubclassing.html

Modify the device open method to push the subclassing device if the feature is enabled.

```c
int tiff_open(gx_device *pdev)
{
   gx_device_printer * const ppdev = (gx_device_printer *)pdev;
   gx_device_tiff *tfdev = (gx_device_tiff *)pdev;
   int code;
   bool update_procs = false;

   /* Use our own warning and error message handlers in libtiff */
   tiff_set_handlers();

   if (!tfdev->BlackTextHandlerPushed && (tfdev->ForceBlackText != 0)) {
   gx_device *dev;

   gx_device_subclass(pdev, (gx_device *)&gs_black_text_device, sizeof(black_text_subclass_data));
   tfdev = (gx_device_tiff *)pdev->child;
   tfdev->BlackTextHandlerPushed = true;

   while(pdev->child)
   pdev = pdev->child;
   pdev->is_open = true;
   update_procs = true;
}
```

--------------------------------

### Include header file in Makefile

Source: https://ghostscript.readthedocs.io/en/latest/C-style.html

Example of including a header file in a Makefile.

```Makefile
#include "xxx.h"
```

```Makefile
#include "math_.h"
```

--------------------------------

### Run OCR Device Example

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Executes the OCR device to process a PDF file using English and Arabic language data.

```bash
gs -sDEVICE=ocr -r200 -sOCRLanguage="eng+ara" -o out.txt\
   zlib/zlib.3.pdf
```

--------------------------------

### Populate CMM procedure pointers

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Example assignments for standard CMM procedure pointers.

```c
map_buffer = gscms_transform_color_buffer;
map_color = gscms_transform_color;
free_link = gscms_release_link;
```

--------------------------------

### File path permission patterns

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Examples of path strings used to define file access permissions.

```text
"/path/to/file"
```

```text
"/path/to/directory/"
```

```text
"/path/to/directory/*"
```

--------------------------------

### Get profile handle from file

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Obtain a profile handle given a file name.

```c
gcmmhprofile_t gscms_get_profile_handle_file(const char *filename);
```

--------------------------------

### .pushpdf14devicefilter

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Installs the transparency compositor device into the graphics state. Must be called before any marking operations on the page.

```APIDOC
## .pushpdf14devicefilter

### Description
Installs the transparency compositor device into the graphics state.

### Signature
<depth> .pushpdf14devicefilter -

### Parameters
- **depth** (integer) - Required - Should currently always be zero.
```

--------------------------------

### Implement parameter handling methods

Source: https://ghostscript.readthedocs.io/en/latest/DeviceSubclassing.html

Update get and put methods in gdevtifs.c to support the new ForceBlackText parameter.

```c
static int tiff_get_some_params(gx_device * dev, gs_param_list * plist, int which)
{
   gx_device_tiff *const tfdev = (gx_device_tiff *)dev;
   int code = gdev_prn_get_params(dev, plist);
   int ecode = code;
   gs_param_string comprstr;

   if ((code = param_write_bool(plist, "ForceBlackText", &tfdev->ForceBlackText)) < 0)
   ecode = code;
   ....
}

static int tiff_put_some_params(gx_device * dev, gs_param_list * plist, int which)
{
   gx_device_tiff *const tfdev = (gx_device_tiff *)dev; int ecode = 0;
   int code;
   const char *param_name;
   bool big_endian = tfdev->BigEndian;
   bool usebigtiff = tfdev->UseBigTIFF;
   uint16 compr = tfdev->Compression;
   gs_param_string comprstr;
   long downscale = tfdev->DownScaleFactor;
   long mss = tfdev->MaxStripSize;
   long aw = tfdev->AdjustWidth;
   long mfs = tfdev->MinFeatureSize;
   bool ForceBlackText = tfdev->ForceBlackText;

   /* Read ForceBlackText option as bool */
   switch (code = param_read_bool(plist, (param_name = "ForceBlackText"), &ForceBlackText)) {
      default:
      ecode = code;
      param_signal_error(plist, param_name, ecode);
      case 0:
      case 1:
      break;
   }

   /* Read BigEndian option as bool */
   switch (code = param_read_bool(plist, (param_name = "BigEndian"), &big_endian)) {
      ...
      tfdev->MinFeatureSize = mfs;
      tfdev->ForceBlackText = ForceBlackText;
      return code;
   }
}
```

--------------------------------

### Example Unified Printer Parameter (.upp) file

Source: https://ghostscript.readthedocs.io/en/latest/UnsupportedDevices.html

A sample configuration file for the Epson Stylus Color I printer, illustrating parameter definitions and printer command sequences.

```text
-supModel="Epson Stylus Color I (and PRO Series), 360x360DpI, noWeave"
-sDEVICE=uniprint                    -- Select the driver
-dNOPAUSE                            -- Useful with printers
-dSAFER                              -- Provides some security
-dupColorModel=/DeviceCMYK           -- Selects the color mapping
-dupRendering=/ErrorDiffusion        -- Selects the color rendering
-dupOutputFormat=/EscP2              -- Selects the output format
-r360x360                            -- Adjusts the resolution
-dupMargins="{ 9.0 39.96 9.0 9.0}"   -- Establishes (L/B/R/T margins in points)
-dupComponentBits="{1 1 1 1}"        -- Map: bits per component (default: 8)
-dupWeaveYPasses=4                   -- Weave: Y-passes (default: 1)
-dupOutputPins=15                    -- Format/weave: scans per Command
-dupBeginPageCommand="<              -- Goes to the printer
  1b40   1b40                        -- ESC '@' ESC '@'    -> dual reset
  1b2847 0100 01                     -- ESC '(' 'G' 1 0 1  -> graphics
  1b2869 0100 00                     -- ESC '(' 'i' 1 0 1  -> no HW weave
  1b2855 0100 0A                     -- ESC '(' 'U' 1 0 10 -> 360dpi
  1b5500                             -- ESC 'U'  0         -> bidir print
  1b2843 0200 0000                   -- ESC '(' 'C' 2 0 xx -> page length
  1b2863 0400 0000 0000              -- ESC '(' 'c' 4 0 xxxx -> margins
>"                                   -- as it is, unless:
-dupAdjustPageLengthCommand          -- Adjust page length in BOP requested
-dupAdjustTopMarginCommand           -- Adjust top margin in BOP
-dupAdjustBottomMarginCommand        -- Adjust bottom margin in BOP
-dupEndPageCommand="(\033@\014)"     -- Last (but one) data to the printer
-dupAbortCommand="(\033@\15\12\12\12\12    Printout-Aborted\15\014)"
```

--------------------------------

### Define Identity Registry and Ordering

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Example of CID system info where the language cannot be determined.

```PostScript
/Registry (Adobe) /Ordering (Identity)
```

--------------------------------

### View Configuration Help

Source: https://ghostscript.readthedocs.io/en/latest/Make.html

Display available configuration options for the build process.

```bash
./configure --help
```

--------------------------------

### Validate Ghostscript installation

Source: https://ghostscript.readthedocs.io/en/latest/Install.html

Checks the installed version of Ghostscript to verify the installation was successful.

```shell
gs --version
```

--------------------------------

### Configure device settings with a PostScript setup file

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Define device properties like resolution, bit depth, and printer selection within a PostScript dictionary passed to setpagedevice.

```postscript
 <<
   /NoCancel      true                       % don't show the cancel dialog
   /BitsPerPixel  4                          % force 4 bits/pixel
   /UserSettings
     <<
       /DocumentName  (Ghostscript document) % name for the Windows spooler
       /MaxResolution 360                    % maximum document resolution
     >>
   /OutputDevice /mswinpr2                   % select the Windows device driver
 >> setpagedevice
setdevice
```

--------------------------------

### Initialize Ghostscript Instance

Source: https://ghostscript.readthedocs.io/en/latest/API.html

Create a new Ghostscript instance and configure standard I/O redirection.

```c
void *minst = NULL;
code = gsapi_new_instance(&minst, NULL);
code = gsapi_set_stdio(minst, gsdll_stdin, gsdll_stdout, gsdll_stderr);
```

--------------------------------

### Initialize device state

Source: https://ghostscript.readthedocs.io/en/latest/Drivers.html

Performs minimum internal state initialization after the procedure table is set. Should return an error if setup fails.

```c
int (*initialize_device)(gx_device *dev) [OPTIONAL]
```

--------------------------------

### Ghostscript Invocation with Coding and Transfer Parameters

Source: https://ghostscript.readthedocs.io/en/latest/UnsupportedDevices.html

Example command line for configuring color coding and transfer functions in Ghostscript.

```bash
gs -sDEVICE=stcolor -sDithering=fscmyk -dBitsPerPixel=16 \
     -dKcoding='{ 0.0 0.09 0.9 1.0 }' \
     -dMcoding='{ 0.0 0.09 0.9 1.0 }' \
   -dKtransfer='{ 0.0 0.09 0.9 1.0 }' \
   -dYtransfer='{ 0.0 0.09 0.9 1.0 }'
```

--------------------------------

### Convert PostScript to PNG using Ghostscript

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Command-line examples for converting PostScript or PDF files to PNG images with specific device and anti-aliasing settings.

```bash
gs -dSAFER -dBATCH -dNOPAUSE -sDEVICE=png16m -dGraphicsAlphaBits=4 \
   -sOutputFile=tiger.png examples/tiger.png
gs -dSAFER -dBATCH -dNOPAUSE -r150 -sDEVICE=pnggray -dTextAlphaBits=4 \
   -sOutputFile=doc-%02d.png doc.pdf
```

--------------------------------

### Specify Device Link Profile

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Example command line configuration for mapping colors through an sRGB profile and a device link profile to CMYK.

```bash
-sDEVICE=tiff32nc -sOutputICCProfile=srgb.icc -sDeviceLinkProfile=linkRGBtoCMYK.icc
```

--------------------------------

### DisplayDeviceOpen()

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsCSharp.html

Initializes the display device, instantiates Ghostscript, and configures callbacks.

```APIDOC
## DisplayDeviceOpen()

### Description
Sets up the display device ahead of time. Calling this method instantiates Ghostscript and configures the encoding and the callbacks for the display device.

### Signature
public gsParamState_t DisplayDeviceOpen()

### Example
m_ghostscript.DisplayDeviceOpen();
```

--------------------------------

### Configure Page Selection with -sPageList

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Examples of using the -sPageList switch to define which pages to process in a document.

```bash
-sPageList=1,3,5 indicates that pages 1, 3 and 5 should be processed.
-sPageList=5-10 indicates that pages 5, 6, 7, 8, 9 and 10 should be processed.
-sPageList=1,5-10,12- indicates that pages 1, 5, 6, 7, 8, 9, 10 and 12 onwards should be processed.
-sPageList=odd:3-7,9-,-1,8 processes pages 3, 5, 7, 9, 10, 11, ..., last, last, last-1, ..., 1, 8
```

--------------------------------

### Implement text_begin device method

Source: https://ghostscript.readthedocs.io/en/latest/DeviceSubclassing.html

Defines the text_begin method to allocate the enumerator, initialize it, and delegate to the child device.

```c
/* The device method which we do actually need to define. */
int black_text_text_begin(gx_device *dev, gs_imager_state *pis, const gs_text_params_t *text,
gs_font *font, gx_path *path, const gx_device_color *pdcolor, const gx_clip_path *pcpath,
gs_memory_t *memory, gs_text_enum_t **ppte)
{
   black_text_text_enum_t *penum;
   int code;
   gs_text_enum_t *p;

   rc_alloc_struct_1(penum, black_text_text_enum_t, &st_black_text_text_enum, memory,
   return_error(gs_error_VMerror), "black_text_text_begin");
   penum->rc.free = rc_free_text_enum;
   code = gs_text_enum_init((gs_text_enum_t *)penum, &black_text_text_procs,
   dev, pis, text, font, path, pdcolor, pcpath, memory);
   if (code < 0) {
      gs_free_object(memory, penum, "black_text_text_begin");
      return code;
   }
   *ppte = (gs_text_enum_t *)penum;

   code = default_subclass_text_begin(dev, pis, text, font, path, pdcolor, pcpath, memory, &p);
   if (code < 0) {
      gs_free_object(memory, penum, "black_text_text_begin");
      return code;
   }
   penum->child = p;

   return 0;
}
```

--------------------------------

### Identify CID System Info

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Example of a CID system info dictionary used for font substitution.

```PostScript
/CIDSystemInfo << /Registry (Adobe) /Ordering (CNS1) /Supplement 1 >>
```

--------------------------------

### Generate PDF with Downscaling

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Example command to produce a 200dpi PDF output from a 600dpi internal rendering using a downscale factor of 3.

```bash
gs -sDEVICE=pdfimage8 -r600 -dDownScaleFactor=3 -o tiger.pdf\
   examples/tiger.eps
```

--------------------------------

### Configure device parameters via command line

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Sets device-specific parameters like GrayValues during initialization.

```bash
-sDEVICE=ppmraw -dGrayValues=16
```

--------------------------------

### gsicc_getprofilesize

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Get the size of a profile.

```APIDOC
## gsicc_getprofilesize

### Description
Get the size of a profile, as given by the profile information.

### Signature
`unsigned int gsicc_getprofilesize(unsigned char *buffer);`
```

--------------------------------

### Configure NCLR Output Colors and Max Spots

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Example configuration for using a 6-color ICC profile with additional spot colors and a custom maximum spot count.

```bash
-sICCOutputColors="Cyan, Magenta, Yellow, Black, Orange, Violet, Varnish" -dMaxSpots=4 -sOutputICCProfile=My_6CLR_Profile.icc
```

--------------------------------

### Handling Filenames Starting with Percent

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Prepend %os% to filenames that begin with a percent sign to avoid conflict with PostScript filedevice syntax.

```bash
gs -sOutputFile=%os%%abc
```

```bash
gs -sOutputFile=%%os%%%%abc
```

--------------------------------

### Get Parameter

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Wraps the gsapi_get_param method.

```java
public int get_param(byte[] param,
                       long value,
                        int paramType);

public int get_param(String param,
                       long value,
                        int paramType);
```

--------------------------------

### Open device instance

Source: https://ghostscript.readthedocs.io/en/latest/Drivers.html

Initializes the device to make it valid for output. Always call gs_opendevice instead of this procedure directly.

```c
int (*open_device)(gx_device *) [OPTIONAL]
```

--------------------------------

### Get Default Device List

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Wraps the gsapi_get_default_device_list method.

```java
public int get_default_device_list(Reference<byte[]> list,
                                   Reference<Integer> listlen);
```

--------------------------------

### Initialize Ghostscript arguments

Source: https://ghostscript.readthedocs.io/en/latest/API.html

Setting up the argument array for Ghostscript initialization.

```c
int argc = 0;
/* Allow for up to 32 args of up to 64 chars each. */
char argv[32][64];
sprintf(argc[argc++], "gs");
sprintf(argv[argc++], "-sDEVICE=display");
```

--------------------------------

### .knownget

Source: https://ghostscript.readthedocs.io/en/latest/Ps-style.html

Combines the known and get operations for dictionary lookups.

```APIDOC
## .knownget

### Description
Checks if a key exists in a dictionary and retrieves its value if present.

### Syntax
<dict> <key> .knownget <value> true
<dict> <key> .knownget false
```

--------------------------------

### fill_parallelogram

Source: https://ghostscript.readthedocs.io/en/latest/Drivers.html

Fills a parallelogram defined by a starting corner and two vectors.

```APIDOC
int (*fill_parallelogram)(gx_device *dev, fixed px, fixed py, fixed ax, fixed ay, fixed bx, fixed by, const gx_drawing_color *pdcolor, gs_logical_operation_t lop)
```

--------------------------------

### DisplayDeviceOpen()

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsCSharp.html

Initializes the display device, instantiates Ghostscript, and configures encoding and callbacks.

```APIDOC
## public gsParamState_t DisplayDeviceOpen()

### Description
Sets up the display device ahead of time. Calling this method instantiates Ghostscript and configures the encoding and the callbacks for the display device.
```

--------------------------------

### Get initial transformation matrix

Source: https://ghostscript.readthedocs.io/en/latest/Drivers.html

Constructs the matrix mapping user coordinates to device coordinates. The default implementation assumes an upper-left origin.

```c
void (*get_initial_matrix)(gx_device *, gs_matrix *) [OPTIONAL]
```

```text
xx = x_pixels_per_inch/72, xy = 0,
yx = 0, yy = -y_pixels_per_inch/72,
tx = 0, ty = height.
```

--------------------------------

### Define Ghostscript Printer Devices

Source: https://ghostscript.readthedocs.io/en/latest/Unix-lpr.html

Example configuration for the DEVICES variable in lprsetup.sh, demonstrating support for multiple bit depths and dual queue configurations.

```bash
DEVICES="cdj550.24.dq cdj550.3.dq cdj550.1.dq deskjet djet500.dq"
```

--------------------------------

### Prototype Device Text Begin Method

Source: https://ghostscript.readthedocs.io/en/latest/DeviceSubclassing.html

Declares the prototype for the text_begin device method.

```C
/* Device procedures */
static dev_proc_text_begin(black_text_text_begin);
```

--------------------------------

### Initialize Ghostscript with arguments

Source: https://ghostscript.readthedocs.io/en/latest/API.html

Passing the configured arguments to the Ghostscript interpreter.

```c
code = gsapi_init_with_args(minst, argc, argv);
```

--------------------------------

### Get output channel count

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Returns the number of output channels for the profile.

```c
int gscms_get_output_channel_count(gcmmhprofile_t profile);
```

--------------------------------

### Use -dJOBSERVER with input file

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Demonstrates how to use the -dJOBSERVER switch with an input file via stdin.

```bash
gs ... -dJOBSERVER - < inputfile.ps
```

```bash
cat inputfile.ps | gs ... -dJOBSERVER -
```

--------------------------------

### Start Run String Operation

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsPython.html

Initiates a run_string operation on the Ghostscript instance.

```python
exitcode = gsapi.gsapi_run_string_begin(instance, 0)
```

--------------------------------

### Configure Printer Initialization for 600x600 Resolution

Source: https://ghostscript.readthedocs.io/en/latest/UnsupportedDevices.html

Use this command string for the -dupBeginPageCommand option when setting up 600x600 resolution.

```text
1b28 64 0400 0258 0258
```

--------------------------------

### Begin Transparency Group

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Initializes a new transparency group with a specified bounding box and parameter dictionary.

```PostScript
<paramdict> <llx> <lly> <urx> <ury> .begintransparencygroup -
```

--------------------------------

### Define CID Font Mappings

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Examples of mapping font names to specific file paths and character sets using different formats.

```PostScript
/Ryumin-Medium /ShinGo-Bold ;
/Ryumin-Light /MS-Mincho ;
Format 2:
/Batang << /FileType /TrueType /Path (C:/WINDOWS/fonts/batang.ttc) /SubfontID 0 /CSI [(Korea1) 3] >> ;
/Gulim << /FileType /TrueType /Path (C:/WINDOWS/fonts/gulim.ttc) /SubfontID 0 /CSI [(Korea1) 3] >> ;
/Dotum << /FileType /TrueType /Path (C:/WINDOWS/fonts/gulim.ttc) /SubfontID 2 /CSI [(Korea1) 3] >> ;
```

```PostScript
/SimSun << /FileType /TrueType /Path (C:/WINDOWS/fonts/simsun.ttc) /SubfontID 0 /CSI [(GB1) 2] >> ;
/SimHei << /FileType /TrueType /Path (C:/WINDOWS/fonts/simhei.ttf) /SubfontID 0 /CSI [(GB1) 2] >> ;
/STSong-Light /SimSun ;
/STHeiti-Regular /SimHei ;
Format 3:
/PMingLiU (/usr/local/share/font/cidfont/PMingLiU.cid) ;
```

```PostScript
/Ryumin-Light /PMingLiU ;
/PMingLiU (/usr/local/share/font/cidfont/PMingLiU.cid) ;
```

--------------------------------

### Initialize with Arguments

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Wraps the gsapi_init_with_args method with multiple input types.

```java
public int init_with_args(int argc,
                     byte[][] argv);

public int init_with_args(String[] argv);

public int init_with_args(List<String> argv);
```

--------------------------------

### Bounding Box Output Format

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Example of the output format generated by the bbox device.

```text
%%BoundingBox: 14 37 570 719
%%HiResBoundingBox: 14.3ep08066 37.547999 569.495061 718.319158
```

--------------------------------

### Initialize Library and Memory Manager

Source: https://ghostscript.readthedocs.io/en/latest/Lib.html

Perform library initialization and allocate the graphics state memory.

```c
gs_ref_memory_t *imem;
#define mem ((gs_memory_t *)imem)
gs_state *pgs;
gx_device *dev = gx_device_list[0];

gp_init();
get_real();
gs_stdin = real_stdin;
gs_stdout = real_stdout;
gs_stderr = real_stderr;
gs_lib_init(stdout);
....
imem = ialloc_alloc_state(&gs_memory_default, 20000);
imem->space = 0;
....
pgs = gs_state_alloc(mem);
```

--------------------------------

### -dJOBSERVER

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Defines the control character (\004) to start a new encapsulated job, providing compatibility with Adobe PS Interpreters that run under a job server.

```APIDOC
## -dJOBSERVER

### Description
Defines \004 (^D) to start a new encapsulated job for compatibility with Adobe PS Interpreters. This requires input from stdin.

### Usage Example
gs ... -dJOBSERVER - < inputfile.ps

cat inputfile.ps | gs ... -dJOBSERVER -
```

--------------------------------

### Retrieve PDF page information

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Example of the dictionary structure returned by the .PDFPageInfo operator.

```PostScript
/UsesTransparency true|false
/NumSpots integer containing the number of spot inks on this page
/MediaBox [llx lly urx ury]
/HasAnnots true|false

May also contain (if they are present in the Page dictionary):
/ArtBox [llx lly urx ury]
/CropBox [llx lly urx ury]
/BleedBox [llx lly urx ury]
/TrimBox [llx lly urx ury]
/UserUnit int
/Rotate number
```

--------------------------------

### Execute GhostPCL with a settings file

Source: https://ghostscript.readthedocs.io/en/latest/VectorDevices.html

Run the GhostPCL interpreter by passing a settings file containing PJL commands before the input file.

```bash
./gpcl6 -sDEVICE=pdfwrite -dPDFA=1 -dCompressPages=false -dCompressFonts=false -sOutputFile=./out.pdf ./pdfa.pjl ./input.pcl
```

--------------------------------

### Retrieve PDF file information

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Example of the dictionary structure returned by the .PDFInfo operator.

```PostScript
/NumPages int
/Creator string
/Producer string
/IsEncrypted boolean
```

--------------------------------

### Initialize interpreter with arguments

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsJava.html

Initializes the interpreter using provided arguments. Utility methods are available for simpler String or List input.

```java
public static native int gsapi_init_with_args(long instance,
                                               int argc,
                                          byte[][] argv);
```

```java
public static int gsapi_init_with_args(long instance,
                                   String[] argv);

public static int gsapi_init_with_args(long instance,
                               List<String> argv);
```

--------------------------------

### Select output device via command line

Source: https://ghostscript.readthedocs.io/en/latest/Use.html

Use the -sDEVICE flag to specify the printer or file format driver before the input file.

```bash
gs -sDEVICE=epson myfile.ps
```

--------------------------------

### Get input channel count

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Provides the number of colorants associated with the ICC profile.

```c
int gscms_get_input_channel_count(gcmmhprofile_t profile);
```

--------------------------------

### Convert PS to PDF using GS DLL

Source: https://ghostscript.readthedocs.io/en/latest/API.html

Demonstrates initializing a Ghostscript instance to convert a PostScript file to PDF.

```c
/* Example of using GS DLL as a ps2pdf converter. */

#if defined(_WIN32) && !defined(_Windows)
# define _Windows
#endif
#ifdef _Windows
/* add this source to a project with gsdll32.dll, or compile it directly with:
 *   cl -D_Windows -Isrc -Febin\ps2pdf.exe ps2pdf.c bin\gsdll32.lib
 */
# include <windows.h>
# define GSDLLEXPORT __declspec(dllimport)
#endif

#include "ierrors.h"
#include "iapi.h"

void *minst = NULL;

int main(int argc, char *argv[])
{
    int code, code1;
    const char * gsargv[7];
    int gsargc;
    gsargv[0] = "";
    gsargv[1] = "-dNOPAUSE";
    gsargv[2] = "-dBATCH";
    gsargv[3] = "-dSAFER";
    gsargv[4] = "-sDEVICE=pdfwrite";
    gsargv[5] = "-sOutputFile=out.pdf";
    gsargv[6] = "input.ps";
    gsargc=7;

    code = gsapi_new_instance(&minst, NULL);
    if (code < 0)
        return 1;
    code = gsapi_set_arg_encoding(minst, GS_ARG_ENCODING_UTF8);
    if (code == 0)
        code = gsapi_init_with_args(minst, gsargc, gsargv);
    code1 = gsapi_exit(minst);
    if ((code == 0) || (code == gs_error_Quit))
        code = code1;

    gsapi_delete_instance(minst);

    if ((code == 0) || (code == gs_error_Quit))
        return 0;
    return 1;
}
```

--------------------------------

### Manage Transparency Compositor

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Operators for installing and removing the transparency compositor device in the graphics state.

```Postscript
<depth> .pushpdf14devicefilter -
```

```Postscript
- .popdf14devicefilter -
```

--------------------------------

### .PDFInit

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Initializes an instance of the PDF interpreter and returns a PDFContext object.

```APIDOC
## .PDFInit

### Description
Initialises an instance of the PDF interpreter. The optional dictionary can contain interpreter-level switches such as PDFDEBUG.

### Parameters
- **dict** (dictionary) - Optional - Interpreter-level switches.

### Response
- **PDFContext** (object) - An opaque object used with other PDF operators.
```

--------------------------------

### Define callout handler

Source: https://ghostscript.readthedocs.io/en/latest/API.html

Example implementation of a callout handler that responds to display device requests.

```c
static int
my_callout_handler(void *instance,
                     void *callout_handle,
                     const char *device_name,
                     int id,
                     int size,
                     void *data)
{
    /* On entry, callout_handle == the value of state passed in
     * to gsapi_register_callout. */
    /* We are only interested in callouts from the display device. */
    if (device_name == NULL || strcmp(device_name, "display"))
        return -1;

    if (id == DISPLAY_CALLOUT_GET_CALLBACK)
    {
        /* Fill in the supplied block with the details of our callback
         * handler, and the handle to use. In this instance, the handle
         * is the pointer to our test structure. */
        gs_display_get_callback_t *cb = (gs_display_get_callback_t *)data;
        cb->callback = &display_callback;
        cb->caller_handle = callout_handle;
        return 0;
    }
    return -1;
}
```

--------------------------------

### Ink Coverage Output Format

Source: https://ghostscript.readthedocs.io/en/latest/Devices.html

Example of the output format generated by ink coverage devices.

```text
Page 1
 0.10022  0.09563  0.10071  0.06259 CMYK OK
Page 2
 0.06108  0.05000  0.05834  0.04727 CMYK OK
```

--------------------------------

### Retrieve extended PDF page information

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Example of the additional fields returned by the .PDFPageInfoExt operator.

```PostScript
/Spots array of names, may be empty
/Fonts array of dictionaries, one dictionary per font used on the page.
```

--------------------------------

### Configure Plan 9 Build

Source: https://ghostscript.readthedocs.io/en/latest/Make.html

Set the compiler and flags in unix-gcc.mak for Plan 9 environments.

```makefile
CC=cc GCFLAGS=-D_BSD_EXTENSION -DPlan9
```

--------------------------------

### Define instance allocation entrypoint

Source: https://ghostscript.readthedocs.io/en/latest/GPDL.html

The proc_allocate_interp_instance_t function is used to initialize the interpreter instance during startup.

```c
typedef int (*pl_interp_proc_allocate_interp_instance_t)
                                                (pl_interp_implementation_t *,
                                                 gs_memory_t *);
```

--------------------------------

### Move to coordinate operator

Source: https://ghostscript.readthedocs.io/en/latest/Lib.html

Example of a high-level PostScript graphics operator implemented as a C procedure.

```c
int gs_moveto(gs_state *, double, double);
```

--------------------------------

### Configure Display Handle via Command Line

Source: https://ghostscript.readthedocs.io/en/latest/API.html

Pass a display handle string to the display device via command line arguments.

```text
-sDisplayHandle=1234
```

--------------------------------

### Get document page count

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsCSharp.html

Returns the number of pages in a document, or -1 if the count cannot be determined.

```csharp
public int GetPageCount(String fileName)
```

```csharp
int page_number = m_ghostscript.GetPageCount("my_document.pdf");
```

--------------------------------

### Initialize stcolor driver via command line

Source: https://ghostscript.readthedocs.io/en/latest/UnsupportedDevices.html

Use this command to invoke the stcolor device with specific resolution settings for your input file.

```bash
gs -sDEVICE=stcolor -r{Xdpi}x{Ydpi} stcolor.ps {YourFile.ps}
```

--------------------------------

### Get Ghostscript version

Source: https://ghostscript.readthedocs.io/en/latest/LanguageBindingsCSharp.html

Retrieves version information as a string. Throws an exception if the DLL is inaccessible.

```csharp
public String GetVersion()
```

```csharp
String gs_vers = m_ghostscript.GetVersion();
```

--------------------------------

### Define proc_process_begin

Source: https://ghostscript.readthedocs.io/en/latest/GPDL.html

Sets up the transfer of data when processing files or streams.

```c
typedef int (*pl_interp_proc_process_begin_t) (pl_interp_implementation_t *);
```

--------------------------------

### Get profile handle from memory

Source: https://ghostscript.readthedocs.io/en/latest/GhostscriptColorManagement.html

Returns a profile handle for the profile contained in the specified buffer.

```c
gcmmhprofile_t gscms_get_profile_handle_mem(unsigned char *buffer, unsigned int input_size);
```

--------------------------------

### Get Overprint Mode

Source: https://ghostscript.readthedocs.io/en/latest/Language.html

Retrieves the current integer value of the overprint mode from the graphics state.

```PostScript
- .currentoverprintmode <int>
```
Tokens:
Raw