Solaris X Window System Developer's Guide

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:

Include the file /usr/openwin/include/X11/extensions/transovl.h
Link the library device handler with the library /usr/openwin/lib/libXext.so

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.