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)

Syndicate content