Unix/Linux Go Back    


RedHat 9 (Linux i386) - man page for image (redhat section n)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


image(n)			       Tk Built-In Commands				 image(n)

_________________________________________________________________________________________________

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 dif-
       ferent forms, depending on the option argument.	The legal forms are:

       image create type ?name? ?option value ...?
	      Creates a new image and returns its name.  type specifies the type  of  the  image,
	      which  must  be  one of the types currently defined (e.g., bitmap).  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.	There may be any number of option-value pairs, which pro-
	      vide 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  proce-
	      dure  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.,  ::img::logo,
	      ::img::large).

       image delete ?name name ...?
	      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 image create, the existing instances will use the new image.

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

       image names
	      Returns a list containing the names of all existing images.

       image type name
	      Returns the type of image name (the value of the type argument to image create when
	      the image was created).

       image types
	      Returns  a  list	whose elements are all of the valid image types (i.e., all of the
	      values that may be supplied for the type argument to image create).

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

BUILT-IN IMAGE TYPES
       The following image types are defined by Tk so they will be available in any  Tk  applica-
       tion.  Individual applications or extensions may define additional types.

       bitmap Each  pixel  in the image displays a foreground color, a background color, or noth-
	      ing.  See the bitmap manual entry for more information.

       photo  Displays a variety of full-color images, using dithering to approximate  colors  on
	      displays	with  limited  color  capabilities.   See the photo manual entry for more
	      information.

KEYWORDS
       height, image, types of images, width

Tk					       4.0					 image(n)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 03:14 PM.