Next Prev Up

# 4.8 Pixmaps

A pixmap is a three-dimensional array of bits. A pixmap is normally thought of as a two-dimensional array of pixels, where each pixel can be a value from 0 to 2n-1, where n is the depth of the pixmap. A pixmap can also be thought of as a stack of n bitmaps. A bitmap is a single bit pixmap of depth 1. CLX provides functions to:

- Create or free a pixmap
- Test if an object is a pixmap
- Test if two pixmap objects are equal
- Return the pixmap resource ID from a pixmap object

Note that pixmaps can only be used on the screen where they were created. Pixmaps are off-screen server resources that are used for a number of operations. These include defining patterns for cursors or as the source for certain raster operations.

create-pixmap | &key :width :height :depth :drawable | Function

| :width, :height The nonzero width and height (type card16). :depth The depth (type card8 ) of the pixmap. :drawable A drawable which determines the screen where the pixmap will be used. Creates a pixmap of the specified :width, :height , and :depth. It is valid to pass a window whose class is :input-only as the :drawable argument. The :width and :height arguments must be nonzero. The :depth must be supported by the screen of the specified :drawable. pixmap Type pixmap.

free-pixmap | pixmap | Function

| pixmap A pixmap. Allows the X server to free the pixmap storage when no other server resources reference it. The pixmap should never be referenced again.

pixmap-display | pixmap | Function

| pixmap A pixmap. Returns the display object associated with the specified pixmap. display Type display.

pixmap-equal | pixmap-1 pixmap-2 | Function

| pixmap-1, pixmap-2 A three-dimensional array of bits to be tested. Returns true if the two arguments refer to the same server resource, and nil if they do not.

pixmap-id | pixmap | Function

| pixmap A pixmap. Returns the unique resource ID that has been assigned to the specified pixmap. id Type resource-id .

pixmap-p | object | Function

| Returns true if the argument is a pixmap object and nil otherwise. pixmap Type boolean.

pixmap-plist | pixmap | Function

| pixmap A pixmap. Returns and (with setf) sets the property list for the specified pixmap. This function provides a hook where extensions can add data. plist A property list.

Next Prev Up

© 1988, 1989 Texas Instruments Incorporated
Conversion to HTML made by Gilbert Baumann.
Last build: Tue Dec 16 23:30:42 1997