Imageclass Definitions

Still under construction

Before we get started

Imageclasses can be grouped into two categories. Those that are used directly by e16 (static) and those that are used in other parts of your theme configuration (dynamic).

Static imageclasses required a specific name. Dynamic imageclasses can be named anything. But, sticking with names that are found in this documentation helps when working on a lot of e16 themes.

Not all static imageclasses are required. As a matter of fact e16 defaults back to a generic gray image if you don't have something defined, but your theme probably wont look right if that happens. There are a few that can safely be ignored without this gray image being applied. They are identified in the below tables with an asterisk * next to their name.

The following syntax is used to depict how images are scaled in (width)x(height).
(-) image size is used
(*) scales as needed
(c) configuration defined
(c+) configuration defined to scale as needed
(25) image is scaled to (n) fixed pixels

For example:
(-)x(*) would use the image width but scale height as needed.
(*)x(25) would scale an image width as needed but force height to be 25 pixels.
(c)x(c+) both width and height are configuration controlled but width is fixed and height is scalable.

Organization

As noted in the structure part of the documentation, all imageclass configuration files are placed in the directory [THEME]/imageclasses/ and are included by the base config file [THEME]/imageclasses.cfg.

borders.cfg

All imagery around your windows including the action buttons (ie. minimize, maximize, close, etc.)

NAME	Category	Size
DEFAULT_TITLEBAR	dynamic	(c+)x(c)
DEFAULT_BOTTOMBAR	dynamic	(c+)x(c)
DEFAULT_SIDE_LEFT	dynamic	(c)x(c+)
DEFAULT_SIDE_RIGHT	dynamic	(c)x(c+)
DEFAULT_CORNER_TL	dynamic	(c)x(c)
DEFAULT_CORNER_TR	dynamic	(c)x(c)
DEFAULT_CORNER_BL	dynamic	(c)x(c)
DEFAULT_CORNER_BR	dynamic	(c)x(c)
DEFAULT_KILL	dynamic	(c)x(c)
DEFAULT_ICONIFY	dynamic	(c)x(c)
DEFAULT_MAXIMIZE	dynamic	(c)x(c)
DEFAULT_LOWER	dynamic	(c)x(c)

The names for border imageclasses are all flexible because you call them from borderclasses. Try to be descriptive, it helps when working on your theme. If you have imageclasses that are only used for a particular border then prepend them with the border name like above (DEFAULT_).

coords.cfg

The image used to displaying positional coordinates during window movement or resizing.

NAME	Category	Size
COORDS	static	()x()

dialogs.cfg

The images used in the configuration and pop-up dialogs of e16.

NAME	Category	Size
DIALOG	static	()x()
DIALOG_BUTTON	static	()x()
DIALOG_WIDGET_AREA	static	()x()
DIALOG_WIDGET_BUTTON	static	()x()
DIALOG_WIDGET_CHECK_BUTTON	static	(-)x(-)
DIALOG_WIDGET_RADIO_BUTTON	static	(-)x(-)
DIALOG_WIDGET_SEPARATOR	static	(*)x(c+)
DIALOG_WIDGET_SLIDER_BASE_HORIZONTAL	static	(*)x(-)
DIALOG_WIDGET_SLIDER_BASE_VERTICAL	static	(-)x(*)
DIALOG_WIDGET_SLIDER_KNOB_HORIZONTAL	static	(-)x(-)
DIALOG_WIDGET_SLIDER_KNOB_VERTICAL	static	(-)x(-)
SETTINGS_AREADESK_AREA	static	()x()
SETTINGS_AREA_AREA	static	()x()
SETTINGS_DESKTOP_AREA	static	()x()

dock.cfg

The image used for dockapps. See http://web.cs.mun.ca/~gstarkes/wmaker/dockapps/ for more information on these utility/monitoring programs.

NAME	Category	Size
DEFAULT_DOCK_BUTTON	static	(64)x(64)

dragbar.cfg

Dragbar images. When you have multiple desktops configured, it allows you to slide back the current desktop and expose the one underneath. It sits on either the top, bottom, left, or right edge of the screen. The RAISE and LOWER buttons switch to previous and subsequent desktops.

NAME	Category	Size
DESKTOP_DESKRAY_HORIZ	static	(-)x(-)
DESKTOP_DESKRAY_VERT	static	(-)x(-)
DESKTOP_DRAGBUTTON_HORIZ	static	(*)x(16)
DESKTOP_DRAGBUTTON_VERT	static	(16)x(*)
DESKTOP_LOWERBUTTON_HORIZ	static	(16)x(16)
DESKTOP_LOWERBUTTON_VERT	static	(16)x(16)
DESKTOP_RAISEBUTTON_HORIZ	static	(16)x(16)
DESKTOP_RAISEBUTTON_VERT	static	(16)x(16)

epplets.cfg

The images needed for e16's custom utility and system monitoring programs.

Insert Images for EPPLETS

NAME	Category	Size
EPPLET_ARROW_DOWN	static
EPPLET_ARROW_LEFT	static
EPPLET_ARROW_RIGHT	static
EPPLET_ARROW_UP	static
EPPLET_BACKGROUND_HORIZONTAL	static
EPPLET_BACKGROUND_VERTICAL	static
EPPLET_BUTTON	static
EPPLET_CLOSE	static
EPPLET_CONFIGURE	static
EPPLET_DRAWINGAREA	static
EPPLET_EJECT	static
EPPLET_FAST_FORWARD	static
EPPLET_HBAR_BAR	static
EPPLET_HBAR_BASE	static
EPPLET_HELP	static
EPPLET_HSLIDER_BASE	static
EPPLET_HSLIDER_KNOB	static
EPPLET_NEXT	static
EPPLET_PAUSE	static
EPPLET_PLAY	static
EPPLET_POPUP_BASE	static
EPPLET_POPUP_ENTRY	static
EPPLET_PREVIOUS	static
EPPLET_REPEAT	static
EPPLET_REWIND	static
EPPLET_SKIP	static
EPPLET_STOP	static
EPPLET_TOGGLEBUTTON_OFF	static
EPPLET_TOGGLEBUTTON_ON	static
EPPLET_VBAR_BAR	static
EPPLET_VBAR_BASE	static
EPPLET_VSLIDER_BASE	static
EPPLET_VSLIDER_KNOB	static

focuslist.cfg

The image used when selecting running applications via "Alt-TAB". Each program listed repeats this image.

NAME	Category	Size
WARPFOCUS	static	()x()

iconbox.cfg

The iconbox holds minimized applications. The images defined in here are also used for the SysTray that recent versions of e16 support.

NAME	Category	Size
DEFAULT_ICON_BUTTON	static	()x()
ICONBOX_ARROW_DOWN	static	(12)x(12)
ICONBOX_ARROW_LEFT	static	(12)x(12)
ICONBOX_ARROW_RIGHT	static	(12)x(12)
ICONBOX_ARROW_UP	static	(12)x(12)
ICONBOX_COVER_HORIZONTAL *	static	()x()
ICONBOX_COVER_VERTICAL *	static	()x()
ICONBOX_HORIZONTAL	static	()x()
ICONBOX_SCROLLBAR_BASE_HORIZONTAL	static	(*)x(12)
ICONBOX_SCROLLBAR_BASE_VERTICAL	static	(12)x(*)
ICONBOX_SCROLLBAR_KNOB_HORIZONTAL	static	(*)x(8)
ICONBOX_SCROLLBAR_KNOB_VERTICAL	static	(8)x(*)
ICONBOX_SCROLLKNOB_HORIZONTAL	static	(8)x(8)
ICONBOX_SCROLLKNOB_VERTICAL	static	(8)x(8)
ICONBOX_VERTICAL	static	()x()

menustyles.cfg

The images defined here are used for the application menus and window/border menus.

NAME	Category	Size
MENU_BG	dynamic	()x()
MENU_SEL	dynamic	()x()
MENU_SUB	dynamic	()x()

pager.cfg

The images used when the desktop pager is not drawing your active desktop(s).

NAME	Category	Size
PAGER_BG	dynamic	()x()
PAGER_SEL *	dynamic	()x()
PAGER_WIN	dynamic	()x()

tooltips.cfg

The images needed for e16's pop-up help windows.

NAME	Category	Size
TT_MAIN	dynamic	()x()
TT_LOGO	dynamic	(-)x(-)
TT_CLOUD1	dynamic	(8)x(8)
TT_CLOUD2	dynamic	(16)x(16)
TT_CLOUD3	dynamic	(24)x(24)
TT_CLOUD4	dynamic	(32)x(32)

themes.effx.us

Navigation