
14.2.0.3 ICON_MASK_IMAGE
The attribute ICON_MASK_IMAGE may be used to clip all drawing into the pixmap to the bits
set in the Pixmap or Server_image specified here. Therefore, this image should be a
1-bit deep bitmap. The image used as the icon mask is usually a “shadow” of the icon’s nor-
mal image. That is, it is the same image “filled in,” resulting in a totally black 1-bit deep
icon that has the same shape as the icon’s image.
Example 14-2 can be modified to use this attribute by adding the following code:
image_mask = (Server_image)xv_create(NULL, SERVER_IMAGE,
XV_WIDTH, 64,
XV_HEIGHT, 64,
XV_DEPTH, 1,
SERVER_IMAGE_BITS, closed_image_mask_bits,
NULL);
icon = (Icon)xv_create(frame, ICON,
ICON_IMAGE, closed_image,
ICON_MASK_IMAGE, image_mask,
XV_X, 100,
XV_Y, 100,
NULL);
When used in conjunction with the ICON_TRANSPARENT attribute, it may be possible to cre-
ate an icon that appears to have a shape other than a square.
14.2.1 The Icon Text
Each icon can have text associated with it. This text is not part of the icon’s image; it is ren-
dered on top of the image after the image is rendered. To specify the text displayed in the
icon, use the generic attribute
ICON_LABEL.* By default, the text is displayed at the bottom
of the icon area. This may overlap the icon’s image. You can change the position in which
the text is rendered by using the attribute ICON_LABEL_RECT. The value of the attribute
describes