1mNAME0m
       image - Create and manipulate images

1mSYNOPSIS0m
       1mimage 4m22moption24m ?4marg24m 4marg24m 4m...24m?


1mDESCRIPTION0m
       The  1mimage 22mcommand is used to create, delete, and query images.  It can
       take several different forms, depending on the  4moption24m  argument.   The
       legal forms are:

       1mimage create 4m22mtype24m ?4mname24m? ?4moption24m 4mvalue24m 4m...24m?
              Creates a new image and a command with the same name and returns
              its name.  4mtype24m specifies the type of the image, which  must  be
              one  of the types currently defined (e.g., 1mbitmap22m).  4mname24m speci-
              fies the name for the image;  if it is omitted then Tk  picks  a
              name  of  the  form 1mimage4m22mx24m, where 4mx24m is an integer.  There may be
              any number of 4moption24m-4mvalue24m pairs,  which  provide  configuration
              options  for the new image.  The legal set of options is defined
              separately for each image type;  see below for  details  on  the
              options for built-in image types.  If an image already exists by
              the given name then it is replaced with the new  image  and  any
              instances  of  that  image will redisplay with the new contents.
              It is important to note that the  image  command  will  silently
              overwrite  any  procedure  that  may currently be defined by the
              given name, so choose the name wisely.  It is recommended to use
              a   separate  namespace  for  image  names  (e.g.,  1m::img::logo22m,
              1m::img::large22m).

       1mimage delete 22m?4mname24m 4mname24m ...?
              Deletes each of the named images and returns  an  empty  string.
              If  there  are instances of the images displayed in widgets, the
              images won't actually be deleted until all of the instances  are
              released.   However,  the  association between the instances and
              the image manager will  be  dropped.   Existing  instances  will
              retain  their  sizes but redisplay as empty areas.  If a deleted
              image is recreated with another call to 1mimage create22m, the exist-
              ing instances will use the new image.

       1mimage height 4m22mname0m
              Returns a decimal string giving the height of image 4mname24m in pix-
              els.

       1mimage inuse 4m22mname0m
              Returns a boolean value indicating  whether  or  not  the  image
              given by 4mname24m is in use by any widgets.

       1mimage names0m
              Returns a list containing the names of all existing images.

       1mimage type 4m22mname0m
              Returns  the  type of image 4mname24m (the value of the 4mtype24m argument
              to 1mimage create 22mwhen the image was created).

       1mimage types0m
              Returns a list whose elements are all of the valid  image  types
              (i.e., all of the values that may be supplied for the 4mtype24m argu-
              ment to 1mimage create22m).

       1mimage width 4m22mname0m
              Returns a decimal string giving the width of image 4mname24m in  pix-
              els.

       Additional  operations (e.g. writing the image to a file) may be avail-
       able as subcommands of the image instance command. See the manual  page
       for the particular image type for details.

1mBUILT-IN IMAGE TYPES0m
       The  following  image types are defined by Tk so they will be available
       in any Tk  application.   Individual  applications  or  extensions  may
       define additional types.

       1mbitmap 22mEach  pixel  in  the  image displays a foreground color, a back-
              ground color, or nothing.  See the 1mbitmap 22mmanual entry for  more
              information.

       1mphoto  22mDisplays  a  variety  of  full-color  images, using dithering to
              approximate colors on displays with limited color  capabilities.
              See the 1mphoto 22mmanual entry for more information.


1mSEE ALSO0m
       bitmap(n), options(n), photo(n)


1mKEYWORDS0m
