src/gtk/app.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/gtk/app.cpp
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Id:          $Id$
   6 // Copyright:   (c) 1998 Robert Roebling, Julian Smart
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 #ifdef __VMS
  11 // vms_jackets.h should for proper working be included before anything else
  12 # include <vms_jackets.h>
  13 #undef ConnectionNumber
  14 #endif
  15
  16 // For compilers that support precompilation, includes "wx.h".
  17 #include "wx/wxprec.h"
  18
  19 #include "wx/app.h"
  20
  21 #ifndef WX_PRECOMP
  22     #include "wx/intl.h"
  23     #include "wx/log.h"
  24     #include "wx/utils.h"
  25     #include "wx/memory.h"
  26     #include "wx/font.h"
  27 #endif
  28
  29 #include "wx/thread.h"
  30
  31 #ifdef __WXGPE__
  32     #include <gpe/init.h>
  33 #endif
  34
  35 #include "wx/gtk/win_gtk.h"
  36 #include "wx/gtk/private.h"
  37
  38 #include <gdk/gdkx.h>
  39
  40 //-----------------------------------------------------------------------------
  41 // link GnomeVFS
  42 //-----------------------------------------------------------------------------
  43
  44 #if wxUSE_MIMETYPE && wxUSE_LIBGNOMEVFS
  45     #include "wx/link.h"
  46     wxFORCE_LINK_MODULE(gnome_vfs)
  47 #endif
  48
  49 //-----------------------------------------------------------------------------
  50 // global data
  51 //-----------------------------------------------------------------------------
  52
  53 bool   g_mainThreadLocked = false;
  54
  55 static GtkWidget *gs_RootWindow = (GtkWidget*) NULL;
  56
  57 //-----------------------------------------------------------------------------
  58 // idle system
  59 //-----------------------------------------------------------------------------
  60
  61 void wxapp_install_idle_handler();
  62
  63 #if wxUSE_THREADS
  64 static wxMutex gs_idleTagsMutex;
  65 #endif
  66
  67 //-----------------------------------------------------------------------------
  68 // wxYield
  69 //-----------------------------------------------------------------------------
  70
  71 // not static because used by textctrl.cpp
  72 //
  73 // MT-FIXME
  74 bool wxIsInsideYield = false;
  75
  76 bool wxApp::Yield(bool onlyIfNeeded)
  77 {
  78     if ( wxIsInsideYield )
  79     {
  80         if ( !onlyIfNeeded )
  81         {
  82             wxFAIL_MSG( wxT("wxYield called recursively" ) );
  83         }
  84
  85         return false;
  86     }
  87
  88 #if wxUSE_THREADS
  89     if ( !wxThread::IsMain() )
  90     {
  91         // can't call gtk_main_iteration() from other threads like this
  92         return true;
  93     }
  94 #endif // wxUSE_THREADS
  95
  96     wxIsInsideYield = true;
  97
  98     // We need to remove idle callbacks or the loop will
  99     // never finish.
 100     SuspendIdleCallback();
 101
 102 #if wxUSE_LOG
 103     // disable log flushing from here because a call to wxYield() shouldn't
 104     // normally result in message boxes popping up &c
 105     wxLog::Suspend();
 106 #endif
 107
 108     while (gtk_events_pending())
 109         gtk_main_iteration();
 110
 111     // It's necessary to call ProcessIdle() to update the frames sizes which
 112     // might have been changed (it also will update other things set from
 113     // OnUpdateUI() which is a nice (and desired) side effect). But we
 114     // call ProcessIdle() only once since this is not meant for longish
 115     // background jobs (controlled by wxIdleEvent::RequestMore() and the
 116     // return value of Processidle().
 117     ProcessIdle();
 118
 119 #if wxUSE_LOG
 120     // let the logs be flashed again
 121     wxLog::Resume();
 122 #endif
 123
 124     wxIsInsideYield = false;
 125
 126     return true;
 127 }
 128
 129 //-----------------------------------------------------------------------------
 130 // wxWakeUpIdle
 131 //-----------------------------------------------------------------------------
 132
 133 // RR/KH: No wxMutexGui calls are needed here according to the GTK faq,
 134 // http://www.gtk.org/faq/#AEN500 - this caused problems for wxPostEvent.
 135
 136 void wxApp::WakeUpIdle()
 137 {
 138     wxapp_install_idle_handler();
 139 }
 140
 141 //-----------------------------------------------------------------------------
 142 // local functions
 143 //-----------------------------------------------------------------------------
 144
 145 // the callback functions must be extern "C" to comply with GTK+ declarations
 146 extern "C"
 147 {
 148
 149 // One-shot emission hook for "event" signal, to install idle handler.
 150 // This will be called when the "event" signal is issued on any GtkWidget object.
 151 static gboolean
 152 event_emission_hook(GSignalInvocationHint*, guint, const GValue*, gpointer)
 153 {
 154     wxapp_install_idle_handler();
 155     // remove hook
 156     return false;
 157 }
 158
 159 // add emission hook for "event" signal, to re-install idle handler when needed
 160 static inline void wxAddEmissionHook()
 161 {
 162     GType widgetType = GTK_TYPE_WIDGET;
 163     // if GtkWidget type is loaded
 164     if (g_type_class_peek(widgetType) != NULL)
 165     {
 166         guint sig_id = g_signal_lookup("event", widgetType);
 167         g_signal_add_emission_hook(sig_id, 0, event_emission_hook, NULL, NULL);
 168     }
 169 }
 170
 171 static gint wxapp_idle_callback( gpointer WXUNUSED(data) )
 172 {
 173     // this does not look possible, but just in case...
 174     if (!wxTheApp)
 175         return false;
 176
 177     bool moreIdles = false;
 178
 179 #ifdef __WXDEBUG__
 180     // don't generate the idle events while the assert modal dialog is shown,
 181     // this matches the behavior of wxMSW
 182     if (!wxTheApp->IsInAssert())
 183 #endif // __WXDEBUG__
 184     {
 185         guint idleID_save;
 186         {
 187             // Allow another idle source to be added while this one is busy.
 188             // Needed if an idle event handler runs a new event loop,
 189             // for example by showing a dialog.
 190 #if wxUSE_THREADS
 191             wxMutexLocker lock(gs_idleTagsMutex);
 192 #endif
 193             idleID_save = wxTheApp->m_idleTag;
 194             wxTheApp->m_idleTag = 0;
 195             g_isIdle = true;
 196             wxAddEmissionHook();
 197         }
 198
 199         // When getting called from GDK's time-out handler
 200         // we are no longer within GDK's grab on the GUI
 201         // thread so we must lock it here ourselves.
 202         gdk_threads_enter();
 203
 204         // Send idle event to all who request them as long as
 205         // no events have popped up in the event queue.
 206         do {
 207             moreIdles = wxTheApp->ProcessIdle();
 208         } while (moreIdles && gtk_events_pending() == 0);
 209
 210         // Release lock again
 211         gdk_threads_leave();
 212
 213         {
 214             // If another idle source was added, remove it
 215 #if wxUSE_THREADS
 216             wxMutexLocker lock(gs_idleTagsMutex);
 217 #endif
 218             if (wxTheApp->m_idleTag != 0)
 219                 g_source_remove(wxTheApp->m_idleTag);
 220             wxTheApp->m_idleTag = idleID_save;
 221             g_isIdle = false;
 222         }
 223     }
 224
 225     if (!moreIdles)
 226     {
 227 #if wxUSE_THREADS
 228         wxMutexLocker lock(gs_idleTagsMutex);
 229 #endif
 230         // Indicate that we are now in idle mode and event handlers
 231         // will have to reinstall the idle handler again.
 232         g_isIdle = true;
 233         wxTheApp->m_idleTag = 0;
 234
 235         wxAddEmissionHook();
 236     }
 237
 238     // Return FALSE if no more idle events are to be sent
 239     return moreIdles;
 240 }
 241 } // extern "C"
 242
 243 #if wxUSE_THREADS
 244
 245 static GPollFunc wxgs_poll_func;
 246
 247 extern "C" {
 248 static gint wxapp_poll_func( GPollFD *ufds, guint nfds, gint timeout )
 249 {
 250     g_mainThreadLocked = true;
 251
 252     gint res = (*wxgs_poll_func)(ufds, nfds, timeout);
 253
 254     g_mainThreadLocked = false;
 255
 256     return res;
 257 }
 258 }
 259
 260 #endif // wxUSE_THREADS
 261
 262 void wxapp_install_idle_handler()
 263 {
 264     if (wxTheApp == NULL)
 265         return;
 266
 267 #if wxUSE_THREADS
 268     wxMutexLocker lock(gs_idleTagsMutex);
 269 #endif
 270
 271     // Don't install the handler if it's already installed. This test *MUST*
 272     // be done when gs_idleTagsMutex is locked!
 273     if (!g_isIdle)
 274         return;
 275
 276     // GD: this assert is raised when using the thread sample (which works)
 277     //     so the test is probably not so easy. Can widget callbacks be
 278     //     triggered from child threads and, if so, for which widgets?
 279     // wxASSERT_MSG( wxThread::IsMain() || gs_WakeUpIdle, wxT("attempt to install idle handler from widget callback in child thread (should be exclusively from wxWakeUpIdle)") );
 280
 281     wxASSERT_MSG( wxTheApp->m_idleTag == 0, wxT("attempt to install idle handler twice") );
 282
 283     g_isIdle = false;
 284
 285     // This routine gets called by all event handlers
 286     // indicating that the idle is over. It may also
 287     // get called from other thread for sending events
 288     // to the main thread (and processing these in
 289     // idle time). Very low priority.
 290     wxTheApp->m_idleTag = g_idle_add_full(G_PRIORITY_LOW, wxapp_idle_callback, NULL, NULL);
 291 }
 292
 293 //-----------------------------------------------------------------------------
 294 // Access to the root window global
 295 //-----------------------------------------------------------------------------
 296
 297 GtkWidget* wxGetRootWindow()
 298 {
 299     if (gs_RootWindow == NULL)
 300     {
 301         gs_RootWindow = gtk_window_new( GTK_WINDOW_TOPLEVEL );
 302         gtk_widget_realize( gs_RootWindow );
 303     }
 304     return gs_RootWindow;
 305 }
 306
 307 //-----------------------------------------------------------------------------
 308 // wxApp
 309 //-----------------------------------------------------------------------------
 310
 311 IMPLEMENT_DYNAMIC_CLASS(wxApp,wxEvtHandler)
 312
 313 BEGIN_EVENT_TABLE(wxApp, wxEvtHandler)
 314     EVT_IDLE(wxAppBase::OnIdle)
 315 END_EVENT_TABLE()
 316
 317 wxApp::wxApp()
 318 {
 319 #ifdef __WXDEBUG__
 320     m_isInAssert = false;
 321 #endif // __WXDEBUG__
 322
 323     m_idleTag = 0;
 324     g_isIdle = true;
 325     wxapp_install_idle_handler();
 326
 327     // this is NULL for a "regular" wxApp, but is set (and freed) by a wxGLApp
 328     m_glVisualInfo = (void *) NULL;
 329     m_glFBCInfo = (void *) NULL;
 330 }
 331
 332 wxApp::~wxApp()
 333 {
 334     if (m_idleTag)
 335         g_source_remove( m_idleTag );
 336 }
 337
 338 bool wxApp::OnInitGui()
 339 {
 340     if ( !wxAppBase::OnInitGui() )
 341         return false;
 342
 343     // if this is a wxGLApp (derived from wxApp), and we've already
 344     // chosen a specific visual, then derive the GdkVisual from that
 345     if (m_glVisualInfo != NULL)
 346     {
 347         GdkVisual* vis = gtk_widget_get_default_visual();
 348
 349         GdkColormap *colormap = gdk_colormap_new( vis, FALSE );
 350         gtk_widget_set_default_colormap( colormap );
 351     }
 352     else
 353     {
 354         // On some machines, the default visual is just 256 colours, so
 355         // we make sure we get the best. This can sometimes be wasteful.
 356         if (m_useBestVisual)
 357         {
 358             if (m_forceTrueColour)
 359             {
 360                 GdkVisual* visual = gdk_visual_get_best_with_both( 24, GDK_VISUAL_TRUE_COLOR );
 361                 if (!visual)
 362                 {
 363                     wxLogError(wxT("Unable to initialize TrueColor visual."));
 364                     return false;
 365                 }
 366                 GdkColormap *colormap = gdk_colormap_new( visual, FALSE );
 367                 gtk_widget_set_default_colormap( colormap );
 368             }
 369             else
 370             {
 371                 if (gdk_visual_get_best() != gdk_visual_get_system())
 372                 {
 373                     GdkVisual* visual = gdk_visual_get_best();
 374                     GdkColormap *colormap = gdk_colormap_new( visual, FALSE );
 375                     gtk_widget_set_default_colormap( colormap );
 376                 }
 377             }
 378         }
 379     }
 380
 381     return true;
 382 }
 383
 384 GdkVisual *wxApp::GetGdkVisual()
 385 {
 386     GdkVisual *visual = NULL;
 387
 388     if (m_glVisualInfo)
 389         visual = gdkx_visual_get( ((XVisualInfo *) m_glVisualInfo)->visualid );
 390     else
 391         visual = gdk_drawable_get_visual( wxGetRootWindow()->window );
 392
 393     wxASSERT( visual );
 394
 395     return visual;
 396 }
 397
 398 bool wxApp::Initialize(int& argc, wxChar **argv)
 399 {
 400     bool init_result;
 401
 402 #if wxUSE_THREADS
 403     if (!g_thread_supported())
 404         g_thread_init(NULL);
 405     gdk_threads_init();
 406
 407     wxgs_poll_func = g_main_context_get_poll_func(NULL);
 408     g_main_context_set_poll_func(NULL, wxapp_poll_func);
 409 #endif // wxUSE_THREADS
 410
 411     gtk_set_locale();
 412
 413     // We should have the wxUSE_WCHAR_T test on the _outside_
 414 #if wxUSE_WCHAR_T
 415     // gtk+ 2.0 supports Unicode through UTF-8 strings
 416     wxConvCurrent = &wxConvUTF8;
 417 #else // !wxUSE_WCHAR_T
 418     if (!wxOKlibc())
 419         wxConvCurrent = (wxMBConv*) NULL;
 420 #endif // wxUSE_WCHAR_T/!wxUSE_WCHAR_T
 421
 422     // decide which conversion to use for the file names
 423
 424     // (1) this variable exists for the sole purpose of specifying the encoding
 425     //     of the filenames for GTK+ programs, so use it if it is set
 426     wxString encName(wxGetenv(_T("G_FILENAME_ENCODING")));
 427     encName = encName.BeforeFirst(_T(','));
 428     if (encName.CmpNoCase(_T("@locale")) == 0)
 429         encName.clear();
 430     encName.MakeUpper();
 431 #if wxUSE_INTL
 432     if (encName.empty())
 433     {
 434         // (2) if a non default locale is set, assume that the user wants his
 435         //     filenames in this locale too
 436         encName = wxLocale::GetSystemEncodingName().Upper();
 437         // (3) finally use UTF-8 by default
 438         if (encName.empty() || encName == _T("US-ASCII"))
 439             encName = _T("UTF-8");
 440         wxSetEnv(_T("G_FILENAME_ENCODING"), encName);
 441     }
 442 #else
 443     if (encName.empty())
 444         encName = _T("UTF-8");
 445 #endif // wxUSE_INTL
 446     static wxConvBrokenFileNames fileconv(encName);
 447     wxConvFileName = &fileconv;
 448
 449 #if wxUSE_UNICODE
 450     // gtk_init() wants UTF-8, not wchar_t, so convert
 451     int i;
 452     char **argvGTK = new char *[argc + 1];
 453     for ( i = 0; i < argc; i++ )
 454     {
 455         argvGTK[i] = wxStrdupA(wxConvUTF8.cWX2MB(argv[i]));
 456     }
 457
 458     argvGTK[argc] = NULL;
 459
 460     int argcGTK = argc;
 461
 462 #ifdef __WXGPE__
 463     init_result = true;  // is there a _check() version of this?
 464     gpe_application_init( &argcGTK, &argvGTK );
 465 #else
 466     init_result = gtk_init_check( &argcGTK, &argvGTK );
 467 #endif
 468
 469     if ( argcGTK != argc )
 470     {
 471         // we have to drop the parameters which were consumed by GTK+
 472         for ( i = 0; i < argcGTK; i++ )
 473         {
 474             while ( strcmp(wxConvUTF8.cWX2MB(argv[i]), argvGTK[i]) != 0 )
 475             {
 476                 memmove(argv + i, argv + i + 1, argc - i);
 477             }
 478         }
 479
 480         argc = argcGTK;
 481     }
 482     //else: gtk_init() didn't modify our parameters
 483
 484     // free our copy
 485     for ( i = 0; i < argcGTK; i++ )
 486     {
 487         free(argvGTK[i]);
 488     }
 489
 490     delete [] argvGTK;
 491 #else // !wxUSE_UNICODE
 492     // gtk_init() shouldn't actually change argv itself (just its contents) so
 493     // it's ok to pass pointer to it
 494     init_result = gtk_init_check( &argc, &argv );
 495 #endif // wxUSE_UNICODE/!wxUSE_UNICODE
 496
 497     if (!init_result) {
 498         wxLogError(wxT("Unable to initialize gtk, is DISPLAY set properly?"));
 499         return false;
 500     }
 501
 502     // we can not enter threads before gtk_init is done
 503     gdk_threads_enter();
 504
 505     if ( !wxAppBase::Initialize(argc, argv) )
 506     {
 507         gdk_threads_leave();
 508
 509         return false;
 510     }
 511
 512     wxSetDetectableAutoRepeat( true );
 513
 514 #if wxUSE_INTL
 515     wxFont::SetDefaultEncoding(wxLocale::GetSystemEncoding());
 516 #endif
 517
 518     return true;
 519 }
 520
 521 void wxApp::CleanUp()
 522 {
 523     gdk_threads_leave();
 524
 525     wxAppBase::CleanUp();
 526 }
 527
 528 #ifdef __WXDEBUG__
 529
 530 void wxApp::OnAssertFailure(const wxChar *file,
 531                             int line,
 532                             const wxChar* func,
 533                             const wxChar* cond,
 534                             const wxChar *msg)
 535 {
 536
 537     // block wx idle events while assert dialog is showing
 538     m_isInAssert = true;
 539
 540     wxAppBase::OnAssertFailure(file, line, func, cond, msg);
 541
 542     m_isInAssert = false;
 543 }
 544
 545 #endif // __WXDEBUG__
 546
 547 void wxApp::SuspendIdleCallback()
 548 {
 549 #if wxUSE_THREADS
 550     wxMutexLocker lock(gs_idleTagsMutex);
 551 #endif
 552     if (m_idleTag != 0)
 553     {
 554         g_source_remove(m_idleTag);
 555         m_idleTag = 0;
 556         g_isIdle = true;
 557         wxAddEmissionHook();
 558     }
 559 }
 560
 561 #if wxUSE_THREADS
 562 void wxMutexGuiEnter()
 563 {
 564     gdk_threads_enter();
 565 }
 566
 567 void wxMutexGuiLeave()
 568 {
 569     gdk_threads_leave();
 570 }
 571 #endif