.TH IMAGE 9.SH NAMEimage \- Create and manipulate images.SH SYNOPSIS\f5image\fR \fIoption \fR?\fIarg arg ...\fR?.SH DESCRIPTIONThe \f5image\fR command is used to create, delete, and query images.It can take several different forms, depending on the\fIoption\fR argument.  The legal forms are:.TP\f5image create bitmap \fR?\fIname\fR? ?\fIoption value ...\fR?Creates a new image and returns its name.\fIname\fR specifies the name for the image;  if it is omitted thenTk picks a name of the form \f5image\fIx\fR, where \fIx\fR isan integer.The following options are supported:.RS.TP\f5-file \fIname\fR\fIname\fR gives the name of a file whose contents define thesource bitmap.The file must be in.IR image (6)format..TP\f5-maskfile \fIname\fR\fIname\fR gives the name of a file whose contents define themask. The file must be in.IR image (6)format..RE.PPIf an image already exists by the given name then it is replacedwith the new image..PPTransparency effects can be achieved by either the source image including an alpha channelor by specifying a mask image.If a mask is specified then the resultant image is generated by rendering the sourcethrough the mask onto a transparent destination image..PPThe following commands are posible for images:.TP\f5image delete \fR?\fIname name\fR ...?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 instancesare released..TP\f5image height \fIname\fRReturns a decimal string giving the height of image \fIname\fRin pixels..TP\f5image names\fRReturns a list containing the names of all existing images..TP\f5image type \fIname\fRReturns ``bitmap'' if.I nameis an existing image, or an error otherwise..TP\f5image width \fIname\fRReturns a decimal string giving the width of image \fIname\fRin pixels..SH BUGSWhen an image is reconfigured the widgets that refer to itwill continue to render the original image until their.B -imageoption is reconfigured..SH SEE ALSO.IR options (9),.IR types (9),.B imageputin.IR tk (2),