[Index]


Table of Contents


Title and Copyright Pages

About This Manual
Audience
Organization
Related Documents
Reader's Comments
Conventions

1    Introduction to the Display PostScript System
1.1    Overview of the Display PostScript System
1.2    PostScript Language Imaging Capabilities
1.3    Display PostScript System in WS

2    Components and Concepts
2.1    Components
2.1.1    PostScript Interpreter
2.1.2    Client Library
2.1.3    The Translation Program: pswrap
2.2    Concepts
2.2.1    Contexts
2.2.1.1    Execution Context
2.2.1.2    Text Context
2.2.2    Context Record and DPSContext Handle
2.2.3    Context Status
2.2.4    Current Context
2.2.5    Space
2.2.6    Identifiers
2.2.7    Coordinate Systems

3    Getting Started
3.1    Developing a Typical Application
3.2    Basic Application Requirements
3.3    Sample Application: examplemain
3.3.1    What the Sample Application Does
3.3.2    The Main Code
3.3.3    Source File for Wrap
3.3.4    Running examplemain
3.4    Building XDPS Applications
3.4.1    Including Header Files
3.4.2    Compiling
3.4.3    Linking
3.4.4    Invoking pswrap from a Makefile
3.4.5    Sample Makefile
3.5    More Sample Applications
3.5.1    Examples Contrasting Design Approaches
3.5.2    Running the Sample Applications
3.6    Summary of Basic Tasks

4    Advanced Concepts and Tasks
4.1    PostScript Language Encoding
4.2    Buffering and the Client Library
4.3    Accessing Files on the Server
4.4    Converting Coordinates
4.4.1    Preparing to Convert Coordinates
4.4.2    X Coordinates to User Space Coordinates
4.4.3    User Space Coordinates to X Coordinates
4.5    Resizing Windows
4.5.1    Window Resizing and the Clipping Path
4.5.2    Window Resizing and the User Space Origin
4.6    Synchronizing the Display PostScript System and X
4.7    Synchronizing Client and Context
4.8    Sharing Contexts and Spaces
4.9    Using Color
4.9.1    Converting Colors and Shades into Pixel Values
4.9.2    Defining a Color Cube and Gray Ramp
4.9.2.1    Using the Color Cube
4.9.2.2    Using the Gray Ramp
4.9.3    Rendering Colors Not in the Color Cube
4.9.4    The colorinfo Array and XStandardColormaps

5    Client Library Routines for WS
5.1    System-Specific Header File
5.2    X-Specific Singleops
5.3    Naming Conventions
5.4    Client Library Routine Descriptions

6    X-Specific Operators for WS
6.1    About the Operators
6.2    Operator Errors
6.3    Operator Descriptions

Examples

3-1    Sample Application: examplemain
3-2    Source File for Wrap Called by examplemain
3-3    Makefile for examplemain
4-1    Wrap Returning CTM, Its Inverse, and Current User Space Origin
5-1    Definitions of X-specific Singleops

Figures

1-1    Display PostScript System as Implemented in WS
2-1    X Coordinate System
2-2    User Space Coordinate System Used by the PostScript Language
2-3    Initial User Space Origin Offset from X Origin
3-1    Developing a Typical Application
3-2    Output of the examplemain Program
3-3    Output of the Sample Calculator Programs
4-1    Resizing a Window with NorthWest Bit Gravity
4-2    Resizing a Window with SouthWest Bit Gravity

Tables

3-1    Online Sample Programs
3-2    Summary of Basic Tasks
4-1    Default PostScript Language Encodings for XDPS
4-2    Mapping Between colorinfo Array and XStandardColormap Storing Color Cube
4-3    Mapping Between colorinfo Array and XStandardColormap Storing Gray Ramp
5-1    Arguments Used by X-Specific Singleops
5-2    Naming Conventions in the Client Library
6-1    Operands and Results for X-Specific Operators
6-2    Errors for X-Specific Operators