ULTRIX Worksystem Software Display PostScript® Client Library Reference Manual

This document is the Display PostScript Client Library Reference Manual for ULTRIX Worksystem Software, published by Digital (and developed by Adobe Systems).

It serves as a comprehensive guide for application programmers on how to use the Client Library, which is the programming interface to the Display PostScript system. The manual details:

• Core Concepts: Creating, managing, and destroying PostScript execution "contexts," which represent the interpreter's state for executing PostScript language programs.
• Sending Code & Data: The primary method is using "wrapped procedures" (C-callable PostScript code generated by the pswrap translator), but also covers single-operator procedures and sending direct ASCII text or binary data.
• Handling Output: How to manage information returned from the PostScript interpreter, including results from wrapped procedures, text output, and errors, often through "call-back procedures" (text and error handlers).
• Advanced Features: Topics like context chaining, data encoding and translation, buffering, and synchronizing applications with PostScript contexts.
• Reference Information: Detailed documentation of Client Library procedures and data structures found in header files like dpsclient.h, dpsops.h, and dpsfriends.h.
• Practical Guidance: Programming tips, notes on system-specific aspects (e.g., for the X Window System), and an example application program demonstrating the Client Library's usage, including error and exception handling.

The manual aims to provide programmers with the necessary information to leverage the PostScript interpreter's imaging power for online displays and printing within a C language environment.