/usr/dt/share/man/cat4/dtpmfile.4(/usr/dt/share/man/cat4/dtpmfile.4)

dtpmfile(4)	 DEVICES AND NETWORK INTERFACES	      dtpmfile(4)

NAME
     dtpmfile -	format of X  Pixmap  (XPM)  format  desktop  icon
     files

SYNOPSIS
	 /* XPM	*/
	 static	char * icon_name[] = {
	 "width	height num_colors chars_per_pixel [x_hot y_hot]",
	 "char {key color}+",
	 ...
	 " pixels ",
	 ...
	 };

DESCRIPTION
     Pixmap icons are multi-color images based on the XPM (X Pix-
     Map)  format  developed by	Arnaud Le Hors.	 A pixmap file is
     an	ASCII file, which can be read and modified  by	hand,  in
     addition  to  the use of color pixmap editors (like the Icon
     Editor).  The XPM format was designed specifically	for small
     "icon"  images.   XPM  files  can	be included directly in	C
     source code, so the file data is in the  form  of	a  pixmap
     structure	variable.   A pixmap file can be broken	down into
     three main	components: generic  pixmap  information,  pixmap
     colors, and the actual pixmap data.

     The generic pixmap	file contains the following information:

	o	pixmap name

	o	pixmap width

	o	pixmap height

	o	number of colors used in pixmap

	o	number of characters per pixel

	o	x hot-spot and y hot-spot (optional)

     Each color	used in	the pixmap is defined by  a  string  con-
     taining the following information:

	o	character(s) used to represent this color in pix-
		map data

	o	symbolic name for this color

	o	mono visual to	use  for  this	color  (that  is,
		black/white)

	o	color  visual  by  name	 ("red")  or  RGB   value

Unix System LaboratoLast change: 1 August 1995			1

dtpmfile(4)	 DEVICES AND NETWORK INTERFACES	      dtpmfile(4)

		("#9696c8c8afaf")

	o	gray scale visuals (most TED icons do not include
		gray scale data)

     The data itself is	simply strings	of  symbols  representing
     colors.  There  is	 one string per	column of the pixmap, and
     this data will resemble the actual	icon.

     More detailed information on the XPM library  API	and  file
     format  is	 available  with  the  XPM package from	Arnaud Le
     Hors.

     For documentation on the  XPM  Library,  questions,  sugges-
     tions, etc., send electronic mail to lehors@sophia.inria.fr.
     There is an email group to	discuss	XPM issues that	 you  can
     subscribe to by writing to	xpm-talk-request@sophia.inria.fr.
     The latest	release, along with an	archive	 of  the  mailing
     list,  is	available  by  anonymous  ftp  on  avahi.inria.fr
     (138.96.24.30) or export.lcs.mit.edu (18.30.0.238).

RETURN VALUE
     None.

EXAMPLES
     The following is a	pixmap that can	be used	to  represent  an
     executable	 file.	 The  icon has a 3-D border around it and
     contains a	lightning bolt.

	  static char ** execute = {
	  "22 22 7 1",
	  "R s iconGray1 m white c #e1e1e1e1e1e1",
	  "B s iconGray3 m white c #afafafafafaf",
	  "~ s iconColor6 m white c yellow",
	  "Y s iconColor1 m black c black",
	  "X s iconGray2 m white c #c8c8c8c8c8c8",
	  "+ s iconGray7 m black c #4b4b4b4b4b4b",
	  "@ s iconGray5 m black c #7d7d7d7d7d7d",
	  "RRRRRRRRRRRRRRRRRRRBRR",
	  "RRRRRRRRRRRRRRRR~~BRRY",
	  "RRBBBBBBBBBBBBX~~YBBYY",
	  "RRBBBBBBBBBBBB~~YBBBYY",
	  "RRBBBBBBBBBB~~~YBBBBYY",
	  "RRBBBBBBBBX~~~YBBBBBYY",
	  "RRBBBBBBBB~~~YBBBBBBYY",
	  "RRBBBBBBX~~~~~~~~XYBYY",
	  "RRBBBBX~~~~~~~~XYYBBYY",
	  "RRBBBBBYYYY~~~XYBBBBYY",
	  "RRBBBBBBX~~~XYYBBBBBYY",
	  "RRBBBBBX~~XYYBBBBBBBYY",
	  "RRBBBX~~~YYYBBBBBBBBYY",
	  "RRBB~~~~~~~~~~~XYBBBYY",

Unix System LaboratoLast change: 1 August 1995			2

dtpmfile(4)	 DEVICES AND NETWORK INTERFACES	      dtpmfile(4)

	  "RRX~~~~~~~~~~X+YBBBBYY",
	  "RRBYYYY~~~~X+YBBBBBBYY",
	  "RRBBBBB~~B@YBBBBBBBBYY",
	  "RRBBBB~X@YYBBBBBBBBBYY",
	  "RRBBB~B+YBBBBBBBBBBBYY",
	  "RRBB~+YBBBBBBBBBBBBBYY",
	  "RRY~YYYYYYYYYYYYYYYYYY",
	  "RYYYYYYYYYYYYYYYYYYYYY"};

REQUIRED XPM COPYRIGHT
     /*
      *	Copyright 1990-92 GROUPE BULL
      *
      *	Permission to use,  copy,  modify,  and	 distribute  this
     software
      *	and its	documentation for any purpose and without fee  is
     hereby
      *	granted, provided that the above copyright notice  appear
     in	all
      *	copies and that	both that copyright notice and this  per-
     mission
      *	notice appear in supporting documentation, and	that  the
     name of
      *	GROUPE BULL not	be used	in advertising or publicity  per-
     taining
      *	to distribution	of the software	without	specific, written
     prior
      *	permission.  GROUPE BULL makes no  representations  about
     the
      *	suitability of this software for any purpose.  It is pro-
     vided
      *	"as is"	without	express	or implied warranty.
      *
      *	GROUPE BULL disclaims all warranties with regard to  this
     software,
      *	including all implied warranties of  merchantability  and
     fitness,
      *	in no event shall GROUPE BULL be liable	for any	special,
      *	indirect or consequential damages or any damages
      *	whatsoever resulting from loss of use, data or profits,
      *	whether	in an action of	 contract,  negligence	or  other
     tortious
      *	action,	arising	out of or in connection	with the use
      *	or performance of this software.
      *
      */ Arnaud	LE HORS	     BULL Research FRANCE --  Koala  Pro-
     ject
			 (XPM -	X PixMap format	version	2 & 3)
	 Internet:	  lehors@sophia.inria.fr  Surface   Mail:
     Arnaud LE HORS, INRIA - Sophia Antipolis,
			 2004, route des Lucioles, 06565 Valbonne
     Cedex -- FRANCE

Unix System LaboratoLast change: 1 August 1995			3

dtpmfile(4)	 DEVICES AND NETWORK INTERFACES	      dtpmfile(4)

      Voice phone:	 (33) 93.65.77.71, Fax:	(33) 93	65 77 66,
     Telex: 97 00 50 F

APPLICATION USAGE
     For a description of  icon	 location,  usage,  design,  etc.
     within the	TED, refer to dticonfile(4).

SEE ALSO
     X11WindowSystemdocumentation, dticonfile(4), dticon(1),
     dtbmfile(4).

Unix System LaboratoLast change: 1 August 1995			4

See also dtpmfile(4)