IMAGE(9)                                                 IMAGE(9)

     NAME
          image - Create and manipulate images

     SYNOPSIS
          image option ?arg arg ...?

     DESCRIPTION
          The image command is used to create, delete, and query
          images.  It can take several different forms, depending on
          the option argument.  The legal forms are:

          image create bitmap ?name? ?option value ...?
               Creates a new image and returns its name.  name
               specifies the name for the image;  if it is omitted
               then Tk picks a name of the form imagex, where x is an
               integer.  The following options are supported:

               -file name
                    name gives the name of a file whose contents
                    define the source bitmap.  The file must be in
                    image(6) format.

               -maskfile name
                    name gives the name of a file whose contents
                    define the mask. The file must be in image(6) for-
                    mat.

          If an image already exists by the given name then it is
          replaced with the new image.

          Transparency effects can be achieved by either the source
          image including an alpha channel or by specifying a mask
          image.  If a mask is specified then the resultant image is
          generated by rendering the source through the mask onto a
          transparent destination image.

          The following commands are posible for images:

          image delete ?name name ...?
               Deletes each of the named images and returns an empty
               string.  Each image name is invalidated.  If there are
               instances of the images displayed in widgets, the
               images won't actually be deleted until all of the
               instances are released.

          image height name
               Returns a decimal string giving the height of image
               name in pixels.

          image names

     IMAGE(9)                                                 IMAGE(9)

               Returns a list containing the names of all existing
               images.

          image type name
               Returns ``bitmap'' if name is an existing image, or an
               error otherwise.

          image width name
               Returns a decimal string giving the width of image name
               in pixels.

     BUGS
          When an image is reconfigured the widgets that refer to it
          will continue to render the original image until their
          -image option is reconfigured.

     SEE ALSO
          options(9), types(9), imageput in tk(2),