Module PIL.ImageTk
Module Summary:
#194
class BitmapImage
:
def __init__(self, image=None, **options)
Create a Tkinter-compatible bitmap image.
#60
class PhotoImage
:
def __init__(self, image=None, size=None, **options)
Creates a Tkinter-compatible photo image.
Classes
The BitmapImage Class
BitmapImage()
Create a Tkinter-compatible bitmap image.  This can be used
everywhere Tkinter expects an image object.
Constructor:
BitmapImage(image=None, **options)
Create a Tkinter-compatible bitmap image.
The given image must have mode "1".  Pixels having value 0 are
treated as transparent.  Options, if any, are passed on to
Tkinter.  The most commonly used option is
foreground
,
which is used to specify the colour for the non-transparent
parts.  See the Tkinter documentation for information on how to
specify colours.
Parameters:
image
-- A PIL image.
Method Summary:
#265
__str__()
Get the Tkinter bitmap image identifier.
#255
height()
Get the height of the image.
#247
width()
Get the width of the image.
__str__
__str__()
Get the Tkinter bitmap image identifier.  This method is
automatically called by Tkinter whenever a BitmapImage object
is passed to a Tkinter method.
Returns:
A Tkinter bitmap image identifier (a string).
height
height()
Get the height of the image.
Returns:
The height, in pixels.
width
width()
Get the width of the image.
Returns:
The width, in pixels.
The PhotoImage Class
PhotoImage()
Creates a Tkinter-compatible photo image.  This can be used
everywhere Tkinter expects an image object.  If the image is an RGBA
image, pixels having alpha 0 are treated as transparent.
Constructor:
PhotoImage(image=None, size=None, **options)
Create a photo image object. The constructor takes either
a PIL image, or a mode and a size.  Alternatively, you can
use the
file
or
data
options to initialize
the photo image object.
Parameters:
image
-- Either a PIL image, or a mode string.  If a
mode string is used, a size must also be given.
size
-- If the first argument is a mode string, this
defines the size of the image.
Keyword Parameters:
file
-- A filename to load the image from (using
Image.open(file)).
data
-- An 8-bit string containing image data (as
loaded from an image file).
Method Summary:
#130
__str__()
Get the Tkinter photo image identifier.
#146
height()
Get the height of the image.
#160
paste(im, box=None)
Paste a PIL image into the photo image.
#138
width()
Get the width of the image.
__str__
__str__()
Get the Tkinter photo image identifier.  This method is
automatically called by Tkinter whenever a PhotoImage object is
passed to a Tkinter method.
Returns:
A Tkinter photo image identifier (a string).
height
height()
Get the height of the image.
Returns:
The height, in pixels.
paste
paste(im, box=None)
Paste a PIL image into the photo image.  Note that this can
be very slow if the photo image is displayed.
Parameters:
im
-- A PIL image.  The size must match the target region.
If the mode does not match, the image is converted to the
mode of the bitmap image.
box
-- A 4-tuple defining the left, upper, right, and
lower pixel coordinate.  If None is given instead of a
tuple, all of the image is assumed.
width
width()
Get the width of the image.
Returns:
The width, in pixels.
