2005-04-15 05:41:28 +08:00
|
|
|
/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2005 Robert Osfield
|
2003-01-22 00:45:36 +08:00
|
|
|
*
|
|
|
|
|
* This library is open source and may be redistributed and/or modified under
|
|
|
|
|
* the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
|
|
|
|
|
* (at your option) any later version. The full license is in LICENSE file
|
|
|
|
|
* included with this distribution, and on the openscenegraph.org website.
|
|
|
|
|
*
|
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
* OpenSceneGraph Public License for more details.
|
|
|
|
|
*/
|
2002-05-09 18:31:03 +08:00
|
|
|
|
|
|
|
|
// The following symbol has a underscore suffix for compatibility.
|
|
|
|
|
#ifndef OSGGA_EXPORT_
|
|
|
|
|
#define OSGGA_EXPORT_ 1
|
|
|
|
|
|
|
|
|
|
#if defined(WIN32) && !(defined(__CYGWIN__) || defined(__MINGW32__))
|
2002-05-29 00:11:49 +08:00
|
|
|
#pragma warning( disable : 4244 )
|
|
|
|
|
#pragma warning( disable : 4251 )
|
|
|
|
|
#pragma warning( disable : 4267 )
|
|
|
|
|
#pragma warning( disable : 4275 )
|
|
|
|
|
#pragma warning( disable : 4290 )
|
|
|
|
|
#pragma warning( disable : 4786 )
|
2003-03-17 05:58:27 +08:00
|
|
|
#pragma warning( disable : 4305 )
|
2005-05-25 02:57:13 +08:00
|
|
|
#pragma warning( disable : 4996 )
|
2002-05-09 18:31:03 +08:00
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#if defined(_MSC_VER) || defined(__CYGWIN__) || defined(__MINGW32__) || defined( __BCPLUSPLUS__) || defined( __MWERKS__)
|
2002-08-28 22:27:18 +08:00
|
|
|
# ifdef OSGGA_LIBRARY
|
|
|
|
|
# define OSGGA_EXPORT __declspec(dllexport)
|
|
|
|
|
# else
|
|
|
|
|
# define OSGGA_EXPORT __declspec(dllimport)
|
|
|
|
|
#endif /* OSGUTIL_LIBRARY */
|
2002-05-09 18:31:03 +08:00
|
|
|
#else
|
2002-08-28 22:27:18 +08:00
|
|
|
#define OSGGA_EXPORT
|
2002-05-09 18:31:03 +08:00
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
|
|
|
|
\namespace osgGA
|
|
|
|
|
|
2002-05-22 16:50:05 +08:00
|
|
|
The 'GA' in osgGA stands for 'GUI Abstraction'; the osgGA namespace provides facilities to
|
|
|
|
|
help developers write the glue to allow the osg to work with varying window systems.
|
2002-05-09 18:31:03 +08:00
|
|
|
|
2002-05-22 16:50:05 +08:00
|
|
|
As a cross-platform, window system-agnostic class library, the OpenSceneGraph
|
|
|
|
|
has no direct ties to any given windowing environment. Viewers, however, must at
|
2002-05-09 18:31:03 +08:00
|
|
|
some level interact with a window system - where Window system may refer to a windowing
|
|
|
|
|
API, e.g. GLUT, Qt, FLTK, MFC, ...
|
|
|
|
|
|
|
|
|
|
There is much commonality in the implementation of Viewers for varying windowing
|
|
|
|
|
environments. E.g. most Viewers will update a Camera position in response to a mouse
|
|
|
|
|
event, and may request that a timer be started as a result of a model being 'spun'.
|
|
|
|
|
|
|
|
|
|
The purpose of the osgGA namespace is to centralise the common areas of this
|
2002-05-22 16:50:05 +08:00
|
|
|
functionality. The viewer writer needs then only write a GUIEventAdapter, a
|
|
|
|
|
GUIActionAdapter, and assemble a collection of GUIEventHandlers
|
2002-05-09 18:31:03 +08:00
|
|
|
as appropriate for the viewer.
|
|
|
|
|
|
|
|
|
|
Events from the windowing environment are adpated, and then fed into the GUIEventHandlers.
|
|
|
|
|
The GUIEventHandlers analyse and take action, and make requests of the windowing
|
2002-05-22 16:50:05 +08:00
|
|
|
environemnt via the GUIActionAdapter. The viewer writer should then honour these
|
|
|
|
|
requests, translating them into calls to the windowing API.
|
2002-05-09 18:31:03 +08:00
|
|
|
|
|
|
|
|
*/
|
2002-08-28 22:27:18 +08:00
|
|
|
|
|
|
|
|
|
