Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-File
                               ciconblk


The G_CICON object (available as of AES version 3.3) defines its ob_spec
field to be a pointer to a CICONBLK structure as defined below:

typedef struct cicon_blk
{
    ICONBLK     monoblk;
    CICON *     mainlist;
} CICONBLK;

monoblk contains a monochrome icon which is rendered if a color icon
matching the display parameters cannot be found. In addition, the icon
text, character, size, and positioning data from the monochrome icon are
always used for the color one. mainlist points to the first CICON
structure in a linked list of color icons for different resolutions. CICON
is defined as follows:

typedef struct cicon_data
{
    WORD                num_planes;
    WORD *              col_data;
    WORD *              col_mask;
    WORD *              sel_data;
    WORD *              sel_mask;
    struct cicon_data * next_res;
} CICON;

num_planes indicates the number of bit planes this color icon contains.
col_data and col_mask point to the icon data and mask for the unselected
icon respectively. Likewise, sel_data and sel_mask point to the icon data
and mask for the selected icon. next_res points to the next color icon
definition or NULL if no more are available. Bitmap data pointed to by
these variables should be in VDI device-dependent format (they are stored
as device-independent images in a .RSC file).

The AES searches the CICONBLK object for a color icon that has the same
number of planes in the display. If none is found, the AES simply uses the
monochrome icon.