JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Solaris X Window System Developer's Guide
search filter icon
search icon

Document Information

Preface

1.  Introduction to the Solaris X Server

2.  DPS Features and Enhancements

3.  Visuals on the Solaris X Server

4.  Font Support

5.  Server Overlay Windows

6.  Transparent Overlay Windows

What are Transparent Overlay Windows?

Basic Characteristics of Transparent Overlay Windows

Paint Type

Viewability

More on Transparent Overlay Characteristics

Background

Window Border

Backing Store

Window Gravity

Colormaps

Input Distribution Model

Print Capture

Choosing Visuals for Overlay/Underlay Windows

Example Program

Overview of the Solaris Transparent Overlay Window API

Creating Transparent Overlay Windows

Setting the Paint Type of a Graphics Context

Setting the Background State of a Transparent Overlay Window

Rendering to a Transparent Overlay Window

Querying the Characteristics of a Transparent Overlay Window

Determining Whether a Window is an Overlay Window

Determining the Paint Type of a Graphics Context

Pixel Transfer Routines

Filling an Area Using the Source Area Paint Type

Copying an Area and Its Paint Type

Retrieving Overlay Color Information

Using Existing Xlib Pixel Transfer Routines

XGetImage

XCopyArea and XCopyPlane

Designing an Application for Portability

Selecting a Visual for an Overlay/Underlay Window

Argument Types

Return Types

Multiple Criteria Sets

Selecting an Optimal Overlay/Underlay Visual Pair

Argument Types

Return Types

Criteria Sets

7.  Security Issues

A.  Reference Display Devices

Glossary

Index

Overview of the Solaris Transparent Overlay Window API

The transparent overlay window API includes the routines listed in Table 6-2. These routines are provided by libXext.so. To use the Solaris overlay routines, do the following:

Table 6-2 List of Transparent Overlay Window Routines

Name
Description
XSolarisOvlCreateWindow
Creates an overlay window.
XSolarisOvlIsOverlayWindow
Indicates whether a window is an overlay window.
XSolarisOvlSetPaintType
Specifies the type of paint rendered by subsequent Xlib drawing.
XSolarisOvlGetPaintType
Gets the current paint type.
XSolarisOvlSetWindowTransparent
Sets the background state of an overlay window to be transparent.
XSolarisOvlCopyPaintType
Renders opaque and transparent paint into the destination drawable based on the paint type attributes of the pixels in the source drawable.
XSolarisOvlCopyAreaAndPaintType
Copies the area and paint type from one pair of drawables to another.
XReadScreen
Returns the displayed colors in a rectangle of the screen.
XSolarisOvlSelectPartner
Returns the optimal overlay or underlay visual for an existing visual.XSolarisOvlSelectPairSelects an optimal overlay/underlay pair that best meets a set of defined criteria for the overlay and underlay visuals.

The remainder of this chapter discusses the transparent overlay API routines.