wxPython/src/helpers.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        helpers.cpp
   3 // Purpose:     Helper functions/classes for the wxPython extension module
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     7/1/97
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 1998 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 #include <stdio.h>  // get the correct definition of NULL
  14
  15 #undef DEBUG
  16 #include <Python.h>
  17 #include "helpers.h"
  18
  19 #ifdef __WXMSW__
  20 #include <wx/msw/private.h>
  21 #undef FindWindow
  22 #undef GetCharWidth
  23 #undef LoadAccelerators
  24 #undef GetClassInfo
  25 #undef GetClassName
  26 #endif
  27
  28 #ifdef __WXGTK__
  29 #include <gtk/gtk.h>
  30 #include <gdk/gdkprivate.h>
  31 #include <wx/gtk/win_gtk.h>
  32 //#include <gdk/gdk.h>
  33 //#include <gdk/gdkx.h>
  34 //#include <gtk/gtkwindow.h>
  35
  36 //extern GtkWidget *wxRootWindow;
  37
  38 #endif
  39
  40
  41 //---------------------------------------------------------------------------
  42
  43 //wxHashTable*  wxPyWindows = NULL;
  44
  45
  46 wxPoint     wxPyDefaultPosition;        //wxDefaultPosition);
  47 wxSize      wxPyDefaultSize;            //wxDefaultSize);
  48 wxString    wxPyEmptyStr("");
  49
  50
  51
  52 #ifdef __WXMSW__             // If building for win32...
  53 //----------------------------------------------------------------------
  54 // This gets run when the DLL is loaded.  We just need to save a handle.
  55 //----------------------------------------------------------------------
  56
  57 BOOL WINAPI DllMain(
  58     HINSTANCE   hinstDLL,    // handle to DLL module
  59     DWORD       fdwReason,   // reason for calling function
  60     LPVOID      lpvReserved  // reserved
  61    )
  62 {
  63     wxSetInstance(hinstDLL);
  64     return 1;
  65 }
  66 #endif
  67
  68 //----------------------------------------------------------------------
  69 // Class for implementing the wxp main application shell.
  70 //----------------------------------------------------------------------
  71
  72 wxPyApp *wxPythonApp = NULL;            // Global instance of application object
  73
  74
  75 wxPyApp::wxPyApp() {
  76 //    printf("**** ctor\n");
  77 }
  78
  79 wxPyApp::~wxPyApp() {
  80 //    printf("**** dtor\n");
  81 }
  82
  83
  84 // This one isn't acutally called...  See __wxStart()
  85 bool wxPyApp::OnInit(void) {
  86     return FALSE;
  87 }
  88
  89 int  wxPyApp::MainLoop(void) {
  90     int retval = 0;
  91
  92     DeletePendingObjects();
  93 #ifdef __WXGTK__
  94     m_initialized = wxTopLevelWindows.GetCount() != 0;
  95 #endif
  96
  97     if (Initialized()) {
  98         retval = wxApp::MainLoop();
  99         wxPythonApp->OnExit();
 100     }
 101     return retval;
 102 }
 103
 104
 105 //---------------------------------------------------------------------
 106 //----------------------------------------------------------------------
 107
 108 int  WXDLLEXPORT wxEntryStart( int argc, char** argv );
 109 int  WXDLLEXPORT wxEntryInitGui();
 110 void WXDLLEXPORT wxEntryCleanup();
 111
 112
 113 #ifdef WXP_WITH_THREAD
 114 PyThreadState*  wxPyEventThreadState = NULL;
 115 #endif
 116 static char* __nullArgv[1] = { 0 };
 117
 118
 119 // This is where we pick up the first part of the wxEntry functionality...
 120 // The rest is in __wxStart and  __wxCleanup.  This function is called when
 121 // wxcmodule is imported.  (Before there is a wxApp object.)
 122 void __wxPreStart()
 123 {
 124 #ifdef WXP_WITH_THREAD
 125     PyEval_InitThreads();
 126     wxPyEventThreadState = PyThreadState_Get();
 127 #endif
 128
 129     // Bail out if there is already windows created.  This means that the
 130     // toolkit has already been initialized, as in embedding wxPython in
 131     // a C++ wxWindows app.
 132     if (wxTopLevelWindows.Number() > 0)
 133         return;
 134
 135
 136     PyObject* sysargv = PySys_GetObject("argv");
 137     int argc = PyList_Size(sysargv);
 138     char** argv = new char*[argc+1];
 139     int x;
 140     for(x=0; x<argc; x++)
 141         argv[x] = PyString_AsString(PyList_GetItem(sysargv, x));
 142     argv[argc] = NULL;
 143
 144     wxEntryStart(argc, argv);
 145     delete [] argv;
 146 }
 147
 148
 149
 150 // Start the user application, user App's OnInit method is a parameter here
 151 PyObject* __wxStart(PyObject* /* self */, PyObject* args)
 152 {
 153     PyObject*   onInitFunc = NULL;
 154     PyObject*   arglist;
 155     PyObject*   result;
 156     long        bResult;
 157
 158     if (!PyArg_ParseTuple(args, "O", &onInitFunc))
 159         return NULL;
 160
 161     if (wxTopLevelWindows.Number() > 0) {
 162         PyErr_SetString(PyExc_TypeError, "Only 1 wxApp per process!");
 163         return NULL;
 164     }
 165
 166
 167     // This is the next part of the wxEntry functionality...
 168     PyObject* sysargv = PySys_GetObject("argv");
 169     int argc = PyList_Size(sysargv);
 170     char** argv = new char*[argc+1];
 171     int x;
 172     for(x=0; x<argc; x++)
 173         argv[x] = copystring(PyString_AsString(PyList_GetItem(sysargv, x)));
 174     argv[argc] = NULL;
 175
 176     wxPythonApp->argc = argc;
 177     wxPythonApp->argv = argv;
 178
 179     wxEntryInitGui();
 180
 181     // Call the Python App's OnInit function
 182     arglist = PyTuple_New(0);
 183     result = PyEval_CallObject(onInitFunc, arglist);
 184     if (!result) {      // an exception was raised.
 185         return NULL;
 186     }
 187
 188     if (! PyInt_Check(result)) {
 189         PyErr_SetString(PyExc_TypeError, "OnInit should return a boolean value");
 190         return NULL;
 191     }
 192     bResult = PyInt_AS_LONG(result);
 193     if (! bResult) {
 194         PyErr_SetString(PyExc_SystemExit, "OnInit returned FALSE, exiting...");
 195         return NULL;
 196     }
 197
 198 #ifdef __WXGTK__
 199     wxTheApp->m_initialized = (wxTopLevelWindows.GetCount() > 0);
 200 #endif
 201
 202     Py_INCREF(Py_None);
 203     return Py_None;
 204 }
 205
 206 void __wxCleanup() {
 207     wxEntryCleanup();
 208 }
 209
 210
 211
 212 PyObject* wxPython_dict;
 213 PyObject* __wxSetDictionary(PyObject* /* self */, PyObject* args)
 214 {
 215
 216     if (!PyArg_ParseTuple(args, "O", &wxPython_dict))
 217         return NULL;
 218
 219     if (!PyDict_Check(wxPython_dict)) {
 220         PyErr_SetString(PyExc_TypeError, "_wxSetDictionary must have dictionary object!");
 221         return NULL;
 222     }
 223 #ifdef __WXMOTIF__
 224 #define wxPlatform "__WXMOTIF__"
 225 #endif
 226 #ifdef __WXQT__
 227 #define wxPlatform "__WXQT__"
 228 #endif
 229 #ifdef __WXGTK__
 230 #define wxPlatform "__WXGTK__"
 231 #endif
 232 #if defined(__WIN32__) || defined(__WXMSW__)
 233 #define wxPlatform "__WXMSW__"
 234 #endif
 235 #ifdef __WXMAC__
 236 #define wxPlatform "__WXMAC__"
 237 #endif
 238
 239     PyDict_SetItemString(wxPython_dict, "wxPlatform", PyString_FromString(wxPlatform));
 240
 241     Py_INCREF(Py_None);
 242     return Py_None;
 243 }
 244
 245
 246 //---------------------------------------------------------------------------
 247
 248 PyObject* wxPyConstructObject(void* ptr,
 249                                  const char* className,
 250                                  int setThisOwn) {
 251     PyObject* obj;
 252     PyObject* arg;
 253
 254     if (!ptr) {
 255         Py_INCREF(Py_None);
 256         return Py_None;
 257     }
 258
 259     char    buff[64];               // should always be big enough...
 260     char    swigptr[64];
 261
 262     sprintf(buff, "_%s_p", className);
 263     SWIG_MakePtr(swigptr, ptr, buff);
 264
 265     sprintf(buff, "%sPtr", className);
 266     PyObject* classobj = PyDict_GetItemString(wxPython_dict, buff);
 267     if (! classobj) {
 268         //Py_INCREF(Py_None);
 269         //return Py_None;
 270         char temp[128];
 271         sprintf(temp,
 272                 "*** Unknown class name %s, tell Robin about it please ***",
 273                 buff);
 274         obj = PyString_FromString(temp);
 275         return obj;
 276     }
 277
 278     arg = Py_BuildValue("(s)", swigptr);
 279     obj = PyInstance_New(classobj, arg, NULL);
 280     Py_DECREF(arg);
 281
 282     if (setThisOwn) {
 283         PyObject_SetAttrString(obj, "thisown", PyInt_FromLong(1));
 284     }
 285
 286     return obj;
 287 }
 288
 289 //---------------------------------------------------------------------------
 290
 291 static unsigned int _wxPyNestCount = 0;
 292
 293 static PyThreadState* myPyThreadState_Get() {
 294     PyThreadState* current;
 295     current = PyThreadState_Swap(NULL);
 296     PyThreadState_Swap(current);
 297     return current;
 298 }
 299
 300
 301 HELPEREXPORT bool wxPyRestoreThread() {
 302     // NOTE: The Python API docs state that if a thread already has the
 303     // interpreter lock and calls PyEval_RestoreThread again a deadlock
 304     // occurs, so I put in this code as a guard condition since there are
 305     // many possibilites for nested events and callbacks in wxPython.  If
 306     // The current thread is our thread, then we can assume that we
 307     // already have the lock.  (I hope!)
 308     //
 309 #ifdef WXP_WITH_THREAD
 310     _wxPyNestCount += 1;
 311     if (wxPyEventThreadState != myPyThreadState_Get()) {
 312         PyEval_RestoreThread(wxPyEventThreadState);
 313         return TRUE;
 314     }
 315     else
 316 #endif
 317         return FALSE;
 318 }
 319
 320
 321 HELPEREXPORT void wxPySaveThread(bool doSave) {
 322 #ifdef WXP_WITH_THREAD
 323     if (doSave) {
 324         wxPyEventThreadState = PyEval_SaveThread();
 325     }
 326     _wxPyNestCount -= 1;
 327 #endif
 328 }
 329
 330 //---------------------------------------------------------------------------
 331
 332
 333 IMPLEMENT_ABSTRACT_CLASS(wxPyCallback, wxObject);
 334
 335 wxPyCallback::wxPyCallback(PyObject* func) {
 336     m_func = func;
 337     Py_INCREF(m_func);
 338 }
 339
 340 wxPyCallback::wxPyCallback(const wxPyCallback& other) {
 341     m_func = other.m_func;
 342     Py_INCREF(m_func);
 343 }
 344
 345 wxPyCallback::~wxPyCallback() {
 346     bool doSave = wxPyRestoreThread();
 347     Py_DECREF(m_func);
 348     wxPySaveThread(doSave);
 349 }
 350
 351
 352
 353 // This function is used for all events destined for Python event handlers.
 354 void wxPyCallback::EventThunker(wxEvent& event) {
 355     wxPyCallback*   cb = (wxPyCallback*)event.m_callbackUserData;
 356     PyObject*       func = cb->m_func;
 357     PyObject*       result;
 358     PyObject*       arg;
 359     PyObject*       tuple;
 360
 361
 362     bool doSave = wxPyRestoreThread();
 363     wxString className = event.GetClassInfo()->GetClassName();
 364
 365     if (className == "wxPyEvent")
 366         arg = ((wxPyEvent*)&event)->GetSelf();
 367     else if (className == "wxPyCommandEvent")
 368         arg = ((wxPyCommandEvent*)&event)->GetSelf();
 369     else
 370         arg = wxPyConstructObject((void*)&event, className);
 371
 372     tuple = PyTuple_New(1);
 373     PyTuple_SET_ITEM(tuple, 0, arg);
 374     result = PyEval_CallObject(func, tuple);
 375     Py_DECREF(tuple);
 376     if (result) {
 377         Py_DECREF(result);
 378         PyErr_Clear();
 379     } else {
 380         PyErr_Print();
 381     }
 382     wxPySaveThread(doSave);
 383 }
 384
 385
 386 //----------------------------------------------------------------------
 387
 388 wxPyCallbackHelper::wxPyCallbackHelper() {
 389     m_class = NULL;
 390     m_self = NULL;
 391     m_lastFound = NULL;
 392     m_incRef = FALSE;
 393 }
 394
 395
 396 wxPyCallbackHelper::~wxPyCallbackHelper() {
 397     bool doSave = wxPyRestoreThread();
 398     if (m_incRef) {
 399         Py_XDECREF(m_self);
 400         Py_XDECREF(m_class);
 401     }
 402     wxPySaveThread(doSave);
 403 }
 404
 405 wxPyCallbackHelper::wxPyCallbackHelper(const wxPyCallbackHelper& other) {
 406       m_lastFound = NULL;
 407       m_self = other.m_self;
 408       m_class = other.m_class;
 409       if (m_self) {
 410           Py_INCREF(m_self);
 411           Py_INCREF(m_class);
 412       }
 413 }
 414
 415
 416 void wxPyCallbackHelper::setSelf(PyObject* self, PyObject* klass, int incref) {
 417     m_self = self;
 418     m_class = klass;
 419     m_incRef = incref;
 420     if (incref) {
 421         Py_INCREF(m_self);
 422         Py_INCREF(m_class);
 423     }
 424 }
 425
 426
 427 // If the object (m_self) has an attibute of the given name, and if that
 428 // attribute is a method, and if that method's class is not from a base class,
 429 // then we'll save a pointer to the method so callCallback can call it.
 430 bool wxPyCallbackHelper::findCallback(const wxString& name) const {
 431     wxPyCallbackHelper* self = (wxPyCallbackHelper*)this; // cast away const
 432     self->m_lastFound = NULL;
 433     if (m_self && PyObject_HasAttrString(m_self, (char*)name.c_str())) {
 434         PyObject* method;
 435         method = PyObject_GetAttrString(m_self, (char*)name.c_str());
 436
 437         if (PyMethod_Check(method) &&
 438             ((PyMethod_GET_CLASS(method) == m_class) ||
 439              PyClass_IsSubclass(PyMethod_GET_CLASS(method), m_class))) {
 440
 441             self->m_lastFound = method;
 442         }
 443     }
 444     return m_lastFound != NULL;
 445 }
 446
 447
 448 int wxPyCallbackHelper::callCallback(PyObject* argTuple) const {
 449     PyObject*   result;
 450     int         retval = FALSE;
 451
 452     result = callCallbackObj(argTuple);
 453     if (result) {                       // Assumes an integer return type...
 454         retval = PyInt_AsLong(result);
 455         Py_DECREF(result);
 456         PyErr_Clear();                  // forget about it if it's not...
 457     }
 458     return retval;
 459 }
 460
 461 // Invoke the Python callable object, returning the raw PyObject return
 462 // value.  Caller should DECREF the return value and also call PyEval_SaveThread.
 463 PyObject* wxPyCallbackHelper::callCallbackObj(PyObject* argTuple) const {
 464     PyObject*   result;
 465
 466     result = PyEval_CallObject(m_lastFound, argTuple);
 467     Py_DECREF(argTuple);
 468     if (!result) {
 469         PyErr_Print();
 470     }
 471     return result;
 472 }
 473
 474
 475
 476 //---------------------------------------------------------------------------
 477 //---------------------------------------------------------------------------
 478 // These classes can be derived from in Python and passed through the event
 479 // system without losing anything.  They do this by keeping a reference to
 480 // themselves and some special case handling in wxPyCallback::EventThunker.
 481
 482
 483 wxPyEvtSelfRef::wxPyEvtSelfRef() {
 484     //m_self = Py_None;         // **** We don't do normal ref counting to prevent
 485     //Py_INCREF(m_self);        //      circular loops...
 486     m_cloned = FALSE;
 487 }
 488
 489 wxPyEvtSelfRef::~wxPyEvtSelfRef() {
 490     bool doSave = wxPyRestoreThread();
 491     if (m_cloned)
 492         Py_DECREF(m_self);
 493     wxPySaveThread(doSave);
 494 }
 495
 496 void wxPyEvtSelfRef::SetSelf(PyObject* self, bool clone) {
 497     bool doSave = wxPyRestoreThread();
 498     if (m_cloned)
 499         Py_DECREF(m_self);
 500     m_self = self;
 501     if (clone) {
 502         Py_INCREF(m_self);
 503         m_cloned = TRUE;
 504     }
 505     wxPySaveThread(doSave);
 506 }
 507
 508 PyObject* wxPyEvtSelfRef::GetSelf() const {
 509     Py_INCREF(m_self);
 510     return m_self;
 511 }
 512
 513
 514 wxPyEvent::wxPyEvent(int id)
 515     : wxEvent(id) {
 516 }
 517
 518 wxPyEvent::~wxPyEvent() {
 519 }
 520
 521 // This one is so the event object can be Cloned...
 522 void wxPyEvent::CopyObject(wxObject& dest) const {
 523     wxEvent::CopyObject(dest);
 524     ((wxPyEvent*)&dest)->SetSelf(m_self, TRUE);
 525 }
 526
 527
 528 IMPLEMENT_DYNAMIC_CLASS(wxPyEvent, wxEvent);
 529
 530
 531 wxPyCommandEvent::wxPyCommandEvent(wxEventType commandType, int id)
 532     : wxCommandEvent(commandType, id) {
 533 }
 534
 535 wxPyCommandEvent::~wxPyCommandEvent() {
 536 }
 537
 538 void wxPyCommandEvent::CopyObject(wxObject& dest) const {
 539     wxCommandEvent::CopyObject(dest);
 540     ((wxPyCommandEvent*)&dest)->SetSelf(m_self, TRUE);
 541 }
 542
 543
 544 IMPLEMENT_DYNAMIC_CLASS(wxPyCommandEvent, wxCommandEvent);
 545
 546
 547
 548 //---------------------------------------------------------------------------
 549 //---------------------------------------------------------------------------
 550
 551
 552 wxPyTimer::wxPyTimer(PyObject* callback) {
 553     func = callback;
 554     Py_INCREF(func);
 555 }
 556
 557 wxPyTimer::~wxPyTimer() {
 558     bool doSave = wxPyRestoreThread();
 559     Py_DECREF(func);
 560     wxPySaveThread(doSave);
 561 }
 562
 563 void wxPyTimer::Notify() {
 564     bool doSave = wxPyRestoreThread();
 565
 566     PyObject*   result;
 567     PyObject*   args = Py_BuildValue("()");
 568
 569     result = PyEval_CallObject(func, args);
 570     Py_DECREF(args);
 571     if (result) {
 572         Py_DECREF(result);
 573         PyErr_Clear();
 574     } else {
 575         PyErr_Print();
 576     }
 577     wxPySaveThread(doSave);
 578 }
 579
 580
 581
 582 //---------------------------------------------------------------------------
 583 //---------------------------------------------------------------------------
 584 // Convert a wxList to a Python List
 585
 586 PyObject* wxPy_ConvertList(wxListBase* list, const char* className) {
 587     PyObject*   pyList;
 588     PyObject*   pyObj;
 589     wxObject*   wxObj;
 590     wxNode*     node = list->First();
 591
 592     bool doSave = wxPyRestoreThread();
 593     pyList = PyList_New(0);
 594     while (node) {
 595         wxObj = node->Data();
 596         pyObj = wxPyConstructObject(wxObj, className);
 597         PyList_Append(pyList, pyObj);
 598         node = node->Next();
 599     }
 600     wxPySaveThread(doSave);
 601     return pyList;
 602 }
 603
 604 //----------------------------------------------------------------------
 605
 606 long wxPyGetWinHandle(wxWindow* win) {
 607 #ifdef __WXMSW__
 608     return (long)win->GetHandle();
 609 #endif
 610
 611     // Find and return the actual X-Window.
 612 #ifdef __WXGTK__
 613     if (win->m_wxwindow) {
 614         GdkWindowPrivate* bwin = (GdkWindowPrivate*)GTK_PIZZA(win->m_wxwindow)->bin_window;
 615         if (bwin) {
 616             return (long)bwin->xwindow;
 617         }
 618     }
 619 #endif
 620     return 0;
 621 }
 622
 623 //----------------------------------------------------------------------
 624 // Some helper functions for typemaps in my_typemaps.i, so they won't be
 625 // included in every file...
 626
 627
 628 byte* byte_LIST_helper(PyObject* source) {
 629     if (!PyList_Check(source)) {
 630         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 631         return NULL;
 632     }
 633     int count = PyList_Size(source);
 634     byte* temp = new byte[count];
 635     if (! temp) {
 636         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 637         return NULL;
 638     }
 639     for (int x=0; x<count; x++) {
 640         PyObject* o = PyList_GetItem(source, x);
 641         if (! PyInt_Check(o)) {
 642             PyErr_SetString(PyExc_TypeError, "Expected a list of integers.");
 643             return NULL;
 644         }
 645         temp[x] = (byte)PyInt_AsLong(o);
 646     }
 647     return temp;
 648 }
 649
 650
 651 int* int_LIST_helper(PyObject* source) {
 652     if (!PyList_Check(source)) {
 653         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 654         return NULL;
 655     }
 656     int count = PyList_Size(source);
 657     int* temp = new int[count];
 658     if (! temp) {
 659         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 660         return NULL;
 661     }
 662     for (int x=0; x<count; x++) {
 663         PyObject* o = PyList_GetItem(source, x);
 664         if (! PyInt_Check(o)) {
 665             PyErr_SetString(PyExc_TypeError, "Expected a list of integers.");
 666             return NULL;
 667         }
 668         temp[x] = PyInt_AsLong(o);
 669     }
 670     return temp;
 671 }
 672
 673
 674 long* long_LIST_helper(PyObject* source) {
 675     if (!PyList_Check(source)) {
 676         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 677         return NULL;
 678     }
 679     int count = PyList_Size(source);
 680     long* temp = new long[count];
 681     if (! temp) {
 682         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 683         return NULL;
 684     }
 685     for (int x=0; x<count; x++) {
 686         PyObject* o = PyList_GetItem(source, x);
 687         if (! PyInt_Check(o)) {
 688             PyErr_SetString(PyExc_TypeError, "Expected a list of integers.");
 689             return NULL;
 690         }
 691         temp[x] = PyInt_AsLong(o);
 692     }
 693     return temp;
 694 }
 695
 696
 697 char** string_LIST_helper(PyObject* source) {
 698     if (!PyList_Check(source)) {
 699         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 700         return NULL;
 701     }
 702     int count = PyList_Size(source);
 703     char** temp = new char*[count];
 704     if (! temp) {
 705         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 706         return NULL;
 707     }
 708     for (int x=0; x<count; x++) {
 709         PyObject* o = PyList_GetItem(source, x);
 710         if (! PyString_Check(o)) {
 711             PyErr_SetString(PyExc_TypeError, "Expected a list of strings.");
 712             return NULL;
 713         }
 714         temp[x] = PyString_AsString(o);
 715     }
 716     return temp;
 717 }
 718
 719
 720
 721 wxPoint* wxPoint_LIST_helper(PyObject* source) {
 722     if (!PyList_Check(source)) {
 723         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 724         return NULL;
 725     }
 726     int count = PyList_Size(source);
 727     wxPoint* temp = new wxPoint[count];
 728     if (! temp) {
 729         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 730         return NULL;
 731     }
 732     for (int x=0; x<count; x++) {
 733         PyObject* o = PyList_GetItem(source, x);
 734         if (PyTuple_Check(o)) {
 735             PyObject* o1 = PyTuple_GetItem(o, 0);
 736             PyObject* o2 = PyTuple_GetItem(o, 1);
 737
 738             temp[x].x = PyInt_AsLong(o1);
 739             temp[x].y = PyInt_AsLong(o2);
 740         }
 741         else if (PyInstance_Check(o)) {
 742             wxPoint* pt;
 743             if (SWIG_GetPtrObj(o,(void **) &pt,"_wxPoint_p")) {
 744                 PyErr_SetString(PyExc_TypeError,"Expected _wxPoint_p.");
 745                 return NULL;
 746             }
 747             temp[x] = *pt;
 748         }
 749         else {
 750             PyErr_SetString(PyExc_TypeError, "Expected a list of 2-tuples or wxPoints.");
 751             return NULL;
 752         }
 753     }
 754     return temp;
 755 }
 756
 757
 758 wxBitmap** wxBitmap_LIST_helper(PyObject* source) {
 759     if (!PyList_Check(source)) {
 760         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 761         return NULL;
 762     }
 763     int count = PyList_Size(source);
 764     wxBitmap** temp = new wxBitmap*[count];
 765     if (! temp) {
 766         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 767         return NULL;
 768     }
 769     for (int x=0; x<count; x++) {
 770         PyObject* o = PyList_GetItem(source, x);
 771         if (PyInstance_Check(o)) {
 772             wxBitmap*    pt;
 773             if (SWIG_GetPtrObj(o, (void **) &pt,"_wxBitmap_p")) {
 774                 PyErr_SetString(PyExc_TypeError,"Expected _wxBitmap_p.");
 775                 return NULL;
 776             }
 777             temp[x] = pt;
 778         }
 779         else {
 780             PyErr_SetString(PyExc_TypeError, "Expected a list of wxBitmaps.");
 781             return NULL;
 782         }
 783     }
 784     return temp;
 785 }
 786
 787
 788
 789 wxString* wxString_LIST_helper(PyObject* source) {
 790     if (!PyList_Check(source)) {
 791         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 792         return NULL;
 793     }
 794     int count = PyList_Size(source);
 795     wxString* temp = new wxString[count];
 796     if (! temp) {
 797         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 798         return NULL;
 799     }
 800     for (int x=0; x<count; x++) {
 801         PyObject* o = PyList_GetItem(source, x);
 802         if (! PyString_Check(o)) {
 803             PyErr_SetString(PyExc_TypeError, "Expected a list of strings.");
 804             return NULL;
 805         }
 806         temp[x] = PyString_AsString(o);
 807     }
 808     return temp;
 809 }
 810
 811
 812 wxAcceleratorEntry* wxAcceleratorEntry_LIST_helper(PyObject* source) {
 813     if (!PyList_Check(source)) {
 814         PyErr_SetString(PyExc_TypeError, "Expected a list object.");
 815         return NULL;
 816     }
 817     int count                = PyList_Size(source);
 818     wxAcceleratorEntry* temp = new wxAcceleratorEntry[count];
 819     if (! temp) {
 820         PyErr_SetString(PyExc_MemoryError, "Unable to allocate temporary array");
 821         return NULL;
 822     }
 823     for (int x=0; x<count; x++) {
 824         PyObject* o = PyList_GetItem(source, x);
 825         if (PyInstance_Check(o)) {
 826             wxAcceleratorEntry* ae;
 827             if (SWIG_GetPtrObj(o, (void **) &ae,"_wxAcceleratorEntry_p")) {
 828                 PyErr_SetString(PyExc_TypeError,"Expected _wxAcceleratorEntry_p.");
 829                 return NULL;
 830             }
 831             temp[x] = *ae;
 832         }
 833         else if (PyTuple_Check(o)) {
 834             PyObject* o1 = PyTuple_GetItem(o, 0);
 835             PyObject* o2 = PyTuple_GetItem(o, 1);
 836             PyObject* o3 = PyTuple_GetItem(o, 2);
 837
 838             temp[x].m_flags   = PyInt_AsLong(o1);
 839             temp[x].m_keyCode = PyInt_AsLong(o2);
 840             temp[x].m_command = PyInt_AsLong(o3);
 841         }
 842         else {
 843             PyErr_SetString(PyExc_TypeError, "Expected a list of 3-tuples or wxAcceleratorEntry objects.");
 844             return NULL;
 845         }
 846     }
 847     return temp;
 848 }
 849
 850
 851
 852 //----------------------------------------------------------------------
 853
 854 bool wxSize_helper(PyObject* source, wxSize** obj) {
 855
 856     // If source is an object instance then it may already be the right type
 857     if (PyInstance_Check(source)) {
 858         wxSize* ptr;
 859         if (SWIG_GetPtrObj(source, (void **)&ptr, "_wxSize_p"))
 860             goto error;
 861         *obj = ptr;
 862         return TRUE;
 863     }
 864     // otherwise a 2-tuple of integers is expected
 865     else if (PySequence_Check(source) && PyObject_Length(source) == 2) {
 866         PyObject* o1 = PySequence_GetItem(source, 0);
 867         PyObject* o2 = PySequence_GetItem(source, 1);
 868         **obj = wxSize(PyInt_AsLong(o1), PyInt_AsLong(o2));
 869         return TRUE;
 870     }
 871
 872  error:
 873     PyErr_SetString(PyExc_TypeError, "Expected a 2-tuple of integers or a wxSize object.");
 874     return FALSE;
 875 }
 876
 877 bool wxPoint_helper(PyObject* source, wxPoint** obj) {
 878
 879     // If source is an object instance then it may already be the right type
 880     if (PyInstance_Check(source)) {
 881         wxPoint* ptr;
 882         if (SWIG_GetPtrObj(source, (void **)&ptr, "_wxPoint_p"))
 883             goto error;
 884         *obj = ptr;
 885         return TRUE;
 886     }
 887     // otherwise a 2-tuple of integers is expected
 888     else if (PySequence_Check(source) && PyObject_Length(source) == 2) {
 889         PyObject* o1 = PySequence_GetItem(source, 0);
 890         PyObject* o2 = PySequence_GetItem(source, 1);
 891         **obj = wxPoint(PyInt_AsLong(o1), PyInt_AsLong(o2));
 892         return TRUE;
 893     }
 894
 895  error:
 896     PyErr_SetString(PyExc_TypeError, "Expected a 2-tuple of integers or a wxPoint object.");
 897     return FALSE;
 898 }
 899
 900
 901
 902 bool wxRealPoint_helper(PyObject* source, wxRealPoint** obj) {
 903
 904     // If source is an object instance then it may already be the right type
 905     if (PyInstance_Check(source)) {
 906         wxRealPoint* ptr;
 907         if (SWIG_GetPtrObj(source, (void **)&ptr, "_wxRealPoint_p"))
 908             goto error;
 909         *obj = ptr;
 910         return TRUE;
 911     }
 912     // otherwise a 2-tuple of floats is expected
 913     else if (PySequence_Check(source) && PyObject_Length(source) == 2) {
 914         PyObject* o1 = PySequence_GetItem(source, 0);
 915         PyObject* o2 = PySequence_GetItem(source, 1);
 916         **obj = wxRealPoint(PyFloat_AsDouble(o1), PyFloat_AsDouble(o2));
 917         return TRUE;
 918     }
 919
 920  error:
 921     PyErr_SetString(PyExc_TypeError, "Expected a 2-tuple of floats or a wxRealPoint object.");
 922     return FALSE;
 923 }
 924
 925
 926
 927
 928 bool wxRect_helper(PyObject* source, wxRect** obj) {
 929
 930     // If source is an object instance then it may already be the right type
 931     if (PyInstance_Check(source)) {
 932         wxRect* ptr;
 933         if (SWIG_GetPtrObj(source, (void **)&ptr, "_wxRect_p"))
 934             goto error;
 935         *obj = ptr;
 936         return TRUE;
 937     }
 938     // otherwise a 4-tuple of integers is expected
 939     else if (PySequence_Check(source) && PyObject_Length(source) == 4) {
 940         PyObject* o1 = PySequence_GetItem(source, 0);
 941         PyObject* o2 = PySequence_GetItem(source, 1);
 942         PyObject* o3 = PySequence_GetItem(source, 2);
 943         PyObject* o4 = PySequence_GetItem(source, 3);
 944         **obj = wxRect(PyInt_AsLong(o1), PyInt_AsLong(o2),
 945                      PyInt_AsLong(o3), PyInt_AsLong(o4));
 946         return TRUE;
 947     }
 948
 949  error:
 950     PyErr_SetString(PyExc_TypeError, "Expected a 4-tuple of integers or a wxRect object.");
 951     return FALSE;
 952 }
 953
 954
 955
 956 bool wxColour_helper(PyObject* source, wxColour** obj) {
 957
 958     // If source is an object instance then it may already be the right type
 959     if (PyInstance_Check(source)) {
 960         wxColour* ptr;
 961         if (SWIG_GetPtrObj(source, (void **)&ptr, "_wxColour_p"))
 962             goto error;
 963         *obj = ptr;
 964         return TRUE;
 965     }
 966     // otherwise a string is expected
 967     else if (PyString_Check(source)) {
 968         wxString spec = PyString_AS_STRING(source);
 969         if (spec[0] == '#' && spec.Length() == 7) {  // It's  #RRGGBB
 970             char* junk;
 971             int red   = strtol(spec.Mid(1,2), &junk, 16);
 972             int green = strtol(spec.Mid(3,2), &junk, 16);
 973             int blue  = strtol(spec.Mid(5,2), &junk, 16);
 974             **obj = wxColour(red, green, blue);
 975             return TRUE;
 976         }
 977         else {                                       // it's a colour name
 978             **obj = wxColour(spec);
 979             return TRUE;
 980         }
 981     }
 982
 983  error:
 984     PyErr_SetString(PyExc_TypeError, "Expected a wxColour object or a string containing a colour name or #RRGGBB.");
 985     return FALSE;
 986 }
 987
 988
 989 //----------------------------------------------------------------------
 990 //----------------------------------------------------------------------
 991 //----------------------------------------------------------------------
 992
 993
 994