ICONS: Man Page

The icons command is used to create, delete, and query icon images stored in the ICONS icon library format. It can take several different forms, depending on the mode argument. The legal forms are:

icons create ?option value ...? ?icon-list?

Creates new icon images as specified by -group -or- icon-list from the specified/default icon library. The icon images created are named ::icon::icon-name. A list of the names of the icons created is returned. A group-list and/or icon-list must be specified.

-file filename

Specifies the name of the icon library file to be used. The default name is tkIcons in the directory given by info library. If a filename is specified, icons will first check to see if it identifies a file relative to the info library directory. If not it will be assumed to be a fully qualified filename.

-group group-list

Specifies a group -or- group-list for which icon images will be created. To create icon images for all icons in the specified library use asterisk as the group (-group *). This option may be used in conjunction with an icon-list.

icon-list

Specifies an icon -or- icon-list for which icon images will be created. This option may be used in conjunction with a group-list.

icons delete icon-list

Deletes each of the icon images specified in the icon-list. An icon-list must be specified.

icon-list

Specifies an icon -or- icon-list for which icon images will be deleted.

icons query ?option value ...? ?icon-list?

Returns the data specified by -items from the specified/default icon library. The result is returned as a list. Each item in the list is a list of data as specified by the -items option. A group-list and/or icon-list must be specified.

-file filename

-group group-list

Specifies a group -or- group-list for which icon images will be queried. To query all icons in the specified library use asterisk as the group (-group *). This option may be used in conjunction with an icon-list.

-items items

Specifies the data items, and their order, in the query result. The default items are ngts. The valid items are:

n	- Name (Icon)
g	- Groups
t	- Type
s	- Size
d	- Data (Image)

icon-list

Specifies an icon -or- icon-list for which icon images will be queried. This option may be used in conjunction with a group-list.

ICON LIBRARY FORMAT

Icon libraries have the following format:

name:groups:type:size:image-data

*name*	Icon name (Must be unique).
*groups*	List of groups to which icon belongs (Must be at least one).
*type*	Image data type (Only `photo` currently supported).
*size*	Size of icon (widthxheight, In pixels).
*image-data*	Image data (Base64 encoded GIF).