# The PIL.ImageWin Module

Dib(image, size=None) (class) [#]

  Create a Windows bitmap with the given mode and size.

  For more information about this class, see The Dib Class.

HDC(dc) (class) [#]

  The ImageWin module contains support to create and display images under Windows 95/98, NT, 2000 and later.

  For more information about this class, see The HDC Class.

ImageWindow(image, title="PIL") (class) [#]

  Create an image window which displays the given image.

  For more information about this class, see The ImageWindow Class.

Window(title="PIL", width=None, height=None) (class) [#]

  Create a Window with the given title size.

  For more information about this class, see The Window Class.

## The Dib Class

Dib(image, size=None) (class) [#]

  Create a Windows bitmap with the given mode and size. The mode can be one of "1", "L", "P", or "RGB". If the display requires a palette, this constructor creates a suitable palette and associates it with the image. For an "L" image, 128 greylevels are allocated. For an "RGB" image, a 6x6x6 colour cube is used, together with 20 greylevels. To make sure that palettes work properly under Windows, you must call the palette method upon certain events from Windows.

__init__(image, size=None) [#]

  Create Windows bitmap.

  image
    Either a PIL image, or a mode string. If a mode string is used, a size must also be given. The mode can be one of "1", "L", "P", or "RGB".
  size
    If the first argument is a mode string, this defines the size of the image.
expose(handle) [#]

  Copy the bitmap contents to a device context.

  handle
    Device context (HDC), cast to a Python integer, or a HDC or HWND instance. In PythonWin, you can use the GetHandleAttrib method of the CDC class to get a suitable handle.
fromstring(buffer) [#]

  Load display memory contents from string buffer.

  buffer
    A string buffer containing display data (usually data returned from tostring)
paste(im, box=None) [#]

  Paste a PIL image into the bitmap image.

  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.
query_palette(dc) [#]

  Installs the palette associated with the image in the given device context.

  This method should be called upon QUERYNEWPALETTE and PALETTECHANGED events from Windows. If this method returns a non-zero value, one or more display palette entries were changed, and the image should be redrawn.

  dc
    Device context (HDC), cast to a Python integer, or an HDC or HWND instance.
  Returns:
    A true value if one or more entries were changed (this indicates that the image should be redrawn).
tostring() [#]

  Copy display memory contents to string buffer.

  Returns:
    A string buffer containing display data.

## The HDC Class

HDC(dc) (class) [#]

  The ImageWin module contains support to create and display images under Windows 95/98, NT, 2000 and later.

## The ImageWindow Class

ImageWindow(image, title="PIL") (class) [#]

  Create an image window which displays the given image.

## The Window Class

Window(title="PIL", width=None, height=None) (class) [#]

  Create a Window with the given title size.