*default-texture-info*

The value of this variable is a standard texture-info object that may be used by multiple pixmaps for efficiency, if the properties of those pixmaps all happen to match those specified by this texture-info. In addition, this texture-info may be used with typical button-sized pixmaps to cause them to automatically change some of their colors to match the user's Control Panel color scheme.

The texture-info's width and height are 16 pixels, its bits-per-pixel is 4 (for up to 16 colors), and its colors are those returned by default-pixmap-color-vector. These attributes are commonly used by pixmaps in picture-buttons and multi-picture-buttons. Since default-pixmap-color-vector is used for the colors, using this texture-info for such buttons will cause them to match the user's Control Panel scheme (see default-pixmap-color-vector for more info).

The invert-p property of this texture-info is nil, meaning that it is suitable for use with pixmaps that were loaded from a file with load-pixmap. (If such a pixmap matches all of the attributes of this special texture-info, including the color order, then this texture-info could be swapped in by calling (setf texture-info) on the pixmap after loading it, to cause the pixmap to match the user's Control Panel colors). If you are instead defining pixmaps as source code (with the rows of the source code matching the order of the rows in the image), then use *default-inverted-texture-info* instead. See that page for an example usage.

If a pixmap is created by specifying its width, height, bits-per-pixel, and invert-p properties individually such that they all match this special texture-info, and the colors property is specified as the keyword :default, then this texture-info will automatically be used internally.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.