pixmap

pixmap(n)                    Tix Built-In Commands                   pixmap(n)



______________________________________________________________________________

NAME
       pixmap - image type for the XPM file format.

SYNOPSIS
       image create pixmap ?name? ?options?
_________________________________________________________________


DESCRIPTION
       XPM  is  a  popular X Window image file format for storing color icons.
       The pixmap image type defined by the Tix(n) library can be used to cre-
       ate color images using XPM files.


CREATING PIXMAPS
       Like  all  images,  pixmaps are created using the image create command.
       Pixmaps support the following options:

       -data string
              Specifies the contents of the source pixmap as  a  string.   The
              string must adhere to the XPM file format (e.g., as generated by
              the pixmap(1) program). If both the -data and -file options  are
              specified,  the -data option takes precedence.  Please note that
              the XPM file parsing code in the xpm library is extremely  frag-
              ile.  The first line of the string must be "/* XPM */" or other-
              wise a segmatation fault will be caused.

       -file name
              name gives the name of a file whose contents define  the  source
              pixmap.   The  file must adhere to the XPM file format (e.g., as
              generated by the pixmap(1) program).

IMAGE COMMAND
       When a pixmap image is created, Tk also creates  a  new  command  whose
       name is the same as the image.  This command may be used to invoke var-
       ious operations on the image.  It has the following general form:
                     imageName option ?arg arg ...?
       Option and the args determine the exact behavior of  the  command.  The
       following commands are possible for pixmap images:

       imageName cget option
              Returns  the  current value of the configuration option given by
              option. Option may have any of the values accepted by the  image
              create pixmap command.

       imageName configure ?option? ?value option value ...?
              Query  or  modify the configuration options for the image. If no
              option is specified, returns a list describing all of the avail-
              able options for imageName (see Tk_ConfigureInfo for information
              on the format of this list).  If option  is  specified  with  no
              value,  then the command returns a list describing the one named
              option (this list will be identical to the corresponding sublist
              of  the  value  returned  if no option is specified).  If one or
              more option-value pairs are specified, then the command modifies
              the given option(s) to have the given value(s); in this case the
              command returns an empty string.  Option may  have  any  of  the
              values accepted by the image create pixmap command.


KEYWORDS
       pixmap(1), image(n), Tix(n)





Tix                                   4.0                            pixmap(n)