Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
dticonfile(special file)			      dticonfile(special file)

       dticonfile -- icon conventions for XCDE icons

       The conventions used within the XCDE for	icon
       sizes, naming, location,	and usage are specified.

       Both  X Pixmap and X Bitmap icon	file formats are used within the XCDE.
       X Pixmap	(XPM) icons are	multi-color images based on the	XPM format de-
       veloped	by  Arnaud Le Hors. A pixmap file is an	ASCII file that	can be
       read and	modified by hand, in addition to using	color  pixmap  editors
       (like  the XCDE Icon Editor). X Bitmap (XBM) icons are monochrome (two-
       color) images based on the official  X11	 Bitmap	 File  Format.	Bitmap
       files are ASCII files; however, the data	is simply a binary representa-
       tion of the bitmap, and as such is not easily read or modified by hand.
       The  XCDE  icon editor can create and modify XBM	icons. The icon	editor
       has the ability to write	out any	icon in	either the  XPM	 or  XBM  file
       format.	For  a more detailed description of these file formats and the
       icon editor, see	the dtbmfile(4), dtpmfile(4) and dticon(1) man pages.

   File	Naming
       XCDE icon file names are	typically in one of the	following forms:


       The basename is the logical name	of the icon. The basenames  for	 icons
       that  are installed with	XCDE begin with	either Dt or Fp. Dt is the de-
       fault prefix for	all XCDE icons.	The Fp prefix is used for  icons  that
       appear  in  the front panel when	an icon	other than the default Dt icon
       is desired. In this case, the basename is the same.

       If an additional	icon is	needed for  the	 client	 iconImage  (iconified
       client window icon), a third prefix, Ic,	is used.

       The  format is pm for a pixmap file and bm for a	bitmap file. Size is a
       single letter: l	for large, m for medium, s for small and t  for	 tiny.
       Many of the logical icons are provided in multiple sizes	for both color
       and monochrome. This allows XCDE	to use the optimal color and size com-
       bination	 for  the specific task	and configuration the user is running.
       Many bitmap icons have a	mask associated	 with  the  icon.   These  are
       named  basename.size_m.format.  All icons are named so that the longest
       filename	associated with	that icon is 14	bytes or less; this allows  it
       to  be used on a	short filename system. The longest filename can	be de-
       scribed as, where	xxxxx is the logical icon name.

       This is an example of icon files	that might be associated with the icon
       foo. The	single logical icon foo	contains tiny, small, medium and large
       bitmap icons (with mask)	and pixmap icons.

   Icon	Sizes
       Icons of	the following sizes and	with the following suffixes  are  sup-

       Large	 48~48 icon with .l suffix

       Medium	 32~32 icon with .m suffix

       Small	 24~24 icon with .s suffix

       Tiny	 16~16 icon with .t suffix

       The  icon  sizes	used varies for	different components, and is dependent
       on the display hardware.

   Table Of Icon Sizes Used
       XCDE Component	      HiRes,MedRes	      LoRes(vga)
       Front Panel	      48~48		      32~32
       FP Subpanels	      32~32		      24~24
       FP Inset	FP	      24~24		      16~16
       WMgr ClientIcon	      48~48		      32~32
       File Mgr	(Large)	      32~32		      32~32
       File Mgr	(Small)	      16~16		      16~16

   Icon	Colors
       These colors are	used in	XCDE icons. The	dynamic	colors use color cells
       from  one  of  the color	sets in	the user's color palette (except none,
       which requires no color cell).

       The eight icon color names are already included in  the	rgb.txt	 file.
       The  eight  icon	gray color names should	be added to each XCDE vendor's

       Color Name (rgb.txt)	    Symbolic Name (<icon>.pm)
       < dynamic >		    none
       < dynamic >		    background
       < dynamic >		    selectColor
       < dynamic >		    topShadowColor
       < dynamic >		    bottomShadowColor
       black			    iconColor1
       white			    iconColor2
       red			    iconColor3
       green			    iconColor4
       blue			    iconColor5
       yellow			    iconColor6
       cyan			    iconColor7
       magenta			    iconColor8
       iconGray1		    iconGray1
       iconGray2		    iconGray2
       iconGray3		    iconGray3
       iconGray4		    iconGray4
       iconGray5		    iconGray5
       iconGray6		    iconGray6
       iconGray7		    iconGray7
       iconGray8		    iconGray8

   Icon	File Locations
       XCDE has	default	locations where	it looks to find system	and user  icon
       files.  See  the	dtappintegrate(1) manual page for detailed information
       on where	to install icons. See the dtsearchpath(1) manual page for  in-
       formation on the	icon lookup path.

   Icon	Usage In XCDE
       Icons are used in a variety of ways within XCDE.	Following are examples
       of some of the general areas in which users can use icons to  customize
       XCDE  configurations. A system administrator can	also do	this on	a sys-
       tem- or network-wide basis. For more detailed  information  on  any  of
       these topics, see the documentation for that component or configuration

   Actions And Data Types
       An icon is associated with an action or data type using the  ICON  key-
       word  in	 the action or data type definition (located in	.dt files). If
       XCDE naming conventions are followed, there is no need to  specify  the
       path  or	icon suffix. The size and format used is determined at runtime
       based on	the system configuration.

       ACTION	 IslandPaintOpenDoc
	   ICON		  Ipaint
	   EXEC_HOST	  MyMachine
	   EXEC_STRING	  /usr/bin/IslandPaint %(File)Arg_1"File to open:"

   Client Icons
       An icon is associated with a  client's  iconified  window  through  the
       iconImage window	manager	resource as follows:

       Dtwm*clientName*iconImage: IconFilename

       The icon	may be a pixmap	or bitmap format icon. Some clients do not al-
       low their default icon to be overridden.


   Front Panel
       Icons can be displayed as controls in the front panel  using  the  ICON
       keyword	in  control definitions. Either	pixmap-	or bitmap-format icons
       can be used. For	controls that are of type icon with  MONITOR_TYPE  set
       to  file	or mail, an alternate image can	be specified using the keyword
       ALTERNATE_ICON. The alternate icon is  used  when  the  file  size  has
       grown.  Controls	of type	busy can also have an alternate	icon, which is
       cycled with the ICON to give a blinking effect. For controls that allow
       a  PUSH_ACTION  or a DROP_ACTION, push or drop animation	can be defined
       using multiple icons that create	animation visual effects.

       CONTROL DirectoryTerm
	   TYPE		    icon
	   IMAGE	    directoryTerm
	   DROP_ACTION	    f.action StartDirectoryTerm
	   PUSH_ACTION	    f.action StartDirectoryTerm
	   PUSH_ANIMATION   DirAnimation
       ANIMATION DirAnimation
	   ANIMATION   frame1  300
	   ANIMATION   frame2

       The backdrop icons show up in a list in	the  Backdrop  Dialog  of  the
       Style  Manager.	The user can select a single backdrop per workspace to
       be used as the background for that workspace. This is a visual clue  to
       help  the  user	distinguish  one workspace from	another. Backdrops are
       available in both monochrome (bitmap) and color	(pixmap)  format  (all
       backdrops  are  unique; there are not bitmap and	pixmap versions	of the
       same backdrop). Although	backdrops use the same file  format  as	 other
       icons, they are not used	like what is typically referred	to as an icon.
       They would be more accurately described as an image.  The image is  re-
       peated  (tiled)	to fill	the entire background of a workspace.  This is
       not typically done with an icon.	The XCDE comes with a set of  standard
       backdrops.  Some	are monochrome and some	are in color. Custom backdrops
       can be added to system-installed	backdrops using	the Style Manager  and
       Window  Manager	backdropDirectories  resource. Backdrops can be	either
       bitmap or pixmap	format.	A system  administrator	 can  add  system-wide
       backdrops  to  the  system-wide	default	 backdrop  directory, /usr/lo-

       *backdropDirectories: /users/julie/.dt/icons/myBackdrops

   File	Manager	As Icon	Browser
       The File	Manager	can be used as an icon browser.	In this	mode, when you
       change  to  a  directory	 that contains icons ( .bm or .pm files), each
       icon is displayed next to the icon file name. To	enable icon  browsing,
       copy   the  file	 /usr/local/dt/contrib/types/IconBrowse.dt  into  your
       $HOME/.dt/types directory. Then reload the action database by executing
       the  ReloadActions  action.  For	large icons, or	on systems with	little
       memory, this could cause	delays on some directories.  To	 disable  icon
       browsing,  remove  personal copies of the IconBrowse.dt file and	reload
       the action database again.

   Design Recommendations
       In order	to allow colorful icons	while minimizing the number of	colors
       used  by	the XCDE, it is	recommended that the colors used be limited to
       those available in the Icon Editor. These  include  the	dynamic	 Motif
       widget  colors,	as well	as a set of static colors and static gray col-
       ors. The	dynamic	colors include	foreground,  background,  top  shadow,
       bottom  shadow,	select	and a transparent color. The static colors in-
       clude black, white, red,	blue, green, yellow,  magenta  and  cyan.  The
       static  gray colors are eight varying shades of gray, from nearly black
       to nearly white.

       dtpmfile(4), dtbmfile(4), dticon(1),  dtfpfile(4),  dtdtfile(4),	 dtac-
       tionfile(4),   dtdtsfile(4),  dtstyle(1),  dtenvvar(5),	xmgeticonfile-

						      dticonfile(special file)


Want to link to this manual page? Use this URL:

home | help