From 7a27cf7c183dd1a089af96832d66b2467e274556 Mon Sep 17 00:00:00 2001 From: Robin Dunn Date: Tue, 3 May 2005 00:03:08 +0000 Subject: [PATCH] reSWIGged git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@33932 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- wxPython/src/gtk/_controls.py | 14 +- wxPython/src/gtk/_core.py | 477 ++++++++++++++++++++++++----- wxPython/src/gtk/_core_wrap.cpp | 224 +++++++------- wxPython/src/gtk/_windows_wrap.cpp | 4 +- wxPython/src/gtk/wizard_wrap.cpp | 2 +- wxPython/src/mac/_controls.py | 19 +- wxPython/src/mac/_core.py | 477 ++++++++++++++++++++++++----- wxPython/src/mac/_core_wrap.cpp | 224 +++++++------- wxPython/src/mac/_windows_wrap.cpp | 4 +- wxPython/src/mac/wizard_wrap.cpp | 2 +- wxPython/src/msw/_controls.py | 19 +- wxPython/src/msw/_core.py | 477 ++++++++++++++++++++++++----- wxPython/src/msw/_core_wrap.cpp | 224 +++++++------- wxPython/src/msw/_windows_wrap.cpp | 4 +- wxPython/src/msw/wizard_wrap.cpp | 2 +- 15 files changed, 1586 insertions(+), 587 deletions(-) diff --git a/wxPython/src/gtk/_controls.py b/wxPython/src/gtk/_controls.py index 34824e5875..e00b5204f1 100644 --- a/wxPython/src/gtk/_controls.py +++ b/wxPython/src/gtk/_controls.py @@ -1504,19 +1504,11 @@ class CheckListBox(ListBox): return _controls_.CheckListBox_GetItemHeight(*args, **kwargs) def HitTest(*args, **kwargs): - """ - HitTest(self, Point pt) -> int - - Test where the given (in client coords) point lies - """ + """HitTest(self, Point pt) -> int""" return _controls_.CheckListBox_HitTest(*args, **kwargs) def HitTestXY(*args, **kwargs): - """ - HitTestXY(self, int x, int y) -> int - - Test where the given (in client coords) point lies - """ + """HitTestXY(self, int x, int y) -> int""" return _controls_.CheckListBox_HitTestXY(*args, **kwargs) @@ -2117,6 +2109,8 @@ class ScrollBar(_core.Control): """ SetScrollbar(self, int position, int thumbSize, int range, int pageSize, bool refresh=True) + + Sets the scrollbar properties of a built-in scrollbar. """ return _controls_.ScrollBar_SetScrollbar(*args, **kwargs) diff --git a/wxPython/src/gtk/_core.py b/wxPython/src/gtk/_core.py index bd98b8c10e..dd3e8c99fd 100644 --- a/wxPython/src/gtk/_core.py +++ b/wxPython/src/gtk/_core.py @@ -2107,7 +2107,7 @@ class ImageHistogram(object): del newobj.thisown def MakeKey(*args, **kwargs): """ - MakeKey(unsigned char r, unsigned char g, unsigned char b) -> unsigned long + MakeKey(byte r, byte g, byte b) -> unsigned long Get the key in the histogram for the given RGB values """ @@ -2135,7 +2135,7 @@ class ImageHistogram(object): def GetCountRGB(*args, **kwargs): """ - GetCountRGB(self, unsigned char r, unsigned char g, unsigned char b) -> unsigned long + GetCountRGB(self, byte r, byte g, byte b) -> unsigned long Returns the pixel count for the given RGB values. """ @@ -2159,18 +2159,47 @@ _core_.ImageHistogram_swigregister(ImageHistogramPtr) def ImageHistogram_MakeKey(*args, **kwargs): """ - ImageHistogram_MakeKey(unsigned char r, unsigned char g, unsigned char b) -> unsigned long + ImageHistogram_MakeKey(byte r, byte g, byte b) -> unsigned long Get the key in the histogram for the given RGB values """ return _core_.ImageHistogram_MakeKey(*args, **kwargs) class Image(Object): - """Proxy of C++ Image class""" + """ + A platform-independent image class. An image can be created from + data, or using `wx.Bitmap.ConvertToImage`, or loaded from a file in a + variety of formats. Functions are available to set and get image + bits, so it can be used for basic image manipulation. + + A wx.Image cannot be drawn directly to a `wx.DC`. Instead, a + platform-specific `wx.Bitmap` object must be created from it using the + `wx.BitmapFromImage` constructor. This bitmap can then be drawn in a + device context, using `wx.DC.DrawBitmap`. + + One colour value of the image may be used as a mask colour which will + lead to the automatic creation of a `wx.Mask` object associated to the + bitmap object. + + wx.Image supports alpha channel data, that is in addition to a byte + for the red, green and blue colour components for each pixel it also + stores a byte representing the pixel opacity. An alpha value of 0 + corresponds to a transparent pixel (null opacity) while a value of 255 + means that the pixel is 100% opaque. + + Unlike RGB data, not all images have an alpha channel and before using + `GetAlpha` you should check if this image contains an alpha channel + with `HasAlpha`. Note that currently only images loaded from PNG files + with transparency information will have an alpha channel. + """ def __repr__(self): return "<%s.%s; proxy of C++ wxImage instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,) def __init__(self, *args, **kwargs): - """__init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image""" + """ + __init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image + + Loads an image from a file. + """ newobj = _core_.new_Image(*args, **kwargs) self.this = newobj.this self.thisown = 1 @@ -2182,63 +2211,143 @@ class Image(Object): except: pass def Create(*args, **kwargs): - """Create(self, int width, int height)""" + """ + Create(self, int width, int height, bool clear=True) + + Creates a fresh image. If clear is ``True``, the new image will be + initialized to black. Otherwise, the image data will be uninitialized. + """ return _core_.Image_Create(*args, **kwargs) def Destroy(*args, **kwargs): """ Destroy(self) - Deletes the C++ object this Python object is a proxy for. + Destroys the image data. """ return _core_.Image_Destroy(*args, **kwargs) def Scale(*args, **kwargs): - """Scale(self, int width, int height) -> Image""" + """ + Scale(self, int width, int height) -> Image + + Returns a scaled version of the image. This is also useful for scaling + bitmaps in general as the only other way to scale bitmaps is to blit a + `wx.MemoryDC` into another `wx.MemoryDC`. + """ return _core_.Image_Scale(*args, **kwargs) def ShrinkBy(*args, **kwargs): - """ShrinkBy(self, int xFactor, int yFactor) -> Image""" + """ + ShrinkBy(self, int xFactor, int yFactor) -> Image + + Return a version of the image scaled smaller by the given factors. + """ return _core_.Image_ShrinkBy(*args, **kwargs) def Rescale(*args, **kwargs): - """Rescale(self, int width, int height) -> Image""" + """ + Rescale(self, int width, int height) -> Image + + Changes the size of the image in-place by scaling it: after a call to + this function, the image will have the given width and height. + + Returns the (modified) image itself. + """ return _core_.Image_Rescale(*args, **kwargs) def Resize(*args, **kwargs): - """Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image""" + """ + Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image + + Changes the size of the image in-place without scaling it, by adding + either a border with the given colour or cropping as necessary. The + image is pasted into a new image with the given size and background + colour at the position pos relative to the upper left of the new + image. If red = green = blue = -1 then use either the current mask + colour if set or find, use, and set a suitable mask colour for any + newly exposed areas. + + Returns the (modified) image itself. + """ return _core_.Image_Resize(*args, **kwargs) def SetRGB(*args, **kwargs): - """SetRGB(self, int x, int y, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetRGB(self, int x, int y, byte r, byte g, byte b) + + Sets the pixel at the given coordinate. This routine performs + bounds-checks for the coordinate so it can be considered a safe way to + manipulate the data, but in some cases this might be too slow so that + the data will have to be set directly. In that case you will have to + get access to the image data using the `GetData` method. + """ return _core_.Image_SetRGB(*args, **kwargs) def SetRGBRect(*args, **kwargs): - """SetRGBRect(self, Rect rect, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetRGBRect(self, Rect rect, byte r, byte g, byte b) + + Sets the colour of the pixels within the given rectangle. This routine + performs bounds-checks for the rectangle so it can be considered a + safe way to manipulate the data. + """ return _core_.Image_SetRGBRect(*args, **kwargs) def GetRed(*args, **kwargs): - """GetRed(self, int x, int y) -> unsigned char""" + """ + GetRed(self, int x, int y) -> byte + + Returns the red intensity at the given coordinate. + """ return _core_.Image_GetRed(*args, **kwargs) def GetGreen(*args, **kwargs): - """GetGreen(self, int x, int y) -> unsigned char""" + """ + GetGreen(self, int x, int y) -> byte + + Returns the green intensity at the given coordinate. + """ return _core_.Image_GetGreen(*args, **kwargs) def GetBlue(*args, **kwargs): - """GetBlue(self, int x, int y) -> unsigned char""" + """ + GetBlue(self, int x, int y) -> byte + + Returns the blue intensity at the given coordinate. + """ return _core_.Image_GetBlue(*args, **kwargs) def SetAlpha(*args, **kwargs): - """SetAlpha(self, int x, int y, unsigned char alpha)""" + """ + SetAlpha(self, int x, int y, byte alpha) + + Sets the alpha value for the given pixel. This function should only be + called if the image has alpha channel data, use `HasAlpha` to check + for this. + """ return _core_.Image_SetAlpha(*args, **kwargs) def GetAlpha(*args, **kwargs): - """GetAlpha(self, int x, int y) -> unsigned char""" + """ + GetAlpha(self, int x, int y) -> byte + + Returns the alpha value for the given pixel. This function may only be + called for the images with alpha channel, use `HasAlpha` to check for + this. + + The returned value is the *opacity* of the image, i.e. the value of 0 + corresponds to the fully transparent pixels while the value of 255 to + the fully opaque pixels. + """ return _core_.Image_GetAlpha(*args, **kwargs) def HasAlpha(*args, **kwargs): - """HasAlpha(self) -> bool""" + """ + HasAlpha(self) -> bool + + Returns true if this image has alpha channel, false otherwise. + """ return _core_.Image_HasAlpha(*args, **kwargs) def InitAlpha(*args, **kwargs): @@ -2254,10 +2363,10 @@ class Image(Object): def IsTransparent(*args, **kwargs): """ - IsTransparent(self, int x, int y, unsigned char threshold=IMAGE_ALPHA_THRESHOLD) -> bool + IsTransparent(self, int x, int y, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool - Returns True if this pixel is masked or has an alpha value less than - the spcified threshold. + Returns ``True`` if this pixel is masked or has an alpha value less + than the spcified threshold. """ return _core_.Image_IsTransparent(*args, **kwargs) @@ -2275,10 +2384,10 @@ class Image(Object): """ ConvertAlphaToMask(self, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool - If the image has alpha channel, this method converts it to mask. All pixels - with alpha value less than ``threshold`` are replaced with mask colour and the - alpha channel is removed. Mask colour is chosen automatically using - `FindFirstUnusedColour`. + If the image has alpha channel, this method converts it to mask. All + pixels with alpha value less than ``threshold`` are replaced with the + mask colour and the alpha channel is removed. The mask colour is + chosen automatically using `FindFirstUnusedColour`. If the image image doesn't have alpha channel, ConvertAlphaToMask does nothing. @@ -2287,7 +2396,7 @@ class Image(Object): def ConvertColourToAlpha(*args, **kwargs): """ - ConvertColourToAlpha(self, unsigned char r, unsigned char g, unsigned char b) -> bool + ConvertColourToAlpha(self, byte r, byte g, byte b) -> bool This method converts an image where the original alpha information is only available as a shades of a colour (actually shades of grey) @@ -2300,78 +2409,178 @@ class Image(Object): return _core_.Image_ConvertColourToAlpha(*args, **kwargs) def SetMaskFromImage(*args, **kwargs): - """SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool""" + """ + SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool + + Sets the image's mask so that the pixels that have RGB value of + ``(mr,mg,mb)`` in ``mask`` will be masked in this image. This is done + by first finding an unused colour in the image, setting this colour as + the mask colour and then using this colour to draw all pixels in the + image who corresponding pixel in mask has given RGB value. + + Returns ``False`` if ``mask`` does not have same dimensions as the + image or if there is no unused colour left. Returns ``True`` if the + mask was successfully applied. + + Note that this method involves computing the histogram, which is + computationally intensive operation. + """ return _core_.Image_SetMaskFromImage(*args, **kwargs) def CanRead(*args, **kwargs): - """CanRead(String name) -> bool""" + """ + CanRead(String filename) -> bool + + Returns True if the image handlers can read this file. + """ return _core_.Image_CanRead(*args, **kwargs) CanRead = staticmethod(CanRead) def GetImageCount(*args, **kwargs): - """GetImageCount(String name, long type=BITMAP_TYPE_ANY) -> int""" + """ + GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int + + If the image file contains more than one image and the image handler + is capable of retrieving these individually, this function will return + the number of available images. + """ return _core_.Image_GetImageCount(*args, **kwargs) GetImageCount = staticmethod(GetImageCount) def LoadFile(*args, **kwargs): - """LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool""" + """ + LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool + + Loads an image from a file. If no handler type is provided, the + library will try to autodetect the format. + """ return _core_.Image_LoadFile(*args, **kwargs) def LoadMimeFile(*args, **kwargs): - """LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool""" + """ + LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool + + Loads an image from a file, specifying the image type with a MIME type + string. + """ return _core_.Image_LoadMimeFile(*args, **kwargs) def SaveFile(*args, **kwargs): - """SaveFile(self, String name, int type) -> bool""" + """ + SaveFile(self, String name, int type) -> bool + + Saves an image in the named file. + """ return _core_.Image_SaveFile(*args, **kwargs) def SaveMimeFile(*args, **kwargs): - """SaveMimeFile(self, String name, String mimetype) -> bool""" + """ + SaveMimeFile(self, String name, String mimetype) -> bool + + Saves an image in the named file. + """ return _core_.Image_SaveMimeFile(*args, **kwargs) def CanReadStream(*args, **kwargs): - """CanReadStream(InputStream stream) -> bool""" + """ + CanReadStream(InputStream stream) -> bool + + Returns True if the image handlers can read an image file from the + data currently on the input stream, or a readable Python file-like + object. + """ return _core_.Image_CanReadStream(*args, **kwargs) CanReadStream = staticmethod(CanReadStream) def LoadStream(*args, **kwargs): - """LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool""" + """ + LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool + + Loads an image from an input stream or a readable Python file-like + object. If no handler type is provided, the library will try to + autodetect the format. + """ return _core_.Image_LoadStream(*args, **kwargs) def LoadMimeStream(*args, **kwargs): - """LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool""" + """ + LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool + + Loads an image from an input stream or a readable Python file-like + object, using a MIME type string to specify the image file format. + """ return _core_.Image_LoadMimeStream(*args, **kwargs) def Ok(*args, **kwargs): - """Ok(self) -> bool""" + """ + Ok(self) -> bool + + Returns true if image data is present. + """ return _core_.Image_Ok(*args, **kwargs) def GetWidth(*args, **kwargs): - """GetWidth(self) -> int""" + """ + GetWidth(self) -> int + + Gets the width of the image in pixels. + """ return _core_.Image_GetWidth(*args, **kwargs) def GetHeight(*args, **kwargs): - """GetHeight(self) -> int""" + """ + GetHeight(self) -> int + + Gets the height of the image in pixels. + """ return _core_.Image_GetHeight(*args, **kwargs) def GetSize(*args, **kwargs): - """GetSize(self) -> Size""" + """ + GetSize(self) -> Size + + Returns the size of the image in pixels. + """ return _core_.Image_GetSize(*args, **kwargs) def GetSubImage(*args, **kwargs): - """GetSubImage(self, Rect rect) -> Image""" + """ + GetSubImage(self, Rect rect) -> Image + + Returns a sub image of the current one as long as the rect belongs + entirely to the image. + """ return _core_.Image_GetSubImage(*args, **kwargs) def Size(*args, **kwargs): - """Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image""" + """ + Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image + + Returns a resized version of this image without scaling it by adding + either a border with the given colour or cropping as necessary. The + image is pasted into a new image with the given size and background + colour at the position ``pos`` relative to the upper left of the new + image. If red = green = blue = -1 then use either the current mask + colour if set or find, use, and set a suitable mask colour for any + newly exposed areas. + """ return _core_.Image_Size(*args, **kwargs) def Copy(*args, **kwargs): - """Copy(self) -> Image""" + """ + Copy(self) -> Image + + Returns an identical copy of the image. + """ return _core_.Image_Copy(*args, **kwargs) def Paste(*args, **kwargs): - """Paste(self, Image image, int x, int y)""" + """ + Paste(self, Image image, int x, int y) + + Pastes ``image`` into this instance and takes care of the mask colour + and any out of bounds problems. + """ return _core_.Image_Paste(*args, **kwargs) def GetData(*args, **kwargs): @@ -2397,7 +2606,8 @@ class Image(Object): GetDataBuffer(self) -> PyObject Returns a writable Python buffer object that is pointing at the RGB - image data buffer inside the wx.Image. + image data buffer inside the wx.Image. You need to ensure that you do + not use this buffer object after the image has been destroyed. """ return _core_.Image_GetDataBuffer(*args, **kwargs) @@ -2406,8 +2616,8 @@ class Image(Object): SetDataBuffer(self, buffer data) Sets the internal image data pointer to point at a Python buffer - object. This can save a copy of the data but you must ensure that the - buffer object lives longer than the wx.Image does. + object. This can save making an extra copy of the data but you must + ensure that the buffer object lives longer than the wx.Image does. """ return _core_.Image_SetDataBuffer(*args, **kwargs) @@ -2438,7 +2648,12 @@ class Image(Object): return _core_.Image_SetAlphaBuffer(*args, **kwargs) def SetMaskColour(*args, **kwargs): - """SetMaskColour(self, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetMaskColour(self, byte r, byte g, byte b) + + Sets the mask colour for this image (and tells the image to use the + mask). + """ return _core_.Image_SetMaskColour(*args, **kwargs) def GetOrFindMaskColour(*args, **kwargs): @@ -2450,69 +2665,139 @@ class Image(Object): return _core_.Image_GetOrFindMaskColour(*args, **kwargs) def GetMaskRed(*args, **kwargs): - """GetMaskRed(self) -> unsigned char""" + """ + GetMaskRed(self) -> byte + + Gets the red component of the mask colour. + """ return _core_.Image_GetMaskRed(*args, **kwargs) def GetMaskGreen(*args, **kwargs): - """GetMaskGreen(self) -> unsigned char""" + """ + GetMaskGreen(self) -> byte + + Gets the green component of the mask colour. + """ return _core_.Image_GetMaskGreen(*args, **kwargs) def GetMaskBlue(*args, **kwargs): - """GetMaskBlue(self) -> unsigned char""" + """ + GetMaskBlue(self) -> byte + + Gets the blue component of the mask colour. + """ return _core_.Image_GetMaskBlue(*args, **kwargs) def SetMask(*args, **kwargs): - """SetMask(self, bool mask=True)""" + """ + SetMask(self, bool mask=True) + + Specifies whether there is a mask or not. The area of the mask is + determined by the current mask colour. + """ return _core_.Image_SetMask(*args, **kwargs) def HasMask(*args, **kwargs): - """HasMask(self) -> bool""" + """ + HasMask(self) -> bool + + Returns ``True`` if there is a mask active, ``False`` otherwise. + """ return _core_.Image_HasMask(*args, **kwargs) def Rotate(*args, **kwargs): """ Rotate(self, double angle, Point centre_of_rotation, bool interpolating=True, Point offset_after_rotation=None) -> Image + + Rotates the image about the given point, by ``angle`` radians. Passing + ``True`` to ``interpolating`` results in better image quality, but is + slower. If the image has a mask, then the mask colour is used for the + uncovered pixels in the rotated image background. Otherwise, black + will be used as the fill colour. + + Returns the rotated image, leaving this image intact. """ return _core_.Image_Rotate(*args, **kwargs) def Rotate90(*args, **kwargs): - """Rotate90(self, bool clockwise=True) -> Image""" + """ + Rotate90(self, bool clockwise=True) -> Image + + Returns a copy of the image rotated 90 degrees in the direction + indicated by ``clockwise``. + """ return _core_.Image_Rotate90(*args, **kwargs) def Mirror(*args, **kwargs): - """Mirror(self, bool horizontally=True) -> Image""" + """ + Mirror(self, bool horizontally=True) -> Image + + Returns a mirrored copy of the image. The parameter ``horizontally`` + indicates the orientation. + """ return _core_.Image_Mirror(*args, **kwargs) def Replace(*args, **kwargs): """ - Replace(self, unsigned char r1, unsigned char g1, unsigned char b1, - unsigned char r2, unsigned char g2, unsigned char b2) + Replace(self, byte r1, byte g1, byte b1, byte r2, byte g2, byte b2) + + Replaces the colour specified by ``(r1,g1,b1)`` by the colour + ``(r2,g2,b2)``. """ return _core_.Image_Replace(*args, **kwargs) def ConvertToMono(*args, **kwargs): - """ConvertToMono(self, unsigned char r, unsigned char g, unsigned char b) -> Image""" + """ + ConvertToMono(self, byte r, byte g, byte b) -> Image + + Returns monochromatic version of the image. The returned image has + white colour where the original has ``(r,g,b)`` colour and black + colour everywhere else. + """ return _core_.Image_ConvertToMono(*args, **kwargs) def SetOption(*args, **kwargs): - """SetOption(self, String name, String value)""" + """ + SetOption(self, String name, String value) + + Sets an image handler defined option. For example, when saving as a + JPEG file, the option ``wx.IMAGE_OPTION_QUALITY`` is used, which is a + number between 0 and 100 (0 is terrible, 100 is very good). + """ return _core_.Image_SetOption(*args, **kwargs) def SetOptionInt(*args, **kwargs): - """SetOptionInt(self, String name, int value)""" + """ + SetOptionInt(self, String name, int value) + + Sets an image option as an integer. + """ return _core_.Image_SetOptionInt(*args, **kwargs) def GetOption(*args, **kwargs): - """GetOption(self, String name) -> String""" + """ + GetOption(self, String name) -> String + + Gets the value of an image handler option. + """ return _core_.Image_GetOption(*args, **kwargs) def GetOptionInt(*args, **kwargs): - """GetOptionInt(self, String name) -> int""" + """ + GetOptionInt(self, String name) -> int + + Gets the value of an image handler option as an integer. If the given + option is not present, the function returns 0. + """ return _core_.Image_GetOptionInt(*args, **kwargs) def HasOption(*args, **kwargs): - """HasOption(self, String name) -> bool""" + """ + HasOption(self, String name) -> bool + + Returns true if the given option is present. + """ return _core_.Image_HasOption(*args, **kwargs) def CountColours(*args, **kwargs): @@ -2539,7 +2824,13 @@ class Image(Object): RemoveHandler = staticmethod(RemoveHandler) def GetImageExtWildcard(*args, **kwargs): - """GetImageExtWildcard() -> String""" + """ + GetImageExtWildcard() -> String + + Iterates all registered wxImageHandler objects, and returns a string + containing file extension masks suitable for passing to file open/save + dialog boxes. + """ return _core_.Image_GetImageExtWildcard(*args, **kwargs) GetImageExtWildcard = staticmethod(GetImageExtWildcard) @@ -2548,7 +2839,7 @@ class Image(Object): return _core_.Image_ConvertToBitmap(*args, **kwargs) def ConvertToMonoBitmap(*args, **kwargs): - """ConvertToMonoBitmap(self, unsigned char red, unsigned char green, unsigned char blue) -> Bitmap""" + """ConvertToMonoBitmap(self, byte red, byte green, byte blue) -> Bitmap""" return _core_.Image_ConvertToMonoBitmap(*args, **kwargs) def __nonzero__(self): return self.Ok() @@ -2561,19 +2852,34 @@ class ImagePtr(Image): _core_.Image_swigregister(ImagePtr) def ImageFromMime(*args, **kwargs): - """ImageFromMime(String name, String mimetype, int index=-1) -> Image""" + """ + ImageFromMime(String name, String mimetype, int index=-1) -> Image + + Loads an image from a file, using a MIME type string (such as + 'image/jpeg') to specify image type. + """ val = _core_.new_ImageFromMime(*args, **kwargs) val.thisown = 1 return val def ImageFromStream(*args, **kwargs): - """ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image""" + """ + ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image + + Loads an image from an input stream, or any readable Python file-like + object. + """ val = _core_.new_ImageFromStream(*args, **kwargs) val.thisown = 1 return val def ImageFromStreamMime(*args, **kwargs): - """ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image""" + """ + ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image + + Loads an image from an input stream, or any readable Python file-like + object, specifying the image format with a MIME type string. + """ val = _core_.new_ImageFromStreamMime(*args, **kwargs) val.thisown = 1 return val @@ -2617,22 +2923,39 @@ def ImageFromDataWithAlpha(*args, **kwargs): Construct an Image from a buffer of RGB bytes with an Alpha channel. Accepts either a string or a buffer object holding the data and the - length of the data must be width*height*3. + length of the data must be width*height*3 bytes, and the length of the + alpha data must be width*height bytes. """ val = _core_.new_ImageFromDataWithAlpha(*args, **kwargs) val.thisown = 1 return val def Image_CanRead(*args, **kwargs): - """Image_CanRead(String name) -> bool""" + """ + Image_CanRead(String filename) -> bool + + Returns True if the image handlers can read this file. + """ return _core_.Image_CanRead(*args, **kwargs) def Image_GetImageCount(*args, **kwargs): - """Image_GetImageCount(String name, long type=BITMAP_TYPE_ANY) -> int""" + """ + Image_GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int + + If the image file contains more than one image and the image handler + is capable of retrieving these individually, this function will return + the number of available images. + """ return _core_.Image_GetImageCount(*args, **kwargs) def Image_CanReadStream(*args, **kwargs): - """Image_CanReadStream(InputStream stream) -> bool""" + """ + Image_CanReadStream(InputStream stream) -> bool + + Returns True if the image handlers can read an image file from the + data currently on the input stream, or a readable Python file-like + object. + """ return _core_.Image_CanReadStream(*args, **kwargs) def Image_AddHandler(*args, **kwargs): @@ -2648,7 +2971,13 @@ def Image_RemoveHandler(*args, **kwargs): return _core_.Image_RemoveHandler(*args, **kwargs) def Image_GetImageExtWildcard(*args, **kwargs): - """Image_GetImageExtWildcard() -> String""" + """ + Image_GetImageExtWildcard() -> String + + Iterates all registered wxImageHandler objects, and returns a string + containing file extension masks suitable for passing to file open/save + dialog boxes. + """ return _core_.Image_GetImageExtWildcard(*args, **kwargs) def InitAllImageHandlers(): diff --git a/wxPython/src/gtk/_core_wrap.cpp b/wxPython/src/gtk/_core_wrap.cpp index 07210d1c61..e929a8682c 100644 --- a/wxPython/src/gtk/_core_wrap.cpp +++ b/wxPython/src/gtk/_core_wrap.cpp @@ -2328,7 +2328,7 @@ static unsigned long wxImageHistogram_GetCount(wxImageHistogram *self,unsigned l wxImageHistogramEntry e = (*self)[key]; return e.value; } -static unsigned long wxImageHistogram_GetCountRGB(wxImageHistogram *self,unsigned char r,unsigned char g,unsigned char b){ +static unsigned long wxImageHistogram_GetCountRGB(wxImageHistogram *self,byte r,byte g,byte b){ unsigned long key = wxImageHistogram::MakeKey(r, g, b); wxImageHistogramEntry e = (*self)[key]; return e.value; @@ -2476,7 +2476,7 @@ static wxBitmap wxImage_ConvertToBitmap(wxImage *self,int depth=-1){ wxBitmap bitmap(*self, depth); return bitmap; } -static wxBitmap wxImage_ConvertToMonoBitmap(wxImage *self,unsigned char red,unsigned char green,unsigned char blue){ +static wxBitmap wxImage_ConvertToMonoBitmap(wxImage *self,byte red,byte green,byte blue){ wxImage mono = self->ConvertToMono( red, green, blue ); wxBitmap bitmap( mono, 1 ); return bitmap; @@ -10243,9 +10243,9 @@ static PyObject *_wrap_new_ImageHistogram(PyObject *, PyObject *args, PyObject * static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; - unsigned char arg1 ; - unsigned char arg2 ; - unsigned char arg3 ; + byte arg1 ; + byte arg2 ; + byte arg3 ; unsigned long result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10256,15 +10256,15 @@ static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObje if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO:ImageHistogram_MakeKey",kwnames,&obj0,&obj1,&obj2)) goto fail; { - arg1 = (unsigned char)(SWIG_As_unsigned_SS_char(obj0)); + arg1 = (byte)(SWIG_As_unsigned_SS_char(obj0)); if (SWIG_arg_fail(1)) SWIG_fail; } { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { @@ -10286,18 +10286,18 @@ static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObje static PyObject *_wrap_ImageHistogram_FindFirstUnusedColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImageHistogram *arg1 = (wxImageHistogram *) 0 ; - unsigned char *arg2 = (unsigned char *) 0 ; - unsigned char *arg3 = (unsigned char *) 0 ; - unsigned char *arg4 = (unsigned char *) 0 ; - unsigned char arg5 = (unsigned char) 1 ; - unsigned char arg6 = (unsigned char) 0 ; - unsigned char arg7 = (unsigned char) 0 ; + byte *arg2 = (byte *) 0 ; + byte *arg3 = (byte *) 0 ; + byte *arg4 = (byte *) 0 ; + byte arg5 = (byte) 1 ; + byte arg6 = (byte) 0 ; + byte arg7 = (byte) 0 ; bool result; - unsigned char temp2 ; + byte temp2 ; int res2 = 0 ; - unsigned char temp3 ; + byte temp3 ; int res3 = 0 ; - unsigned char temp4 ; + byte temp4 ; int res4 = 0 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10315,19 +10315,19 @@ static PyObject *_wrap_ImageHistogram_FindFirstUnusedColour(PyObject *, PyObject if (SWIG_arg_fail(1)) SWIG_fail; if (obj1) { { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(5)) SWIG_fail; } } if (obj2) { { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(6)) SWIG_fail; } } if (obj3) { { - arg7 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg7 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(7)) SWIG_fail; } } @@ -10390,9 +10390,9 @@ static PyObject *_wrap_ImageHistogram_GetCount(PyObject *, PyObject *args, PyObj static PyObject *_wrap_ImageHistogram_GetCountRGB(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImageHistogram *arg1 = (wxImageHistogram *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; unsigned long result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10406,15 +10406,15 @@ static PyObject *_wrap_ImageHistogram_GetCountRGB(PyObject *, PyObject *args, Py SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImageHistogram, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -10918,14 +10918,16 @@ static PyObject *_wrap_Image_Create(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; + bool arg4 = (bool) true ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; + PyObject * obj3 = 0 ; char *kwnames[] = { - (char *) "self",(char *) "width",(char *) "height", NULL + (char *) "self",(char *) "width",(char *) "height",(char *) "clear", NULL }; - if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO:Image_Create",kwnames,&obj0,&obj1,&obj2)) goto fail; + if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO|O:Image_Create",kwnames,&obj0,&obj1,&obj2,&obj3)) goto fail; SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { @@ -10936,9 +10938,15 @@ static PyObject *_wrap_Image_Create(PyObject *, PyObject *args, PyObject *kwargs arg3 = (int)(SWIG_As_int(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } + if (obj3) { + { + arg4 = (bool)(SWIG_As_bool(obj3)); + if (SWIG_arg_fail(4)) SWIG_fail; + } + } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - (arg1)->Create(arg2,arg3); + (arg1)->Create(arg2,arg3,arg4); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11172,9 +11180,9 @@ static PyObject *_wrap_Image_SetRGB(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; - unsigned char arg6 ; + byte arg4 ; + byte arg5 ; + byte arg6 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11197,15 +11205,15 @@ static PyObject *_wrap_Image_SetRGB(PyObject *, PyObject *args, PyObject *kwargs if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj5)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj5)); if (SWIG_arg_fail(6)) SWIG_fail; } { @@ -11226,9 +11234,9 @@ static PyObject *_wrap_Image_SetRGBRect(PyObject *, PyObject *args, PyObject *kw PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; wxRect *arg2 = 0 ; - unsigned char arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; + byte arg3 ; + byte arg4 ; + byte arg5 ; wxRect temp2 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11247,15 +11255,15 @@ static PyObject *_wrap_Image_SetRGBRect(PyObject *, PyObject *args, PyObject *kw if ( ! wxRect_helper(obj1, &arg2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { @@ -11277,7 +11285,7 @@ static PyObject *_wrap_Image_GetRed(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11298,7 +11306,7 @@ static PyObject *_wrap_Image_GetRed(PyObject *, PyObject *args, PyObject *kwargs } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetRed(arg2,arg3); + result = (byte)(arg1)->GetRed(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11317,7 +11325,7 @@ static PyObject *_wrap_Image_GetGreen(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11338,7 +11346,7 @@ static PyObject *_wrap_Image_GetGreen(PyObject *, PyObject *args, PyObject *kwar } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetGreen(arg2,arg3); + result = (byte)(arg1)->GetGreen(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11357,7 +11365,7 @@ static PyObject *_wrap_Image_GetBlue(PyObject *, PyObject *args, PyObject *kwarg wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11378,7 +11386,7 @@ static PyObject *_wrap_Image_GetBlue(PyObject *, PyObject *args, PyObject *kwarg } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetBlue(arg2,arg3); + result = (byte)(arg1)->GetBlue(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11397,7 +11405,7 @@ static PyObject *_wrap_Image_SetAlpha(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 ; + byte arg4 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11418,7 +11426,7 @@ static PyObject *_wrap_Image_SetAlpha(PyObject *, PyObject *args, PyObject *kwar if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -11440,7 +11448,7 @@ static PyObject *_wrap_Image_GetAlpha(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11461,7 +11469,7 @@ static PyObject *_wrap_Image_GetAlpha(PyObject *, PyObject *args, PyObject *kwar } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetAlpha(arg2,arg3); + result = (byte)(arg1)->GetAlpha(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11533,7 +11541,7 @@ static PyObject *_wrap_Image_IsTransparent(PyObject *, PyObject *args, PyObject wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 = (unsigned char) wxIMAGE_ALPHA_THRESHOLD ; + byte arg4 = (byte) wxIMAGE_ALPHA_THRESHOLD ; bool result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11556,7 +11564,7 @@ static PyObject *_wrap_Image_IsTransparent(PyObject *, PyObject *args, PyObject } if (obj3) { { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } } @@ -11685,9 +11693,9 @@ static PyObject *_wrap_Image_ConvertAlphaToMask(PyObject *, PyObject *args, PyOb static PyObject *_wrap_Image_ConvertColourToAlpha(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; bool result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11701,15 +11709,15 @@ static PyObject *_wrap_Image_ConvertColourToAlpha(PyObject *, PyObject *args, Py SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -11791,7 +11799,7 @@ static PyObject *_wrap_Image_CanRead(PyObject *, PyObject *args, PyObject *kwarg bool temp1 = false ; PyObject * obj0 = 0 ; char *kwnames[] = { - (char *) "name", NULL + (char *) "filename", NULL }; if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"O:Image_CanRead",kwnames,&obj0)) goto fail; @@ -11833,7 +11841,7 @@ static PyObject *_wrap_Image_GetImageCount(PyObject *, PyObject *args, PyObject PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; char *kwnames[] = { - (char *) "name",(char *) "type", NULL + (char *) "filename",(char *) "type", NULL }; if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"O|O:Image_GetImageCount",kwnames,&obj0,&obj1)) goto fail; @@ -12829,9 +12837,9 @@ static PyObject *_wrap_Image_SetAlphaBuffer(PyObject *, PyObject *args, PyObject static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -12844,15 +12852,15 @@ static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -12872,14 +12880,14 @@ static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject static PyObject *_wrap_Image_GetOrFindMaskColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char *arg2 = (unsigned char *) 0 ; - unsigned char *arg3 = (unsigned char *) 0 ; - unsigned char *arg4 = (unsigned char *) 0 ; - unsigned char temp2 ; + byte *arg2 = (byte *) 0 ; + byte *arg3 = (byte *) 0 ; + byte *arg4 = (byte *) 0 ; + byte temp2 ; int res2 = 0 ; - unsigned char temp3 ; + byte temp3 ; int res3 = 0 ; - unsigned char temp4 ; + byte temp4 ; int res4 = 0 ; PyObject * obj0 = 0 ; char *kwnames[] = { @@ -12915,7 +12923,7 @@ static PyObject *_wrap_Image_GetOrFindMaskColour(PyObject *, PyObject *args, PyO static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12926,7 +12934,7 @@ static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kw if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskRed(); + result = (byte)(arg1)->GetMaskRed(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -12943,7 +12951,7 @@ static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kw static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12954,7 +12962,7 @@ static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject * if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskGreen(); + result = (byte)(arg1)->GetMaskGreen(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -12971,7 +12979,7 @@ static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject * static PyObject *_wrap_Image_GetMaskBlue(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12982,7 +12990,7 @@ static PyObject *_wrap_Image_GetMaskBlue(PyObject *, PyObject *args, PyObject *k if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskBlue(); + result = (byte)(arg1)->GetMaskBlue(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -13193,12 +13201,12 @@ static PyObject *_wrap_Image_Mirror(PyObject *, PyObject *args, PyObject *kwargs static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; - unsigned char arg6 ; - unsigned char arg7 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; + byte arg5 ; + byte arg6 ; + byte arg7 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -13214,27 +13222,27 @@ static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwarg SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj5)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj5)); if (SWIG_arg_fail(6)) SWIG_fail; } { - arg7 = (unsigned char)(SWIG_As_unsigned_SS_char(obj6)); + arg7 = (byte)(SWIG_As_unsigned_SS_char(obj6)); if (SWIG_arg_fail(7)) SWIG_fail; } { @@ -13254,9 +13262,9 @@ static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwarg static PyObject *_wrap_Image_ConvertToMono(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; SwigValueWrapper result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -13270,15 +13278,15 @@ static PyObject *_wrap_Image_ConvertToMono(PyObject *, PyObject *args, PyObject SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -13773,9 +13781,9 @@ static PyObject *_wrap_Image_ConvertToBitmap(PyObject *, PyObject *args, PyObjec static PyObject *_wrap_Image_ConvertToMonoBitmap(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; wxBitmap result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -13789,15 +13797,15 @@ static PyObject *_wrap_Image_ConvertToMonoBitmap(PyObject *, PyObject *args, PyO SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -31966,7 +31974,7 @@ static PyObject *_wrap_Window_GetSizer(PyObject *, PyObject *args, PyObject *kwa if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -32023,7 +32031,7 @@ static PyObject *_wrap_Window_GetContainingSizer(PyObject *, PyObject *args, PyO if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -35446,7 +35454,7 @@ static PyObject *_wrap_MenuBar_FindMenu(PyObject *, PyObject *args, PyObject *kw } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (int)((wxMenuBar const *)arg1)->FindMenu((wxString const &)*arg2); + result = (int)(arg1)->FindMenu((wxString const &)*arg2); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -39300,7 +39308,7 @@ static PyObject *_wrap_SizerItem_GetSizer(PyObject *, PyObject *args, PyObject * if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -47218,7 +47226,7 @@ static swig_type_info _swigt__unsigned_int[] = {{"_unsigned_int", 0, "unsigned i static swig_type_info _swigt__p_unsigned_int[] = {{"_p_unsigned_int", 0, "unsigned int *|time_t *", 0, 0, 0, 0},{"_p_unsigned_int", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxMenuEvent[] = {{"_p_wxMenuEvent", 0, "wxMenuEvent *", 0, 0, 0, 0},{"_p_wxMenuEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxContextMenuEvent[] = {{"_p_wxContextMenuEvent", 0, "wxContextMenuEvent *", 0, 0, 0, 0},{"_p_wxContextMenuEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; -static swig_type_info _swigt__p_unsigned_char[] = {{"_p_unsigned_char", 0, "unsigned char *", 0, 0, 0, 0},{"_p_unsigned_char", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; +static swig_type_info _swigt__p_unsigned_char[] = {{"_p_unsigned_char", 0, "unsigned char *|byte *", 0, 0, 0, 0},{"_p_unsigned_char", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxEraseEvent[] = {{"_p_wxEraseEvent", 0, "wxEraseEvent *", 0, 0, 0, 0},{"_p_wxEraseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxMouseEvent[] = {{"_p_wxMouseEvent", 0, "wxMouseEvent *", 0, 0, 0, 0},{"_p_wxMouseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxCloseEvent[] = {{"_p_wxCloseEvent", 0, "wxCloseEvent *", 0, 0, 0, 0},{"_p_wxCloseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; diff --git a/wxPython/src/gtk/_windows_wrap.cpp b/wxPython/src/gtk/_windows_wrap.cpp index 8b75d855dc..7f8ebbfdf2 100644 --- a/wxPython/src/gtk/_windows_wrap.cpp +++ b/wxPython/src/gtk/_windows_wrap.cpp @@ -5870,7 +5870,7 @@ static PyObject *_wrap_Dialog_CreateTextSizer(PyObject *, PyObject *args, PyObje if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } { if (temp2) @@ -5912,7 +5912,7 @@ static PyObject *_wrap_Dialog_CreateButtonSizer(PyObject *, PyObject *args, PyOb if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: diff --git a/wxPython/src/gtk/wizard_wrap.cpp b/wxPython/src/gtk/wizard_wrap.cpp index a7ab75fcfa..4b978fa179 100644 --- a/wxPython/src/gtk/wizard_wrap.cpp +++ b/wxPython/src/gtk/wizard_wrap.cpp @@ -3351,7 +3351,7 @@ static PyObject *_wrap_Wizard_GetPageAreaSizer(PyObject *, PyObject *args, PyObj if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: diff --git a/wxPython/src/mac/_controls.py b/wxPython/src/mac/_controls.py index b1313620b7..e0baa75af6 100644 --- a/wxPython/src/mac/_controls.py +++ b/wxPython/src/mac/_controls.py @@ -1491,19 +1491,11 @@ class CheckListBox(ListBox): return _controls_.CheckListBox_Check(*args, **kwargs) def HitTest(*args, **kwargs): - """ - HitTest(self, Point pt) -> int - - Test where the given (in client coords) point lies - """ + """HitTest(self, Point pt) -> int""" return _controls_.CheckListBox_HitTest(*args, **kwargs) def HitTestXY(*args, **kwargs): - """ - HitTestXY(self, int x, int y) -> int - - Test where the given (in client coords) point lies - """ + """HitTestXY(self, int x, int y) -> int""" return _controls_.CheckListBox_HitTestXY(*args, **kwargs) @@ -3052,7 +3044,12 @@ class BookCtrlBaseEvent(_core.NotifyEvent): self.thisown = 1 del newobj.thisown def GetSelection(*args, **kwargs): - """GetSelection(self) -> int""" + """ + GetSelection(self) -> int + + Returns item index for a listbox or choice selection event (not valid + for a deselection). + """ return _controls_.BookCtrlBaseEvent_GetSelection(*args, **kwargs) def SetSelection(*args, **kwargs): diff --git a/wxPython/src/mac/_core.py b/wxPython/src/mac/_core.py index bd98b8c10e..dd3e8c99fd 100644 --- a/wxPython/src/mac/_core.py +++ b/wxPython/src/mac/_core.py @@ -2107,7 +2107,7 @@ class ImageHistogram(object): del newobj.thisown def MakeKey(*args, **kwargs): """ - MakeKey(unsigned char r, unsigned char g, unsigned char b) -> unsigned long + MakeKey(byte r, byte g, byte b) -> unsigned long Get the key in the histogram for the given RGB values """ @@ -2135,7 +2135,7 @@ class ImageHistogram(object): def GetCountRGB(*args, **kwargs): """ - GetCountRGB(self, unsigned char r, unsigned char g, unsigned char b) -> unsigned long + GetCountRGB(self, byte r, byte g, byte b) -> unsigned long Returns the pixel count for the given RGB values. """ @@ -2159,18 +2159,47 @@ _core_.ImageHistogram_swigregister(ImageHistogramPtr) def ImageHistogram_MakeKey(*args, **kwargs): """ - ImageHistogram_MakeKey(unsigned char r, unsigned char g, unsigned char b) -> unsigned long + ImageHistogram_MakeKey(byte r, byte g, byte b) -> unsigned long Get the key in the histogram for the given RGB values """ return _core_.ImageHistogram_MakeKey(*args, **kwargs) class Image(Object): - """Proxy of C++ Image class""" + """ + A platform-independent image class. An image can be created from + data, or using `wx.Bitmap.ConvertToImage`, or loaded from a file in a + variety of formats. Functions are available to set and get image + bits, so it can be used for basic image manipulation. + + A wx.Image cannot be drawn directly to a `wx.DC`. Instead, a + platform-specific `wx.Bitmap` object must be created from it using the + `wx.BitmapFromImage` constructor. This bitmap can then be drawn in a + device context, using `wx.DC.DrawBitmap`. + + One colour value of the image may be used as a mask colour which will + lead to the automatic creation of a `wx.Mask` object associated to the + bitmap object. + + wx.Image supports alpha channel data, that is in addition to a byte + for the red, green and blue colour components for each pixel it also + stores a byte representing the pixel opacity. An alpha value of 0 + corresponds to a transparent pixel (null opacity) while a value of 255 + means that the pixel is 100% opaque. + + Unlike RGB data, not all images have an alpha channel and before using + `GetAlpha` you should check if this image contains an alpha channel + with `HasAlpha`. Note that currently only images loaded from PNG files + with transparency information will have an alpha channel. + """ def __repr__(self): return "<%s.%s; proxy of C++ wxImage instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,) def __init__(self, *args, **kwargs): - """__init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image""" + """ + __init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image + + Loads an image from a file. + """ newobj = _core_.new_Image(*args, **kwargs) self.this = newobj.this self.thisown = 1 @@ -2182,63 +2211,143 @@ class Image(Object): except: pass def Create(*args, **kwargs): - """Create(self, int width, int height)""" + """ + Create(self, int width, int height, bool clear=True) + + Creates a fresh image. If clear is ``True``, the new image will be + initialized to black. Otherwise, the image data will be uninitialized. + """ return _core_.Image_Create(*args, **kwargs) def Destroy(*args, **kwargs): """ Destroy(self) - Deletes the C++ object this Python object is a proxy for. + Destroys the image data. """ return _core_.Image_Destroy(*args, **kwargs) def Scale(*args, **kwargs): - """Scale(self, int width, int height) -> Image""" + """ + Scale(self, int width, int height) -> Image + + Returns a scaled version of the image. This is also useful for scaling + bitmaps in general as the only other way to scale bitmaps is to blit a + `wx.MemoryDC` into another `wx.MemoryDC`. + """ return _core_.Image_Scale(*args, **kwargs) def ShrinkBy(*args, **kwargs): - """ShrinkBy(self, int xFactor, int yFactor) -> Image""" + """ + ShrinkBy(self, int xFactor, int yFactor) -> Image + + Return a version of the image scaled smaller by the given factors. + """ return _core_.Image_ShrinkBy(*args, **kwargs) def Rescale(*args, **kwargs): - """Rescale(self, int width, int height) -> Image""" + """ + Rescale(self, int width, int height) -> Image + + Changes the size of the image in-place by scaling it: after a call to + this function, the image will have the given width and height. + + Returns the (modified) image itself. + """ return _core_.Image_Rescale(*args, **kwargs) def Resize(*args, **kwargs): - """Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image""" + """ + Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image + + Changes the size of the image in-place without scaling it, by adding + either a border with the given colour or cropping as necessary. The + image is pasted into a new image with the given size and background + colour at the position pos relative to the upper left of the new + image. If red = green = blue = -1 then use either the current mask + colour if set or find, use, and set a suitable mask colour for any + newly exposed areas. + + Returns the (modified) image itself. + """ return _core_.Image_Resize(*args, **kwargs) def SetRGB(*args, **kwargs): - """SetRGB(self, int x, int y, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetRGB(self, int x, int y, byte r, byte g, byte b) + + Sets the pixel at the given coordinate. This routine performs + bounds-checks for the coordinate so it can be considered a safe way to + manipulate the data, but in some cases this might be too slow so that + the data will have to be set directly. In that case you will have to + get access to the image data using the `GetData` method. + """ return _core_.Image_SetRGB(*args, **kwargs) def SetRGBRect(*args, **kwargs): - """SetRGBRect(self, Rect rect, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetRGBRect(self, Rect rect, byte r, byte g, byte b) + + Sets the colour of the pixels within the given rectangle. This routine + performs bounds-checks for the rectangle so it can be considered a + safe way to manipulate the data. + """ return _core_.Image_SetRGBRect(*args, **kwargs) def GetRed(*args, **kwargs): - """GetRed(self, int x, int y) -> unsigned char""" + """ + GetRed(self, int x, int y) -> byte + + Returns the red intensity at the given coordinate. + """ return _core_.Image_GetRed(*args, **kwargs) def GetGreen(*args, **kwargs): - """GetGreen(self, int x, int y) -> unsigned char""" + """ + GetGreen(self, int x, int y) -> byte + + Returns the green intensity at the given coordinate. + """ return _core_.Image_GetGreen(*args, **kwargs) def GetBlue(*args, **kwargs): - """GetBlue(self, int x, int y) -> unsigned char""" + """ + GetBlue(self, int x, int y) -> byte + + Returns the blue intensity at the given coordinate. + """ return _core_.Image_GetBlue(*args, **kwargs) def SetAlpha(*args, **kwargs): - """SetAlpha(self, int x, int y, unsigned char alpha)""" + """ + SetAlpha(self, int x, int y, byte alpha) + + Sets the alpha value for the given pixel. This function should only be + called if the image has alpha channel data, use `HasAlpha` to check + for this. + """ return _core_.Image_SetAlpha(*args, **kwargs) def GetAlpha(*args, **kwargs): - """GetAlpha(self, int x, int y) -> unsigned char""" + """ + GetAlpha(self, int x, int y) -> byte + + Returns the alpha value for the given pixel. This function may only be + called for the images with alpha channel, use `HasAlpha` to check for + this. + + The returned value is the *opacity* of the image, i.e. the value of 0 + corresponds to the fully transparent pixels while the value of 255 to + the fully opaque pixels. + """ return _core_.Image_GetAlpha(*args, **kwargs) def HasAlpha(*args, **kwargs): - """HasAlpha(self) -> bool""" + """ + HasAlpha(self) -> bool + + Returns true if this image has alpha channel, false otherwise. + """ return _core_.Image_HasAlpha(*args, **kwargs) def InitAlpha(*args, **kwargs): @@ -2254,10 +2363,10 @@ class Image(Object): def IsTransparent(*args, **kwargs): """ - IsTransparent(self, int x, int y, unsigned char threshold=IMAGE_ALPHA_THRESHOLD) -> bool + IsTransparent(self, int x, int y, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool - Returns True if this pixel is masked or has an alpha value less than - the spcified threshold. + Returns ``True`` if this pixel is masked or has an alpha value less + than the spcified threshold. """ return _core_.Image_IsTransparent(*args, **kwargs) @@ -2275,10 +2384,10 @@ class Image(Object): """ ConvertAlphaToMask(self, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool - If the image has alpha channel, this method converts it to mask. All pixels - with alpha value less than ``threshold`` are replaced with mask colour and the - alpha channel is removed. Mask colour is chosen automatically using - `FindFirstUnusedColour`. + If the image has alpha channel, this method converts it to mask. All + pixels with alpha value less than ``threshold`` are replaced with the + mask colour and the alpha channel is removed. The mask colour is + chosen automatically using `FindFirstUnusedColour`. If the image image doesn't have alpha channel, ConvertAlphaToMask does nothing. @@ -2287,7 +2396,7 @@ class Image(Object): def ConvertColourToAlpha(*args, **kwargs): """ - ConvertColourToAlpha(self, unsigned char r, unsigned char g, unsigned char b) -> bool + ConvertColourToAlpha(self, byte r, byte g, byte b) -> bool This method converts an image where the original alpha information is only available as a shades of a colour (actually shades of grey) @@ -2300,78 +2409,178 @@ class Image(Object): return _core_.Image_ConvertColourToAlpha(*args, **kwargs) def SetMaskFromImage(*args, **kwargs): - """SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool""" + """ + SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool + + Sets the image's mask so that the pixels that have RGB value of + ``(mr,mg,mb)`` in ``mask`` will be masked in this image. This is done + by first finding an unused colour in the image, setting this colour as + the mask colour and then using this colour to draw all pixels in the + image who corresponding pixel in mask has given RGB value. + + Returns ``False`` if ``mask`` does not have same dimensions as the + image or if there is no unused colour left. Returns ``True`` if the + mask was successfully applied. + + Note that this method involves computing the histogram, which is + computationally intensive operation. + """ return _core_.Image_SetMaskFromImage(*args, **kwargs) def CanRead(*args, **kwargs): - """CanRead(String name) -> bool""" + """ + CanRead(String filename) -> bool + + Returns True if the image handlers can read this file. + """ return _core_.Image_CanRead(*args, **kwargs) CanRead = staticmethod(CanRead) def GetImageCount(*args, **kwargs): - """GetImageCount(String name, long type=BITMAP_TYPE_ANY) -> int""" + """ + GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int + + If the image file contains more than one image and the image handler + is capable of retrieving these individually, this function will return + the number of available images. + """ return _core_.Image_GetImageCount(*args, **kwargs) GetImageCount = staticmethod(GetImageCount) def LoadFile(*args, **kwargs): - """LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool""" + """ + LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool + + Loads an image from a file. If no handler type is provided, the + library will try to autodetect the format. + """ return _core_.Image_LoadFile(*args, **kwargs) def LoadMimeFile(*args, **kwargs): - """LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool""" + """ + LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool + + Loads an image from a file, specifying the image type with a MIME type + string. + """ return _core_.Image_LoadMimeFile(*args, **kwargs) def SaveFile(*args, **kwargs): - """SaveFile(self, String name, int type) -> bool""" + """ + SaveFile(self, String name, int type) -> bool + + Saves an image in the named file. + """ return _core_.Image_SaveFile(*args, **kwargs) def SaveMimeFile(*args, **kwargs): - """SaveMimeFile(self, String name, String mimetype) -> bool""" + """ + SaveMimeFile(self, String name, String mimetype) -> bool + + Saves an image in the named file. + """ return _core_.Image_SaveMimeFile(*args, **kwargs) def CanReadStream(*args, **kwargs): - """CanReadStream(InputStream stream) -> bool""" + """ + CanReadStream(InputStream stream) -> bool + + Returns True if the image handlers can read an image file from the + data currently on the input stream, or a readable Python file-like + object. + """ return _core_.Image_CanReadStream(*args, **kwargs) CanReadStream = staticmethod(CanReadStream) def LoadStream(*args, **kwargs): - """LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool""" + """ + LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool + + Loads an image from an input stream or a readable Python file-like + object. If no handler type is provided, the library will try to + autodetect the format. + """ return _core_.Image_LoadStream(*args, **kwargs) def LoadMimeStream(*args, **kwargs): - """LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool""" + """ + LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool + + Loads an image from an input stream or a readable Python file-like + object, using a MIME type string to specify the image file format. + """ return _core_.Image_LoadMimeStream(*args, **kwargs) def Ok(*args, **kwargs): - """Ok(self) -> bool""" + """ + Ok(self) -> bool + + Returns true if image data is present. + """ return _core_.Image_Ok(*args, **kwargs) def GetWidth(*args, **kwargs): - """GetWidth(self) -> int""" + """ + GetWidth(self) -> int + + Gets the width of the image in pixels. + """ return _core_.Image_GetWidth(*args, **kwargs) def GetHeight(*args, **kwargs): - """GetHeight(self) -> int""" + """ + GetHeight(self) -> int + + Gets the height of the image in pixels. + """ return _core_.Image_GetHeight(*args, **kwargs) def GetSize(*args, **kwargs): - """GetSize(self) -> Size""" + """ + GetSize(self) -> Size + + Returns the size of the image in pixels. + """ return _core_.Image_GetSize(*args, **kwargs) def GetSubImage(*args, **kwargs): - """GetSubImage(self, Rect rect) -> Image""" + """ + GetSubImage(self, Rect rect) -> Image + + Returns a sub image of the current one as long as the rect belongs + entirely to the image. + """ return _core_.Image_GetSubImage(*args, **kwargs) def Size(*args, **kwargs): - """Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image""" + """ + Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image + + Returns a resized version of this image without scaling it by adding + either a border with the given colour or cropping as necessary. The + image is pasted into a new image with the given size and background + colour at the position ``pos`` relative to the upper left of the new + image. If red = green = blue = -1 then use either the current mask + colour if set or find, use, and set a suitable mask colour for any + newly exposed areas. + """ return _core_.Image_Size(*args, **kwargs) def Copy(*args, **kwargs): - """Copy(self) -> Image""" + """ + Copy(self) -> Image + + Returns an identical copy of the image. + """ return _core_.Image_Copy(*args, **kwargs) def Paste(*args, **kwargs): - """Paste(self, Image image, int x, int y)""" + """ + Paste(self, Image image, int x, int y) + + Pastes ``image`` into this instance and takes care of the mask colour + and any out of bounds problems. + """ return _core_.Image_Paste(*args, **kwargs) def GetData(*args, **kwargs): @@ -2397,7 +2606,8 @@ class Image(Object): GetDataBuffer(self) -> PyObject Returns a writable Python buffer object that is pointing at the RGB - image data buffer inside the wx.Image. + image data buffer inside the wx.Image. You need to ensure that you do + not use this buffer object after the image has been destroyed. """ return _core_.Image_GetDataBuffer(*args, **kwargs) @@ -2406,8 +2616,8 @@ class Image(Object): SetDataBuffer(self, buffer data) Sets the internal image data pointer to point at a Python buffer - object. This can save a copy of the data but you must ensure that the - buffer object lives longer than the wx.Image does. + object. This can save making an extra copy of the data but you must + ensure that the buffer object lives longer than the wx.Image does. """ return _core_.Image_SetDataBuffer(*args, **kwargs) @@ -2438,7 +2648,12 @@ class Image(Object): return _core_.Image_SetAlphaBuffer(*args, **kwargs) def SetMaskColour(*args, **kwargs): - """SetMaskColour(self, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetMaskColour(self, byte r, byte g, byte b) + + Sets the mask colour for this image (and tells the image to use the + mask). + """ return _core_.Image_SetMaskColour(*args, **kwargs) def GetOrFindMaskColour(*args, **kwargs): @@ -2450,69 +2665,139 @@ class Image(Object): return _core_.Image_GetOrFindMaskColour(*args, **kwargs) def GetMaskRed(*args, **kwargs): - """GetMaskRed(self) -> unsigned char""" + """ + GetMaskRed(self) -> byte + + Gets the red component of the mask colour. + """ return _core_.Image_GetMaskRed(*args, **kwargs) def GetMaskGreen(*args, **kwargs): - """GetMaskGreen(self) -> unsigned char""" + """ + GetMaskGreen(self) -> byte + + Gets the green component of the mask colour. + """ return _core_.Image_GetMaskGreen(*args, **kwargs) def GetMaskBlue(*args, **kwargs): - """GetMaskBlue(self) -> unsigned char""" + """ + GetMaskBlue(self) -> byte + + Gets the blue component of the mask colour. + """ return _core_.Image_GetMaskBlue(*args, **kwargs) def SetMask(*args, **kwargs): - """SetMask(self, bool mask=True)""" + """ + SetMask(self, bool mask=True) + + Specifies whether there is a mask or not. The area of the mask is + determined by the current mask colour. + """ return _core_.Image_SetMask(*args, **kwargs) def HasMask(*args, **kwargs): - """HasMask(self) -> bool""" + """ + HasMask(self) -> bool + + Returns ``True`` if there is a mask active, ``False`` otherwise. + """ return _core_.Image_HasMask(*args, **kwargs) def Rotate(*args, **kwargs): """ Rotate(self, double angle, Point centre_of_rotation, bool interpolating=True, Point offset_after_rotation=None) -> Image + + Rotates the image about the given point, by ``angle`` radians. Passing + ``True`` to ``interpolating`` results in better image quality, but is + slower. If the image has a mask, then the mask colour is used for the + uncovered pixels in the rotated image background. Otherwise, black + will be used as the fill colour. + + Returns the rotated image, leaving this image intact. """ return _core_.Image_Rotate(*args, **kwargs) def Rotate90(*args, **kwargs): - """Rotate90(self, bool clockwise=True) -> Image""" + """ + Rotate90(self, bool clockwise=True) -> Image + + Returns a copy of the image rotated 90 degrees in the direction + indicated by ``clockwise``. + """ return _core_.Image_Rotate90(*args, **kwargs) def Mirror(*args, **kwargs): - """Mirror(self, bool horizontally=True) -> Image""" + """ + Mirror(self, bool horizontally=True) -> Image + + Returns a mirrored copy of the image. The parameter ``horizontally`` + indicates the orientation. + """ return _core_.Image_Mirror(*args, **kwargs) def Replace(*args, **kwargs): """ - Replace(self, unsigned char r1, unsigned char g1, unsigned char b1, - unsigned char r2, unsigned char g2, unsigned char b2) + Replace(self, byte r1, byte g1, byte b1, byte r2, byte g2, byte b2) + + Replaces the colour specified by ``(r1,g1,b1)`` by the colour + ``(r2,g2,b2)``. """ return _core_.Image_Replace(*args, **kwargs) def ConvertToMono(*args, **kwargs): - """ConvertToMono(self, unsigned char r, unsigned char g, unsigned char b) -> Image""" + """ + ConvertToMono(self, byte r, byte g, byte b) -> Image + + Returns monochromatic version of the image. The returned image has + white colour where the original has ``(r,g,b)`` colour and black + colour everywhere else. + """ return _core_.Image_ConvertToMono(*args, **kwargs) def SetOption(*args, **kwargs): - """SetOption(self, String name, String value)""" + """ + SetOption(self, String name, String value) + + Sets an image handler defined option. For example, when saving as a + JPEG file, the option ``wx.IMAGE_OPTION_QUALITY`` is used, which is a + number between 0 and 100 (0 is terrible, 100 is very good). + """ return _core_.Image_SetOption(*args, **kwargs) def SetOptionInt(*args, **kwargs): - """SetOptionInt(self, String name, int value)""" + """ + SetOptionInt(self, String name, int value) + + Sets an image option as an integer. + """ return _core_.Image_SetOptionInt(*args, **kwargs) def GetOption(*args, **kwargs): - """GetOption(self, String name) -> String""" + """ + GetOption(self, String name) -> String + + Gets the value of an image handler option. + """ return _core_.Image_GetOption(*args, **kwargs) def GetOptionInt(*args, **kwargs): - """GetOptionInt(self, String name) -> int""" + """ + GetOptionInt(self, String name) -> int + + Gets the value of an image handler option as an integer. If the given + option is not present, the function returns 0. + """ return _core_.Image_GetOptionInt(*args, **kwargs) def HasOption(*args, **kwargs): - """HasOption(self, String name) -> bool""" + """ + HasOption(self, String name) -> bool + + Returns true if the given option is present. + """ return _core_.Image_HasOption(*args, **kwargs) def CountColours(*args, **kwargs): @@ -2539,7 +2824,13 @@ class Image(Object): RemoveHandler = staticmethod(RemoveHandler) def GetImageExtWildcard(*args, **kwargs): - """GetImageExtWildcard() -> String""" + """ + GetImageExtWildcard() -> String + + Iterates all registered wxImageHandler objects, and returns a string + containing file extension masks suitable for passing to file open/save + dialog boxes. + """ return _core_.Image_GetImageExtWildcard(*args, **kwargs) GetImageExtWildcard = staticmethod(GetImageExtWildcard) @@ -2548,7 +2839,7 @@ class Image(Object): return _core_.Image_ConvertToBitmap(*args, **kwargs) def ConvertToMonoBitmap(*args, **kwargs): - """ConvertToMonoBitmap(self, unsigned char red, unsigned char green, unsigned char blue) -> Bitmap""" + """ConvertToMonoBitmap(self, byte red, byte green, byte blue) -> Bitmap""" return _core_.Image_ConvertToMonoBitmap(*args, **kwargs) def __nonzero__(self): return self.Ok() @@ -2561,19 +2852,34 @@ class ImagePtr(Image): _core_.Image_swigregister(ImagePtr) def ImageFromMime(*args, **kwargs): - """ImageFromMime(String name, String mimetype, int index=-1) -> Image""" + """ + ImageFromMime(String name, String mimetype, int index=-1) -> Image + + Loads an image from a file, using a MIME type string (such as + 'image/jpeg') to specify image type. + """ val = _core_.new_ImageFromMime(*args, **kwargs) val.thisown = 1 return val def ImageFromStream(*args, **kwargs): - """ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image""" + """ + ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image + + Loads an image from an input stream, or any readable Python file-like + object. + """ val = _core_.new_ImageFromStream(*args, **kwargs) val.thisown = 1 return val def ImageFromStreamMime(*args, **kwargs): - """ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image""" + """ + ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image + + Loads an image from an input stream, or any readable Python file-like + object, specifying the image format with a MIME type string. + """ val = _core_.new_ImageFromStreamMime(*args, **kwargs) val.thisown = 1 return val @@ -2617,22 +2923,39 @@ def ImageFromDataWithAlpha(*args, **kwargs): Construct an Image from a buffer of RGB bytes with an Alpha channel. Accepts either a string or a buffer object holding the data and the - length of the data must be width*height*3. + length of the data must be width*height*3 bytes, and the length of the + alpha data must be width*height bytes. """ val = _core_.new_ImageFromDataWithAlpha(*args, **kwargs) val.thisown = 1 return val def Image_CanRead(*args, **kwargs): - """Image_CanRead(String name) -> bool""" + """ + Image_CanRead(String filename) -> bool + + Returns True if the image handlers can read this file. + """ return _core_.Image_CanRead(*args, **kwargs) def Image_GetImageCount(*args, **kwargs): - """Image_GetImageCount(String name, long type=BITMAP_TYPE_ANY) -> int""" + """ + Image_GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int + + If the image file contains more than one image and the image handler + is capable of retrieving these individually, this function will return + the number of available images. + """ return _core_.Image_GetImageCount(*args, **kwargs) def Image_CanReadStream(*args, **kwargs): - """Image_CanReadStream(InputStream stream) -> bool""" + """ + Image_CanReadStream(InputStream stream) -> bool + + Returns True if the image handlers can read an image file from the + data currently on the input stream, or a readable Python file-like + object. + """ return _core_.Image_CanReadStream(*args, **kwargs) def Image_AddHandler(*args, **kwargs): @@ -2648,7 +2971,13 @@ def Image_RemoveHandler(*args, **kwargs): return _core_.Image_RemoveHandler(*args, **kwargs) def Image_GetImageExtWildcard(*args, **kwargs): - """Image_GetImageExtWildcard() -> String""" + """ + Image_GetImageExtWildcard() -> String + + Iterates all registered wxImageHandler objects, and returns a string + containing file extension masks suitable for passing to file open/save + dialog boxes. + """ return _core_.Image_GetImageExtWildcard(*args, **kwargs) def InitAllImageHandlers(): diff --git a/wxPython/src/mac/_core_wrap.cpp b/wxPython/src/mac/_core_wrap.cpp index 07210d1c61..e929a8682c 100644 --- a/wxPython/src/mac/_core_wrap.cpp +++ b/wxPython/src/mac/_core_wrap.cpp @@ -2328,7 +2328,7 @@ static unsigned long wxImageHistogram_GetCount(wxImageHistogram *self,unsigned l wxImageHistogramEntry e = (*self)[key]; return e.value; } -static unsigned long wxImageHistogram_GetCountRGB(wxImageHistogram *self,unsigned char r,unsigned char g,unsigned char b){ +static unsigned long wxImageHistogram_GetCountRGB(wxImageHistogram *self,byte r,byte g,byte b){ unsigned long key = wxImageHistogram::MakeKey(r, g, b); wxImageHistogramEntry e = (*self)[key]; return e.value; @@ -2476,7 +2476,7 @@ static wxBitmap wxImage_ConvertToBitmap(wxImage *self,int depth=-1){ wxBitmap bitmap(*self, depth); return bitmap; } -static wxBitmap wxImage_ConvertToMonoBitmap(wxImage *self,unsigned char red,unsigned char green,unsigned char blue){ +static wxBitmap wxImage_ConvertToMonoBitmap(wxImage *self,byte red,byte green,byte blue){ wxImage mono = self->ConvertToMono( red, green, blue ); wxBitmap bitmap( mono, 1 ); return bitmap; @@ -10243,9 +10243,9 @@ static PyObject *_wrap_new_ImageHistogram(PyObject *, PyObject *args, PyObject * static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; - unsigned char arg1 ; - unsigned char arg2 ; - unsigned char arg3 ; + byte arg1 ; + byte arg2 ; + byte arg3 ; unsigned long result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10256,15 +10256,15 @@ static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObje if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO:ImageHistogram_MakeKey",kwnames,&obj0,&obj1,&obj2)) goto fail; { - arg1 = (unsigned char)(SWIG_As_unsigned_SS_char(obj0)); + arg1 = (byte)(SWIG_As_unsigned_SS_char(obj0)); if (SWIG_arg_fail(1)) SWIG_fail; } { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { @@ -10286,18 +10286,18 @@ static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObje static PyObject *_wrap_ImageHistogram_FindFirstUnusedColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImageHistogram *arg1 = (wxImageHistogram *) 0 ; - unsigned char *arg2 = (unsigned char *) 0 ; - unsigned char *arg3 = (unsigned char *) 0 ; - unsigned char *arg4 = (unsigned char *) 0 ; - unsigned char arg5 = (unsigned char) 1 ; - unsigned char arg6 = (unsigned char) 0 ; - unsigned char arg7 = (unsigned char) 0 ; + byte *arg2 = (byte *) 0 ; + byte *arg3 = (byte *) 0 ; + byte *arg4 = (byte *) 0 ; + byte arg5 = (byte) 1 ; + byte arg6 = (byte) 0 ; + byte arg7 = (byte) 0 ; bool result; - unsigned char temp2 ; + byte temp2 ; int res2 = 0 ; - unsigned char temp3 ; + byte temp3 ; int res3 = 0 ; - unsigned char temp4 ; + byte temp4 ; int res4 = 0 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10315,19 +10315,19 @@ static PyObject *_wrap_ImageHistogram_FindFirstUnusedColour(PyObject *, PyObject if (SWIG_arg_fail(1)) SWIG_fail; if (obj1) { { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(5)) SWIG_fail; } } if (obj2) { { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(6)) SWIG_fail; } } if (obj3) { { - arg7 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg7 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(7)) SWIG_fail; } } @@ -10390,9 +10390,9 @@ static PyObject *_wrap_ImageHistogram_GetCount(PyObject *, PyObject *args, PyObj static PyObject *_wrap_ImageHistogram_GetCountRGB(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImageHistogram *arg1 = (wxImageHistogram *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; unsigned long result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10406,15 +10406,15 @@ static PyObject *_wrap_ImageHistogram_GetCountRGB(PyObject *, PyObject *args, Py SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImageHistogram, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -10918,14 +10918,16 @@ static PyObject *_wrap_Image_Create(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; + bool arg4 = (bool) true ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; + PyObject * obj3 = 0 ; char *kwnames[] = { - (char *) "self",(char *) "width",(char *) "height", NULL + (char *) "self",(char *) "width",(char *) "height",(char *) "clear", NULL }; - if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO:Image_Create",kwnames,&obj0,&obj1,&obj2)) goto fail; + if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO|O:Image_Create",kwnames,&obj0,&obj1,&obj2,&obj3)) goto fail; SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { @@ -10936,9 +10938,15 @@ static PyObject *_wrap_Image_Create(PyObject *, PyObject *args, PyObject *kwargs arg3 = (int)(SWIG_As_int(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } + if (obj3) { + { + arg4 = (bool)(SWIG_As_bool(obj3)); + if (SWIG_arg_fail(4)) SWIG_fail; + } + } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - (arg1)->Create(arg2,arg3); + (arg1)->Create(arg2,arg3,arg4); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11172,9 +11180,9 @@ static PyObject *_wrap_Image_SetRGB(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; - unsigned char arg6 ; + byte arg4 ; + byte arg5 ; + byte arg6 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11197,15 +11205,15 @@ static PyObject *_wrap_Image_SetRGB(PyObject *, PyObject *args, PyObject *kwargs if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj5)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj5)); if (SWIG_arg_fail(6)) SWIG_fail; } { @@ -11226,9 +11234,9 @@ static PyObject *_wrap_Image_SetRGBRect(PyObject *, PyObject *args, PyObject *kw PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; wxRect *arg2 = 0 ; - unsigned char arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; + byte arg3 ; + byte arg4 ; + byte arg5 ; wxRect temp2 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11247,15 +11255,15 @@ static PyObject *_wrap_Image_SetRGBRect(PyObject *, PyObject *args, PyObject *kw if ( ! wxRect_helper(obj1, &arg2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { @@ -11277,7 +11285,7 @@ static PyObject *_wrap_Image_GetRed(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11298,7 +11306,7 @@ static PyObject *_wrap_Image_GetRed(PyObject *, PyObject *args, PyObject *kwargs } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetRed(arg2,arg3); + result = (byte)(arg1)->GetRed(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11317,7 +11325,7 @@ static PyObject *_wrap_Image_GetGreen(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11338,7 +11346,7 @@ static PyObject *_wrap_Image_GetGreen(PyObject *, PyObject *args, PyObject *kwar } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetGreen(arg2,arg3); + result = (byte)(arg1)->GetGreen(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11357,7 +11365,7 @@ static PyObject *_wrap_Image_GetBlue(PyObject *, PyObject *args, PyObject *kwarg wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11378,7 +11386,7 @@ static PyObject *_wrap_Image_GetBlue(PyObject *, PyObject *args, PyObject *kwarg } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetBlue(arg2,arg3); + result = (byte)(arg1)->GetBlue(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11397,7 +11405,7 @@ static PyObject *_wrap_Image_SetAlpha(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 ; + byte arg4 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11418,7 +11426,7 @@ static PyObject *_wrap_Image_SetAlpha(PyObject *, PyObject *args, PyObject *kwar if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -11440,7 +11448,7 @@ static PyObject *_wrap_Image_GetAlpha(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11461,7 +11469,7 @@ static PyObject *_wrap_Image_GetAlpha(PyObject *, PyObject *args, PyObject *kwar } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetAlpha(arg2,arg3); + result = (byte)(arg1)->GetAlpha(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11533,7 +11541,7 @@ static PyObject *_wrap_Image_IsTransparent(PyObject *, PyObject *args, PyObject wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 = (unsigned char) wxIMAGE_ALPHA_THRESHOLD ; + byte arg4 = (byte) wxIMAGE_ALPHA_THRESHOLD ; bool result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11556,7 +11564,7 @@ static PyObject *_wrap_Image_IsTransparent(PyObject *, PyObject *args, PyObject } if (obj3) { { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } } @@ -11685,9 +11693,9 @@ static PyObject *_wrap_Image_ConvertAlphaToMask(PyObject *, PyObject *args, PyOb static PyObject *_wrap_Image_ConvertColourToAlpha(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; bool result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11701,15 +11709,15 @@ static PyObject *_wrap_Image_ConvertColourToAlpha(PyObject *, PyObject *args, Py SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -11791,7 +11799,7 @@ static PyObject *_wrap_Image_CanRead(PyObject *, PyObject *args, PyObject *kwarg bool temp1 = false ; PyObject * obj0 = 0 ; char *kwnames[] = { - (char *) "name", NULL + (char *) "filename", NULL }; if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"O:Image_CanRead",kwnames,&obj0)) goto fail; @@ -11833,7 +11841,7 @@ static PyObject *_wrap_Image_GetImageCount(PyObject *, PyObject *args, PyObject PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; char *kwnames[] = { - (char *) "name",(char *) "type", NULL + (char *) "filename",(char *) "type", NULL }; if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"O|O:Image_GetImageCount",kwnames,&obj0,&obj1)) goto fail; @@ -12829,9 +12837,9 @@ static PyObject *_wrap_Image_SetAlphaBuffer(PyObject *, PyObject *args, PyObject static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -12844,15 +12852,15 @@ static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -12872,14 +12880,14 @@ static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject static PyObject *_wrap_Image_GetOrFindMaskColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char *arg2 = (unsigned char *) 0 ; - unsigned char *arg3 = (unsigned char *) 0 ; - unsigned char *arg4 = (unsigned char *) 0 ; - unsigned char temp2 ; + byte *arg2 = (byte *) 0 ; + byte *arg3 = (byte *) 0 ; + byte *arg4 = (byte *) 0 ; + byte temp2 ; int res2 = 0 ; - unsigned char temp3 ; + byte temp3 ; int res3 = 0 ; - unsigned char temp4 ; + byte temp4 ; int res4 = 0 ; PyObject * obj0 = 0 ; char *kwnames[] = { @@ -12915,7 +12923,7 @@ static PyObject *_wrap_Image_GetOrFindMaskColour(PyObject *, PyObject *args, PyO static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12926,7 +12934,7 @@ static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kw if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskRed(); + result = (byte)(arg1)->GetMaskRed(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -12943,7 +12951,7 @@ static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kw static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12954,7 +12962,7 @@ static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject * if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskGreen(); + result = (byte)(arg1)->GetMaskGreen(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -12971,7 +12979,7 @@ static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject * static PyObject *_wrap_Image_GetMaskBlue(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12982,7 +12990,7 @@ static PyObject *_wrap_Image_GetMaskBlue(PyObject *, PyObject *args, PyObject *k if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskBlue(); + result = (byte)(arg1)->GetMaskBlue(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -13193,12 +13201,12 @@ static PyObject *_wrap_Image_Mirror(PyObject *, PyObject *args, PyObject *kwargs static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; - unsigned char arg6 ; - unsigned char arg7 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; + byte arg5 ; + byte arg6 ; + byte arg7 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -13214,27 +13222,27 @@ static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwarg SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj5)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj5)); if (SWIG_arg_fail(6)) SWIG_fail; } { - arg7 = (unsigned char)(SWIG_As_unsigned_SS_char(obj6)); + arg7 = (byte)(SWIG_As_unsigned_SS_char(obj6)); if (SWIG_arg_fail(7)) SWIG_fail; } { @@ -13254,9 +13262,9 @@ static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwarg static PyObject *_wrap_Image_ConvertToMono(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; SwigValueWrapper result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -13270,15 +13278,15 @@ static PyObject *_wrap_Image_ConvertToMono(PyObject *, PyObject *args, PyObject SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -13773,9 +13781,9 @@ static PyObject *_wrap_Image_ConvertToBitmap(PyObject *, PyObject *args, PyObjec static PyObject *_wrap_Image_ConvertToMonoBitmap(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; wxBitmap result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -13789,15 +13797,15 @@ static PyObject *_wrap_Image_ConvertToMonoBitmap(PyObject *, PyObject *args, PyO SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -31966,7 +31974,7 @@ static PyObject *_wrap_Window_GetSizer(PyObject *, PyObject *args, PyObject *kwa if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -32023,7 +32031,7 @@ static PyObject *_wrap_Window_GetContainingSizer(PyObject *, PyObject *args, PyO if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -35446,7 +35454,7 @@ static PyObject *_wrap_MenuBar_FindMenu(PyObject *, PyObject *args, PyObject *kw } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (int)((wxMenuBar const *)arg1)->FindMenu((wxString const &)*arg2); + result = (int)(arg1)->FindMenu((wxString const &)*arg2); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -39300,7 +39308,7 @@ static PyObject *_wrap_SizerItem_GetSizer(PyObject *, PyObject *args, PyObject * if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -47218,7 +47226,7 @@ static swig_type_info _swigt__unsigned_int[] = {{"_unsigned_int", 0, "unsigned i static swig_type_info _swigt__p_unsigned_int[] = {{"_p_unsigned_int", 0, "unsigned int *|time_t *", 0, 0, 0, 0},{"_p_unsigned_int", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxMenuEvent[] = {{"_p_wxMenuEvent", 0, "wxMenuEvent *", 0, 0, 0, 0},{"_p_wxMenuEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxContextMenuEvent[] = {{"_p_wxContextMenuEvent", 0, "wxContextMenuEvent *", 0, 0, 0, 0},{"_p_wxContextMenuEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; -static swig_type_info _swigt__p_unsigned_char[] = {{"_p_unsigned_char", 0, "unsigned char *", 0, 0, 0, 0},{"_p_unsigned_char", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; +static swig_type_info _swigt__p_unsigned_char[] = {{"_p_unsigned_char", 0, "unsigned char *|byte *", 0, 0, 0, 0},{"_p_unsigned_char", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxEraseEvent[] = {{"_p_wxEraseEvent", 0, "wxEraseEvent *", 0, 0, 0, 0},{"_p_wxEraseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxMouseEvent[] = {{"_p_wxMouseEvent", 0, "wxMouseEvent *", 0, 0, 0, 0},{"_p_wxMouseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxCloseEvent[] = {{"_p_wxCloseEvent", 0, "wxCloseEvent *", 0, 0, 0, 0},{"_p_wxCloseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; diff --git a/wxPython/src/mac/_windows_wrap.cpp b/wxPython/src/mac/_windows_wrap.cpp index 37e22b4833..2a59c9cf32 100644 --- a/wxPython/src/mac/_windows_wrap.cpp +++ b/wxPython/src/mac/_windows_wrap.cpp @@ -5925,7 +5925,7 @@ static PyObject *_wrap_Dialog_CreateTextSizer(PyObject *, PyObject *args, PyObje if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } { if (temp2) @@ -5967,7 +5967,7 @@ static PyObject *_wrap_Dialog_CreateButtonSizer(PyObject *, PyObject *args, PyOb if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: diff --git a/wxPython/src/mac/wizard_wrap.cpp b/wxPython/src/mac/wizard_wrap.cpp index df538ba99e..9f42c1d03b 100644 --- a/wxPython/src/mac/wizard_wrap.cpp +++ b/wxPython/src/mac/wizard_wrap.cpp @@ -3351,7 +3351,7 @@ static PyObject *_wrap_Wizard_GetPageAreaSizer(PyObject *, PyObject *args, PyObj if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: diff --git a/wxPython/src/msw/_controls.py b/wxPython/src/msw/_controls.py index 09182f4955..3f4894b850 100644 --- a/wxPython/src/msw/_controls.py +++ b/wxPython/src/msw/_controls.py @@ -1504,19 +1504,11 @@ class CheckListBox(ListBox): return _controls_.CheckListBox_GetItemHeight(*args, **kwargs) def HitTest(*args, **kwargs): - """ - HitTest(self, Point pt) -> int - - Test where the given (in client coords) point lies - """ + """HitTest(self, Point pt) -> int""" return _controls_.CheckListBox_HitTest(*args, **kwargs) def HitTestXY(*args, **kwargs): - """ - HitTestXY(self, int x, int y) -> int - - Test where the given (in client coords) point lies - """ + """HitTestXY(self, int x, int y) -> int""" return _controls_.CheckListBox_HitTestXY(*args, **kwargs) @@ -3073,7 +3065,12 @@ class BookCtrlBaseEvent(_core.NotifyEvent): self.thisown = 1 del newobj.thisown def GetSelection(*args, **kwargs): - """GetSelection(self) -> int""" + """ + GetSelection(self) -> int + + Returns item index for a listbox or choice selection event (not valid + for a deselection). + """ return _controls_.BookCtrlBaseEvent_GetSelection(*args, **kwargs) def SetSelection(*args, **kwargs): diff --git a/wxPython/src/msw/_core.py b/wxPython/src/msw/_core.py index 43dc9907c4..347487449e 100644 --- a/wxPython/src/msw/_core.py +++ b/wxPython/src/msw/_core.py @@ -2107,7 +2107,7 @@ class ImageHistogram(object): del newobj.thisown def MakeKey(*args, **kwargs): """ - MakeKey(unsigned char r, unsigned char g, unsigned char b) -> unsigned long + MakeKey(byte r, byte g, byte b) -> unsigned long Get the key in the histogram for the given RGB values """ @@ -2135,7 +2135,7 @@ class ImageHistogram(object): def GetCountRGB(*args, **kwargs): """ - GetCountRGB(self, unsigned char r, unsigned char g, unsigned char b) -> unsigned long + GetCountRGB(self, byte r, byte g, byte b) -> unsigned long Returns the pixel count for the given RGB values. """ @@ -2159,18 +2159,47 @@ _core_.ImageHistogram_swigregister(ImageHistogramPtr) def ImageHistogram_MakeKey(*args, **kwargs): """ - ImageHistogram_MakeKey(unsigned char r, unsigned char g, unsigned char b) -> unsigned long + ImageHistogram_MakeKey(byte r, byte g, byte b) -> unsigned long Get the key in the histogram for the given RGB values """ return _core_.ImageHistogram_MakeKey(*args, **kwargs) class Image(Object): - """Proxy of C++ Image class""" + """ + A platform-independent image class. An image can be created from + data, or using `wx.Bitmap.ConvertToImage`, or loaded from a file in a + variety of formats. Functions are available to set and get image + bits, so it can be used for basic image manipulation. + + A wx.Image cannot be drawn directly to a `wx.DC`. Instead, a + platform-specific `wx.Bitmap` object must be created from it using the + `wx.BitmapFromImage` constructor. This bitmap can then be drawn in a + device context, using `wx.DC.DrawBitmap`. + + One colour value of the image may be used as a mask colour which will + lead to the automatic creation of a `wx.Mask` object associated to the + bitmap object. + + wx.Image supports alpha channel data, that is in addition to a byte + for the red, green and blue colour components for each pixel it also + stores a byte representing the pixel opacity. An alpha value of 0 + corresponds to a transparent pixel (null opacity) while a value of 255 + means that the pixel is 100% opaque. + + Unlike RGB data, not all images have an alpha channel and before using + `GetAlpha` you should check if this image contains an alpha channel + with `HasAlpha`. Note that currently only images loaded from PNG files + with transparency information will have an alpha channel. + """ def __repr__(self): return "<%s.%s; proxy of C++ wxImage instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,) def __init__(self, *args, **kwargs): - """__init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image""" + """ + __init__(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> Image + + Loads an image from a file. + """ newobj = _core_.new_Image(*args, **kwargs) self.this = newobj.this self.thisown = 1 @@ -2182,63 +2211,143 @@ class Image(Object): except: pass def Create(*args, **kwargs): - """Create(self, int width, int height)""" + """ + Create(self, int width, int height, bool clear=True) + + Creates a fresh image. If clear is ``True``, the new image will be + initialized to black. Otherwise, the image data will be uninitialized. + """ return _core_.Image_Create(*args, **kwargs) def Destroy(*args, **kwargs): """ Destroy(self) - Deletes the C++ object this Python object is a proxy for. + Destroys the image data. """ return _core_.Image_Destroy(*args, **kwargs) def Scale(*args, **kwargs): - """Scale(self, int width, int height) -> Image""" + """ + Scale(self, int width, int height) -> Image + + Returns a scaled version of the image. This is also useful for scaling + bitmaps in general as the only other way to scale bitmaps is to blit a + `wx.MemoryDC` into another `wx.MemoryDC`. + """ return _core_.Image_Scale(*args, **kwargs) def ShrinkBy(*args, **kwargs): - """ShrinkBy(self, int xFactor, int yFactor) -> Image""" + """ + ShrinkBy(self, int xFactor, int yFactor) -> Image + + Return a version of the image scaled smaller by the given factors. + """ return _core_.Image_ShrinkBy(*args, **kwargs) def Rescale(*args, **kwargs): - """Rescale(self, int width, int height) -> Image""" + """ + Rescale(self, int width, int height) -> Image + + Changes the size of the image in-place by scaling it: after a call to + this function, the image will have the given width and height. + + Returns the (modified) image itself. + """ return _core_.Image_Rescale(*args, **kwargs) def Resize(*args, **kwargs): - """Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image""" + """ + Resize(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image + + Changes the size of the image in-place without scaling it, by adding + either a border with the given colour or cropping as necessary. The + image is pasted into a new image with the given size and background + colour at the position pos relative to the upper left of the new + image. If red = green = blue = -1 then use either the current mask + colour if set or find, use, and set a suitable mask colour for any + newly exposed areas. + + Returns the (modified) image itself. + """ return _core_.Image_Resize(*args, **kwargs) def SetRGB(*args, **kwargs): - """SetRGB(self, int x, int y, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetRGB(self, int x, int y, byte r, byte g, byte b) + + Sets the pixel at the given coordinate. This routine performs + bounds-checks for the coordinate so it can be considered a safe way to + manipulate the data, but in some cases this might be too slow so that + the data will have to be set directly. In that case you will have to + get access to the image data using the `GetData` method. + """ return _core_.Image_SetRGB(*args, **kwargs) def SetRGBRect(*args, **kwargs): - """SetRGBRect(self, Rect rect, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetRGBRect(self, Rect rect, byte r, byte g, byte b) + + Sets the colour of the pixels within the given rectangle. This routine + performs bounds-checks for the rectangle so it can be considered a + safe way to manipulate the data. + """ return _core_.Image_SetRGBRect(*args, **kwargs) def GetRed(*args, **kwargs): - """GetRed(self, int x, int y) -> unsigned char""" + """ + GetRed(self, int x, int y) -> byte + + Returns the red intensity at the given coordinate. + """ return _core_.Image_GetRed(*args, **kwargs) def GetGreen(*args, **kwargs): - """GetGreen(self, int x, int y) -> unsigned char""" + """ + GetGreen(self, int x, int y) -> byte + + Returns the green intensity at the given coordinate. + """ return _core_.Image_GetGreen(*args, **kwargs) def GetBlue(*args, **kwargs): - """GetBlue(self, int x, int y) -> unsigned char""" + """ + GetBlue(self, int x, int y) -> byte + + Returns the blue intensity at the given coordinate. + """ return _core_.Image_GetBlue(*args, **kwargs) def SetAlpha(*args, **kwargs): - """SetAlpha(self, int x, int y, unsigned char alpha)""" + """ + SetAlpha(self, int x, int y, byte alpha) + + Sets the alpha value for the given pixel. This function should only be + called if the image has alpha channel data, use `HasAlpha` to check + for this. + """ return _core_.Image_SetAlpha(*args, **kwargs) def GetAlpha(*args, **kwargs): - """GetAlpha(self, int x, int y) -> unsigned char""" + """ + GetAlpha(self, int x, int y) -> byte + + Returns the alpha value for the given pixel. This function may only be + called for the images with alpha channel, use `HasAlpha` to check for + this. + + The returned value is the *opacity* of the image, i.e. the value of 0 + corresponds to the fully transparent pixels while the value of 255 to + the fully opaque pixels. + """ return _core_.Image_GetAlpha(*args, **kwargs) def HasAlpha(*args, **kwargs): - """HasAlpha(self) -> bool""" + """ + HasAlpha(self) -> bool + + Returns true if this image has alpha channel, false otherwise. + """ return _core_.Image_HasAlpha(*args, **kwargs) def InitAlpha(*args, **kwargs): @@ -2254,10 +2363,10 @@ class Image(Object): def IsTransparent(*args, **kwargs): """ - IsTransparent(self, int x, int y, unsigned char threshold=IMAGE_ALPHA_THRESHOLD) -> bool + IsTransparent(self, int x, int y, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool - Returns True if this pixel is masked or has an alpha value less than - the spcified threshold. + Returns ``True`` if this pixel is masked or has an alpha value less + than the spcified threshold. """ return _core_.Image_IsTransparent(*args, **kwargs) @@ -2275,10 +2384,10 @@ class Image(Object): """ ConvertAlphaToMask(self, byte threshold=IMAGE_ALPHA_THRESHOLD) -> bool - If the image has alpha channel, this method converts it to mask. All pixels - with alpha value less than ``threshold`` are replaced with mask colour and the - alpha channel is removed. Mask colour is chosen automatically using - `FindFirstUnusedColour`. + If the image has alpha channel, this method converts it to mask. All + pixels with alpha value less than ``threshold`` are replaced with the + mask colour and the alpha channel is removed. The mask colour is + chosen automatically using `FindFirstUnusedColour`. If the image image doesn't have alpha channel, ConvertAlphaToMask does nothing. @@ -2287,7 +2396,7 @@ class Image(Object): def ConvertColourToAlpha(*args, **kwargs): """ - ConvertColourToAlpha(self, unsigned char r, unsigned char g, unsigned char b) -> bool + ConvertColourToAlpha(self, byte r, byte g, byte b) -> bool This method converts an image where the original alpha information is only available as a shades of a colour (actually shades of grey) @@ -2300,78 +2409,178 @@ class Image(Object): return _core_.Image_ConvertColourToAlpha(*args, **kwargs) def SetMaskFromImage(*args, **kwargs): - """SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool""" + """ + SetMaskFromImage(self, Image mask, byte mr, byte mg, byte mb) -> bool + + Sets the image's mask so that the pixels that have RGB value of + ``(mr,mg,mb)`` in ``mask`` will be masked in this image. This is done + by first finding an unused colour in the image, setting this colour as + the mask colour and then using this colour to draw all pixels in the + image who corresponding pixel in mask has given RGB value. + + Returns ``False`` if ``mask`` does not have same dimensions as the + image or if there is no unused colour left. Returns ``True`` if the + mask was successfully applied. + + Note that this method involves computing the histogram, which is + computationally intensive operation. + """ return _core_.Image_SetMaskFromImage(*args, **kwargs) def CanRead(*args, **kwargs): - """CanRead(String name) -> bool""" + """ + CanRead(String filename) -> bool + + Returns True if the image handlers can read this file. + """ return _core_.Image_CanRead(*args, **kwargs) CanRead = staticmethod(CanRead) def GetImageCount(*args, **kwargs): - """GetImageCount(String name, long type=BITMAP_TYPE_ANY) -> int""" + """ + GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int + + If the image file contains more than one image and the image handler + is capable of retrieving these individually, this function will return + the number of available images. + """ return _core_.Image_GetImageCount(*args, **kwargs) GetImageCount = staticmethod(GetImageCount) def LoadFile(*args, **kwargs): - """LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool""" + """ + LoadFile(self, String name, long type=BITMAP_TYPE_ANY, int index=-1) -> bool + + Loads an image from a file. If no handler type is provided, the + library will try to autodetect the format. + """ return _core_.Image_LoadFile(*args, **kwargs) def LoadMimeFile(*args, **kwargs): - """LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool""" + """ + LoadMimeFile(self, String name, String mimetype, int index=-1) -> bool + + Loads an image from a file, specifying the image type with a MIME type + string. + """ return _core_.Image_LoadMimeFile(*args, **kwargs) def SaveFile(*args, **kwargs): - """SaveFile(self, String name, int type) -> bool""" + """ + SaveFile(self, String name, int type) -> bool + + Saves an image in the named file. + """ return _core_.Image_SaveFile(*args, **kwargs) def SaveMimeFile(*args, **kwargs): - """SaveMimeFile(self, String name, String mimetype) -> bool""" + """ + SaveMimeFile(self, String name, String mimetype) -> bool + + Saves an image in the named file. + """ return _core_.Image_SaveMimeFile(*args, **kwargs) def CanReadStream(*args, **kwargs): - """CanReadStream(InputStream stream) -> bool""" + """ + CanReadStream(InputStream stream) -> bool + + Returns True if the image handlers can read an image file from the + data currently on the input stream, or a readable Python file-like + object. + """ return _core_.Image_CanReadStream(*args, **kwargs) CanReadStream = staticmethod(CanReadStream) def LoadStream(*args, **kwargs): - """LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool""" + """ + LoadStream(self, InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> bool + + Loads an image from an input stream or a readable Python file-like + object. If no handler type is provided, the library will try to + autodetect the format. + """ return _core_.Image_LoadStream(*args, **kwargs) def LoadMimeStream(*args, **kwargs): - """LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool""" + """ + LoadMimeStream(self, InputStream stream, String mimetype, int index=-1) -> bool + + Loads an image from an input stream or a readable Python file-like + object, using a MIME type string to specify the image file format. + """ return _core_.Image_LoadMimeStream(*args, **kwargs) def Ok(*args, **kwargs): - """Ok(self) -> bool""" + """ + Ok(self) -> bool + + Returns true if image data is present. + """ return _core_.Image_Ok(*args, **kwargs) def GetWidth(*args, **kwargs): - """GetWidth(self) -> int""" + """ + GetWidth(self) -> int + + Gets the width of the image in pixels. + """ return _core_.Image_GetWidth(*args, **kwargs) def GetHeight(*args, **kwargs): - """GetHeight(self) -> int""" + """ + GetHeight(self) -> int + + Gets the height of the image in pixels. + """ return _core_.Image_GetHeight(*args, **kwargs) def GetSize(*args, **kwargs): - """GetSize(self) -> Size""" + """ + GetSize(self) -> Size + + Returns the size of the image in pixels. + """ return _core_.Image_GetSize(*args, **kwargs) def GetSubImage(*args, **kwargs): - """GetSubImage(self, Rect rect) -> Image""" + """ + GetSubImage(self, Rect rect) -> Image + + Returns a sub image of the current one as long as the rect belongs + entirely to the image. + """ return _core_.Image_GetSubImage(*args, **kwargs) def Size(*args, **kwargs): - """Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image""" + """ + Size(self, Size size, Point pos, int r=-1, int g=-1, int b=-1) -> Image + + Returns a resized version of this image without scaling it by adding + either a border with the given colour or cropping as necessary. The + image is pasted into a new image with the given size and background + colour at the position ``pos`` relative to the upper left of the new + image. If red = green = blue = -1 then use either the current mask + colour if set or find, use, and set a suitable mask colour for any + newly exposed areas. + """ return _core_.Image_Size(*args, **kwargs) def Copy(*args, **kwargs): - """Copy(self) -> Image""" + """ + Copy(self) -> Image + + Returns an identical copy of the image. + """ return _core_.Image_Copy(*args, **kwargs) def Paste(*args, **kwargs): - """Paste(self, Image image, int x, int y)""" + """ + Paste(self, Image image, int x, int y) + + Pastes ``image`` into this instance and takes care of the mask colour + and any out of bounds problems. + """ return _core_.Image_Paste(*args, **kwargs) def GetData(*args, **kwargs): @@ -2397,7 +2606,8 @@ class Image(Object): GetDataBuffer(self) -> PyObject Returns a writable Python buffer object that is pointing at the RGB - image data buffer inside the wx.Image. + image data buffer inside the wx.Image. You need to ensure that you do + not use this buffer object after the image has been destroyed. """ return _core_.Image_GetDataBuffer(*args, **kwargs) @@ -2406,8 +2616,8 @@ class Image(Object): SetDataBuffer(self, buffer data) Sets the internal image data pointer to point at a Python buffer - object. This can save a copy of the data but you must ensure that the - buffer object lives longer than the wx.Image does. + object. This can save making an extra copy of the data but you must + ensure that the buffer object lives longer than the wx.Image does. """ return _core_.Image_SetDataBuffer(*args, **kwargs) @@ -2438,7 +2648,12 @@ class Image(Object): return _core_.Image_SetAlphaBuffer(*args, **kwargs) def SetMaskColour(*args, **kwargs): - """SetMaskColour(self, unsigned char r, unsigned char g, unsigned char b)""" + """ + SetMaskColour(self, byte r, byte g, byte b) + + Sets the mask colour for this image (and tells the image to use the + mask). + """ return _core_.Image_SetMaskColour(*args, **kwargs) def GetOrFindMaskColour(*args, **kwargs): @@ -2450,69 +2665,139 @@ class Image(Object): return _core_.Image_GetOrFindMaskColour(*args, **kwargs) def GetMaskRed(*args, **kwargs): - """GetMaskRed(self) -> unsigned char""" + """ + GetMaskRed(self) -> byte + + Gets the red component of the mask colour. + """ return _core_.Image_GetMaskRed(*args, **kwargs) def GetMaskGreen(*args, **kwargs): - """GetMaskGreen(self) -> unsigned char""" + """ + GetMaskGreen(self) -> byte + + Gets the green component of the mask colour. + """ return _core_.Image_GetMaskGreen(*args, **kwargs) def GetMaskBlue(*args, **kwargs): - """GetMaskBlue(self) -> unsigned char""" + """ + GetMaskBlue(self) -> byte + + Gets the blue component of the mask colour. + """ return _core_.Image_GetMaskBlue(*args, **kwargs) def SetMask(*args, **kwargs): - """SetMask(self, bool mask=True)""" + """ + SetMask(self, bool mask=True) + + Specifies whether there is a mask or not. The area of the mask is + determined by the current mask colour. + """ return _core_.Image_SetMask(*args, **kwargs) def HasMask(*args, **kwargs): - """HasMask(self) -> bool""" + """ + HasMask(self) -> bool + + Returns ``True`` if there is a mask active, ``False`` otherwise. + """ return _core_.Image_HasMask(*args, **kwargs) def Rotate(*args, **kwargs): """ Rotate(self, double angle, Point centre_of_rotation, bool interpolating=True, Point offset_after_rotation=None) -> Image + + Rotates the image about the given point, by ``angle`` radians. Passing + ``True`` to ``interpolating`` results in better image quality, but is + slower. If the image has a mask, then the mask colour is used for the + uncovered pixels in the rotated image background. Otherwise, black + will be used as the fill colour. + + Returns the rotated image, leaving this image intact. """ return _core_.Image_Rotate(*args, **kwargs) def Rotate90(*args, **kwargs): - """Rotate90(self, bool clockwise=True) -> Image""" + """ + Rotate90(self, bool clockwise=True) -> Image + + Returns a copy of the image rotated 90 degrees in the direction + indicated by ``clockwise``. + """ return _core_.Image_Rotate90(*args, **kwargs) def Mirror(*args, **kwargs): - """Mirror(self, bool horizontally=True) -> Image""" + """ + Mirror(self, bool horizontally=True) -> Image + + Returns a mirrored copy of the image. The parameter ``horizontally`` + indicates the orientation. + """ return _core_.Image_Mirror(*args, **kwargs) def Replace(*args, **kwargs): """ - Replace(self, unsigned char r1, unsigned char g1, unsigned char b1, - unsigned char r2, unsigned char g2, unsigned char b2) + Replace(self, byte r1, byte g1, byte b1, byte r2, byte g2, byte b2) + + Replaces the colour specified by ``(r1,g1,b1)`` by the colour + ``(r2,g2,b2)``. """ return _core_.Image_Replace(*args, **kwargs) def ConvertToMono(*args, **kwargs): - """ConvertToMono(self, unsigned char r, unsigned char g, unsigned char b) -> Image""" + """ + ConvertToMono(self, byte r, byte g, byte b) -> Image + + Returns monochromatic version of the image. The returned image has + white colour where the original has ``(r,g,b)`` colour and black + colour everywhere else. + """ return _core_.Image_ConvertToMono(*args, **kwargs) def SetOption(*args, **kwargs): - """SetOption(self, String name, String value)""" + """ + SetOption(self, String name, String value) + + Sets an image handler defined option. For example, when saving as a + JPEG file, the option ``wx.IMAGE_OPTION_QUALITY`` is used, which is a + number between 0 and 100 (0 is terrible, 100 is very good). + """ return _core_.Image_SetOption(*args, **kwargs) def SetOptionInt(*args, **kwargs): - """SetOptionInt(self, String name, int value)""" + """ + SetOptionInt(self, String name, int value) + + Sets an image option as an integer. + """ return _core_.Image_SetOptionInt(*args, **kwargs) def GetOption(*args, **kwargs): - """GetOption(self, String name) -> String""" + """ + GetOption(self, String name) -> String + + Gets the value of an image handler option. + """ return _core_.Image_GetOption(*args, **kwargs) def GetOptionInt(*args, **kwargs): - """GetOptionInt(self, String name) -> int""" + """ + GetOptionInt(self, String name) -> int + + Gets the value of an image handler option as an integer. If the given + option is not present, the function returns 0. + """ return _core_.Image_GetOptionInt(*args, **kwargs) def HasOption(*args, **kwargs): - """HasOption(self, String name) -> bool""" + """ + HasOption(self, String name) -> bool + + Returns true if the given option is present. + """ return _core_.Image_HasOption(*args, **kwargs) def CountColours(*args, **kwargs): @@ -2539,7 +2824,13 @@ class Image(Object): RemoveHandler = staticmethod(RemoveHandler) def GetImageExtWildcard(*args, **kwargs): - """GetImageExtWildcard() -> String""" + """ + GetImageExtWildcard() -> String + + Iterates all registered wxImageHandler objects, and returns a string + containing file extension masks suitable for passing to file open/save + dialog boxes. + """ return _core_.Image_GetImageExtWildcard(*args, **kwargs) GetImageExtWildcard = staticmethod(GetImageExtWildcard) @@ -2548,7 +2839,7 @@ class Image(Object): return _core_.Image_ConvertToBitmap(*args, **kwargs) def ConvertToMonoBitmap(*args, **kwargs): - """ConvertToMonoBitmap(self, unsigned char red, unsigned char green, unsigned char blue) -> Bitmap""" + """ConvertToMonoBitmap(self, byte red, byte green, byte blue) -> Bitmap""" return _core_.Image_ConvertToMonoBitmap(*args, **kwargs) def __nonzero__(self): return self.Ok() @@ -2561,19 +2852,34 @@ class ImagePtr(Image): _core_.Image_swigregister(ImagePtr) def ImageFromMime(*args, **kwargs): - """ImageFromMime(String name, String mimetype, int index=-1) -> Image""" + """ + ImageFromMime(String name, String mimetype, int index=-1) -> Image + + Loads an image from a file, using a MIME type string (such as + 'image/jpeg') to specify image type. + """ val = _core_.new_ImageFromMime(*args, **kwargs) val.thisown = 1 return val def ImageFromStream(*args, **kwargs): - """ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image""" + """ + ImageFromStream(InputStream stream, long type=BITMAP_TYPE_ANY, int index=-1) -> Image + + Loads an image from an input stream, or any readable Python file-like + object. + """ val = _core_.new_ImageFromStream(*args, **kwargs) val.thisown = 1 return val def ImageFromStreamMime(*args, **kwargs): - """ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image""" + """ + ImageFromStreamMime(InputStream stream, String mimetype, int index=-1) -> Image + + Loads an image from an input stream, or any readable Python file-like + object, specifying the image format with a MIME type string. + """ val = _core_.new_ImageFromStreamMime(*args, **kwargs) val.thisown = 1 return val @@ -2617,22 +2923,39 @@ def ImageFromDataWithAlpha(*args, **kwargs): Construct an Image from a buffer of RGB bytes with an Alpha channel. Accepts either a string or a buffer object holding the data and the - length of the data must be width*height*3. + length of the data must be width*height*3 bytes, and the length of the + alpha data must be width*height bytes. """ val = _core_.new_ImageFromDataWithAlpha(*args, **kwargs) val.thisown = 1 return val def Image_CanRead(*args, **kwargs): - """Image_CanRead(String name) -> bool""" + """ + Image_CanRead(String filename) -> bool + + Returns True if the image handlers can read this file. + """ return _core_.Image_CanRead(*args, **kwargs) def Image_GetImageCount(*args, **kwargs): - """Image_GetImageCount(String name, long type=BITMAP_TYPE_ANY) -> int""" + """ + Image_GetImageCount(String filename, long type=BITMAP_TYPE_ANY) -> int + + If the image file contains more than one image and the image handler + is capable of retrieving these individually, this function will return + the number of available images. + """ return _core_.Image_GetImageCount(*args, **kwargs) def Image_CanReadStream(*args, **kwargs): - """Image_CanReadStream(InputStream stream) -> bool""" + """ + Image_CanReadStream(InputStream stream) -> bool + + Returns True if the image handlers can read an image file from the + data currently on the input stream, or a readable Python file-like + object. + """ return _core_.Image_CanReadStream(*args, **kwargs) def Image_AddHandler(*args, **kwargs): @@ -2648,7 +2971,13 @@ def Image_RemoveHandler(*args, **kwargs): return _core_.Image_RemoveHandler(*args, **kwargs) def Image_GetImageExtWildcard(*args, **kwargs): - """Image_GetImageExtWildcard() -> String""" + """ + Image_GetImageExtWildcard() -> String + + Iterates all registered wxImageHandler objects, and returns a string + containing file extension masks suitable for passing to file open/save + dialog boxes. + """ return _core_.Image_GetImageExtWildcard(*args, **kwargs) def InitAllImageHandlers(): diff --git a/wxPython/src/msw/_core_wrap.cpp b/wxPython/src/msw/_core_wrap.cpp index 6d96a18b9a..0d8133dafd 100644 --- a/wxPython/src/msw/_core_wrap.cpp +++ b/wxPython/src/msw/_core_wrap.cpp @@ -2328,7 +2328,7 @@ static unsigned long wxImageHistogram_GetCount(wxImageHistogram *self,unsigned l wxImageHistogramEntry e = (*self)[key]; return e.value; } -static unsigned long wxImageHistogram_GetCountRGB(wxImageHistogram *self,unsigned char r,unsigned char g,unsigned char b){ +static unsigned long wxImageHistogram_GetCountRGB(wxImageHistogram *self,byte r,byte g,byte b){ unsigned long key = wxImageHistogram::MakeKey(r, g, b); wxImageHistogramEntry e = (*self)[key]; return e.value; @@ -2476,7 +2476,7 @@ static wxBitmap wxImage_ConvertToBitmap(wxImage *self,int depth=-1){ wxBitmap bitmap(*self, depth); return bitmap; } -static wxBitmap wxImage_ConvertToMonoBitmap(wxImage *self,unsigned char red,unsigned char green,unsigned char blue){ +static wxBitmap wxImage_ConvertToMonoBitmap(wxImage *self,byte red,byte green,byte blue){ wxImage mono = self->ConvertToMono( red, green, blue ); wxBitmap bitmap( mono, 1 ); return bitmap; @@ -10227,9 +10227,9 @@ static PyObject *_wrap_new_ImageHistogram(PyObject *, PyObject *args, PyObject * static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; - unsigned char arg1 ; - unsigned char arg2 ; - unsigned char arg3 ; + byte arg1 ; + byte arg2 ; + byte arg3 ; unsigned long result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10240,15 +10240,15 @@ static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObje if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO:ImageHistogram_MakeKey",kwnames,&obj0,&obj1,&obj2)) goto fail; { - arg1 = (unsigned char)(SWIG_As_unsigned_SS_char(obj0)); + arg1 = (byte)(SWIG_As_unsigned_SS_char(obj0)); if (SWIG_arg_fail(1)) SWIG_fail; } { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { @@ -10270,18 +10270,18 @@ static PyObject *_wrap_ImageHistogram_MakeKey(PyObject *, PyObject *args, PyObje static PyObject *_wrap_ImageHistogram_FindFirstUnusedColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImageHistogram *arg1 = (wxImageHistogram *) 0 ; - unsigned char *arg2 = (unsigned char *) 0 ; - unsigned char *arg3 = (unsigned char *) 0 ; - unsigned char *arg4 = (unsigned char *) 0 ; - unsigned char arg5 = (unsigned char) 1 ; - unsigned char arg6 = (unsigned char) 0 ; - unsigned char arg7 = (unsigned char) 0 ; + byte *arg2 = (byte *) 0 ; + byte *arg3 = (byte *) 0 ; + byte *arg4 = (byte *) 0 ; + byte arg5 = (byte) 1 ; + byte arg6 = (byte) 0 ; + byte arg7 = (byte) 0 ; bool result; - unsigned char temp2 ; + byte temp2 ; int res2 = 0 ; - unsigned char temp3 ; + byte temp3 ; int res3 = 0 ; - unsigned char temp4 ; + byte temp4 ; int res4 = 0 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10299,19 +10299,19 @@ static PyObject *_wrap_ImageHistogram_FindFirstUnusedColour(PyObject *, PyObject if (SWIG_arg_fail(1)) SWIG_fail; if (obj1) { { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(5)) SWIG_fail; } } if (obj2) { { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(6)) SWIG_fail; } } if (obj3) { { - arg7 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg7 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(7)) SWIG_fail; } } @@ -10374,9 +10374,9 @@ static PyObject *_wrap_ImageHistogram_GetCount(PyObject *, PyObject *args, PyObj static PyObject *_wrap_ImageHistogram_GetCountRGB(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImageHistogram *arg1 = (wxImageHistogram *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; unsigned long result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -10390,15 +10390,15 @@ static PyObject *_wrap_ImageHistogram_GetCountRGB(PyObject *, PyObject *args, Py SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImageHistogram, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -10902,14 +10902,16 @@ static PyObject *_wrap_Image_Create(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; + bool arg4 = (bool) true ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; + PyObject * obj3 = 0 ; char *kwnames[] = { - (char *) "self",(char *) "width",(char *) "height", NULL + (char *) "self",(char *) "width",(char *) "height",(char *) "clear", NULL }; - if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO:Image_Create",kwnames,&obj0,&obj1,&obj2)) goto fail; + if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"OOO|O:Image_Create",kwnames,&obj0,&obj1,&obj2,&obj3)) goto fail; SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { @@ -10920,9 +10922,15 @@ static PyObject *_wrap_Image_Create(PyObject *, PyObject *args, PyObject *kwargs arg3 = (int)(SWIG_As_int(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } + if (obj3) { + { + arg4 = (bool)(SWIG_As_bool(obj3)); + if (SWIG_arg_fail(4)) SWIG_fail; + } + } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - (arg1)->Create(arg2,arg3); + (arg1)->Create(arg2,arg3,arg4); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11156,9 +11164,9 @@ static PyObject *_wrap_Image_SetRGB(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; - unsigned char arg6 ; + byte arg4 ; + byte arg5 ; + byte arg6 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11181,15 +11189,15 @@ static PyObject *_wrap_Image_SetRGB(PyObject *, PyObject *args, PyObject *kwargs if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj5)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj5)); if (SWIG_arg_fail(6)) SWIG_fail; } { @@ -11210,9 +11218,9 @@ static PyObject *_wrap_Image_SetRGBRect(PyObject *, PyObject *args, PyObject *kw PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; wxRect *arg2 = 0 ; - unsigned char arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; + byte arg3 ; + byte arg4 ; + byte arg5 ; wxRect temp2 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11231,15 +11239,15 @@ static PyObject *_wrap_Image_SetRGBRect(PyObject *, PyObject *args, PyObject *kw if ( ! wxRect_helper(obj1, &arg2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { @@ -11261,7 +11269,7 @@ static PyObject *_wrap_Image_GetRed(PyObject *, PyObject *args, PyObject *kwargs wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11282,7 +11290,7 @@ static PyObject *_wrap_Image_GetRed(PyObject *, PyObject *args, PyObject *kwargs } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetRed(arg2,arg3); + result = (byte)(arg1)->GetRed(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11301,7 +11309,7 @@ static PyObject *_wrap_Image_GetGreen(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11322,7 +11330,7 @@ static PyObject *_wrap_Image_GetGreen(PyObject *, PyObject *args, PyObject *kwar } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetGreen(arg2,arg3); + result = (byte)(arg1)->GetGreen(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11341,7 +11349,7 @@ static PyObject *_wrap_Image_GetBlue(PyObject *, PyObject *args, PyObject *kwarg wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11362,7 +11370,7 @@ static PyObject *_wrap_Image_GetBlue(PyObject *, PyObject *args, PyObject *kwarg } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetBlue(arg2,arg3); + result = (byte)(arg1)->GetBlue(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11381,7 +11389,7 @@ static PyObject *_wrap_Image_SetAlpha(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 ; + byte arg4 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11402,7 +11410,7 @@ static PyObject *_wrap_Image_SetAlpha(PyObject *, PyObject *args, PyObject *kwar if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -11424,7 +11432,7 @@ static PyObject *_wrap_Image_GetAlpha(PyObject *, PyObject *args, PyObject *kwar wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -11445,7 +11453,7 @@ static PyObject *_wrap_Image_GetAlpha(PyObject *, PyObject *args, PyObject *kwar } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetAlpha(arg2,arg3); + result = (byte)(arg1)->GetAlpha(arg2,arg3); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -11517,7 +11525,7 @@ static PyObject *_wrap_Image_IsTransparent(PyObject *, PyObject *args, PyObject wxImage *arg1 = (wxImage *) 0 ; int arg2 ; int arg3 ; - unsigned char arg4 = (unsigned char) wxIMAGE_ALPHA_THRESHOLD ; + byte arg4 = (byte) wxIMAGE_ALPHA_THRESHOLD ; bool result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11540,7 +11548,7 @@ static PyObject *_wrap_Image_IsTransparent(PyObject *, PyObject *args, PyObject } if (obj3) { { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } } @@ -11669,9 +11677,9 @@ static PyObject *_wrap_Image_ConvertAlphaToMask(PyObject *, PyObject *args, PyOb static PyObject *_wrap_Image_ConvertColourToAlpha(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; bool result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -11685,15 +11693,15 @@ static PyObject *_wrap_Image_ConvertColourToAlpha(PyObject *, PyObject *args, Py SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -11775,7 +11783,7 @@ static PyObject *_wrap_Image_CanRead(PyObject *, PyObject *args, PyObject *kwarg bool temp1 = false ; PyObject * obj0 = 0 ; char *kwnames[] = { - (char *) "name", NULL + (char *) "filename", NULL }; if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"O:Image_CanRead",kwnames,&obj0)) goto fail; @@ -11817,7 +11825,7 @@ static PyObject *_wrap_Image_GetImageCount(PyObject *, PyObject *args, PyObject PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; char *kwnames[] = { - (char *) "name",(char *) "type", NULL + (char *) "filename",(char *) "type", NULL }; if(!PyArg_ParseTupleAndKeywords(args,kwargs,(char *)"O|O:Image_GetImageCount",kwnames,&obj0,&obj1)) goto fail; @@ -12813,9 +12821,9 @@ static PyObject *_wrap_Image_SetAlphaBuffer(PyObject *, PyObject *args, PyObject static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -12828,15 +12836,15 @@ static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -12856,14 +12864,14 @@ static PyObject *_wrap_Image_SetMaskColour(PyObject *, PyObject *args, PyObject static PyObject *_wrap_Image_GetOrFindMaskColour(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char *arg2 = (unsigned char *) 0 ; - unsigned char *arg3 = (unsigned char *) 0 ; - unsigned char *arg4 = (unsigned char *) 0 ; - unsigned char temp2 ; + byte *arg2 = (byte *) 0 ; + byte *arg3 = (byte *) 0 ; + byte *arg4 = (byte *) 0 ; + byte temp2 ; int res2 = 0 ; - unsigned char temp3 ; + byte temp3 ; int res3 = 0 ; - unsigned char temp4 ; + byte temp4 ; int res4 = 0 ; PyObject * obj0 = 0 ; char *kwnames[] = { @@ -12899,7 +12907,7 @@ static PyObject *_wrap_Image_GetOrFindMaskColour(PyObject *, PyObject *args, PyO static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12910,7 +12918,7 @@ static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kw if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskRed(); + result = (byte)(arg1)->GetMaskRed(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -12927,7 +12935,7 @@ static PyObject *_wrap_Image_GetMaskRed(PyObject *, PyObject *args, PyObject *kw static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12938,7 +12946,7 @@ static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject * if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskGreen(); + result = (byte)(arg1)->GetMaskGreen(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -12955,7 +12963,7 @@ static PyObject *_wrap_Image_GetMaskGreen(PyObject *, PyObject *args, PyObject * static PyObject *_wrap_Image_GetMaskBlue(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char result; + byte result; PyObject * obj0 = 0 ; char *kwnames[] = { (char *) "self", NULL @@ -12966,7 +12974,7 @@ static PyObject *_wrap_Image_GetMaskBlue(PyObject *, PyObject *args, PyObject *k if (SWIG_arg_fail(1)) SWIG_fail; { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (unsigned char)(arg1)->GetMaskBlue(); + result = (byte)(arg1)->GetMaskBlue(); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -13177,12 +13185,12 @@ static PyObject *_wrap_Image_Mirror(PyObject *, PyObject *args, PyObject *kwargs static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; - unsigned char arg5 ; - unsigned char arg6 ; - unsigned char arg7 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; + byte arg5 ; + byte arg6 ; + byte arg7 ; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; PyObject * obj2 = 0 ; @@ -13198,27 +13206,27 @@ static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwarg SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { - arg5 = (unsigned char)(SWIG_As_unsigned_SS_char(obj4)); + arg5 = (byte)(SWIG_As_unsigned_SS_char(obj4)); if (SWIG_arg_fail(5)) SWIG_fail; } { - arg6 = (unsigned char)(SWIG_As_unsigned_SS_char(obj5)); + arg6 = (byte)(SWIG_As_unsigned_SS_char(obj5)); if (SWIG_arg_fail(6)) SWIG_fail; } { - arg7 = (unsigned char)(SWIG_As_unsigned_SS_char(obj6)); + arg7 = (byte)(SWIG_As_unsigned_SS_char(obj6)); if (SWIG_arg_fail(7)) SWIG_fail; } { @@ -13238,9 +13246,9 @@ static PyObject *_wrap_Image_Replace(PyObject *, PyObject *args, PyObject *kwarg static PyObject *_wrap_Image_ConvertToMono(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; SwigValueWrapper result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -13254,15 +13262,15 @@ static PyObject *_wrap_Image_ConvertToMono(PyObject *, PyObject *args, PyObject SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -13757,9 +13765,9 @@ static PyObject *_wrap_Image_ConvertToBitmap(PyObject *, PyObject *args, PyObjec static PyObject *_wrap_Image_ConvertToMonoBitmap(PyObject *, PyObject *args, PyObject *kwargs) { PyObject *resultobj; wxImage *arg1 = (wxImage *) 0 ; - unsigned char arg2 ; - unsigned char arg3 ; - unsigned char arg4 ; + byte arg2 ; + byte arg3 ; + byte arg4 ; wxBitmap result; PyObject * obj0 = 0 ; PyObject * obj1 = 0 ; @@ -13773,15 +13781,15 @@ static PyObject *_wrap_Image_ConvertToMonoBitmap(PyObject *, PyObject *args, PyO SWIG_Python_ConvertPtr(obj0, (void **)&arg1, SWIGTYPE_p_wxImage, SWIG_POINTER_EXCEPTION | 0); if (SWIG_arg_fail(1)) SWIG_fail; { - arg2 = (unsigned char)(SWIG_As_unsigned_SS_char(obj1)); + arg2 = (byte)(SWIG_As_unsigned_SS_char(obj1)); if (SWIG_arg_fail(2)) SWIG_fail; } { - arg3 = (unsigned char)(SWIG_As_unsigned_SS_char(obj2)); + arg3 = (byte)(SWIG_As_unsigned_SS_char(obj2)); if (SWIG_arg_fail(3)) SWIG_fail; } { - arg4 = (unsigned char)(SWIG_As_unsigned_SS_char(obj3)); + arg4 = (byte)(SWIG_As_unsigned_SS_char(obj3)); if (SWIG_arg_fail(4)) SWIG_fail; } { @@ -32016,7 +32024,7 @@ static PyObject *_wrap_Window_GetSizer(PyObject *, PyObject *args, PyObject *kwa if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -32073,7 +32081,7 @@ static PyObject *_wrap_Window_GetContainingSizer(PyObject *, PyObject *args, PyO if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -35496,7 +35504,7 @@ static PyObject *_wrap_MenuBar_FindMenu(PyObject *, PyObject *args, PyObject *kw } { PyThreadState* __tstate = wxPyBeginAllowThreads(); - result = (int)((wxMenuBar const *)arg1)->FindMenu((wxString const &)*arg2); + result = (int)(arg1)->FindMenu((wxString const &)*arg2); wxPyEndAllowThreads(__tstate); if (PyErr_Occurred()) SWIG_fail; @@ -39350,7 +39358,7 @@ static PyObject *_wrap_SizerItem_GetSizer(PyObject *, PyObject *args, PyObject * if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: @@ -47270,7 +47278,7 @@ static swig_type_info _swigt__unsigned_int[] = {{"_unsigned_int", 0, "unsigned i static swig_type_info _swigt__p_unsigned_int[] = {{"_p_unsigned_int", 0, "unsigned int *|time_t *", 0, 0, 0, 0},{"_p_unsigned_int", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxMenuEvent[] = {{"_p_wxMenuEvent", 0, "wxMenuEvent *", 0, 0, 0, 0},{"_p_wxMenuEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxContextMenuEvent[] = {{"_p_wxContextMenuEvent", 0, "wxContextMenuEvent *", 0, 0, 0, 0},{"_p_wxContextMenuEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; -static swig_type_info _swigt__p_unsigned_char[] = {{"_p_unsigned_char", 0, "unsigned char *", 0, 0, 0, 0},{"_p_unsigned_char", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; +static swig_type_info _swigt__p_unsigned_char[] = {{"_p_unsigned_char", 0, "unsigned char *|byte *", 0, 0, 0, 0},{"_p_unsigned_char", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxEraseEvent[] = {{"_p_wxEraseEvent", 0, "wxEraseEvent *", 0, 0, 0, 0},{"_p_wxEraseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxMouseEvent[] = {{"_p_wxMouseEvent", 0, "wxMouseEvent *", 0, 0, 0, 0},{"_p_wxMouseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; static swig_type_info _swigt__p_wxCloseEvent[] = {{"_p_wxCloseEvent", 0, "wxCloseEvent *", 0, 0, 0, 0},{"_p_wxCloseEvent", 0, 0, 0, 0, 0, 0},{0, 0, 0, 0, 0, 0, 0}}; diff --git a/wxPython/src/msw/_windows_wrap.cpp b/wxPython/src/msw/_windows_wrap.cpp index efe52bc572..9925373cbb 100644 --- a/wxPython/src/msw/_windows_wrap.cpp +++ b/wxPython/src/msw/_windows_wrap.cpp @@ -5932,7 +5932,7 @@ static PyObject *_wrap_Dialog_CreateTextSizer(PyObject *, PyObject *args, PyObje if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } { if (temp2) @@ -5974,7 +5974,7 @@ static PyObject *_wrap_Dialog_CreateButtonSizer(PyObject *, PyObject *args, PyOb if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: diff --git a/wxPython/src/msw/wizard_wrap.cpp b/wxPython/src/msw/wizard_wrap.cpp index b4a17d785b..ea0bcbd588 100644 --- a/wxPython/src/msw/wizard_wrap.cpp +++ b/wxPython/src/msw/wizard_wrap.cpp @@ -3351,7 +3351,7 @@ static PyObject *_wrap_Wizard_GetPageAreaSizer(PyObject *, PyObject *args, PyObj if (PyErr_Occurred()) SWIG_fail; } { - resultobj = wxPyMake_wxSizer(result, 0); + resultobj = wxPyMake_wxObject(result, 0); } return resultobj; fail: -- 2.47.2