mirror of
https://github.com/wxWidgets/Phoenix.git
synced 2026-01-04 19:10:09 +01:00
01c3c738a6
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxPython/Phoenix/trunk@70082 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
323 lines
13 KiB
Python
323 lines
13 KiB
Python
#---------------------------------------------------------------------------
|
|
# Name: etg/gdicmn.py
|
|
# Author: Robin Dunn
|
|
#
|
|
# Created: 4-Nov-2010
|
|
# Copyright: (c) 2011 by Total Control Software
|
|
# License: wxWindows License
|
|
#---------------------------------------------------------------------------
|
|
|
|
import etgtools
|
|
import etgtools.tweaker_tools as tools
|
|
|
|
PACKAGE = "wx"
|
|
MODULE = "_core"
|
|
NAME = "gdicmn"
|
|
DOCSTRING = ""
|
|
|
|
# The classes and/or the basename of the Doxygen XML files to be processed by
|
|
# this script.
|
|
ITEMS = [ 'wxPoint',
|
|
'wxSize',
|
|
'wxRect',
|
|
'wxRealPoint',
|
|
'wxColourDatabase',
|
|
]
|
|
|
|
#---------------------------------------------------------------------------
|
|
|
|
def run():
|
|
# Parse the XML file(s) building a collection of Extractor objects
|
|
module = etgtools.ModuleDef(PACKAGE, MODULE, NAME, DOCSTRING)
|
|
etgtools.parseDoxyXML(module, ITEMS)
|
|
|
|
#-----------------------------------------------------------------
|
|
# Tweak the parsed meta objects in the module object as needed for
|
|
# customizing the generated code and docstrings.
|
|
|
|
|
|
# ignore some of these enum values
|
|
e = module.find('wxBitmapType')
|
|
for i in e:
|
|
if i.name.endswith('_RESOURCE'):
|
|
i.ignore()
|
|
|
|
module.addCppCode("""\
|
|
#if !defined(__WXMAC__)
|
|
#define wxCURSOR_COPY_ARROW wxCURSOR_ARROW
|
|
#endif
|
|
""")
|
|
|
|
# these are X11 only
|
|
e = module.find('wxStockCursor')
|
|
e.find('wxCURSOR_BASED_ARROW_DOWN').ignore()
|
|
e.find('wxCURSOR_BASED_ARROW_UP').ignore()
|
|
e.find('wxCURSOR_CROSS_REVERSE').ignore()
|
|
e.find('wxCURSOR_DOUBLE_ARROW').ignore()
|
|
|
|
module.find('wxSetCursor').ignore()
|
|
|
|
module.find('wxClientDisplayRect.x').out = True
|
|
module.find('wxClientDisplayRect.y').out = True
|
|
module.find('wxClientDisplayRect.width').out = True
|
|
module.find('wxClientDisplayRect.height').out = True
|
|
|
|
module.find('wxDisplaySize.width').out = True
|
|
module.find('wxDisplaySize.height').out = True
|
|
module.find('wxDisplaySizeMM.width').out = True
|
|
module.find('wxDisplaySizeMM.height').out = True
|
|
|
|
#---------------------------------------
|
|
# wxPoint tweaks
|
|
c = module.find('wxPoint')
|
|
|
|
# Some operators are documented within the class that shouldn't be, so just
|
|
# ignore them all.
|
|
tools.ignoreAllOperators(c)
|
|
|
|
# Undo a few of those ignores for legitimate items that were
|
|
# documented correctly
|
|
for f in c.find('operator+=').all() + c.find('operator-=').all():
|
|
f.ignore(False)
|
|
|
|
# Add some stand-alone function declarations for the operators that really do
|
|
# exist.
|
|
wc = etgtools.WigCode("""\
|
|
bool operator==(const wxPoint& p1, const wxPoint& p2);
|
|
bool operator!=(const wxPoint& p1, const wxPoint& p2);
|
|
wxPoint operator+(const wxPoint& p, const wxSize& s);
|
|
wxPoint operator+(const wxPoint& p1, const wxPoint& p2);
|
|
wxPoint operator+(const wxSize& s, const wxPoint& p);
|
|
wxPoint operator-(const wxPoint& p);
|
|
wxPoint operator-(const wxPoint& p, const wxSize& s);
|
|
wxPoint operator-(const wxPoint& p1, const wxPoint& p2);
|
|
wxPoint operator-(const wxSize& s, const wxPoint& p);
|
|
wxPoint operator*(const wxPoint& s, int i);
|
|
wxPoint operator*(int i, const wxPoint& s);
|
|
wxPoint operator/(const wxPoint& s, int i);
|
|
""")
|
|
module.insertItemAfter(c, wc)
|
|
|
|
|
|
# wxPoint typemap
|
|
c.convertFromPyObject = tools.convertTwoIntegersTemplate('wxPoint')
|
|
|
|
c.addCppMethod('PyObject*', 'Get', '()', """\
|
|
return sipBuildResult(0, "(ii)", self->x, self->y);
|
|
""",
|
|
pyArgsString="() -> (x,y)",
|
|
briefDoc="Return the x and y properties as a tuple.")
|
|
|
|
# Add sequence protocol methods and other goodies
|
|
c.addPyMethod('__str__', '(self)', 'return str(self.Get())')
|
|
c.addPyMethod('__repr__', '(self)', 'return "wx.Point"+str(self.Get())')
|
|
c.addPyMethod('__len__', '(self)', 'return len(self.Get())')
|
|
c.addPyMethod('__nonzero__', '(self)', 'return self.Get() != (0,0)')
|
|
c.addPyMethod('__reduce__', '(self)', 'return (Point, self.Get())')
|
|
c.addPyMethod('__getitem__', '(self, idx)', 'return self.Get()[idx]')
|
|
c.addPyMethod('__setitem__', '(self, idx, val)',
|
|
"""\
|
|
if idx == 0: self.x = val
|
|
elif idx == 1: self.y = val
|
|
else: raise IndexError
|
|
""")
|
|
c.addPyCode('Point.__safe_for_unpickling__ = True')
|
|
|
|
module.addItem(
|
|
tools.wxListWrapperTemplate('wxPointList', 'wxPoint', module, includeConvertToType=True))
|
|
|
|
|
|
#---------------------------------------
|
|
# wxSize tweaks
|
|
c = module.find('wxSize')
|
|
|
|
c.addProperty("width GetWidth SetWidth")
|
|
c.addProperty("height GetHeight SetHeight")
|
|
|
|
# TODO: How prevalent is the use of x,y properties on a size object? Can we deprecate them?
|
|
c.addProperty("x GetWidth SetWidth")
|
|
c.addProperty("y GetHeight SetHeight")
|
|
|
|
# take care of the same issues as wxPoint
|
|
tools.ignoreAllOperators(c)
|
|
for f in c.find('operator+=').all() + \
|
|
c.find('operator-=').all() + \
|
|
c.find('operator*=').all() + \
|
|
c.find('operator/=').all():
|
|
f.ignore(False)
|
|
wc = etgtools.WigCode("""\
|
|
bool operator==(const wxSize& s1, const wxSize& s2);
|
|
bool operator!=(const wxSize& s1, const wxSize& s2);
|
|
wxSize operator*(const wxSize& s, int i);
|
|
wxSize operator*(int i, const wxSize& s);
|
|
wxSize operator+(const wxSize& s1, const wxSize& s2);
|
|
wxSize operator-(const wxSize& s1, const wxSize& s2);
|
|
wxSize operator/(const wxSize& s, int i);
|
|
""")
|
|
module.insertItemAfter(c, wc)
|
|
|
|
|
|
# wxSize typemap
|
|
c.convertFromPyObject = tools.convertTwoIntegersTemplate('wxSize')
|
|
|
|
c.addCppMethod('PyObject*', 'Get', '()', """\
|
|
return sipBuildResult(0, "(ii)", self->GetWidth(), self->GetHeight());
|
|
""",
|
|
pyArgsString="() -> (width, height)",
|
|
briefDoc="Return the width and height properties as a tuple.")
|
|
|
|
# Add sequence protocol methods and other goodies
|
|
c.addPyMethod('__str__', '(self)', 'return str(self.Get())')
|
|
c.addPyMethod('__repr__', '(self)', 'return "wx.Size"+str(self.Get())')
|
|
c.addPyMethod('__len__', '(self)', 'return len(self.Get())')
|
|
c.addPyMethod('__nonzero__', '(self)', 'return self.Get() != (0,0)')
|
|
c.addPyMethod('__reduce__', '(self)', 'return (Size, self.Get())')
|
|
c.addPyMethod('__getitem__', '(self, idx)', 'return self.Get()[idx]')
|
|
c.addPyMethod('__setitem__', '(self, idx, val)',
|
|
"""\
|
|
if idx == 0: self.width = val
|
|
elif idx == 1: self.height = val
|
|
else: raise IndexError
|
|
""")
|
|
c.addPyCode('Size.__safe_for_unpickling__ = True')
|
|
|
|
|
|
|
|
#---------------------------------------
|
|
# wxRect tweaks
|
|
c = module.find('wxRect')
|
|
assert isinstance(c, etgtools.ClassDef)
|
|
|
|
c.addProperty("left GetLeft")
|
|
c.addProperty("top GetTop")
|
|
c.addProperty("right GetRight")
|
|
c.addProperty("bottom GetBottom")
|
|
|
|
c.addProperty("bottomLeft GetBottomLeft")
|
|
c.addProperty("bottomRight GetBottomRight")
|
|
c.addProperty("topLeft GetTopLeft")
|
|
c.addProperty("topRight GetTopRight")
|
|
|
|
# take care of the same issues as wxPoint
|
|
tools.ignoreAllOperators(c)
|
|
for f in c.find('operator+=').all() + \
|
|
c.find('operator*=').all():
|
|
f.ignore(False)
|
|
wc = etgtools.WigCode("""\
|
|
bool operator==(const wxRect& r1, const wxRect& r2);
|
|
bool operator!=(const wxRect& r1, const wxRect& r2);
|
|
wxRect operator+(const wxRect& r1, const wxRect& r2);
|
|
wxRect operator*(const wxRect& r1, const wxRect& r2);
|
|
""")
|
|
module.insertItemAfter(c, wc)
|
|
|
|
# Because of our add-ons that make wx.Point and wx.Size act like 2-element
|
|
# sequences, and also the typecheck code that allows 2-element sequences, then
|
|
# we end up with a bit of confusion about the (Point,Point) and the
|
|
# (Point,Size) overloads of the wx.Rect constructor. The confusion can be
|
|
# dealt with by using keyword args, but I think that the (Point,Size) version
|
|
# will be used more, so reorder the overloads so it is found first.
|
|
m = module.find('wxRect.wxRect')
|
|
mo = m.findOverload('topLeft')
|
|
del m.overloads[m.overloads.index(mo)]
|
|
m.overloads.append(mo)
|
|
|
|
# These methods have some overloads that will end up with the same signature
|
|
# in Python, so we have to remove one.
|
|
module.find('wxRect.Deflate').findOverload(') const').ignore()
|
|
module.find('wxRect.Inflate').findOverload(') const').ignore()
|
|
module.find('wxRect.Union').findOverload(') const').ignore()
|
|
module.find('wxRect.Intersect').findOverload(') const').ignore()
|
|
|
|
# wxRect typemap
|
|
c.convertFromPyObject = tools.convertFourIntegersTemplate('wxRect')
|
|
|
|
c.addCppMethod('PyObject*', 'Get', '()', """\
|
|
return sipBuildResult(0, "(iiii)",
|
|
self->x, self->y, self->width, self->height);
|
|
""",
|
|
pyArgsString="() -> (x, y, width, height)",
|
|
briefDoc="Return the rectangle's properties as a tuple.")
|
|
|
|
# Add sequence protocol methods and other goodies
|
|
c.addPyMethod('__str__', '(self)', 'return str(self.Get())')
|
|
c.addPyMethod('__repr__', '(self)', 'return "wx.Rect"+str(self.Get())')
|
|
c.addPyMethod('__len__', '(self)', 'return len(self.Get())')
|
|
c.addPyMethod('__nonzero__', '(self)', 'return self.Get() != (0,0,0,0)')
|
|
c.addPyMethod('__reduce__', '(self)', 'return (Rect, self.Get())')
|
|
c.addPyMethod('__getitem__', '(self, idx)', 'return self.Get()[idx]')
|
|
c.addPyMethod('__setitem__', '(self, idx, val)',
|
|
"""\
|
|
if idx == 0: self.x = val
|
|
elif idx == 1: self.y = val
|
|
elif idx == 2: self.width = val
|
|
elif idx == 3: self.height = val
|
|
else: raise IndexError
|
|
""")
|
|
c.addPyCode('Rect.__safe_for_unpickling__ = True')
|
|
|
|
|
|
|
|
#---------------------------------------
|
|
# wxRealPoint tweaks
|
|
c = module.find('wxRealPoint')
|
|
|
|
# take care of the same issues as wxPoint
|
|
tools.ignoreAllOperators(c)
|
|
for f in c.find('operator+=').all() + \
|
|
c.find('operator-=').all():
|
|
f.ignore(False)
|
|
wc = etgtools.WigCode("""\
|
|
bool operator==(const wxRealPoint& p1, const wxRealPoint& p2);
|
|
bool operator!=(const wxRealPoint& p1, const wxRealPoint& p2);
|
|
wxRealPoint operator*(const wxRealPoint& s, double i);
|
|
wxRealPoint operator*(double i, const wxRealPoint& s);
|
|
wxRealPoint operator+(const wxRealPoint& p1, const wxRealPoint& p2);
|
|
wxRealPoint operator-(const wxRealPoint& p1, const wxRealPoint& p2);
|
|
wxRealPoint operator/(const wxRealPoint& s, int i);
|
|
""")
|
|
module.insertItemAfter(c, wc)
|
|
|
|
# wxRealPoint typemap
|
|
c.convertFromPyObject = tools.convertTwoDoublesTemplate('wxRealPoint')
|
|
|
|
c.addCppMethod('PyObject*', 'Get', '()', """\
|
|
return sipBuildResult(0, "(dd)", self->x, self->y);
|
|
""",
|
|
pyArgsString="() -> (x, y)",
|
|
briefDoc="Return the point's properties as a tuple.")
|
|
|
|
# Add sequence protocol methods and other goodies
|
|
c.addPyMethod('__str__', '(self)', 'return str(self.Get())')
|
|
c.addPyMethod('__repr__', '(self)', 'return "wx.RealPoint"+str(self.Get())')
|
|
c.addPyMethod('__len__', '(self)', 'return len(self.Get())')
|
|
c.addPyMethod('__nonzero__', '(self)', 'return self.Get() != (0,0)')
|
|
c.addPyMethod('__reduce__', '(self)', 'return (Rect, self.Get())')
|
|
c.addPyMethod('__getitem__', '(self, idx)', 'return self.Get()[idx]')
|
|
c.addPyMethod('__setitem__', '(self, idx, val)',
|
|
"""\
|
|
if idx == 0: self.x = val
|
|
elif idx == 1: self.y = val
|
|
else: raise IndexError
|
|
""")
|
|
c.addPyCode('RealPoint.__safe_for_unpickling__ = True')
|
|
|
|
|
|
|
|
|
|
c = module.find('wxColourDatabase')
|
|
c.addPyMethod('FindColour', '(self, colour)', 'return self.Find(colour)')
|
|
|
|
module.find('wxTheColourDatabase').ignore()
|
|
|
|
#-----------------------------------------------------------------
|
|
tools.doCommonTweaks(module)
|
|
tools.runGenerators(module)
|
|
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
if __name__ == '__main__':
|
|
run()
|
|
|