VariablePackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version

*default-inverted-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 t, meaning that it is suitable for use with pixmaps that are defined as source code (with the rows of the source code matching the order of the rows in the image). If you instead are loading pixmaps from files with load-pixmap, then use *default-texture-info* instead to match the row order.

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.

Example:

Here is how the IDE creates the check-box pixmap that appears in the Component Toolbar. By using *default-inverted-texture-info*, the colors at indices 7, 8, and 15 will automatically change to match the user's Control Panel colors as explained on the page for default-pixmap-color-vector.

(cache-pixmap
 (make-instance 'pixmap
   :name 'check-box
   :contents
   '((7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7)
     (7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7)
     (7 15 15 15 15 15 15 15 15 15 15 15 15 15 7 7)
     (7 8 7 7 7 7 7 7 7 7 7 7 7 15 7 7)
     (7 8 0 15 15 15 15 15 15 15 15 15 7 15 7 7)
     (7 8 0 15 15 15 0 15 15 15 15 15 7 15 7 7)
     (7 8 0 15 15 0 0 0 15 15 15 15 7 15 7 7)
     (7 8 0 15 0 0 0 0 0 15 15 15 7 15 7 7)
     (7 8 0 15 0 0 15 0 0 0 15 15 7 15 7 7)
     (7 8 0 15 0 15 15 15 0 0 0 15 7 15 7 7)
     (7 8 0 15 15 15 15 15 15 0 0 15 7 15 7 7)
     (7 8 0 15 15 15 15 15 15 15 0 15 7 15 7 7)
     (7 8 0 15 15 15 15 15 15 15 15 15 7 15 7 7)
     (7 8 0 0 0 0 0 0 0 0 0 0 7 15 7 7)
     (7 8 8 8 8 8 8 8 8 8 8 8 8 15 7 7)
     (7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7))
   :texture-info *default-inverted-texture-info*))

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version