SoQt.h

/*=======================================================================
 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.),            ***
 ***              AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT.                     ***
 ***                                                                                ***
 ***  REPRODUCTION, DISCLOSURE,  OR USE,  IN WHOLE OR IN PART,  OTHER THAN AS       ***
 ***  SPECIFIED  IN THE LICENSE ARE  NOT TO BE  UNDERTAKEN  EXCEPT WITH PRIOR       ***
 ***  WRITTEN AUTHORIZATION OF FEI S.A.S.                                           ***
 ***                                                                                ***
 ***                        RESTRICTED RIGHTS LEGEND                                ***
 ***  USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS      ***
 ***  WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN      ***
 ***  SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT      ***
 ***  CLAUSE  AT FAR 52.227-19  OR SUBPARAGRAPH  (C)(1)(II)  OF  THE RIGHTS IN      ***
 ***  TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013.             ***
 ***                                                                                ***
 ***                   COPYRIGHT (C) 1996-2023 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : Nick Thompson (MMM yyyy)
** Modified by : Paul Isaacs (MMM yyyy)
** Modified by : David Mott (MMM yyyy)
** Modified by : Gavin Bell (MMM yyyy)
**=======================================================================*/
 
 
#ifndef _SO_QT_
#define _SO_QT_
 
#ifndef SOQT
#define SOQT
#endif
 
#include <Inventor/Qt/SoXt2SoQt.h>
 
#include <qglobal.h>
 
#include <QEvent>
#include <QObject>
#include <QWidget>
#include <QToolButton>
#include <QPushButton>
#include <QApplication>
#include <QPointer>
 
#include <Inventor/SbLinear.h>
#include <Inventor/SbString.h>
#include <Inventor/Qt/SoQtDef.h>
#include <Inventor/Qt/SoInventorQtLibName.h>
 
#include <Inventor/SoModule.h>
SO_MODULE_HEADER(SoInventorQt, __INVENTORQTDLL)
 
#ifdef _WIN32
#if !defined(InventorQt_EXPORTS)
#ifndef OIV_DISABLE_AUTOLINK
#  pragma comment(lib,__INVENTORQTLIB)
#endif
#endif
#endif //win
 
class SbPList;
class SoQtSensorHandler;
class SoAction;

class   SoQt : public QObject
{
  Q_OBJECT
    // QObject inheritance is not required here.
    // Just for consistency and to allow possible Q_SLOTS.
    public:
  SoNONUNICODE static QWidget *init(const char *appName, const char *className = "Inventor");

  static QWidget *init(const SbString& appName, const SbString& className = "Inventor");

  static void init( QWidget *topLevelWidget );
 
#if 1             SoDEPRECATED
  SoNONUNICODE static QWidget *threadInit(const char *appName,
                             const char *className = "Inventor");
SoDEPRECATED
  static QWidget *threadInit(const SbString& appName,
                             const SbString& className = "Inventor");
SoDEPRECATED
  static void threadInit(QWidget *topLevelWidget);
#endif 

  static void show(QWidget *widget);
  static void     hide(QWidget *widget);

  static int mainLoop();

  static void exit(int returnCode = 0);

  static void nextEvent(XtAppContext appContext, XEvent *event);
  static SbGlContextHelper::Display getDisplay();
  static SbGlContextHelper::GLContext getAppContext();
  static Boolean dispatchEvent(XEvent *);
  static QWidget *getTopLevelWidget();
  static void     setWidgetSize(QWidget *widget, const SbVec2s &size);
  static SbVec2s getWidgetSize(QWidget *widget);

  SoNONUNICODE static void createSimpleErrorDialog(QWidget *widget, char *dialogTitle,
                                      char *errorStr1, char *errorStr2 = NULL);

  static void createSimpleErrorDialog( QWidget *widget, const SbString& sdialogTitle,
                                      const SbString& errorStr1, const SbString& errorStr2 = "" );

  static void finish();

  static bool isInitialized();

  static int getExtensionEventNumber();
 
private:
  // Hide from docs...
 
  static QPointer<QWidget> mainWidget;
  static QPointer<QApplication> qapplication;
  static QApplication *getQApp() {return qapplication;};
 
  // Add/remove the passed event handler for X extension device events
  // (Xt does not handle extension events.)
  // Extension event types are queried from the server at runtime.
  static void addExtensionEventHandler(QWidget *w,
                                       int extensionEventType,
                                       XtEventHandler proc,
                                       XtPointer clientData);
  static void removeExtensionEventHandler(QWidget *w,
                                          int extensionEventType,
                                          XtEventHandler proc,
                                          XtPointer clientData);
 
  static void   getExtensionEventHandler(XEvent *event, QWidget *w,
                                         XtEventHandler &proc,
                                         XtPointer &clientData);
 
private:
 
  static SoQtSensorHandler *sensorHandler;
 
private:
 
  // Code factorization for init(SbString&, SbString&) and threadInit(SbString&, SbString&)
  // Return true if init is ok (false if init is already done)
  static bool commonInit(const SbString& appName, const SbString& className);
 
  static void setupInventorGLDisplay();
 
  static int s_returnCode;
 
  static SbPList *handlerList;
  static int OIVExtensionEventNumber;
  static int s_initRefCount;
  static const char *s_versionString;
  static SbBool s_ownTopLevelWindow;
  static SbBool s_ownApplication;
  static int s_defaultArgc;
  static char** s_defaultArgv;
};
 
#ifdef __APPLE__
#define SoQtButton QToolButton
#else
#define SoQtButton QPushButton
#endif
 
#endif // _SO_QT_