get-texture-info

Generic Function

Package: common-graphics

Arguments: stream bitmap-window-or-pane &optional texture-info

This function returns a texture-info with information about bitmap-window-or-pane's width, height, and bits-per-pixel.

Argument Description

stream a stream compatible with the memory bitmap of bitmap-window-or-pane; you can typically just pass (screen *system*).

bitmap-window-or-pane a bitmap-window or bitmap-pane about whose memory bitmap you would like to know the width, height, or bits-per-pixel.

texture-info a texture-info that you can pass to avoid consing a new one each time; if you pass a texture-info, get-texture-info fills in its fields; if you pass nil or do not specify this argument, a new texture-info is created.

Note that the texture-info as returned by this function does not include the colormap used by bitmap-window-or-pane. If you need the colormap included (as you do, for example, when you pass a texture-info to save-pixmap), use the texture-info returned as the second value by the slower function get-texture.

Note: incompatible change in release 6.0: in releases prior to 6.0, when a frame-with-single-child instance was passed to this operator, the operator was actually applied to the child (the result of applying frame-child to the frame-with-single-child instance). In release 6.0, this redirection no longer occurs. If you intend this operator to apply to the frame-child, pass that to this operator rather than the parent. This is a non-backward-compatible-change. See the release notes for more information.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Created 2000.10.5.