[ новости /+++ | форум | теги | ]

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
                ("#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 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 [email protected].
     There is an email group to discuss XPM issues that  you  can
     subscribe to by writing to [email protected].
     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",
          "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:        [email protected]  Surface   Mail:
     Arnaud LE HORS, INRIA - Sophia Antipolis,
                         2004, route des Lucioles, 06565 Valbonne
     Cedex -- FRANCE
      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 CDE, refer to dticonfile(4).

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

Партнёры:

Хостинг: