DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

/usr/man/cat.4/dticonfile.4(/usr/man/cat.4/dticonfile.4)




dticonfile(4)	 DEVICES AND NETWORK INTERFACES	    dticonfile(4)

NAME
     dticonfile	- icon conventions for TED icons

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

DESCRIPTION
     Both X Pixmap and X Bitmap	icon file formats are used within
     the  TED.	X Pixmap (XPM) icons are multi-color images based
     on	the XPM	format developed 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 TED 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
     representation of the bitmap, and as such is not easily read
     or	 modified  by  hand.   The TED 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
     TED icon file names are typically in one  of  the	following
     forms:

	  basename.format
	  basename.size.format

     The basename is the logical name of the icon.  The	basenames
     for  icons	 that are installed with TED begin with	either Dt
     or	Fp.  Dt	is the default prefix for all TED 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  pro-
     vided in multiple sizes for both color and	monochrome.  This
     allows TED	to use the optimal color and size combination 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   described   as

Unix System LaboratoLast change: 1 August 1995			1

dticonfile(4)	 DEVICES AND NETWORK INTERFACES	    dticonfile(4)

     Dtxxxxx_m.l.pm, where xxxxx is the	logical	icon name.

  Example
     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.

	  Dtfoo.t.pm
	  Dtfoo.t.bm
	  Dtfoo.t_m.bm
	  Dtfoo.s.pm
	  Dtfoo.s.bm
	  Dtfoo.s_m.bm
	  Dtfoo.m.pm
	  Dtfoo.m.bm
	  Dtfoo.m_m.bm
	  Dtfoo.l.pm
	  Dtfoo.l.bm
	  Dtfoo.l_m.bm

  Icon Sizes
     Icons of the following sizes and with the following suffixes
     are supported:

	Large	       48x48 icon with .l suffix

	Medium	       32x32 icon with .m suffix

	Small	       24x24 icon with .s suffix

	Tiny	       16x16 icon with .t suffix

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

  Table	Of Icon	Sizes Used
	      TED Component	HiRes,MedRes   LoRes(vga)
	     ____________________________________________
	     Front Panel	48x48	       32x32
	     FP	Subpanels	32x32	       24x24
	     FP	Inset FP	24x24	       16x16

	     WMgr ClientIcon	48x48	       32x32
	     File Mgr (Large)	32x32	       32x32
	     File Mgr (Small)	16x16	       16x16
	     ____________________________________________

  Icon Colors
     These colors are used in TED 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).

Unix System LaboratoLast change: 1 August 1995			2

dticonfile(4)	 DEVICES AND NETWORK INTERFACES	    dticonfile(4)

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

	   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
     TED 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	 information  on the icon
     lookup path.

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

  Actions And Data Types
     An	icon is	associated with	an action or data type using  the
     ICON  keyword in the action or data type definition (located
     in	.dt files).  If	 TED  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

Unix System LaboratoLast change: 1 August 1995			3

dticonfile(4)	 DEVICES AND NETWORK INTERFACES	    dticonfile(4)

     system configuration.

  Example
	  ACTION  IslandPaintOpenDoc
	  {
	      ICON	     Ipaint
	      WINDOW_TYPE    NO_STDIO
	      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 allow their	default	icon to	be overridden.

  Example
	  Dtwm*IslandPaint*clientIcon: IslandPaint.bm

  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 alter-
     nate   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.

  Example
	  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
	      ...
	  }

Unix System LaboratoLast change: 1 August 1995			4

dticonfile(4)	 DEVICES AND NETWORK INTERFACES	    dticonfile(4)

  Backdrops
     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 distin-
     guish 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  ver-
     sions  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	 repeated
     (tiled)  to fill the entire background of a workspace.  This
     is	not typically done with	an icon.  The TED  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 back-
     dropDirectories 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/dt/backdrops/C.

  Example
	  *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/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 data-
     base again.

  Design Recommendations
     In	order to allow colorful	icons while minimizing the number
     of	colors used by the TED,	it is recommended that the colors
     used be limited to	 those	available  in  the  Icon  Editor.
     These  include  the dynamic OSF/Motif widget colors, as well
     as	a set of static	 colors	 and  static  gray  colors.   The
     dynamic  colors  include foreground, background, top shadow,
     bottom shadow, select and a transparent color.   The  static
     colors  include  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.

SEE ALSO
     dtpmfile(4), dtbmfile(4), dticon(1), dtfpfile(4),

Unix System LaboratoLast change: 1 August 1995			5

dticonfile(4)	 DEVICES AND NETWORK INTERFACES	    dticonfile(4)

     dtdtfile(4), dtactionfile(4), dtdtsfile(4), dtstyle(1),
     dtenvvar(5), xmgeticonfilename(3).

Unix System LaboratoLast change: 1 August 1995			6

See also dticonfile(4)

Man(1) output converted with man2html