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

FreeBSD Manual Pages

  
 
  

home | help
dtpmfile(special file)					dtpmfile(special file)

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 PixMap) format.
       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  containing  the
       following information:

	  o  character(s) used to represent this color in pixmap 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 ("#9696c8c8afaf")

	  o  gray  scale  visuals  (most  CDE  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	resem-
       ble the actual icon.

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",
       "RRX~~~~~~~~~~X+YBBBBYY",
       "RRBYYYY~~~~X+YBBBBBBYY",
       "RRBBBBB~~B@YBBBBBBBBYY",
       "RRBBBB~X@YYBBBBBBBBBYY",
       "RRBBB~B+YBBBBBBBBBBBYY",
       "RRBB~+YBBBBBBBBBBBBBYY",
       "RRY~YYYYYYYYYYYYYYYYYY",
       "RYYYYYYYYYYYYYYYYYYYYY"};

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

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

							dtpmfile(special file)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | APPLICATION USAGE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dtpmfile&sektion=4&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help