Pillow/docs/pythondoc-PIL.ImageWin.rst
2012-02-16 20:10:57 -05:00

107 lines
3.2 KiB
ReStructuredText

=======================
The PIL.ImageWin Module
=======================
The PIL.ImageWin Module
=======================
**Dib(image, size=None)** (class) [`# <#PIL.ImageWin.Dib-class>`_]
Create a Windows bitmap with the given mode and size.
For more information about this class, see `*The Dib
Class* <#PIL.ImageWin.Dib-class>`_.
**HDC(dc)** (class) [`# <#PIL.ImageWin.HDC-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* <#PIL.ImageWin.HDC-class>`_.
**ImageWindow(image, title="PIL")** (class)
[`# <#PIL.ImageWin.ImageWindow-class>`_]
Create an image window which displays the given image.
For more information about this class, see `*The ImageWindow
Class* <#PIL.ImageWin.ImageWindow-class>`_.
**Window(title="PIL", width=None, height=None)** (class)
[`# <#PIL.ImageWin.Window-class>`_]
Create a Window with the given title size.
For more information about this class, see `*The Window
Class* <#PIL.ImageWin.Window-class>`_.
The Dib Class
-------------
**Dib(image, size=None)** (class) [`# <#PIL.ImageWin.Dib-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)**
[`# <#PIL.ImageWin.Dib.__init__-method>`_]
*image*
*size*
**expose(handle)** [`# <#PIL.ImageWin.Dib.expose-method>`_]
*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)** [`# <#PIL.ImageWin.Dib.fromstring-method>`_]
*buffer*
A string buffer containing display data (usually data returned
from **tostring**)
**paste(im, box=None)** [`# <#PIL.ImageWin.Dib.paste-method>`_]
*im*
*box*
**query\_palette(handle)**
[`# <#PIL.ImageWin.Dib.query_palette-method>`_]
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.
*handle*
Returns:
**tostring()** [`# <#PIL.ImageWin.Dib.tostring-method>`_]
Returns:
The HDC Class
-------------
**HDC(dc)** (class) [`# <#PIL.ImageWin.HDC-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)
[`# <#PIL.ImageWin.ImageWindow-class>`_]
The Window Class
----------------
**Window(title="PIL", width=None, height=None)** (class)
[`# <#PIL.ImageWin.Window-class>`_]