The image identifier Semantics of the <image_id> parameter

Some KVIrc commands and functions accept the <image_id> as a parameter. The <image_id> indicates an image to be displayed by some GUI element. Since KVIrc has a set of builtin icons, we want the user to be able to use it :).
The <image_id> can be either a signed integer number or a filename.
If it is a signed integer it is interpreted as index of the internal KVIrc image to use: positive integers (starting at 0) indicate small (16x16) icons (the ones used in the view widget).
If <image_id> is anything else than a signed integer, it is interpreted as a filename. The filename can be an absolute file path or a relative one. In this last case KVIrc will look for the file in a predefined set of directories: First in the local pics directory (usually in ~/kvirc-version/pics/), then in the local incoming directory, then in the global pics directory, then in the user home (~) and in the current directory.

Index, Language Overview