X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/b850e7f3345e0428154e01a3013d322a3862a290..bbc3761ee897d2cdae209c60d415ba00fe825554:/wxPython/src/msw/_gdi.py?ds=sidebyside diff --git a/wxPython/src/msw/_gdi.py b/wxPython/src/msw/_gdi.py index 01b903b65c..2ea7487ffd 100644 --- a/wxPython/src/msw/_gdi.py +++ b/wxPython/src/msw/_gdi.py @@ -75,6 +75,8 @@ _gdi_.GDIObject_swigregister(GDIObject) C2S_NAME = _gdi_.C2S_NAME C2S_CSS_SYNTAX = _gdi_.C2S_CSS_SYNTAX C2S_HTML_SYNTAX = _gdi_.C2S_HTML_SYNTAX +ALPHA_TRANSPARENT = _gdi_.ALPHA_TRANSPARENT +ALPHA_OPAQUE = _gdi_.ALPHA_OPAQUE class Colour(_core.Object): """ A colour is an object representing a combination of Red, Green, and @@ -102,7 +104,7 @@ class Colour(_core.Object): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, byte red=0, byte green=0, byte blue=0) -> Colour + __init__(self, byte red=0, byte green=0, byte blue=0, byte alpha=ALPHA_OPAQUE) -> Colour Constructs a colour from red, green and blue values. @@ -136,18 +138,27 @@ class Colour(_core.Object): """ return _gdi_.Colour_Blue(*args, **kwargs) - def Ok(*args, **kwargs): + def Alpha(*args, **kwargs): """ - Ok(self) -> bool + Alpha(self) -> byte + + Returns the Alpha value. + """ + return _gdi_.Colour_Alpha(*args, **kwargs) + + def IsOk(*args, **kwargs): + """ + IsOk(self) -> bool Returns True if the colour object is valid (the colour has been initialised with RGB values). """ - return _gdi_.Colour_Ok(*args, **kwargs) + return _gdi_.Colour_IsOk(*args, **kwargs) + Ok = IsOk def Set(*args, **kwargs): """ - Set(self, byte red, byte green, byte blue) + Set(self, byte red, byte green, byte blue, byte alpha=ALPHA_OPAQUE) Sets the RGB intensity values. """ @@ -227,12 +238,16 @@ class Colour(_core.Object): return _gdi_.Colour_GetRGB(*args, **kwargs) asTuple = wx._deprecated(Get, "asTuple is deprecated, use `Get` instead") - def __str__(self): return str(self.Get()) - def __repr__(self): return 'wx.Colour' + str(self.Get()) - def __nonzero__(self): return self.Ok() + def __str__(self): return str(self.Get(True)) + def __repr__(self): return 'wx.Colour' + str(self.Get(True)) + def __len__(self): return len(self.Get()) + def __getitem__(self, index): return self.Get()[index] + def __nonzero__(self): return self.IsOk() __safe_for_unpickling__ = True - def __reduce__(self): return (Colour, self.Get()) + def __reduce__(self): return (Colour, self.Get(True)) + Pixel = property(GetPixel,doc="See `GetPixel`") + RGB = property(GetRGB,SetRGB,doc="See `GetRGB` and `SetRGB`") _gdi_.Colour_swigregister(Colour) def NamedColour(*args, **kwargs): @@ -279,11 +294,13 @@ class Palette(GDIObject): """GetColoursCount(self) -> int""" return _gdi_.Palette_GetColoursCount(*args, **kwargs) - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _gdi_.Palette_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.Palette_IsOk(*args, **kwargs) - def __nonzero__(self): return self.Ok() + Ok = IsOk + def __nonzero__(self): return self.IsOk() + ColoursCount = property(GetColoursCount,doc="See `GetColoursCount`") _gdi_.Palette_swigregister(Palette) #--------------------------------------------------------------------------- @@ -317,10 +334,11 @@ class Pen(GDIObject): """GetWidth(self) -> int""" return _gdi_.Pen_GetWidth(*args, **kwargs) - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _gdi_.Pen_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.Pen_IsOk(*args, **kwargs) + Ok = IsOk def SetCap(*args, **kwargs): """SetCap(self, int cap_style)""" return _gdi_.Pen_SetCap(*args, **kwargs) @@ -363,6 +381,7 @@ class Pen(GDIObject): """GetDashCount(self) -> int""" return _gdi_.Pen_GetDashCount(*args, **kwargs) + DashCount = property(GetDashCount,doc="See `GetDashCount`") def GetStipple(*args, **kwargs): """GetStipple(self) -> Bitmap""" return _gdi_.Pen_GetStipple(*args, **kwargs) @@ -371,6 +390,7 @@ class Pen(GDIObject): """SetStipple(self, Bitmap stipple)""" return _gdi_.Pen_SetStipple(*args, **kwargs) + Stipple = property(GetStipple,SetStipple,doc="See `GetStipple` and `SetStipple`") def __eq__(*args, **kwargs): """__eq__(self, Pen other) -> bool""" return _gdi_.Pen___eq__(*args, **kwargs) @@ -379,7 +399,13 @@ class Pen(GDIObject): """__ne__(self, Pen other) -> bool""" return _gdi_.Pen___ne__(*args, **kwargs) - def __nonzero__(self): return self.Ok() + def __nonzero__(self): return self.IsOk() + Cap = property(GetCap,SetCap,doc="See `GetCap` and `SetCap`") + Colour = property(GetColour,SetColour,doc="See `GetColour` and `SetColour`") + Dashes = property(GetDashes,SetDashes,doc="See `GetDashes` and `SetDashes`") + Join = property(GetJoin,SetJoin,doc="See `GetJoin` and `SetJoin`") + Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`") + Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`") _gdi_.Pen_swigregister(Pen) #--------------------------------------------------------------------------- @@ -460,15 +486,19 @@ class Brush(GDIObject): """ return _gdi_.Brush_IsHatch(*args, **kwargs) - def Ok(*args, **kwargs): + def IsOk(*args, **kwargs): """ - Ok(self) -> bool + IsOk(self) -> bool Returns True if the brush is initialised and valid. """ - return _gdi_.Brush_Ok(*args, **kwargs) + return _gdi_.Brush_IsOk(*args, **kwargs) - def __nonzero__(self): return self.Ok() + Ok = IsOk + def __nonzero__(self): return self.IsOk() + Colour = property(GetColour,SetColour,doc="See `GetColour` and `SetColour`") + Stipple = property(GetStipple,SetStipple,doc="See `GetStipple` and `SetStipple`") + Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`") _gdi_.Brush_swigregister(Brush) def BrushFromBitmap(*args, **kwargs): @@ -508,10 +538,11 @@ class Bitmap(GDIObject): """SetHandle(self, long handle)""" return _gdi_.Bitmap_SetHandle(*args, **kwargs) - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _gdi_.Bitmap_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.Bitmap_IsOk(*args, **kwargs) + Ok = IsOk def GetWidth(*args, **kwargs): """ GetWidth(self) -> int @@ -662,7 +693,7 @@ class Bitmap(GDIObject): """CopyFromCursor(self, Cursor cursor) -> bool""" return _gdi_.Bitmap_CopyFromCursor(*args, **kwargs) - def __nonzero__(self): return self.Ok() + def __nonzero__(self): return self.IsOk() def __eq__(*args, **kwargs): """__eq__(self, Bitmap other) -> bool""" return _gdi_.Bitmap___eq__(*args, **kwargs) @@ -671,6 +702,13 @@ class Bitmap(GDIObject): """__ne__(self, Bitmap other) -> bool""" return _gdi_.Bitmap___ne__(*args, **kwargs) + Depth = property(GetDepth,SetDepth,doc="See `GetDepth` and `SetDepth`") + Height = property(GetHeight,SetHeight,doc="See `GetHeight` and `SetHeight`") + Mask = property(GetMask,SetMask,doc="See `GetMask` and `SetMask`") + Palette = property(GetPalette,doc="See `GetPalette`") + Size = property(GetSize,SetSize,doc="See `GetSize` and `SetSize`") + SubBitmap = property(GetSubBitmap,doc="See `GetSubBitmap`") + Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`") _gdi_.Bitmap_swigregister(Bitmap) def EmptyBitmap(*args, **kwargs): @@ -727,6 +765,331 @@ def BitmapFromBits(*args, **kwargs): val = _gdi_.new_BitmapFromBits(*args, **kwargs) return val + +def _BitmapFromBufferAlpha(*args, **kwargs): + """_BitmapFromBufferAlpha(int width, int height, buffer data, buffer alpha) -> Bitmap""" + return _gdi_._BitmapFromBufferAlpha(*args, **kwargs) + +def _BitmapFromBuffer(*args, **kwargs): + """_BitmapFromBuffer(int width, int height, buffer data) -> Bitmap""" + return _gdi_._BitmapFromBuffer(*args, **kwargs) +def BitmapFromBuffer(width, height, dataBuffer, alphaBuffer=None): + """ + Creates a `wx.Bitmap` from the data in dataBuffer. The dataBuffer + parameter must be a Python object that implements the buffer + interface, such as a string, array, etc. The dataBuffer object is + expected to contain a series of RGB bytes and be width*height*3 + bytes long. A buffer object can optionally be supplied for the + image's alpha channel data, and it is expected to be width*height + bytes long. On Windows the RGB values are 'premultiplied' by the + alpha values. (The other platforms do the multiplication + themselves.) + + Unlike `wx.ImageFromBuffer` the bitmap created with this function + does not share the memory buffer with the buffer object. This is + because the native pixel buffer format varies on different + platforms, and so instead an efficient as possible copy of the + data is made from the buffer objects to the bitmap's native pixel + buffer. For direct access to a bitmap's pixel buffer see + `wx.NativePixelData` and `wx.AlphaPixelData`. + + :see: `wx.Bitmap`, `wx.BitmapFromBufferRGBA`, `wx.NativePixelData`, + `wx.AlphaPixelData`, `wx.ImageFromBuffer` + """ + if alphaBuffer is not None: + return _gdi_._BitmapFromBufferAlpha(width, height, dataBuffer, alphaBuffer) + else: + return _gdi_._BitmapFromBuffer(width, height, dataBuffer) + + +def _BitmapFromBufferRGBA(*args, **kwargs): + """_BitmapFromBufferRGBA(int width, int height, buffer data) -> Bitmap""" + return _gdi_._BitmapFromBufferRGBA(*args, **kwargs) +def BitmapFromBufferRGBA(width, height, dataBuffer): + """ + Creates a `wx.Bitmap` from the data in dataBuffer. The dataBuffer + parameter must be a Python object that implements the buffer + interface, such as a string, array, etc. The dataBuffer object is + expected to contain a series of RGBA bytes (red, green, blue and + alpha) and be width*height*4 bytes long. On Windows the RGB + values are 'premultiplied' by the alpha values. (The other + platforms do the multiplication themselves.) + + Unlike `wx.ImageFromBuffer` the bitmap created with this function + does not share the memory buffer with the buffer object. This is + because the native pixel buffer format varies on different + platforms, and so instead an efficient as possible copy of the + data is made from the buffer object to the bitmap's native pixel + buffer. For direct access to a bitmap's pixel buffer see + `wx.NativePixelData` and `wx.AlphaPixelData`. + + :see: `wx.Bitmap`, `wx.BitmapFromBuffer`, `wx.NativePixelData`, + `wx.AlphaPixelData`, `wx.ImageFromBuffer` + """ + return _gdi_._BitmapFromBufferRGBA(width, height, dataBuffer) + +class PixelDataBase(object): + """Proxy of C++ PixelDataBase class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + def __init__(self): raise AttributeError, "No constructor defined" + __repr__ = _swig_repr + def GetOrigin(*args, **kwargs): + """GetOrigin(self) -> Point""" + return _gdi_.PixelDataBase_GetOrigin(*args, **kwargs) + + def GetWidth(*args, **kwargs): + """GetWidth(self) -> int""" + return _gdi_.PixelDataBase_GetWidth(*args, **kwargs) + + def GetHeight(*args, **kwargs): + """GetHeight(self) -> int""" + return _gdi_.PixelDataBase_GetHeight(*args, **kwargs) + + def GetSize(*args, **kwargs): + """GetSize(self) -> Size""" + return _gdi_.PixelDataBase_GetSize(*args, **kwargs) + + def GetRowStride(*args, **kwargs): + """GetRowStride(self) -> int""" + return _gdi_.PixelDataBase_GetRowStride(*args, **kwargs) + + Height = property(GetHeight,doc="See `GetHeight`") + Origin = property(GetOrigin,doc="See `GetOrigin`") + RowStride = property(GetRowStride,doc="See `GetRowStride`") + Size = property(GetSize,doc="See `GetSize`") + Width = property(GetWidth,doc="See `GetWidth`") +_gdi_.PixelDataBase_swigregister(PixelDataBase) + +class NativePixelData(PixelDataBase): + """Proxy of C++ NativePixelData class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args): + """ + __init__(self, Bitmap bmp) -> NativePixelData + __init__(self, Bitmap bmp, Rect rect) -> NativePixelData + __init__(self, Bitmap bmp, Point pt, Size sz) -> NativePixelData + """ + _gdi_.NativePixelData_swiginit(self,_gdi_.new_NativePixelData(*args)) + __swig_destroy__ = _gdi_.delete_NativePixelData + __del__ = lambda self : None; + def GetPixels(*args, **kwargs): + """GetPixels(self) -> NativePixelData_Accessor""" + return _gdi_.NativePixelData_GetPixels(*args, **kwargs) + + def UseAlpha(*args, **kwargs): + """UseAlpha(self)""" + return _gdi_.NativePixelData_UseAlpha(*args, **kwargs) + + def __nonzero__(*args, **kwargs): + """__nonzero__(self) -> bool""" + return _gdi_.NativePixelData___nonzero__(*args, **kwargs) + + def __iter__(self): + """ + Create and return an iterator object for this pixel data + object. (It's really a generator but I won't tell if you + don't tell.) + """ + width = self.GetWidth() + height = self.GetHeight() + pixels = self.GetPixels() + + + + + class PixelFacade(object): + def Get(self): + return pixels.Get() + def Set(self, *args, **kw): + return pixels.Set(*args, **kw) + def __str__(self): + return str(self.Get()) + def __repr__(self): + return 'pixel(%d,%d): %s' % (x,y,self.Get()) + X = property(lambda self: x) + Y = property(lambda self: y) + + pf = PixelFacade() + for y in xrange(height): + for x in xrange(width): + + + + yield pf + pixels.nextPixel() + pixels.MoveTo(self, 0, y) + + Pixels = property(GetPixels,doc="See `GetPixels`") +_gdi_.NativePixelData_swigregister(NativePixelData) + +class NativePixelData_Accessor(object): + """Proxy of C++ NativePixelData_Accessor class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args): + """ + __init__(self, NativePixelData data) -> NativePixelData_Accessor + __init__(self, Bitmap bmp, NativePixelData data) -> NativePixelData_Accessor + __init__(self) -> NativePixelData_Accessor + """ + _gdi_.NativePixelData_Accessor_swiginit(self,_gdi_.new_NativePixelData_Accessor(*args)) + __swig_destroy__ = _gdi_.delete_NativePixelData_Accessor + __del__ = lambda self : None; + def Reset(*args, **kwargs): + """Reset(self, NativePixelData data)""" + return _gdi_.NativePixelData_Accessor_Reset(*args, **kwargs) + + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.NativePixelData_Accessor_IsOk(*args, **kwargs) + + def nextPixel(*args, **kwargs): + """nextPixel(self)""" + return _gdi_.NativePixelData_Accessor_nextPixel(*args, **kwargs) + + def Offset(*args, **kwargs): + """Offset(self, NativePixelData data, int x, int y)""" + return _gdi_.NativePixelData_Accessor_Offset(*args, **kwargs) + + def OffsetX(*args, **kwargs): + """OffsetX(self, NativePixelData data, int x)""" + return _gdi_.NativePixelData_Accessor_OffsetX(*args, **kwargs) + + def OffsetY(*args, **kwargs): + """OffsetY(self, NativePixelData data, int y)""" + return _gdi_.NativePixelData_Accessor_OffsetY(*args, **kwargs) + + def MoveTo(*args, **kwargs): + """MoveTo(self, NativePixelData data, int x, int y)""" + return _gdi_.NativePixelData_Accessor_MoveTo(*args, **kwargs) + + def Set(*args, **kwargs): + """Set(self, byte red, byte green, byte blue)""" + return _gdi_.NativePixelData_Accessor_Set(*args, **kwargs) + + def Get(*args, **kwargs): + """Get(self) -> PyObject""" + return _gdi_.NativePixelData_Accessor_Get(*args, **kwargs) + +_gdi_.NativePixelData_Accessor_swigregister(NativePixelData_Accessor) + +class AlphaPixelData(PixelDataBase): + """Proxy of C++ AlphaPixelData class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args): + """ + __init__(self, Bitmap bmp) -> AlphaPixelData + __init__(self, Bitmap bmp, Rect rect) -> AlphaPixelData + __init__(self, Bitmap bmp, Point pt, Size sz) -> AlphaPixelData + """ + _gdi_.AlphaPixelData_swiginit(self,_gdi_.new_AlphaPixelData(*args)) + self.UseAlpha() + + __swig_destroy__ = _gdi_.delete_AlphaPixelData + __del__ = lambda self : None; + def GetPixels(*args, **kwargs): + """GetPixels(self) -> AlphaPixelData_Accessor""" + return _gdi_.AlphaPixelData_GetPixels(*args, **kwargs) + + def UseAlpha(*args, **kwargs): + """UseAlpha(self)""" + return _gdi_.AlphaPixelData_UseAlpha(*args, **kwargs) + + def __nonzero__(*args, **kwargs): + """__nonzero__(self) -> bool""" + return _gdi_.AlphaPixelData___nonzero__(*args, **kwargs) + + def __iter__(self): + """ + Create and return an iterator object for this pixel data + object. (It's really a generator but I won't tell if you + don't tell.) + """ + width = self.GetWidth() + height = self.GetHeight() + pixels = self.GetPixels() + + + + + class PixelFacade(object): + def Get(self): + return pixels.Get() + def Set(self, *args, **kw): + return pixels.Set(*args, **kw) + def __str__(self): + return str(self.Get()) + def __repr__(self): + return 'pixel(%d,%d): %s' % (x,y,self.Get()) + X = property(lambda self: x) + Y = property(lambda self: y) + + pf = PixelFacade() + for y in xrange(height): + for x in xrange(width): + + + + yield pf + pixels.nextPixel() + pixels.MoveTo(self, 0, y) + + Pixels = property(GetPixels,doc="See `GetPixels`") +_gdi_.AlphaPixelData_swigregister(AlphaPixelData) + +class AlphaPixelData_Accessor(object): + """Proxy of C++ AlphaPixelData_Accessor class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args): + """ + __init__(self, AlphaPixelData data) -> AlphaPixelData_Accessor + __init__(self, Bitmap bmp, AlphaPixelData data) -> AlphaPixelData_Accessor + __init__(self) -> AlphaPixelData_Accessor + """ + _gdi_.AlphaPixelData_Accessor_swiginit(self,_gdi_.new_AlphaPixelData_Accessor(*args)) + __swig_destroy__ = _gdi_.delete_AlphaPixelData_Accessor + __del__ = lambda self : None; + def Reset(*args, **kwargs): + """Reset(self, AlphaPixelData data)""" + return _gdi_.AlphaPixelData_Accessor_Reset(*args, **kwargs) + + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.AlphaPixelData_Accessor_IsOk(*args, **kwargs) + + def nextPixel(*args, **kwargs): + """nextPixel(self)""" + return _gdi_.AlphaPixelData_Accessor_nextPixel(*args, **kwargs) + + def Offset(*args, **kwargs): + """Offset(self, AlphaPixelData data, int x, int y)""" + return _gdi_.AlphaPixelData_Accessor_Offset(*args, **kwargs) + + def OffsetX(*args, **kwargs): + """OffsetX(self, AlphaPixelData data, int x)""" + return _gdi_.AlphaPixelData_Accessor_OffsetX(*args, **kwargs) + + def OffsetY(*args, **kwargs): + """OffsetY(self, AlphaPixelData data, int y)""" + return _gdi_.AlphaPixelData_Accessor_OffsetY(*args, **kwargs) + + def MoveTo(*args, **kwargs): + """MoveTo(self, AlphaPixelData data, int x, int y)""" + return _gdi_.AlphaPixelData_Accessor_MoveTo(*args, **kwargs) + + def Set(*args, **kwargs): + """Set(self, byte red, byte green, byte blue, byte alpha)""" + return _gdi_.AlphaPixelData_Accessor_Set(*args, **kwargs) + + def Get(*args, **kwargs): + """Get(self) -> PyObject""" + return _gdi_.AlphaPixelData_Accessor_Get(*args, **kwargs) + +_gdi_.AlphaPixelData_Accessor_swigregister(AlphaPixelData_Accessor) + class Mask(_core.Object): """ This class encapsulates a monochrome mask bitmap, where the masked @@ -780,10 +1143,11 @@ class Icon(GDIObject): """SetHandle(self, long handle)""" return _gdi_.Icon_SetHandle(*args, **kwargs) - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _gdi_.Icon_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.Icon_IsOk(*args, **kwargs) + Ok = IsOk def GetWidth(*args, **kwargs): """GetWidth(self) -> int""" return _gdi_.Icon_GetWidth(*args, **kwargs) @@ -816,7 +1180,10 @@ class Icon(GDIObject): """CopyFromBitmap(self, Bitmap bmp)""" return _gdi_.Icon_CopyFromBitmap(*args, **kwargs) - def __nonzero__(self): return self.Ok() + def __nonzero__(self): return self.IsOk() + Depth = property(GetDepth,SetDepth,doc="See `GetDepth` and `SetDepth`") + Height = property(GetHeight,SetHeight,doc="See `GetHeight` and `SetHeight`") + Width = property(GetWidth,SetWidth,doc="See `GetWidth` and `SetWidth`") _gdi_.Icon_swigregister(Icon) def EmptyIcon(*args, **kwargs): @@ -852,7 +1219,7 @@ class IconLocation(object): """IsOk(self) -> bool""" return _gdi_.IconLocation_IsOk(*args, **kwargs) - def __nonzero__(self): return self.Ok() + def __nonzero__(self): return self.IsOk() def SetFileName(*args, **kwargs): """SetFileName(self, String filename)""" return _gdi_.IconLocation_SetFileName(*args, **kwargs) @@ -869,6 +1236,8 @@ class IconLocation(object): """GetIndex(self) -> int""" return _gdi_.IconLocation_GetIndex(*args, **kwargs) + FileName = property(GetFileName,SetFileName,doc="See `GetFileName` and `SetFileName`") + Index = property(GetIndex,SetIndex,doc="See `GetIndex` and `SetIndex`") _gdi_.IconLocation_swigregister(IconLocation) class IconBundle(object): @@ -892,6 +1261,7 @@ class IconBundle(object): """GetIcon(self, Size size) -> Icon""" return _gdi_.IconBundle_GetIcon(*args, **kwargs) + Icon = property(GetIcon,doc="See `GetIcon`") _gdi_.IconBundle_swigregister(IconBundle) def IconBundleFromFile(*args, **kwargs): @@ -945,11 +1315,12 @@ class Cursor(GDIObject): """ return _gdi_.Cursor_SetHandle(*args, **kwargs) - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _gdi_.Cursor_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.Cursor_IsOk(*args, **kwargs) - def __nonzero__(self): return self.Ok() + Ok = IsOk + def __nonzero__(self): return self.IsOk() def GetWidth(*args, **kwargs): """GetWidth(self) -> int""" return _gdi_.Cursor_GetWidth(*args, **kwargs) @@ -1058,6 +1429,10 @@ class Region(GDIObject): """IsEmpty(self) -> bool""" return _gdi_.Region_IsEmpty(*args, **kwargs) + def IsEqual(*args, **kwargs): + """IsEqual(self, Region region) -> bool""" + return _gdi_.Region_IsEqual(*args, **kwargs) + def Union(*args, **kwargs): """Union(self, int x, int y, int width, int height) -> bool""" return _gdi_.Region_Union(*args, **kwargs) @@ -1106,6 +1481,7 @@ class Region(GDIObject): """UnionBitmapColour(self, Bitmap bmp, Colour transColour, int tolerance=0) -> bool""" return _gdi_.Region_UnionBitmapColour(*args, **kwargs) + Box = property(GetBox,doc="See `GetBox`") _gdi_.Region_swigregister(Region) def RegionFromBitmap(*args, **kwargs): @@ -1176,6 +1552,13 @@ class RegionIterator(_core.Object): """__nonzero__(self) -> bool""" return _gdi_.RegionIterator___nonzero__(*args, **kwargs) + H = property(GetH,doc="See `GetH`") + Height = property(GetHeight,doc="See `GetHeight`") + Rect = property(GetRect,doc="See `GetRect`") + W = property(GetW,doc="See `GetW`") + Width = property(GetWidth,doc="See `GetWidth`") + X = property(GetX,doc="See `GetX`") + Y = property(GetY,doc="See `GetY`") _gdi_.RegionIterator_swigregister(RegionIterator) #--------------------------------------------------------------------------- @@ -1407,6 +1790,13 @@ class NativeFontInfo(object): """ToUserString(self) -> String""" return _gdi_.NativeFontInfo_ToUserString(*args, **kwargs) + Encoding = property(GetEncoding,SetEncoding,doc="See `GetEncoding` and `SetEncoding`") + FaceName = property(GetFaceName,SetFaceName,doc="See `GetFaceName` and `SetFaceName`") + Family = property(GetFamily,SetFamily,doc="See `GetFamily` and `SetFamily`") + PointSize = property(GetPointSize,SetPointSize,doc="See `GetPointSize` and `SetPointSize`") + Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`") + Underlined = property(GetUnderlined,SetUnderlined,doc="See `GetUnderlined` and `SetUnderlined`") + Weight = property(GetWeight,SetWeight,doc="See `GetWeight` and `SetWeight`") _gdi_.NativeFontInfo_swigregister(NativeFontInfo) class NativeEncodingInfo(object): @@ -1513,6 +1903,7 @@ class FontMapper(object): """SetDialogTitle(self, String title)""" return _gdi_.FontMapper_SetDialogTitle(*args, **kwargs) + AltForEncoding = property(GetAltForEncoding,doc="See `GetAltForEncoding`") _gdi_.FontMapper_swigregister(FontMapper) def FontMapper_Get(*args): @@ -1598,15 +1989,16 @@ class Font(GDIObject): _gdi_.Font_swiginit(self,_gdi_.new_Font(*args, **kwargs)) __swig_destroy__ = _gdi_.delete_Font __del__ = lambda self : None; - def Ok(*args, **kwargs): + def IsOk(*args, **kwargs): """ - Ok(self) -> bool + IsOk(self) -> bool Returns ``True`` if this font was successfully created. """ - return _gdi_.Font_Ok(*args, **kwargs) + return _gdi_.Font_IsOk(*args, **kwargs) - def __nonzero__(self): return self.Ok() + Ok = IsOk + def __nonzero__(self): return self.IsOk() def __eq__(*args, **kwargs): """__eq__(self, Font other) -> bool""" return _gdi_.Font___eq__(*args, **kwargs) @@ -1873,6 +2265,21 @@ class Font(GDIObject): return _gdi_.Font_SetDefaultEncoding(*args, **kwargs) SetDefaultEncoding = staticmethod(SetDefaultEncoding) + Encoding = property(GetEncoding,SetEncoding,doc="See `GetEncoding` and `SetEncoding`") + FaceName = property(GetFaceName,SetFaceName,doc="See `GetFaceName` and `SetFaceName`") + Family = property(GetFamily,SetFamily,doc="See `GetFamily` and `SetFamily`") + FamilyString = property(GetFamilyString,doc="See `GetFamilyString`") + NativeFontInfo = property(GetNativeFontInfo,SetNativeFontInfo,doc="See `GetNativeFontInfo` and `SetNativeFontInfo`") + NativeFontInfoDesc = property(GetNativeFontInfoDesc,doc="See `GetNativeFontInfoDesc`") + NativeFontInfoUserDesc = property(GetNativeFontInfoUserDesc,SetNativeFontInfoUserDesc,doc="See `GetNativeFontInfoUserDesc` and `SetNativeFontInfoUserDesc`") + NoAntiAliasing = property(GetNoAntiAliasing,SetNoAntiAliasing,doc="See `GetNoAntiAliasing` and `SetNoAntiAliasing`") + PixelSize = property(GetPixelSize,SetPixelSize,doc="See `GetPixelSize` and `SetPixelSize`") + PointSize = property(GetPointSize,SetPointSize,doc="See `GetPointSize` and `SetPointSize`") + Style = property(GetStyle,SetStyle,doc="See `GetStyle` and `SetStyle`") + StyleString = property(GetStyleString,doc="See `GetStyleString`") + Underlined = property(GetUnderlined,SetUnderlined,doc="See `GetUnderlined` and `SetUnderlined`") + Weight = property(GetWeight,SetWeight,doc="See `GetWeight` and `SetWeight`") + WeightString = property(GetWeightString,doc="See `GetWeightString`") _gdi_.Font_swigregister(Font) def FontFromNativeInfo(*args, **kwargs): @@ -2360,6 +2767,11 @@ class Locale(object): """AddCatalog(self, String szDomain) -> bool""" return _gdi_.Locale_AddCatalog(*args, **kwargs) + def IsAvailable(*args, **kwargs): + """IsAvailable(int lang) -> bool""" + return _gdi_.Locale_IsAvailable(*args, **kwargs) + + IsAvailable = staticmethod(IsAvailable) def IsLoaded(*args, **kwargs): """IsLoaded(self, String szDomain) -> bool""" return _gdi_.Locale_IsLoaded(*args, **kwargs) @@ -2392,6 +2804,12 @@ class Locale(object): """GetName(self) -> String""" return _gdi_.Locale_GetName(*args, **kwargs) + CanonicalName = property(GetCanonicalName,doc="See `GetCanonicalName`") + Language = property(GetLanguage,doc="See `GetLanguage`") + Locale = property(GetLocale,doc="See `GetLocale`") + Name = property(GetName,doc="See `GetName`") + String = property(GetString,doc="See `GetString`") + SysName = property(GetSysName,doc="See `GetSysName`") _gdi_.Locale_swigregister(Locale) def Locale_GetSystemLanguage(*args): @@ -2410,6 +2828,10 @@ def Locale_AddCatalogLookupPathPrefix(*args, **kwargs): """Locale_AddCatalogLookupPathPrefix(String prefix)""" return _gdi_.Locale_AddCatalogLookupPathPrefix(*args, **kwargs) +def Locale_IsAvailable(*args, **kwargs): + """Locale_IsAvailable(int lang) -> bool""" + return _gdi_.Locale_IsAvailable(*args, **kwargs) + def Locale_GetLanguageInfo(*args, **kwargs): """Locale_GetLanguageInfo(int lang) -> LanguageInfo""" return _gdi_.Locale_GetLanguageInfo(*args, **kwargs) @@ -2426,6 +2848,34 @@ def Locale_AddLanguage(*args, **kwargs): """Locale_AddLanguage(LanguageInfo info)""" return _gdi_.Locale_AddLanguage(*args, **kwargs) +class PyLocale(Locale): + """Proxy of C++ PyLocale class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """__init__(self, int language=-1, int flags=wxLOCALE_LOAD_DEFAULT|wxLOCALE_CONV_ENCODING) -> PyLocale""" + _gdi_.PyLocale_swiginit(self,_gdi_.new_PyLocale(*args, **kwargs)) + self._setCallbackInfo(self, PyLocale) + + __swig_destroy__ = _gdi_.delete_PyLocale + __del__ = lambda self : None; + def _setCallbackInfo(*args, **kwargs): + """_setCallbackInfo(self, PyObject self, PyObject _class)""" + return _gdi_.PyLocale__setCallbackInfo(*args, **kwargs) + + def GetSingularString(*args, **kwargs): + """GetSingularString(self, wxChar szOrigString, wxChar szDomain=None) -> wxChar""" + return _gdi_.PyLocale_GetSingularString(*args, **kwargs) + + def GetPluralString(*args, **kwargs): + """ + GetPluralString(self, wxChar szOrigString, wxChar szOrigString2, size_t n, + wxChar szDomain=None) -> wxChar + """ + return _gdi_.PyLocale_GetPluralString(*args, **kwargs) + +_gdi_.PyLocale_swigregister(PyLocale) + def GetLocale(*args): """GetLocale() -> Locale""" @@ -2477,7 +2927,9 @@ _gdi_.EncodingConverter_swigregister(EncodingConverter) def GetTranslation(*args): """ GetTranslation(String str) -> String + GetTranslation(String str, String domain) -> String GetTranslation(String str, String strPlural, size_t n) -> String + GetTranslation(String str, String strPlural, size_t n, String domain) -> String """ return _gdi_.GetTranslation(*args) @@ -3296,9 +3748,9 @@ class DC(_core.Object): def GetMultiLineTextExtent(*args, **kwargs): """ GetMultiLineTextExtent(wxString string, Font font=None) -> - (width, height, descent, externalLeading) + (width, height, lineHeight) - Get the width, height, decent and leading of the text using the + Get the width, height, and line height of the text using the current or specified font. Works for single as well as multi-line strings. """ @@ -3465,18 +3917,19 @@ class DC(_core.Object): """ GetPPI(self) -> Size - Resolution in Pixels per inch + Resolution in pixels per inch """ return _gdi_.DC_GetPPI(*args, **kwargs) - def Ok(*args, **kwargs): + def IsOk(*args, **kwargs): """ - Ok(self) -> bool + IsOk(self) -> bool Returns true if the DC is ok to use. """ - return _gdi_.DC_Ok(*args, **kwargs) + return _gdi_.DC_IsOk(*args, **kwargs) + Ok = IsOk def GetBackgroundMode(*args, **kwargs): """ GetBackgroundMode(self) -> int @@ -3779,7 +4232,27 @@ class DC(_core.Object): """ return _gdi_.DC_GetBoundingBox(*args, **kwargs) - def __nonzero__(self): return self.Ok() + def __nonzero__(self): return self.IsOk() + def GetLayoutDirection(*args, **kwargs): + """ + GetLayoutDirection(self) -> int + + Get the layout direction (LTR or RTL)_ for this dc. On platforms + where RTL layout is supported, the return value will either be + ``wx.Layout_LeftToRight`` or ``wx.Layout_RightToLeft``. + ``wx.Layout_Default`` is returned if layout direction is not + supported. + """ + return _gdi_.DC_GetLayoutDirection(*args, **kwargs) + + def SetLayoutDirection(*args, **kwargs): + """ + SetLayoutDirection(self, int dir) + + Change the layout direction for this dc. + """ + return _gdi_.DC_SetLayoutDirection(*args, **kwargs) + def GetHDC(*args, **kwargs): """GetHDC(self) -> long""" return _gdi_.DC_GetHDC(*args, **kwargs) @@ -3969,6 +4442,36 @@ class DC(_core.Object): raise ValueError('backgrounds and coords must have same length') return self._DrawTextList(textList, coords, foregrounds, backgrounds) + Background = property(GetBackground,SetBackground,doc="See `GetBackground` and `SetBackground`") + BackgroundMode = property(GetBackgroundMode,SetBackgroundMode,doc="See `GetBackgroundMode` and `SetBackgroundMode`") + BoundingBox = property(GetBoundingBox,doc="See `GetBoundingBox`") + Brush = property(GetBrush,SetBrush,doc="See `GetBrush` and `SetBrush`") + CharHeight = property(GetCharHeight,doc="See `GetCharHeight`") + CharWidth = property(GetCharWidth,doc="See `GetCharWidth`") + ClippingBox = property(GetClippingBox,doc="See `GetClippingBox`") + ClippingRect = property(GetClippingRect,SetClippingRect,doc="See `GetClippingRect` and `SetClippingRect`") + Depth = property(GetDepth,doc="See `GetDepth`") + DeviceOrigin = property(GetDeviceOrigin,SetDeviceOrigin,doc="See `GetDeviceOrigin` and `SetDeviceOrigin`") + Font = property(GetFont,SetFont,doc="See `GetFont` and `SetFont`") + FullTextExtent = property(GetFullTextExtent,doc="See `GetFullTextExtent`") + LogicalFunction = property(GetLogicalFunction,SetLogicalFunction,doc="See `GetLogicalFunction` and `SetLogicalFunction`") + LogicalOrigin = property(GetLogicalOrigin,SetLogicalOrigin,doc="See `GetLogicalOrigin` and `SetLogicalOrigin`") + LogicalScale = property(GetLogicalScale,SetLogicalScale,doc="See `GetLogicalScale` and `SetLogicalScale`") + MapMode = property(GetMapMode,SetMapMode,doc="See `GetMapMode` and `SetMapMode`") + MultiLineTextExtent = property(GetMultiLineTextExtent,doc="See `GetMultiLineTextExtent`") + Optimization = property(GetOptimization,SetOptimization,doc="See `GetOptimization` and `SetOptimization`") + PPI = property(GetPPI,doc="See `GetPPI`") + PartialTextExtents = property(GetPartialTextExtents,doc="See `GetPartialTextExtents`") + Pen = property(GetPen,SetPen,doc="See `GetPen` and `SetPen`") + Pixel = property(GetPixel,doc="See `GetPixel`") + PixelPoint = property(GetPixelPoint,doc="See `GetPixelPoint`") + Size = property(GetSize,doc="See `GetSize`") + SizeMM = property(GetSizeMM,doc="See `GetSizeMM`") + TextBackground = property(GetTextBackground,SetTextBackground,doc="See `GetTextBackground` and `SetTextBackground`") + TextExtent = property(GetTextExtent,doc="See `GetTextExtent`") + TextForeground = property(GetTextForeground,SetTextForeground,doc="See `GetTextForeground` and `SetTextForeground`") + UserScale = property(GetUserScale,SetUserScale,doc="See `GetUserScale` and `SetUserScale`") + LayoutDirection = property(GetLayoutDirection,SetLayoutDirection) _gdi_.DC_swigregister(DC) #--------------------------------------------------------------------------- @@ -3981,7 +4484,7 @@ class MemoryDC(DC): dc = wx.MemoryDC() dc.SelectObject(bitmap) - # draw on the dc usign any of the Draw methods + # draw on the dc using any of the Draw methods dc.SelectObject(wx.NullBitmap) # the bitmap now contains wahtever was drawn upon it @@ -3993,13 +4496,14 @@ class MemoryDC(DC): __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self) -> MemoryDC + __init__(self, Bitmap bitmap=NullBitmap) -> MemoryDC Constructs a new memory device context. Use the Ok member to test whether the constructor was successful in - creating a usable device context. Don't forget to select a bitmap into - the DC before drawing on it. + creating a usable device context. If a bitmap is not given to this + constructor then don't forget to select a bitmap into the DC before + drawing on it. """ _gdi_.MemoryDC_swiginit(self,_gdi_.new_MemoryDC(*args, **kwargs)) def SelectObject(*args, **kwargs): @@ -4031,88 +4535,6 @@ def MemoryDCFromDC(*args, **kwargs): #--------------------------------------------------------------------------- -BUFFER_VIRTUAL_AREA = _gdi_.BUFFER_VIRTUAL_AREA -BUFFER_CLIENT_AREA = _gdi_.BUFFER_CLIENT_AREA -class BufferedDC(MemoryDC): - """ - This simple class provides a simple way to avoid flicker: when drawing - on it, everything is in fact first drawn on an in-memory buffer (a - `wx.Bitmap`) and then copied to the screen only once, when this object - is destroyed. - - It can be used in the same way as any other device - context. wx.BufferedDC itself typically replaces `wx.ClientDC`, if you - want to use it in your EVT_PAINT handler, you should look at - `wx.BufferedPaintDC`. - - """ - thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') - __repr__ = _swig_repr - def __init__(self, *args): - """ - __init__(self, DC dc, Bitmap buffer=NullBitmap, int style=BUFFER_CLIENT_AREA) -> BufferedDC - __init__(self, DC dc, Size area, int style=BUFFER_CLIENT_AREA) -> BufferedDC - - Constructs a buffered DC. - """ - _gdi_.BufferedDC_swiginit(self,_gdi_.new_BufferedDC(*args)) - self.__dc = args[0] # save a ref so the other dc will not be deleted before self - - __swig_destroy__ = _gdi_.delete_BufferedDC - __del__ = lambda self : None; - def UnMask(*args, **kwargs): - """ - UnMask(self) - - Blits the buffer to the dc, and detaches the dc from the buffer (so it - can be effectively used once only). This is usually only called in - the destructor. - """ - return _gdi_.BufferedDC_UnMask(*args, **kwargs) - -_gdi_.BufferedDC_swigregister(BufferedDC) - -class BufferedPaintDC(BufferedDC): - """ - This is a subclass of `wx.BufferedDC` which can be used inside of an - EVT_PAINT event handler. Just create an object of this class instead - of `wx.PaintDC` and that's all you have to do to (mostly) avoid - flicker. The only thing to watch out for is that if you are using this - class together with `wx.ScrolledWindow`, you probably do **not** want - to call `wx.Window.PrepareDC` on it as it already does this internally - for the real underlying `wx.PaintDC`. - - If your window is already fully buffered in a `wx.Bitmap` then your - EVT_PAINT handler can be as simple as just creating a - ``wx.BufferedPaintDC`` as it will `Blit` the buffer to the window - automatically when it is destroyed. For example:: - - def OnPaint(self, event): - dc = wx.BufferedPaintDC(self, self.buffer) - - - - - - """ - thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') - __repr__ = _swig_repr - def __init__(self, *args, **kwargs): - """ - __init__(self, Window window, Bitmap buffer=NullBitmap, int style=BUFFER_CLIENT_AREA) -> BufferedPaintDC - - Create a buffered paint DC. As with `wx.BufferedDC`, you may either - provide the bitmap to be used for buffering or let this object create - one internally (in the latter case, the size of the client part of the - window is automatically used). - - - """ - _gdi_.BufferedPaintDC_swiginit(self,_gdi_.new_BufferedPaintDC(*args, **kwargs)) -_gdi_.BufferedPaintDC_swigregister(BufferedPaintDC) - -#--------------------------------------------------------------------------- - class ScreenDC(DC): """ A wxScreenDC can be used to paint anywhere on the screen. This should @@ -4177,17 +4599,37 @@ _gdi_.ScreenDC_swigregister(ScreenDC) #--------------------------------------------------------------------------- -class ClientDC(DC): +class WindowDC(DC): """ - A wx.ClientDC must be constructed if an application wishes to paint on - the client area of a window from outside an EVT_PAINT event. This should + A wx.WindowDC must be constructed if an application wishes to paint on + the whole area of a window (client and decorations). This should normally be constructed as a temporary stack object; don't store a - wx.ClientDC object long term. - - To draw on a window from within an EVT_PAINT handler, construct a - `wx.PaintDC` object. - - To draw on the whole window including decorations, construct a + wx.WindowDC object. + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, Window win) -> WindowDC + + Constructor. Pass the window on which you wish to paint. + """ + _gdi_.WindowDC_swiginit(self,_gdi_.new_WindowDC(*args, **kwargs)) +_gdi_.WindowDC_swigregister(WindowDC) + +#--------------------------------------------------------------------------- + +class ClientDC(WindowDC): + """ + A wx.ClientDC must be constructed if an application wishes to paint on + the client area of a window from outside an EVT_PAINT event. This should + normally be constructed as a temporary stack object; don't store a + wx.ClientDC object long term. + + To draw on a window from within an EVT_PAINT handler, construct a + `wx.PaintDC` object. + + To draw on the whole window including decorations, construct a `wx.WindowDC` object (Windows only). """ @@ -4204,7 +4646,7 @@ _gdi_.ClientDC_swigregister(ClientDC) #--------------------------------------------------------------------------- -class PaintDC(DC): +class PaintDC(ClientDC): """ A wx.PaintDC must be constructed if an application wishes to paint on the client area of a window from within an EVT_PAINT event @@ -4234,24 +4676,123 @@ _gdi_.PaintDC_swigregister(PaintDC) #--------------------------------------------------------------------------- -class WindowDC(DC): +BUFFER_VIRTUAL_AREA = _gdi_.BUFFER_VIRTUAL_AREA +BUFFER_CLIENT_AREA = _gdi_.BUFFER_CLIENT_AREA +class BufferedDC(MemoryDC): """ - A wx.WindowDC must be constructed if an application wishes to paint on - the whole area of a window (client and decorations). This should - normally be constructed as a temporary stack object; don't store a - wx.WindowDC object. + This simple class provides a simple way to avoid flicker: when drawing + on it, everything is in fact first drawn on an in-memory buffer (a + `wx.Bitmap`) and then copied to the screen only once, when this object + is destroyed. + + It can be used in the same way as any other device context. + wx.BufferedDC itself typically replaces `wx.ClientDC`, if you want to + use it in your EVT_PAINT handler, you should look at + `wx.BufferedPaintDC`. + + Please note that GTK+ 2.0 and OS X provide double buffering themselves + natively. wxBufferedDC is aware of this however, and will bypass the buffering + unless an explicit buffer bitmap is given. + + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args): + """ + __init__(self, DC dc, Bitmap buffer=NullBitmap, int style=BUFFER_CLIENT_AREA) -> BufferedDC + __init__(self, DC dc, Size area, int style=BUFFER_CLIENT_AREA) -> BufferedDC + + Constructs a buffered DC. + """ + _gdi_.BufferedDC_swiginit(self,_gdi_.new_BufferedDC(*args)) + self.__dc = args[0] # save a ref so the other dc will not be deleted before self + + __swig_destroy__ = _gdi_.delete_BufferedDC + __del__ = lambda self : None; + def UnMask(*args, **kwargs): + """ + UnMask(self) + + Blits the buffer to the dc, and detaches the dc from the buffer (so it + can be effectively used once only). This is usually only called in + the destructor. + """ + return _gdi_.BufferedDC_UnMask(*args, **kwargs) + +_gdi_.BufferedDC_swigregister(BufferedDC) + +class BufferedPaintDC(BufferedDC): + """ + This is a subclass of `wx.BufferedDC` which can be used inside of an + EVT_PAINT event handler. Just create an object of this class instead + of `wx.PaintDC` and that's all you have to do to (mostly) avoid + flicker. The only thing to watch out for is that if you are using this + class together with `wx.ScrolledWindow`, you probably do **not** want + to call `wx.Window.PrepareDC` on it as it already does this internally + for the real underlying `wx.PaintDC`. + + If your window is already fully buffered in a `wx.Bitmap` then your + EVT_PAINT handler can be as simple as just creating a + ``wx.BufferedPaintDC`` as it will `Blit` the buffer to the window + automatically when it is destroyed. For example:: + + def OnPaint(self, event): + dc = wx.BufferedPaintDC(self, self.buffer) + + + """ thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') __repr__ = _swig_repr def __init__(self, *args, **kwargs): """ - __init__(self, Window win) -> WindowDC + __init__(self, Window window, Bitmap buffer=NullBitmap, int style=BUFFER_CLIENT_AREA) -> BufferedPaintDC - Constructor. Pass the window on which you wish to paint. + Create a buffered paint DC. As with `wx.BufferedDC`, you may either + provide the bitmap to be used for buffering or let this object create + one internally (in the latter case, the size of the client part of the + window is automatically used). """ - _gdi_.WindowDC_swiginit(self,_gdi_.new_WindowDC(*args, **kwargs)) -_gdi_.WindowDC_swigregister(WindowDC) + _gdi_.BufferedPaintDC_swiginit(self,_gdi_.new_BufferedPaintDC(*args, **kwargs)) +_gdi_.BufferedPaintDC_swigregister(BufferedPaintDC) + +#--------------------------------------------------------------------------- + +class AutoBufferedPaintDC(DC): + """ + If the current platform double buffers by default then this DC is the + same as a plain `wx.PaintDC`, otherwise it is a `wx.BufferedPaintDC`. + + :see: `wx.AutoBufferedPaintDCFactory` + + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self, Window win) -> AutoBufferedPaintDC + + If the current platform double buffers by default then this DC is the + same as a plain `wx.PaintDC`, otherwise it is a `wx.BufferedPaintDC`. + + :see: `wx.AutoBufferedPaintDCFactory` + """ + _gdi_.AutoBufferedPaintDC_swiginit(self,_gdi_.new_AutoBufferedPaintDC(*args, **kwargs)) +_gdi_.AutoBufferedPaintDC_swigregister(AutoBufferedPaintDC) + + +def AutoBufferedPaintDCFactory(*args, **kwargs): + """ + AutoBufferedPaintDCFactory(Window window) -> DC + + Checks if the window is natively double buffered and will return a + `wx.PaintDC` if it is, a `wx.BufferedPaintDC` otherwise. The advantage of + this function over `wx.AutoBufferedPaintDC` is that this function will check + if the the specified window has double-buffering enabled rather than just + going by platform defaults. + """ + return _gdi_.AutoBufferedPaintDCFactory(*args, **kwargs) #--------------------------------------------------------------------------- class MirrorDC(DC): @@ -4317,6 +4858,7 @@ class PostScriptDC(DC): return _gdi_.PostScriptDC_GetResolution(*args, **kwargs) GetResolution = staticmethod(GetResolution) + PrintData = property(GetPrintData,SetPrintData,doc="See `GetPrintData` and `SetPrintData`") _gdi_.PostScriptDC_swigregister(PostScriptDC) def PostScriptDC_SetResolution(*args, **kwargs): @@ -4347,10 +4889,11 @@ class MetaFile(_core.Object): _gdi_.MetaFile_swiginit(self,_gdi_.new_MetaFile(*args, **kwargs)) __swig_destroy__ = _gdi_.delete_MetaFile __del__ = lambda self : None; - def Ok(*args, **kwargs): - """Ok(self) -> bool""" - return _gdi_.MetaFile_Ok(*args, **kwargs) + def IsOk(*args, **kwargs): + """IsOk(self) -> bool""" + return _gdi_.MetaFile_IsOk(*args, **kwargs) + Ok = IsOk def SetClipboard(*args, **kwargs): """SetClipboard(self, int width=0, int height=0) -> bool""" return _gdi_.MetaFile_SetClipboard(*args, **kwargs) @@ -4371,7 +4914,7 @@ class MetaFile(_core.Object): """GetFileName(self) -> String""" return _gdi_.MetaFile_GetFileName(*args, **kwargs) - def __nonzero__(self): return self.Ok() + def __nonzero__(self): return self.IsOk() _gdi_.MetaFile_swigregister(MetaFile) class MetaFileDC(DC): @@ -4401,135 +4944,457 @@ _gdi_.PrinterDC_swigregister(PrinterDC) #--------------------------------------------------------------------------- -IMAGELIST_DRAW_NORMAL = _gdi_.IMAGELIST_DRAW_NORMAL -IMAGELIST_DRAW_TRANSPARENT = _gdi_.IMAGELIST_DRAW_TRANSPARENT -IMAGELIST_DRAW_SELECTED = _gdi_.IMAGELIST_DRAW_SELECTED -IMAGELIST_DRAW_FOCUSED = _gdi_.IMAGELIST_DRAW_FOCUSED -IMAGE_LIST_NORMAL = _gdi_.IMAGE_LIST_NORMAL -IMAGE_LIST_SMALL = _gdi_.IMAGE_LIST_SMALL -IMAGE_LIST_STATE = _gdi_.IMAGE_LIST_STATE -class ImageList(_core.Object): - """Proxy of C++ ImageList class""" +class GraphicsPath(object): + """Proxy of C++ GraphicsPath class""" thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + def __init__(self): raise AttributeError, "No constructor defined" __repr__ = _swig_repr - def __init__(self, *args, **kwargs): - """__init__(self, int width, int height, int mask=True, int initialCount=1) -> ImageList""" - _gdi_.ImageList_swiginit(self,_gdi_.new_ImageList(*args, **kwargs)) - __swig_destroy__ = _gdi_.delete_ImageList + __swig_destroy__ = _gdi_.delete_GraphicsPath __del__ = lambda self : None; - def Add(*args, **kwargs): - """Add(self, Bitmap bitmap, Bitmap mask=NullBitmap) -> int""" - return _gdi_.ImageList_Add(*args, **kwargs) + def MoveToPoint(*args, **kwargs): + """ + MoveToPoint(self, Double x, Double y) - def AddWithColourMask(*args, **kwargs): - """AddWithColourMask(self, Bitmap bitmap, Colour maskColour) -> int""" - return _gdi_.ImageList_AddWithColourMask(*args, **kwargs) + Begins a new subpath at (x,y) + """ + return _gdi_.GraphicsPath_MoveToPoint(*args, **kwargs) - def AddIcon(*args, **kwargs): - """AddIcon(self, Icon icon) -> int""" - return _gdi_.ImageList_AddIcon(*args, **kwargs) + def AddLineToPoint(*args, **kwargs): + """ + AddLineToPoint(self, Double x, Double y) - def GetBitmap(*args, **kwargs): - """GetBitmap(self, int index) -> Bitmap""" - return _gdi_.ImageList_GetBitmap(*args, **kwargs) + Adds a straight line from the current point to (x,y) + """ + return _gdi_.GraphicsPath_AddLineToPoint(*args, **kwargs) - def GetIcon(*args, **kwargs): - """GetIcon(self, int index) -> Icon""" - return _gdi_.ImageList_GetIcon(*args, **kwargs) + def AddCurveToPoint(*args, **kwargs): + """ + AddCurveToPoint(self, Double cx1, Double cy1, Double cx2, Double cy2, Double x, + Double y) - def Replace(*args, **kwargs): - """Replace(self, int index, Bitmap bitmap, Bitmap mask=NullBitmap) -> bool""" - return _gdi_.ImageList_Replace(*args, **kwargs) + Adds a cubic Bezier curve from the current point, using two control + points and an end point + """ + return _gdi_.GraphicsPath_AddCurveToPoint(*args, **kwargs) - def Draw(*args, **kwargs): + def CloseSubpath(*args, **kwargs): """ - Draw(self, int index, DC dc, int x, int x, int flags=IMAGELIST_DRAW_NORMAL, - bool solidBackground=False) -> bool + CloseSubpath(self) + + closes the current sub-path """ - return _gdi_.ImageList_Draw(*args, **kwargs) + return _gdi_.GraphicsPath_CloseSubpath(*args, **kwargs) - def GetImageCount(*args, **kwargs): - """GetImageCount(self) -> int""" - return _gdi_.ImageList_GetImageCount(*args, **kwargs) + def GetCurrentPoint(*args, **kwargs): + """ + GetCurrentPoint(self) -> Point2D - def Remove(*args, **kwargs): - """Remove(self, int index) -> bool""" - return _gdi_.ImageList_Remove(*args, **kwargs) + Gets the last point of the current path, (0,0) if not yet set + """ + return _gdi_.GraphicsPath_GetCurrentPoint(*args, **kwargs) - def RemoveAll(*args, **kwargs): - """RemoveAll(self) -> bool""" - return _gdi_.ImageList_RemoveAll(*args, **kwargs) + def AddArc(*args, **kwargs): + """ + AddArc(self, Double x, Double y, Double r, Double startAngle, Double endAngle, + bool clockwise) - def GetSize(*args, **kwargs): - """GetSize(index) -> (width,height)""" - return _gdi_.ImageList_GetSize(*args, **kwargs) + Adds an arc of a circle centering at (x,y) with radius (r) from + startAngle to endAngle + """ + return _gdi_.GraphicsPath_AddArc(*args, **kwargs) -_gdi_.ImageList_swigregister(ImageList) + def AddQuadCurveToPoint(*args, **kwargs): + """ + AddQuadCurveToPoint(self, Double cx, Double cy, Double x, Double y) -#--------------------------------------------------------------------------- + Adds a quadratic Bezier curve from the current point, using a control + point and an end point + """ + return _gdi_.GraphicsPath_AddQuadCurveToPoint(*args, **kwargs) -class StockGDI(object): - """Proxy of C++ StockGDI class""" + def AddRectangle(*args, **kwargs): + """ + AddRectangle(self, Double x, Double y, Double w, Double h) + + Appends a rectangle as a new closed subpath + """ + return _gdi_.GraphicsPath_AddRectangle(*args, **kwargs) + + def AddCircle(*args, **kwargs): + """ + AddCircle(self, Double x, Double y, Double r) + + Appends a circle as a new closed subpath with the given radius. + """ + return _gdi_.GraphicsPath_AddCircle(*args, **kwargs) + + def AddArcToPoint(*args, **kwargs): + """ + AddArcToPoint(self, Double x1, Double y1, Double x2, Double y2, Double r) + + Draws a an arc to two tangents connecting (current) to (x1,y1) and (x1,y1) + to (x2,y2), also a straight line from (current) to (x1,y1) + """ + return _gdi_.GraphicsPath_AddArcToPoint(*args, **kwargs) + +_gdi_.GraphicsPath_swigregister(GraphicsPath) + +class GraphicsContext(object): + """Proxy of C++ GraphicsContext class""" thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + def __init__(self): raise AttributeError, "No constructor defined" __repr__ = _swig_repr - BRUSH_BLACK = _gdi_.StockGDI_BRUSH_BLACK - BRUSH_BLUE = _gdi_.StockGDI_BRUSH_BLUE - BRUSH_CYAN = _gdi_.StockGDI_BRUSH_CYAN - BRUSH_GREEN = _gdi_.StockGDI_BRUSH_GREEN - BRUSH_GREY = _gdi_.StockGDI_BRUSH_GREY - BRUSH_LIGHTGREY = _gdi_.StockGDI_BRUSH_LIGHTGREY - BRUSH_MEDIUMGREY = _gdi_.StockGDI_BRUSH_MEDIUMGREY - BRUSH_RED = _gdi_.StockGDI_BRUSH_RED - BRUSH_TRANSPARENT = _gdi_.StockGDI_BRUSH_TRANSPARENT - BRUSH_WHITE = _gdi_.StockGDI_BRUSH_WHITE - COLOUR_BLACK = _gdi_.StockGDI_COLOUR_BLACK - COLOUR_BLUE = _gdi_.StockGDI_COLOUR_BLUE - COLOUR_CYAN = _gdi_.StockGDI_COLOUR_CYAN - COLOUR_GREEN = _gdi_.StockGDI_COLOUR_GREEN - COLOUR_LIGHTGREY = _gdi_.StockGDI_COLOUR_LIGHTGREY - COLOUR_RED = _gdi_.StockGDI_COLOUR_RED - COLOUR_WHITE = _gdi_.StockGDI_COLOUR_WHITE - CURSOR_CROSS = _gdi_.StockGDI_CURSOR_CROSS - CURSOR_HOURGLASS = _gdi_.StockGDI_CURSOR_HOURGLASS - CURSOR_STANDARD = _gdi_.StockGDI_CURSOR_STANDARD - FONT_ITALIC = _gdi_.StockGDI_FONT_ITALIC - FONT_NORMAL = _gdi_.StockGDI_FONT_NORMAL - FONT_SMALL = _gdi_.StockGDI_FONT_SMALL - FONT_SWISS = _gdi_.StockGDI_FONT_SWISS - PEN_BLACK = _gdi_.StockGDI_PEN_BLACK - PEN_BLACKDASHED = _gdi_.StockGDI_PEN_BLACKDASHED - PEN_CYAN = _gdi_.StockGDI_PEN_CYAN - PEN_GREEN = _gdi_.StockGDI_PEN_GREEN - PEN_GREY = _gdi_.StockGDI_PEN_GREY - PEN_LIGHTGREY = _gdi_.StockGDI_PEN_LIGHTGREY - PEN_MEDIUMGREY = _gdi_.StockGDI_PEN_MEDIUMGREY - PEN_RED = _gdi_.StockGDI_PEN_RED - PEN_TRANSPARENT = _gdi_.StockGDI_PEN_TRANSPARENT - PEN_WHITE = _gdi_.StockGDI_PEN_WHITE - ITEMCOUNT = _gdi_.StockGDI_ITEMCOUNT - def __init__(self, *args, **kwargs): - """__init__(self) -> StockGDI""" - _gdi_.StockGDI_swiginit(self,_gdi_.new_StockGDI(*args, **kwargs)) - __swig_destroy__ = _gdi_.delete_StockGDI + __swig_destroy__ = _gdi_.delete_GraphicsContext __del__ = lambda self : None; - def DeleteAll(*args, **kwargs): - """DeleteAll()""" - return _gdi_.StockGDI_DeleteAll(*args, **kwargs) + def Create(*args): + """ + Create(WindowDC dc) -> GraphicsContext + Create(Window window) -> GraphicsContext + """ + return _gdi_.GraphicsContext_Create(*args) - DeleteAll = staticmethod(DeleteAll) - def instance(*args, **kwargs): - """instance() -> StockGDI""" - return _gdi_.StockGDI_instance(*args, **kwargs) + Create = staticmethod(Create) + def CreateFromNative(*args, **kwargs): + """CreateFromNative(void context) -> GraphicsContext""" + return _gdi_.GraphicsContext_CreateFromNative(*args, **kwargs) - instance = staticmethod(instance) - def GetBrush(*args, **kwargs): - """GetBrush(int item) -> Brush""" - return _gdi_.StockGDI_GetBrush(*args, **kwargs) + CreateFromNative = staticmethod(CreateFromNative) + def CreatePath(*args, **kwargs): + """CreatePath(self) -> GraphicsPath""" + return _gdi_.GraphicsContext_CreatePath(*args, **kwargs) - GetBrush = staticmethod(GetBrush) - def GetColour(*args, **kwargs): - """GetColour(int item) -> Colour""" - return _gdi_.StockGDI_GetColour(*args, **kwargs) + def PushState(*args, **kwargs): + """PushState(self)""" + return _gdi_.GraphicsContext_PushState(*args, **kwargs) + + def PopState(*args, **kwargs): + """PopState(self)""" + return _gdi_.GraphicsContext_PopState(*args, **kwargs) + + def ClipRegion(*args, **kwargs): + """ClipRegion(self, Region region)""" + return _gdi_.GraphicsContext_ClipRegion(*args, **kwargs) + + def Clip(*args, **kwargs): + """Clip(self, Double x, Double y, Double w, Double h)""" + return _gdi_.GraphicsContext_Clip(*args, **kwargs) + + def ResetClip(*args, **kwargs): + """ResetClip(self)""" + return _gdi_.GraphicsContext_ResetClip(*args, **kwargs) + + def GetNativeContext(*args, **kwargs): + """GetNativeContext(self) -> void""" + return _gdi_.GraphicsContext_GetNativeContext(*args, **kwargs) + + def Translate(*args, **kwargs): + """Translate(self, Double dx, Double dy)""" + return _gdi_.GraphicsContext_Translate(*args, **kwargs) + + def Scale(*args, **kwargs): + """Scale(self, Double xScale, Double yScale)""" + return _gdi_.GraphicsContext_Scale(*args, **kwargs) + + def Rotate(*args, **kwargs): + """Rotate(self, Double angle)""" + return _gdi_.GraphicsContext_Rotate(*args, **kwargs) + + def SetPen(*args, **kwargs): + """SetPen(self, Pen pen)""" + return _gdi_.GraphicsContext_SetPen(*args, **kwargs) + + def SetBrush(*args, **kwargs): + """SetBrush(self, Brush brush)""" + return _gdi_.GraphicsContext_SetBrush(*args, **kwargs) + + def SetLinearGradientBrush(*args, **kwargs): + """ + SetLinearGradientBrush(self, Double x1, Double y1, Double x2, Double y2, Colour c1, + Colour c2) + """ + return _gdi_.GraphicsContext_SetLinearGradientBrush(*args, **kwargs) + + def SetRadialGradientBrush(*args, **kwargs): + """ + SetRadialGradientBrush(self, Double xo, Double yo, Double xc, Double yc, Double radius, + Colour oColor, Colour cColor) + """ + return _gdi_.GraphicsContext_SetRadialGradientBrush(*args, **kwargs) + + def SetFont(*args, **kwargs): + """SetFont(self, Font font)""" + return _gdi_.GraphicsContext_SetFont(*args, **kwargs) + + def SetTextColor(*args, **kwargs): + """SetTextColor(self, Colour col)""" + return _gdi_.GraphicsContext_SetTextColor(*args, **kwargs) + + def StrokePath(*args, **kwargs): + """StrokePath(self, GraphicsPath path)""" + return _gdi_.GraphicsContext_StrokePath(*args, **kwargs) + + def FillPath(*args, **kwargs): + """FillPath(self, GraphicsPath path, int fillStyle=WINDING_RULE)""" + return _gdi_.GraphicsContext_FillPath(*args, **kwargs) + + def DrawPath(*args, **kwargs): + """DrawPath(self, GraphicsPath path, int fillStyle=WINDING_RULE)""" + return _gdi_.GraphicsContext_DrawPath(*args, **kwargs) + + def DrawText(*args, **kwargs): + """DrawText(self, String str, Double x, Double y)""" + return _gdi_.GraphicsContext_DrawText(*args, **kwargs) + + def DrawRotatedText(*args, **kwargs): + """DrawRotatedText(self, String str, Double x, Double y, Double angle)""" + return _gdi_.GraphicsContext_DrawRotatedText(*args, **kwargs) + + def GetTextExtent(*args, **kwargs): + """GetTextExtend(self, text) --> (width, height, descent, externalLeading)""" + return _gdi_.GraphicsContext_GetTextExtent(*args, **kwargs) + + def GetPartialTextExtents(*args, **kwargs): + """GetPartialTextExtents(self, text) -> [widths]""" + return _gdi_.GraphicsContext_GetPartialTextExtents(*args, **kwargs) + + def DrawBitmap(*args, **kwargs): + """DrawBitmap(self, Bitmap bmp, Double x, Double y, Double w, Double h)""" + return _gdi_.GraphicsContext_DrawBitmap(*args, **kwargs) + + def DrawIcon(*args, **kwargs): + """DrawIcon(self, Icon icon, Double x, Double y, Double w, Double h)""" + return _gdi_.GraphicsContext_DrawIcon(*args, **kwargs) + + def StrokeLine(*args, **kwargs): + """StrokeLine(self, Double x1, Double y1, Double x2, Double y2)""" + return _gdi_.GraphicsContext_StrokeLine(*args, **kwargs) + + def StrokeLines(*args, **kwargs): + """StrokeLines(self, List points)""" + return _gdi_.GraphicsContext_StrokeLines(*args, **kwargs) + + def StrokeLineSegements(*args, **kwargs): + """StrokeLineSegements(self, PyObject beginPoints, PyObject endPoints)""" + return _gdi_.GraphicsContext_StrokeLineSegements(*args, **kwargs) + + def DrawLines(*args, **kwargs): + """DrawLines(self, size_t points, int fillStyle=WINDING_RULE)""" + return _gdi_.GraphicsContext_DrawLines(*args, **kwargs) + + def DrawRectangle(*args, **kwargs): + """DrawRectangle(self, Double x, Double y, Double w, Double h)""" + return _gdi_.GraphicsContext_DrawRectangle(*args, **kwargs) + + def DrawEllipse(*args, **kwargs): + """DrawEllipse(self, Double x, Double y, Double w, Double h)""" + return _gdi_.GraphicsContext_DrawEllipse(*args, **kwargs) + + def DrawRoundedRectangle(*args, **kwargs): + """DrawRoundedRectangle(self, Double x, Double y, Double w, Double h, Double radius)""" + return _gdi_.GraphicsContext_DrawRoundedRectangle(*args, **kwargs) + +_gdi_.GraphicsContext_swigregister(GraphicsContext) + +def GraphicsContext_Create(*args): + """ + Create(WindowDC dc) -> GraphicsContext + GraphicsContext_Create(Window window) -> GraphicsContext + """ + return _gdi_.GraphicsContext_Create(*args) + +def GraphicsContext_CreateFromNative(*args, **kwargs): + """GraphicsContext_CreateFromNative(void context) -> GraphicsContext""" + return _gdi_.GraphicsContext_CreateFromNative(*args, **kwargs) + +class GCDC(DC): + """Proxy of C++ GCDC class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """__init__(self, WindowDC dc) -> GCDC""" + _gdi_.GCDC_swiginit(self,_gdi_.new_GCDC(*args, **kwargs)) + self.__dc = args[0] # save a ref so the other dc will not be deleted before self + + __swig_destroy__ = _gdi_.delete_GCDC + __del__ = lambda self : None; + def GetGraphicsContext(*args, **kwargs): + """GetGraphicsContext(self) -> GraphicsContext""" + return _gdi_.GCDC_GetGraphicsContext(*args, **kwargs) + + def SetGraphicsContext(*args, **kwargs): + """SetGraphicsContext(self, GraphicsContext ctx)""" + return _gdi_.GCDC_SetGraphicsContext(*args, **kwargs) + + GraphicsContext = property(GetGraphicsContext,SetGraphicsContext) +_gdi_.GCDC_swigregister(GCDC) + +class Overlay(object): + """Proxy of C++ Overlay class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """__init__(self) -> Overlay""" + _gdi_.Overlay_swiginit(self,_gdi_.new_Overlay(*args, **kwargs)) + __swig_destroy__ = _gdi_.delete_Overlay + __del__ = lambda self : None; + def Reset(*args, **kwargs): + """Reset(self)""" + return _gdi_.Overlay_Reset(*args, **kwargs) + +_gdi_.Overlay_swigregister(Overlay) + +class DCOverlay(object): + """Proxy of C++ DCOverlay class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args): + """ + __init__(self, Overlay overlay, WindowDC dc, int x, int y, int width, + int height) -> DCOverlay + __init__(self, Overlay overlay, WindowDC dc) -> DCOverlay + """ + _gdi_.DCOverlay_swiginit(self,_gdi_.new_DCOverlay(*args)) + __swig_destroy__ = _gdi_.delete_DCOverlay + __del__ = lambda self : None; + def Clear(*args, **kwargs): + """Clear(self)""" + return _gdi_.DCOverlay_Clear(*args, **kwargs) + +_gdi_.DCOverlay_swigregister(DCOverlay) + +#--------------------------------------------------------------------------- + +IMAGELIST_DRAW_NORMAL = _gdi_.IMAGELIST_DRAW_NORMAL +IMAGELIST_DRAW_TRANSPARENT = _gdi_.IMAGELIST_DRAW_TRANSPARENT +IMAGELIST_DRAW_SELECTED = _gdi_.IMAGELIST_DRAW_SELECTED +IMAGELIST_DRAW_FOCUSED = _gdi_.IMAGELIST_DRAW_FOCUSED +IMAGE_LIST_NORMAL = _gdi_.IMAGE_LIST_NORMAL +IMAGE_LIST_SMALL = _gdi_.IMAGE_LIST_SMALL +IMAGE_LIST_STATE = _gdi_.IMAGE_LIST_STATE +class ImageList(_core.Object): + """Proxy of C++ ImageList class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """__init__(self, int width, int height, int mask=True, int initialCount=1) -> ImageList""" + _gdi_.ImageList_swiginit(self,_gdi_.new_ImageList(*args, **kwargs)) + __swig_destroy__ = _gdi_.delete_ImageList + __del__ = lambda self : None; + def Add(*args, **kwargs): + """Add(self, Bitmap bitmap, Bitmap mask=NullBitmap) -> int""" + return _gdi_.ImageList_Add(*args, **kwargs) + + def AddWithColourMask(*args, **kwargs): + """AddWithColourMask(self, Bitmap bitmap, Colour maskColour) -> int""" + return _gdi_.ImageList_AddWithColourMask(*args, **kwargs) + + def AddIcon(*args, **kwargs): + """AddIcon(self, Icon icon) -> int""" + return _gdi_.ImageList_AddIcon(*args, **kwargs) + + def GetBitmap(*args, **kwargs): + """GetBitmap(self, int index) -> Bitmap""" + return _gdi_.ImageList_GetBitmap(*args, **kwargs) + + def GetIcon(*args, **kwargs): + """GetIcon(self, int index) -> Icon""" + return _gdi_.ImageList_GetIcon(*args, **kwargs) + + def Replace(*args, **kwargs): + """Replace(self, int index, Bitmap bitmap, Bitmap mask=NullBitmap) -> bool""" + return _gdi_.ImageList_Replace(*args, **kwargs) + + def Draw(*args, **kwargs): + """ + Draw(self, int index, DC dc, int x, int x, int flags=IMAGELIST_DRAW_NORMAL, + bool solidBackground=False) -> bool + """ + return _gdi_.ImageList_Draw(*args, **kwargs) + + def GetImageCount(*args, **kwargs): + """GetImageCount(self) -> int""" + return _gdi_.ImageList_GetImageCount(*args, **kwargs) + + def Remove(*args, **kwargs): + """Remove(self, int index) -> bool""" + return _gdi_.ImageList_Remove(*args, **kwargs) + + def RemoveAll(*args, **kwargs): + """RemoveAll(self) -> bool""" + return _gdi_.ImageList_RemoveAll(*args, **kwargs) + + def GetSize(*args, **kwargs): + """GetSize(index) -> (width,height)""" + return _gdi_.ImageList_GetSize(*args, **kwargs) + + ImageCount = property(GetImageCount,doc="See `GetImageCount`") + Size = property(GetSize,doc="See `GetSize`") +_gdi_.ImageList_swigregister(ImageList) + +#--------------------------------------------------------------------------- + +class StockGDI(object): + """Proxy of C++ StockGDI class""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + BRUSH_BLACK = _gdi_.StockGDI_BRUSH_BLACK + BRUSH_BLUE = _gdi_.StockGDI_BRUSH_BLUE + BRUSH_CYAN = _gdi_.StockGDI_BRUSH_CYAN + BRUSH_GREEN = _gdi_.StockGDI_BRUSH_GREEN + BRUSH_GREY = _gdi_.StockGDI_BRUSH_GREY + BRUSH_LIGHTGREY = _gdi_.StockGDI_BRUSH_LIGHTGREY + BRUSH_MEDIUMGREY = _gdi_.StockGDI_BRUSH_MEDIUMGREY + BRUSH_RED = _gdi_.StockGDI_BRUSH_RED + BRUSH_TRANSPARENT = _gdi_.StockGDI_BRUSH_TRANSPARENT + BRUSH_WHITE = _gdi_.StockGDI_BRUSH_WHITE + COLOUR_BLACK = _gdi_.StockGDI_COLOUR_BLACK + COLOUR_BLUE = _gdi_.StockGDI_COLOUR_BLUE + COLOUR_CYAN = _gdi_.StockGDI_COLOUR_CYAN + COLOUR_GREEN = _gdi_.StockGDI_COLOUR_GREEN + COLOUR_LIGHTGREY = _gdi_.StockGDI_COLOUR_LIGHTGREY + COLOUR_RED = _gdi_.StockGDI_COLOUR_RED + COLOUR_WHITE = _gdi_.StockGDI_COLOUR_WHITE + CURSOR_CROSS = _gdi_.StockGDI_CURSOR_CROSS + CURSOR_HOURGLASS = _gdi_.StockGDI_CURSOR_HOURGLASS + CURSOR_STANDARD = _gdi_.StockGDI_CURSOR_STANDARD + FONT_ITALIC = _gdi_.StockGDI_FONT_ITALIC + FONT_NORMAL = _gdi_.StockGDI_FONT_NORMAL + FONT_SMALL = _gdi_.StockGDI_FONT_SMALL + FONT_SWISS = _gdi_.StockGDI_FONT_SWISS + PEN_BLACK = _gdi_.StockGDI_PEN_BLACK + PEN_BLACKDASHED = _gdi_.StockGDI_PEN_BLACKDASHED + PEN_CYAN = _gdi_.StockGDI_PEN_CYAN + PEN_GREEN = _gdi_.StockGDI_PEN_GREEN + PEN_GREY = _gdi_.StockGDI_PEN_GREY + PEN_LIGHTGREY = _gdi_.StockGDI_PEN_LIGHTGREY + PEN_MEDIUMGREY = _gdi_.StockGDI_PEN_MEDIUMGREY + PEN_RED = _gdi_.StockGDI_PEN_RED + PEN_TRANSPARENT = _gdi_.StockGDI_PEN_TRANSPARENT + PEN_WHITE = _gdi_.StockGDI_PEN_WHITE + ITEMCOUNT = _gdi_.StockGDI_ITEMCOUNT + def __init__(self, *args, **kwargs): + """__init__(self) -> StockGDI""" + _gdi_.StockGDI_swiginit(self,_gdi_.new_StockGDI(*args, **kwargs)) + __swig_destroy__ = _gdi_.delete_StockGDI + __del__ = lambda self : None; + def DeleteAll(*args, **kwargs): + """DeleteAll()""" + return _gdi_.StockGDI_DeleteAll(*args, **kwargs) + + DeleteAll = staticmethod(DeleteAll) + def instance(*args, **kwargs): + """instance() -> StockGDI""" + return _gdi_.StockGDI_instance(*args, **kwargs) + + instance = staticmethod(instance) + def GetBrush(*args, **kwargs): + """GetBrush(int item) -> Brush""" + return _gdi_.StockGDI_GetBrush(*args, **kwargs) + + GetBrush = staticmethod(GetBrush) + def GetColour(*args, **kwargs): + """GetColour(int item) -> Colour""" + return _gdi_.StockGDI_GetColour(*args, **kwargs) GetColour = staticmethod(GetColour) def GetCursor(*args, **kwargs): @@ -4870,6 +5735,11 @@ class Effects(_core.Object): """TileBitmap(self, Rect rect, DC dc, Bitmap bitmap) -> bool""" return _gdi_.Effects_TileBitmap(*args, **kwargs) + DarkShadow = property(GetDarkShadow,SetDarkShadow,doc="See `GetDarkShadow` and `SetDarkShadow`") + FaceColour = property(GetFaceColour,SetFaceColour,doc="See `GetFaceColour` and `SetFaceColour`") + HighlightColour = property(GetHighlightColour,SetHighlightColour,doc="See `GetHighlightColour` and `SetHighlightColour`") + LightShadow = property(GetLightShadow,SetLightShadow,doc="See `GetLightShadow` and `SetLightShadow`") + MediumShadow = property(GetMediumShadow,SetMediumShadow,doc="See `GetMediumShadow` and `SetMediumShadow`") _gdi_.Effects_swigregister(Effects) #--------------------------------------------------------------------------- @@ -4877,9 +5747,11 @@ _gdi_.Effects_swigregister(Effects) CONTROL_DISABLED = _gdi_.CONTROL_DISABLED CONTROL_FOCUSED = _gdi_.CONTROL_FOCUSED CONTROL_PRESSED = _gdi_.CONTROL_PRESSED +CONTROL_SPECIAL = _gdi_.CONTROL_SPECIAL CONTROL_ISDEFAULT = _gdi_.CONTROL_ISDEFAULT CONTROL_ISSUBMENU = _gdi_.CONTROL_ISSUBMENU CONTROL_EXPANDED = _gdi_.CONTROL_EXPANDED +CONTROL_SIZEGRIP = _gdi_.CONTROL_SIZEGRIP CONTROL_CURRENT = _gdi_.CONTROL_CURRENT CONTROL_SELECTED = _gdi_.CONTROL_SELECTED CONTROL_CHECKED = _gdi_.CONTROL_CHECKED @@ -4925,6 +5797,31 @@ class SplitterRenderParams(object): isHotSensitive = property(_gdi_.SplitterRenderParams_isHotSensitive_get) _gdi_.SplitterRenderParams_swigregister(SplitterRenderParams) +class HeaderButtonParams(object): + """Extra (optional) parameters for `wx.RendererNative.DrawHeaderButton`""" + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self) -> HeaderButtonParams + + Extra (optional) parameters for `wx.RendererNative.DrawHeaderButton` + """ + _gdi_.HeaderButtonParams_swiginit(self,_gdi_.new_HeaderButtonParams(*args, **kwargs)) + __swig_destroy__ = _gdi_.delete_HeaderButtonParams + __del__ = lambda self : None; + m_arrowColour = property(_gdi_.HeaderButtonParams_m_arrowColour_get, _gdi_.HeaderButtonParams_m_arrowColour_set) + m_selectionColour = property(_gdi_.HeaderButtonParams_m_selectionColour_get, _gdi_.HeaderButtonParams_m_selectionColour_set) + m_labelText = property(_gdi_.HeaderButtonParams_m_labelText_get, _gdi_.HeaderButtonParams_m_labelText_set) + m_labelFont = property(_gdi_.HeaderButtonParams_m_labelFont_get, _gdi_.HeaderButtonParams_m_labelFont_set) + m_labelColour = property(_gdi_.HeaderButtonParams_m_labelColour_get, _gdi_.HeaderButtonParams_m_labelColour_set) + m_labelBitmap = property(_gdi_.HeaderButtonParams_m_labelBitmap_get, _gdi_.HeaderButtonParams_m_labelBitmap_set) + m_labelAlignment = property(_gdi_.HeaderButtonParams_m_labelAlignment_get, _gdi_.HeaderButtonParams_m_labelAlignment_set) +_gdi_.HeaderButtonParams_swigregister(HeaderButtonParams) + +HDR_SORT_ICON_NONE = _gdi_.HDR_SORT_ICON_NONE +HDR_SORT_ICON_UP = _gdi_.HDR_SORT_ICON_UP +HDR_SORT_ICON_DOWN = _gdi_.HDR_SORT_ICON_DOWN class RendererVersion(object): """ This simple struct represents the `wx.RendererNative` interface @@ -4961,11 +5858,12 @@ def RendererVersion_IsCompatible(*args, **kwargs): class RendererNative(object): """ - One of the design principles of wxWidgets is to use the native widgets - on every platform in order to be as close to the native look and feel - on every platform. However there are still cases when some generic - widgets are needed for various reasons, but it can sometimes take a - lot of messy work to make them conform to the native LnF. + One of the design principles of wxWidgets is to use the native + widgets on every platform in order to be as close as possible to + the native look and feel on every platform. However there are + still cases when some generic widgets are needed for various + reasons, but it can sometimes take a lot of messy work to make + them conform to the native LnF. The wx.RendererNative class is a collection of functions that have platform-specific implementations for drawing certain parts of @@ -4983,13 +5881,33 @@ class RendererNative(object): __repr__ = _swig_repr def DrawHeaderButton(*args, **kwargs): """ - DrawHeaderButton(self, Window win, DC dc, Rect rect, int flags=0) + DrawHeaderButton(self, Window win, DC dc, Rect rect, int flags=0, int sortArrow=HDR_SORT_ICON_NONE, + HeaderButtonParams params=None) Draw the header control button (such as what is used by `wx.ListCtrl` in report mode.) """ return _gdi_.RendererNative_DrawHeaderButton(*args, **kwargs) + def DrawHeaderButtonContents(*args, **kwargs): + """ + DrawHeaderButtonContents(self, Window win, DC dc, Rect rect, int flags=0, int sortArrow=HDR_SORT_ICON_NONE, + HeaderButtonParams params=None) + + Draw the contents of a header control button, (label, sort + arrows, etc.) Normally this is only called by `DrawHeaderButton`. + """ + return _gdi_.RendererNative_DrawHeaderButtonContents(*args, **kwargs) + + def GetHeaderButtonHeight(*args, **kwargs): + """ + GetHeaderButtonHeight(self, Window win) -> int + + Returns the default height of a header button, either a fixed platform + height if available, or a generic height based on the window's font. + """ + return _gdi_.RendererNative_GetHeaderButtonHeight(*args, **kwargs) + def DrawTreeItemButton(*args, **kwargs): """ DrawTreeItemButton(self, Window win, DC dc, Rect rect, int flags=0) @@ -5104,7 +6022,7 @@ class RendererNative(object): Return the generic implementation of the renderer. Under some platforms, this is the default renderer implementation, others have platform-specific default renderer which can be retrieved by calling - `GetDefault`. + `wx.RendererNative.GetDefault`. """ return _gdi_.RendererNative_GetGeneric(*args, **kwargs) @@ -5114,9 +6032,9 @@ class RendererNative(object): GetDefault() -> RendererNative Return the default (native) implementation for this platform -- this - is also the one used by default but this may be changed by calling `Set` - in which case the return value of this method may be different from - the return value of `Get`. + is also the one used by default but this may be changed by calling + `wx.RendererNative.Set` in which case the return value of this method + may be different from the return value of `wx.RendererNative.Get`. """ return _gdi_.RendererNative_GetDefault(*args, **kwargs) @@ -5140,6 +6058,8 @@ class RendererNative(object): """ return _gdi_.RendererNative_GetVersion(*args, **kwargs) + SplitterParams = property(GetSplitterParams,doc="See `GetSplitterParams`") + Version = property(GetVersion,doc="See `GetVersion`") _gdi_.RendererNative_swigregister(RendererNative) def RendererNative_Get(*args): @@ -5157,7 +6077,7 @@ def RendererNative_GetGeneric(*args): Return the generic implementation of the renderer. Under some platforms, this is the default renderer implementation, others have platform-specific default renderer which can be retrieved by calling - `GetDefault`. + `wx.RendererNative.GetDefault`. """ return _gdi_.RendererNative_GetGeneric(*args) @@ -5166,9 +6086,9 @@ def RendererNative_GetDefault(*args): RendererNative_GetDefault() -> RendererNative Return the default (native) implementation for this platform -- this - is also the one used by default but this may be changed by calling `Set` - in which case the return value of this method may be different from - the return value of `Get`. + is also the one used by default but this may be changed by calling + `wx.RendererNative.Set` in which case the return value of this method + may be different from the return value of `wx.RendererNative.Get`. """ return _gdi_.RendererNative_GetDefault(*args) @@ -5181,5 +6101,784 @@ def RendererNative_Set(*args, **kwargs): """ return _gdi_.RendererNative_Set(*args, **kwargs) +#--------------------------------------------------------------------------- + +class PseudoDC(_core.Object): + """ + A PseudoDC is an object that can be used as if it were a `wx.DC`. All + commands issued to the PseudoDC are stored in a list. You can then + play these commands back to a real DC object using the DrawToDC + method. Commands in the command list are indexed by ID. You can use + this to clear the operations associated with a single ID and then + re-draw the object associated with that ID. + """ + thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag') + __repr__ = _swig_repr + def __init__(self, *args, **kwargs): + """ + __init__(self) -> PseudoDC + + Constructs a new Pseudo device context for recording dc operations + """ + _gdi_.PseudoDC_swiginit(self,_gdi_.new_PseudoDC(*args, **kwargs)) + def BeginDrawing(*args, **kwargs): + """ + BeginDrawing(self) + + Allows for optimization of drawing code on platforms that need it. On + other platforms this is just an empty function and is harmless. To + take advantage of this postential optimization simply enclose each + group of calls to the drawing primitives within calls to + `BeginDrawing` and `EndDrawing`. + """ + return _gdi_.PseudoDC_BeginDrawing(*args, **kwargs) + + def EndDrawing(*args, **kwargs): + """ + EndDrawing(self) + + Ends the group of drawing primitives started with `BeginDrawing`, and + invokes whatever optimization is available for this DC type on the + current platform. + """ + return _gdi_.PseudoDC_EndDrawing(*args, **kwargs) + + __swig_destroy__ = _gdi_.delete_PseudoDC + __del__ = lambda self : None; + def RemoveAll(*args, **kwargs): + """ + RemoveAll(self) + + Removes all objects and operations from the recorded list. + """ + return _gdi_.PseudoDC_RemoveAll(*args, **kwargs) + + def GetLen(*args, **kwargs): + """ + GetLen(self) -> int + + Returns the number of operations in the recorded list. + """ + return _gdi_.PseudoDC_GetLen(*args, **kwargs) + + def SetId(*args, **kwargs): + """ + SetId(self, int id) + + Sets the id to be associated with subsequent operations. + """ + return _gdi_.PseudoDC_SetId(*args, **kwargs) + + def ClearId(*args, **kwargs): + """ + ClearId(self, int id) + + Removes all operations associated with id so the object can be redrawn. + """ + return _gdi_.PseudoDC_ClearId(*args, **kwargs) + + def RemoveId(*args, **kwargs): + """ + RemoveId(self, int id) + + Remove the object node (and all operations) associated with an id. + """ + return _gdi_.PseudoDC_RemoveId(*args, **kwargs) + + def TranslateId(*args, **kwargs): + """ + TranslateId(self, int id, int dx, int dy) + + Translate the operations of id by dx,dy. + """ + return _gdi_.PseudoDC_TranslateId(*args, **kwargs) + + def SetIdGreyedOut(*args, **kwargs): + """ + SetIdGreyedOut(self, int id, bool greyout=True) + + Set whether an object is drawn greyed out or not. + """ + return _gdi_.PseudoDC_SetIdGreyedOut(*args, **kwargs) + + def GetIdGreyedOut(*args, **kwargs): + """ + GetIdGreyedOut(self, int id) -> bool + + Get whether an object is drawn greyed out or not. + """ + return _gdi_.PseudoDC_GetIdGreyedOut(*args, **kwargs) + + def FindObjects(*args, **kwargs): + """ + FindObjects(self, int x, int y, int radius=1, wxColor bg=*wxWHITE) -> PyObject + + Returns a list of all the id's that draw a pixel with color + not equal to bg within radius of (x,y). + Returns an empty list if nothing is found. The list is in + reverse drawing order so list[0] is the top id. + """ + return _gdi_.PseudoDC_FindObjects(*args, **kwargs) + + def FindObjectsByBBox(*args, **kwargs): + """ + FindObjectsByBBox(self, int x, int y) -> PyObject + + Returns a list of all the id's whose bounding boxes include (x,y). + Returns an empty list if nothing is found. The list is in + reverse drawing order so list[0] is the top id. + """ + return _gdi_.PseudoDC_FindObjectsByBBox(*args, **kwargs) + + def DrawIdToDC(*args, **kwargs): + """ + DrawIdToDC(self, int id, DC dc) + + Draw recorded operations of id to dc. + """ + return _gdi_.PseudoDC_DrawIdToDC(*args, **kwargs) + + def SetIdBounds(*args, **kwargs): + """ + SetIdBounds(self, int id, Rect rect) + + Set the bounding rect of a given object. This will create + an object node if one doesn't exist. + """ + return _gdi_.PseudoDC_SetIdBounds(*args, **kwargs) + + def GetIdBounds(*args, **kwargs): + """ + GetIdBounds(self, int id) -> Rect + + Returns the bounding rectangle previouly set with SetIdBounds. If + no bounds have been set, it returns wx.Rect(0,0,0,0). + """ + return _gdi_.PseudoDC_GetIdBounds(*args, **kwargs) + + def DrawToDCClipped(*args, **kwargs): + """ + DrawToDCClipped(self, DC dc, Rect rect) + + Draws the recorded operations to dc unless the operation is known to + be outside rect. + """ + return _gdi_.PseudoDC_DrawToDCClipped(*args, **kwargs) + + def DrawToDCClippedRgn(*args, **kwargs): + """ + DrawToDCClippedRgn(self, DC dc, Region region) + + Draws the recorded operations to dc unless the operation is known to + be outside rect. + """ + return _gdi_.PseudoDC_DrawToDCClippedRgn(*args, **kwargs) + + def DrawToDC(*args, **kwargs): + """ + DrawToDC(self, DC dc) + + Draws the recorded operations to dc. + """ + return _gdi_.PseudoDC_DrawToDC(*args, **kwargs) + + def FloodFill(*args, **kwargs): + """ + FloodFill(self, int x, int y, Colour col, int style=FLOOD_SURFACE) + + Flood fills the device context starting from the given point, using + the current brush colour, and using a style: + + - **wxFLOOD_SURFACE**: the flooding occurs until a colour other than + the given colour is encountered. + + - **wxFLOOD_BORDER**: the area to be flooded is bounded by the given + colour. + + Returns False if the operation failed. + + Note: The present implementation for non-Windows platforms may fail to + find colour borders if the pixels do not match the colour + exactly. However the function will still return true. + """ + return _gdi_.PseudoDC_FloodFill(*args, **kwargs) + + def FloodFillPoint(*args, **kwargs): + """ + FloodFillPoint(self, Point pt, Colour col, int style=FLOOD_SURFACE) + + Flood fills the device context starting from the given point, using + the current brush colour, and using a style: + + - **wxFLOOD_SURFACE**: the flooding occurs until a colour other than + the given colour is encountered. + + - **wxFLOOD_BORDER**: the area to be flooded is bounded by the given + colour. + + Returns False if the operation failed. + + Note: The present implementation for non-Windows platforms may fail to + find colour borders if the pixels do not match the colour + exactly. However the function will still return true. + """ + return _gdi_.PseudoDC_FloodFillPoint(*args, **kwargs) + + def DrawLine(*args, **kwargs): + """ + DrawLine(self, int x1, int y1, int x2, int y2) + + Draws a line from the first point to the second. The current pen is + used for drawing the line. Note that the second point is *not* part of + the line and is not drawn by this function (this is consistent with + the behaviour of many other toolkits). + """ + return _gdi_.PseudoDC_DrawLine(*args, **kwargs) + + def DrawLinePoint(*args, **kwargs): + """ + DrawLinePoint(self, Point pt1, Point pt2) + + Draws a line from the first point to the second. The current pen is + used for drawing the line. Note that the second point is *not* part of + the line and is not drawn by this function (this is consistent with + the behaviour of many other toolkits). + """ + return _gdi_.PseudoDC_DrawLinePoint(*args, **kwargs) + + def CrossHair(*args, **kwargs): + """ + CrossHair(self, int x, int y) + + Displays a cross hair using the current pen. This is a vertical and + horizontal line the height and width of the window, centred on the + given point. + """ + return _gdi_.PseudoDC_CrossHair(*args, **kwargs) + + def CrossHairPoint(*args, **kwargs): + """ + CrossHairPoint(self, Point pt) + + Displays a cross hair using the current pen. This is a vertical and + horizontal line the height and width of the window, centred on the + given point. + """ + return _gdi_.PseudoDC_CrossHairPoint(*args, **kwargs) + + def DrawArc(*args, **kwargs): + """ + DrawArc(self, int x1, int y1, int x2, int y2, int xc, int yc) + + Draws an arc of a circle, centred on the *center* point (xc, yc), from + the first point to the second. The current pen is used for the outline + and the current brush for filling the shape. + + The arc is drawn in an anticlockwise direction from the start point to + the end point. + """ + return _gdi_.PseudoDC_DrawArc(*args, **kwargs) + + def DrawArcPoint(*args, **kwargs): + """ + DrawArcPoint(self, Point pt1, Point pt2, Point center) + + Draws an arc of a circle, centred on the *center* point (xc, yc), from + the first point to the second. The current pen is used for the outline + and the current brush for filling the shape. + + The arc is drawn in an anticlockwise direction from the start point to + the end point. + """ + return _gdi_.PseudoDC_DrawArcPoint(*args, **kwargs) + + def DrawCheckMark(*args, **kwargs): + """ + DrawCheckMark(self, int x, int y, int width, int height) + + Draws a check mark inside the given rectangle. + """ + return _gdi_.PseudoDC_DrawCheckMark(*args, **kwargs) + + def DrawCheckMarkRect(*args, **kwargs): + """ + DrawCheckMarkRect(self, Rect rect) + + Draws a check mark inside the given rectangle. + """ + return _gdi_.PseudoDC_DrawCheckMarkRect(*args, **kwargs) + + def DrawEllipticArc(*args, **kwargs): + """ + DrawEllipticArc(self, int x, int y, int w, int h, double start, double end) + + Draws an arc of an ellipse, with the given rectangle defining the + bounds of the ellipse. The current pen is used for drawing the arc and + the current brush is used for drawing the pie. + + The *start* and *end* parameters specify the start and end of the arc + relative to the three-o'clock position from the center of the + rectangle. Angles are specified in degrees (360 is a complete + circle). Positive values mean counter-clockwise motion. If start is + equal to end, a complete ellipse will be drawn. + """ + return _gdi_.PseudoDC_DrawEllipticArc(*args, **kwargs) + + def DrawEllipticArcPointSize(*args, **kwargs): + """ + DrawEllipticArcPointSize(self, Point pt, Size sz, double start, double end) + + Draws an arc of an ellipse, with the given rectangle defining the + bounds of the ellipse. The current pen is used for drawing the arc and + the current brush is used for drawing the pie. + + The *start* and *end* parameters specify the start and end of the arc + relative to the three-o'clock position from the center of the + rectangle. Angles are specified in degrees (360 is a complete + circle). Positive values mean counter-clockwise motion. If start is + equal to end, a complete ellipse will be drawn. + """ + return _gdi_.PseudoDC_DrawEllipticArcPointSize(*args, **kwargs) + + def DrawPoint(*args, **kwargs): + """ + DrawPoint(self, int x, int y) + + Draws a point using the current pen. + """ + return _gdi_.PseudoDC_DrawPoint(*args, **kwargs) + + def DrawPointPoint(*args, **kwargs): + """ + DrawPointPoint(self, Point pt) + + Draws a point using the current pen. + """ + return _gdi_.PseudoDC_DrawPointPoint(*args, **kwargs) + + def DrawRectangle(*args, **kwargs): + """ + DrawRectangle(self, int x, int y, int width, int height) + + Draws a rectangle with the given top left corner, and with the given + size. The current pen is used for the outline and the current brush + for filling the shape. + """ + return _gdi_.PseudoDC_DrawRectangle(*args, **kwargs) + + def DrawRectangleRect(*args, **kwargs): + """ + DrawRectangleRect(self, Rect rect) + + Draws a rectangle with the given top left corner, and with the given + size. The current pen is used for the outline and the current brush + for filling the shape. + """ + return _gdi_.PseudoDC_DrawRectangleRect(*args, **kwargs) + + def DrawRectanglePointSize(*args, **kwargs): + """ + DrawRectanglePointSize(self, Point pt, Size sz) + + Draws a rectangle with the given top left corner, and with the given + size. The current pen is used for the outline and the current brush + for filling the shape. + """ + return _gdi_.PseudoDC_DrawRectanglePointSize(*args, **kwargs) + + def DrawRoundedRectangle(*args, **kwargs): + """ + DrawRoundedRectangle(self, int x, int y, int width, int height, double radius) + + Draws a rectangle with the given top left corner, and with the given + size. The corners are quarter-circles using the given radius. The + current pen is used for the outline and the current brush for filling + the shape. + + If radius is positive, the value is assumed to be the radius of the + rounded corner. If radius is negative, the absolute value is assumed + to be the proportion of the smallest dimension of the rectangle. This + means that the corner can be a sensible size relative to the size of + the rectangle, and also avoids the strange effects X produces when the + corners are too big for the rectangle. + """ + return _gdi_.PseudoDC_DrawRoundedRectangle(*args, **kwargs) + + def DrawRoundedRectangleRect(*args, **kwargs): + """ + DrawRoundedRectangleRect(self, Rect r, double radius) + + Draws a rectangle with the given top left corner, and with the given + size. The corners are quarter-circles using the given radius. The + current pen is used for the outline and the current brush for filling + the shape. + + If radius is positive, the value is assumed to be the radius of the + rounded corner. If radius is negative, the absolute value is assumed + to be the proportion of the smallest dimension of the rectangle. This + means that the corner can be a sensible size relative to the size of + the rectangle, and also avoids the strange effects X produces when the + corners are too big for the rectangle. + """ + return _gdi_.PseudoDC_DrawRoundedRectangleRect(*args, **kwargs) + + def DrawRoundedRectanglePointSize(*args, **kwargs): + """ + DrawRoundedRectanglePointSize(self, Point pt, Size sz, double radius) + + Draws a rectangle with the given top left corner, and with the given + size. The corners are quarter-circles using the given radius. The + current pen is used for the outline and the current brush for filling + the shape. + + If radius is positive, the value is assumed to be the radius of the + rounded corner. If radius is negative, the absolute value is assumed + to be the proportion of the smallest dimension of the rectangle. This + means that the corner can be a sensible size relative to the size of + the rectangle, and also avoids the strange effects X produces when the + corners are too big for the rectangle. + """ + return _gdi_.PseudoDC_DrawRoundedRectanglePointSize(*args, **kwargs) + + def DrawCircle(*args, **kwargs): + """ + DrawCircle(self, int x, int y, int radius) + + Draws a circle with the given center point and radius. The current + pen is used for the outline and the current brush for filling the + shape. + """ + return _gdi_.PseudoDC_DrawCircle(*args, **kwargs) + + def DrawCirclePoint(*args, **kwargs): + """ + DrawCirclePoint(self, Point pt, int radius) + + Draws a circle with the given center point and radius. The current + pen is used for the outline and the current brush for filling the + shape. + """ + return _gdi_.PseudoDC_DrawCirclePoint(*args, **kwargs) + + def DrawEllipse(*args, **kwargs): + """ + DrawEllipse(self, int x, int y, int width, int height) + + Draws an ellipse contained in the specified rectangle. The current pen + is used for the outline and the current brush for filling the shape. + """ + return _gdi_.PseudoDC_DrawEllipse(*args, **kwargs) + + def DrawEllipseRect(*args, **kwargs): + """ + DrawEllipseRect(self, Rect rect) + + Draws an ellipse contained in the specified rectangle. The current pen + is used for the outline and the current brush for filling the shape. + """ + return _gdi_.PseudoDC_DrawEllipseRect(*args, **kwargs) + + def DrawEllipsePointSize(*args, **kwargs): + """ + DrawEllipsePointSize(self, Point pt, Size sz) + + Draws an ellipse contained in the specified rectangle. The current pen + is used for the outline and the current brush for filling the shape. + """ + return _gdi_.PseudoDC_DrawEllipsePointSize(*args, **kwargs) + + def DrawIcon(*args, **kwargs): + """ + DrawIcon(self, Icon icon, int x, int y) + + Draw an icon on the display (does nothing if the device context is + PostScript). This can be the simplest way of drawing bitmaps on a + window. + """ + return _gdi_.PseudoDC_DrawIcon(*args, **kwargs) + + def DrawIconPoint(*args, **kwargs): + """ + DrawIconPoint(self, Icon icon, Point pt) + + Draw an icon on the display (does nothing if the device context is + PostScript). This can be the simplest way of drawing bitmaps on a + window. + """ + return _gdi_.PseudoDC_DrawIconPoint(*args, **kwargs) + + def DrawBitmap(*args, **kwargs): + """ + DrawBitmap(self, Bitmap bmp, int x, int y, bool useMask=False) + + Draw a bitmap on the device context at the specified point. If + *transparent* is true and the bitmap has a transparency mask, (or + alpha channel on the platforms that support it) then the bitmap will + be drawn transparently. + """ + return _gdi_.PseudoDC_DrawBitmap(*args, **kwargs) + + def DrawBitmapPoint(*args, **kwargs): + """ + DrawBitmapPoint(self, Bitmap bmp, Point pt, bool useMask=False) + + Draw a bitmap on the device context at the specified point. If + *transparent* is true and the bitmap has a transparency mask, (or + alpha channel on the platforms that support it) then the bitmap will + be drawn transparently. + """ + return _gdi_.PseudoDC_DrawBitmapPoint(*args, **kwargs) + + def DrawText(*args, **kwargs): + """ + DrawText(self, String text, int x, int y) + + Draws a text string at the specified point, using the current text + font, and the current text foreground and background colours. + + The coordinates refer to the top-left corner of the rectangle bounding + the string. See `wx.DC.GetTextExtent` for how to get the dimensions of + a text string, which can be used to position the text more precisely, + (you will need to use a real DC with GetTextExtent as wx.PseudoDC does + not implement it.) + + **NOTE**: under wxGTK the current logical function is used by this + function but it is ignored by wxMSW. Thus, you should avoid using + logical functions with this function in portable programs. + """ + return _gdi_.PseudoDC_DrawText(*args, **kwargs) + + def DrawTextPoint(*args, **kwargs): + """ + DrawTextPoint(self, String text, Point pt) + + Draws a text string at the specified point, using the current text + font, and the current text foreground and background colours. + + The coordinates refer to the top-left corner of the rectangle bounding + the string. See `wx.DC.GetTextExtent` for how to get the dimensions of + a text string, which can be used to position the text more precisely, + (you will need to use a real DC with GetTextExtent as wx.PseudoDC does + not implement it.) + + **NOTE**: under wxGTK the current logical function is used by this + function but it is ignored by wxMSW. Thus, you should avoid using + logical functions with this function in portable programs. + """ + return _gdi_.PseudoDC_DrawTextPoint(*args, **kwargs) + + def DrawRotatedText(*args, **kwargs): + """ + DrawRotatedText(self, String text, int x, int y, double angle) + + Draws the text rotated by *angle* degrees, if supported by the platform. + + **NOTE**: Under Win9x only TrueType fonts can be drawn by this + function. In particular, a font different from ``wx.NORMAL_FONT`` + should be used as the it is not normally a TrueType + font. ``wx.SWISS_FONT`` is an example of a font which is. + """ + return _gdi_.PseudoDC_DrawRotatedText(*args, **kwargs) + + def DrawRotatedTextPoint(*args, **kwargs): + """ + DrawRotatedTextPoint(self, String text, Point pt, double angle) + + Draws the text rotated by *angle* degrees, if supported by the platform. + + **NOTE**: Under Win9x only TrueType fonts can be drawn by this + function. In particular, a font different from ``wx.NORMAL_FONT`` + should be used as the it is not normally a TrueType + font. ``wx.SWISS_FONT`` is an example of a font which is. + """ + return _gdi_.PseudoDC_DrawRotatedTextPoint(*args, **kwargs) + + def DrawLines(*args, **kwargs): + """ + DrawLines(self, List points, int xoffset=0, int yoffset=0) + + Draws lines using a sequence of `wx.Point` objects, adding the + optional offset coordinate. The current pen is used for drawing the + lines. + """ + return _gdi_.PseudoDC_DrawLines(*args, **kwargs) + + def DrawPolygon(*args, **kwargs): + """ + DrawPolygon(self, List points, int xoffset=0, int yoffset=0, + int fillStyle=ODDEVEN_RULE) + + Draws a filled polygon using a sequence of `wx.Point` objects, adding + the optional offset coordinate. The last argument specifies the fill + rule: ``wx.ODDEVEN_RULE`` (the default) or ``wx.WINDING_RULE``. + + The current pen is used for drawing the outline, and the current brush + for filling the shape. Using a transparent brush suppresses + filling. Note that wxWidgets automatically closes the first and last + points. + """ + return _gdi_.PseudoDC_DrawPolygon(*args, **kwargs) + + def DrawLabel(*args, **kwargs): + """ + DrawLabel(self, String text, Rect rect, int alignment=wxALIGN_LEFT|wxALIGN_TOP, + int indexAccel=-1) + + Draw *text* within the specified rectangle, abiding by the alignment + flags. Will additionally emphasize the character at *indexAccel* if + it is not -1. + """ + return _gdi_.PseudoDC_DrawLabel(*args, **kwargs) + + def DrawImageLabel(*args, **kwargs): + """ + DrawImageLabel(self, String text, Bitmap image, Rect rect, int alignment=wxALIGN_LEFT|wxALIGN_TOP, + int indexAccel=-1) + + Draw *text* and an image (which may be ``wx.NullBitmap`` to skip + drawing it) within the specified rectangle, abiding by the alignment + flags. Will additionally emphasize the character at *indexAccel* if + it is not -1. + """ + return _gdi_.PseudoDC_DrawImageLabel(*args, **kwargs) + + def DrawSpline(*args, **kwargs): + """ + DrawSpline(self, List points) + + Draws a spline between all given control points, (a list of `wx.Point` + objects) using the current pen. The spline is drawn using a series of + lines, using an algorithm taken from the X drawing program 'XFIG'. + """ + return _gdi_.PseudoDC_DrawSpline(*args, **kwargs) + + def Clear(*args, **kwargs): + """ + Clear(self) + + Clears the device context using the current background brush. + """ + return _gdi_.PseudoDC_Clear(*args, **kwargs) + + def SetFont(*args, **kwargs): + """ + SetFont(self, Font font) + + Sets the current font for the DC. It must be a valid font, in + particular you should not pass ``wx.NullFont`` to this method. + """ + return _gdi_.PseudoDC_SetFont(*args, **kwargs) + + def SetPen(*args, **kwargs): + """ + SetPen(self, Pen pen) + + Sets the current pen for the DC. + + If the argument is ``wx.NullPen``, the current pen is selected out of the + device context, and the original pen restored. + """ + return _gdi_.PseudoDC_SetPen(*args, **kwargs) + + def SetBrush(*args, **kwargs): + """ + SetBrush(self, Brush brush) + + Sets the current brush for the DC. + + If the argument is ``wx.NullBrush``, the current brush is selected out + of the device context, and the original brush restored, allowing the + current brush to be destroyed safely. + """ + return _gdi_.PseudoDC_SetBrush(*args, **kwargs) + + def SetBackground(*args, **kwargs): + """ + SetBackground(self, Brush brush) + + Sets the current background brush for the DC. + """ + return _gdi_.PseudoDC_SetBackground(*args, **kwargs) + + def SetBackgroundMode(*args, **kwargs): + """ + SetBackgroundMode(self, int mode) + + *mode* may be one of ``wx.SOLID`` and ``wx.TRANSPARENT``. This setting + determines whether text will be drawn with a background colour or + not. + """ + return _gdi_.PseudoDC_SetBackgroundMode(*args, **kwargs) + + def SetPalette(*args, **kwargs): + """ + SetPalette(self, Palette palette) + + If this is a window DC or memory DC, assigns the given palette to the + window or bitmap associated with the DC. If the argument is + ``wx.NullPalette``, the current palette is selected out of the device + context, and the original palette restored. + """ + return _gdi_.PseudoDC_SetPalette(*args, **kwargs) + + def SetTextForeground(*args, **kwargs): + """ + SetTextForeground(self, Colour colour) + + Sets the current text foreground colour for the DC. + """ + return _gdi_.PseudoDC_SetTextForeground(*args, **kwargs) + + def SetTextBackground(*args, **kwargs): + """ + SetTextBackground(self, Colour colour) + + Sets the current text background colour for the DC. + """ + return _gdi_.PseudoDC_SetTextBackground(*args, **kwargs) + + def SetLogicalFunction(*args, **kwargs): + """ + SetLogicalFunction(self, int function) + + Sets the current logical function for the device context. This + determines how a source pixel (from a pen or brush colour, combines + with a destination pixel in the current device context. + + The possible values and their meaning in terms of source and + destination pixel values are as follows: + + ================ ========================== + wx.AND src AND dst + wx.AND_INVERT (NOT src) AND dst + wx.AND_REVERSE src AND (NOT dst) + wx.CLEAR 0 + wx.COPY src + wx.EQUIV (NOT src) XOR dst + wx.INVERT NOT dst + wx.NAND (NOT src) OR (NOT dst) + wx.NOR (NOT src) AND (NOT dst) + wx.NO_OP dst + wx.OR src OR dst + wx.OR_INVERT (NOT src) OR dst + wx.OR_REVERSE src OR (NOT dst) + wx.SET 1 + wx.SRC_INVERT NOT src + wx.XOR src XOR dst + ================ ========================== + + The default is wx.COPY, which simply draws with the current + colour. The others combine the current colour and the background using + a logical operation. wx.INVERT is commonly used for drawing rubber + bands or moving outlines, since drawing twice reverts to the original + colour. + + """ + return _gdi_.PseudoDC_SetLogicalFunction(*args, **kwargs) + + IdBounds = property(GetIdBounds,SetIdBounds,doc="See `GetIdBounds` and `SetIdBounds`") + Len = property(GetLen,doc="See `GetLen`") +_gdi_.PseudoDC_swigregister(PseudoDC) +