Solaris X Window System Developer's Guide

Preface

The Solaris X Window System Developer's Guide provides detailed information on the Solaris^TM X server. The guide provides an overview of the server architecture and tells you where to look for more information.

This guide provides detailed information for software developers interested in interfacing with the Solaris X server.

Who Should Use This Book

Programming in this environment primarily involves using a toolkit and possibly interfacing with the server and its protocols. The protocols and toolkits are documented elsewhere (see "Related Books" ). Read this manual if you need detailed information on the:

Features of the Solaris X server
Differences from and enhancements to the X Consortium sample server
DPS imaging system
Supported display devices
Authorization schemes and protocols for server connections

Before You Read This Book

This manual assumes that the reader has a programming background and familiarity with, or access to, appropriate documentation for:

Solaris 7 and compatible versions
X Window System^TM
C programming language
PostScript^TM
The Display PostScript^TM System (DPS)
olwm window manager
XView^TM toolkit

How This Book Is Organized

Although you can read this book in sequence, it is designed for you to read only those chapters of interest. This book serves both as an overview and as a reference document.

Chapter 1, Introduction to the Solaris X Server describes the architecture of the Solaris X server, the X and DPS extensions, Sun's enhancements to the X Consortium libraries and extensions, notes on color-related issues, and a list of applications you can run with the server.

Chapter 2, DPS Features and Enhancements describes the DPS features specific to Solaris and includes information on compositing operators provided as an extension to standard DPS.

Chapter 3, Visuals on the Solaris X Server describes visuals in the Solaris environment. It also provides hints for window programming with visuals.

Chapter 4, Font Support describes the set of fonts provided and how to manage fonts.

Chapter 5, Server Overlay Windows describes server overlays and contrasts them with transparent overlays.

Chapter 6, Transparent Overlay Windows describes the Solaris Transparent Overlay Extension application programming interface (API) for transparent overlay windows.

Chapter 7, Security Issues describes the security features of the Solaris environment.

Appendix A, Reference Display Devices describes the graphics devices provided as reference devices with the Solaris environment.

Related Books

For information on how to write applications in the Solaris environment, consult the following manuals:

Desktop Integration Guide
ToolTalk Reference Guide
OpenWindows Desktop Reference Manual
Solaris X Window System Reference Manual
X Server Device Developer's Guide
XView Developer's Notes
OLIT Quick Start Programer's Guide
OLIT Reference Guide
XIL Programmer's Guide

The following X-related manuals are available through SunExpress or your local bookstore. Contact your SunSoft representative for information on ordering any of these books.

XView Reference Manual, O'Reilly & Associates
XView Programming Manual, O'Reilly & Associates
Xlib Reference Manual, O'Reilly & Associates
Xlib Programming Manual, O'Reilly & Associates
X Protocol Reference Manual, O'Reilly & Associates
Programmer's Supplement for Release 5, O'Reilly & Associates
X Toolkit Intrinsics Reference Manual, O'Reilly & Associates
X Window System, Third Edition, Digital Press
The X Window System Server, X Version 11, Release 5, Digital Press

The following PostScript and DPS-related manuals are available through SunExpress or your local bookstore. Contact your SunSoft representative for information on ordering.

PostScript Language Reference Manual, Second Edition, Adobe® Systems Incorporated
PostScript Language Tutorial and Cookbook, Adobe Systems Incorporated
Programming the Display PostScript System with X, Adobe Systems Incorporated
PostScript Language Program Design, Adobe Systems Incorporated
Adobe Type I Font Format, Adobe Systems Incorporated

Ordering Sun Documents

The SunDocs® program provides more than 250 manuals from Sun Microsystems, Inc. If you live in the United States, Canada, Europe, or Japan, you can purchase documentation sets or individual manuals using this program.

For a list of documents and how to order them, see the catalog section of SunExpress^TM. On The Internet at http://www.sun.com/sunexpress.

What Typographic Changes Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions


Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% You have mail.`
`AaBbCc123`	What you type, contrasted with on-screen computer output	`machine_name%``su` `Password:`
`AaBbCc123`	Command-line placeholder: replace with a real name or value	To delete a file, type `rm` `filename`.
AaBbCc123	Book titles, new words or terms, or words to be emphasized	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts


Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`

What Is x86?

The term "x86" refers to the Intel 8086 family of microprocessor chips, including the Pentium and Pentium Pro processors and compatible microprocessor chips made by AMD and Cynix. In this document, the term "x86" refers to the overall platform architecture, whereas "Intel Platform Edition" appears in the product name.