1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
#---------------------------------------------------------------------------
# Name: etg/region.py
# Author: Robin Dunn
#
# Created: 30-Nov-2010
# Copyright: (c) 2010-2020 by Total Control Software
# License: wxWindows License
#---------------------------------------------------------------------------
import etgtools
import etgtools.tweaker_tools as tools
PACKAGE = "wx"
MODULE = "_core"
NAME = "region" # Base name of the file to generate to for this script
DOCSTRING = ""
# The classes and/or the basename of the Doxygen XML files to be processed by
# this script.
ITEMS = [ 'wxRegionIterator',
'wxRegion'
]
#---------------------------------------------------------------------------
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.
c = module.find('wxRegion')
assert isinstance(c, etgtools.ClassDef)
tools.removeVirtuals(c)
c.mustHaveApp()
# Replace one of the constructors with one having a more python-friendly API
c.find('wxRegion').findOverload('points').ignore()
c.addCppCode(tools.ObjArrayHelperTemplate('wxPoint', 'sipType_wxPoint',
"Expected a sequence of length-2 sequences or wx.Point objects."))
c.addCppCtor_sip('(PyObject* points, wxPolygonFillMode fillStyle = wxODDEVEN_RULE)',
doc="""\
Constructs a region corresponding to the polygon made from the points
in the provided sequence.""",
body="""\
size_t count;
wxPoint* array = wxPoint_array_helper(points, &count);
if ( array != NULL ) {
sipCpp = new wxRegion(count, array, fillStyle);
delete [] array;
}
if (PyErr_Occurred()) sipIsErr = 1;
""")
c.find('GetBox').findOverload('wxCoord').ignore()
# Iterator stuff
c.addPyMethod('__iter__', '(self)', 'return PyRegionIterator(self)',
"""\
Returns a rectangle iterator conforming to the Python iterator
protocol.""")
c.addPyCode("""\
class PyRegionIterator(object):
"A Python iterator for wx.Region objects"
def __init__(self, region):
self._region = region
self._iterator = wx.RegionIterator(region)
def next(self):
if not self._iterator:
raise StopIteration
rect = self._iterator.GetRect()
if self._iterator.HaveRects():
self._iterator.Next()
return rect
__next__ = next # for Python 3
""")
c = module.find('wxRegionIterator')
c.mustHaveApp()
c.find('operator++').ignore()
c.find('operator bool').ignore()
c.addCppMethod('int', '__nonzero__', '()', 'return (int)self->operator bool();',
'Returns true while there are still rectangles available in the iteration.')
c.addCppMethod('int', '__bool__', '()', 'return (int)self->operator bool();',
'Returns true while there are still rectangles available in the iteration.')
c.addCppMethod('void', 'Next', '()', 'self->operator++();',
'Move the iterator to the next rectangle in the region.')
# This is defined in the docs, but not in any of the real headers!
module.find('wxNullRegion').ignore()
#-----------------------------------------------------------------
tools.doCommonTweaks(module)
tools.runGenerators(module)
#---------------------------------------------------------------------------
if __name__ == '__main__':
run()
|
