Misc tests, scripts, etc.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@27078 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

wxPython/misc/fixdc.py

@@ -0,0 +1,130 @@
+"""
+This module will do surgery on the wx.DC class in wxPython 2.5.1.5 to
+make it act like the wx.DC class in later versions will.  To use this
+module simply import it in one of your program's modules before you
+use any DC's.  It does its work upon import and then is done.
+
+This module will *only* do something if it is imported in an app
+running on wxPython 2.5.1.5, for all other versions it will do
+nothing.  This means that you can include it with your application and
+then if your user is on 2.5.1.5 the DC methods will be updated, but if
+they are on a newer version (or an older one for that matter) then
+nothing will be done and your code using DCs will still be compatible.
+
+So what does it do? In a nutshell, the old 2.4.x style of method
+names, where the 'normal' name takes separate parameters for x, y,
+width and height will be restored, and the new methods that take
+wx.Point and/or wx.Size (which can also be converted from 2-element
+sequences) will be given new non-default method names.  The 2.5.1.5
+'XY' style names will be removed.  The new names for the 'Point/Size'
+methods are:
+
+    * BlitPointSize
+    * CrossHairPoint
+    * DrawArcPoint
+    * DrawBitmapPoint
+    * DrawCheckMarkRect
+    * DrawCirclePoint
+    * DrawEllipsePointSize
+    * DrawEllipticArcPointSize
+    * DrawIconPoint
+    * DrawLinePoint
+    * DrawPointPoint
+    * DrawRectanglePointSize
+    * DrawRotatedTextPoint
+    * DrawRoundedRectanglePointSize
+    * DrawTextPoint
+    * FloodFillPoint
+    * GetPixelPoint
+    * SetClippingRegionPointSize
+
+Please note that only the names that you access the methods by will be
+changed.  The names used in docstrings as well as the names used to
+call the extenaion functions and the names used when raising
+exceptions will still use the old names.  (Of course once a new
+version of wxPython has been built with this new style then this will
+no longer apply.  The new names will be the real names.)  For
+example::
+
+  Traceback (most recent call last):
+    File "/usr/lib/python2.3/site-packages/wx/lib/buttons.py", line 272, in OnPaint
+      self.DrawBezel(dc, x1, y1, x2, y2)
+    File "/usr/lib/python2.3/site-packages/wx/lib/buttons.py", line 220, in DrawBezel
+      dc.DrawLine((x1+i, y1), (x1+i, y2-i))
+    File "/usr/lib/python2.3/site-packages/wx/gdi.py", line 2293, in DrawLine
+      return _gdi.DC_DrawLineXY(*args, **kwargs)
+  TypeError: DC_DrawLineXY() takes exactly 5 arguments (3 given)
+
+    
+WARNING: If you import this module then the wx.DC class will be
+         changed for the entire application, so if you use code from
+         the wx.lib package (or 3rd party modules that have already
+         been converted to the doomed 2.5.1.5 implementaion of the DC
+         Draw methods) then that code will break as shown above.  This
+         is an all-or-nothing fix, (just like the next version of
+         wxPython will be,) so you *will* need to do something to
+         resolve this situation if you run into it.  The best thing to
+         do of course is to correct the library module to work with
+         the corrected DC semantics and then send me a patch, although
+         it probably won't be too long before the library modules are
+         updated in CVS so you could get a copy of them there.
+
+--Robin
+"""
+
+import wx
+
+_names = [
+    ("BlitXY",                  "Blit",                 "BlitPointSize"),
+    ("CrossHairXY",             "CrossHair",            "CrossHairPoint"),
+    ("DrawArcXY",               "DrawArc",              "DrawArcPoint"),
+    ("DrawBitmapXY",            "DrawBitmap",           "DrawBitmapPoint"),
+    ("DrawCheckMarkXY",         "DrawCheckMark",        "DrawCheckMarkRect"),
+    ("DrawCircleXY",            "DrawCircle",           "DrawCirclePoint"),
+    ("DrawEllipseXY",           "DrawEllipse",          "DrawEllipsePointSize"),
+    ("DrawEllipticArcXY",       "DrawEllipticArc",      "DrawEllipticArcPointSize"),
+    ("DrawIconXY",              "DrawIcon",             "DrawIconPoint"),
+    ("DrawLineXY",              "DrawLine",             "DrawLinePoint"),
+    ("DrawPointXY",             "DrawPoint",            "DrawPointPoint"),
+    ("DrawRectangleXY",         "DrawRectangle",        "DrawRectanglePointSize"),
+    ("DrawRotatedTextXY",       "DrawRotatedText",      "DrawRotatedTextPoint"),
+    ("DrawRoundedRectangleXY",  "DrawRoundedRectangle", "DrawRoundedRectanglePointSize"),
+    ("DrawTextXY",              "DrawText",             "DrawTextPoint"),
+    ("FloodFillXY",             "FloodFill",            "FloodFillPoint"),
+    ("GetPixelXY",              "GetPixel",             "GetPixelPoint"),
+    ("SetClippingRegionXY",     "SetClippingRegion",    "SetClippingRegionPointSize"),
+]
+
+
+# this is a bit of handy code from the Python Cookbook
+def _renamefunction(function, name):
+    """
+    This function returns a function identical to the given one, but
+    with the given name.
+    """
+    from types import FunctionType, CodeType
+    
+    c = function.func_code
+    if c.co_name != name:
+        # rename the code object.
+        c = CodeType(c.co_argcount, c.co_nlocals, c.co_stacksize,
+                     c.co_flags, c.co_code, c.co_consts,
+                     c.co_names, c.co_varnames, c.co_filename,
+                     name, c.co_firstlineno, c.co_lnotab)
+    if function.func_defaults != None:
+        return FunctionType(c, function.func_globals, name,
+                            function.func_defaults)
+    return FunctionType(c, function.func_globals, name)
+
+
+if wx.VERSION[:4] == (2,5,1,5):
+    for old, norm, new in _names:
+        m_old  = getattr(wx.DC, old)
+        m_norm = getattr(wx.DC, norm)
+        setattr(wx.DC, new,  _renamefunction(m_norm, new))
+        setattr(wx.DC, norm, _renamefunction(m_old, norm))
+        delattr(wx.DC, old)
+        
+    del old, norm, new, m_old, m_norm
+
+