GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SOXTGLWIDGET (3)

NAME

SoXtGLWidget — wrapper around GLwMDraw for OpenGL rendering in a motif widget

CONTENTS

Inherits From
Synopsis
Description
Methods
See Also

INHERITS FROM

SoXtComponent > SoXtGLWidget

SYNOPSIS

#include <Inventor/Xt/SoXtGLWidget.h>

Methods from class SoXtGLWidget:

    void    
                    
void                 setBorder(SbBool onOrOff)    
SbBool    
                    
SbBool               isBorder() const    
virtual void    
                    
virtual void         setDoubleBuffer(SbBool onOrOff)    
SbBool    
                    
SbBool               isDoubleBuffer()    
Window    
                    
Window               getNormalWindow()    
Window    
                    
Window               getOverlayWindow()    
GLXContext    
                    
GLXContext           getNormalContext()    
GLXContext    
                    
GLXContext           getOverlayContext()    
Widget    
                    
Widget               getNormalWidget()    
Widget    
                    
Widget               getOverlayWidget()    
virtual void    
                    
virtual void         setNormalVisual(XVisualInfo *vis)    
XVisualInfo *    
                    
XVisualInfo *        getNormalVisual()    
virtual void    
                    
virtual void         setOverlayVisual(XVisualInfo *vis)    
XVisualInfo *    
                    
XVisualInfo *        getOverlayVisual()    
void    
                    
void                 setDrawToFrontBufferEnable(SbBool enableFlag)    
SbBool    
                    
SbBool               isDrawToFrontBufferEnable() const

Methods from class SoXtComponent:

    virtual void    
                        
virtual void             show()    
virtual void    
                        
virtual void             hide()    
SbBool    
                        
SbBool                   isVisible()    
Widget    
                        
Widget                   getWidget() const    
SbBool    
                        
SbBool                   isTopLevelShell() const    
Widget    
                        
Widget                   getShellWidget() const    
Widget    
                        
Widget                   getParentWidget() const    
void    
                        
void                     setSize(const SbVec2s &size)    
SbVec2s    
                        
SbVec2s                  getSize()    
Display *    
                        
Display *                getDisplay()    
void    
                        
void                     setTitle(const char *newTitle)    
const char *    
                        
const char *             getTitle() const    
void    
                        
void                     setIconTitle(const char *newIconTitle)    
const char *    
                        
const char *             getIconTitle() const    
void    
                        
void                     setWindowCloseCallback(SoXtComponentCB *func, void *data = NULL)    
static SoXtComponent *    
                        
static SoXtComponent *   getComponent(Widget w)    
const char *    
                        
const char *             getWidgetName() const    
const char *    
                        
const char *             getClassName() const

DESCRIPTION

This abstract base class provides a C++ wrapper around the GLwMDraw widget. It allows OpenGL rendering to be performed within a motif widget and is used by the SoXtRenderArea. SoXtGlWidget uses a form widget around two separate GLwMDraw widgets (one for single and one for double buffering), with routines to return the appropriate windows.

Subclasses only need to redefine the redraw() routine for rendering and processEvent() routine if they are interested in receiving X events.

METHODS

    void    
                    
void                 setBorder(SbBool onOrOff)    
SbBool    
                    
SbBool               isBorder() const
Show and hide the border around the glx widgets (thickness 3). Default is no border (FALSE). (The SoXtRenderArea subclass defaults turns the border on by default.)

    virtual void    
                    
virtual void         setDoubleBuffer(SbBool onOrOff)    
SbBool    
                    
SbBool               isDoubleBuffer()
Routine which dynamically changes between single and double buffering. Default is double buffer off. (The SoXtRenderArea subclass makes it double buffer by default.)

    Window    
                    
Window               getNormalWindow()    
Window    
                    
Window               getOverlayWindow()    
GLXContext    
                    
GLXContext           getNormalContext()    
GLXContext    
                    
GLXContext           getOverlayContext()    
Widget    
                    
Widget               getNormalWidget()    
Widget    
                    
Widget               getOverlayWidget()
Get the current normal and overlay GLX windows, contexes and widgets, which are needed as arguments to glXMakeCurrent() when doing drawing in the normal or overlay planes.

Note: These should not be cached by users because they will change as single/double buffering changes.

    virtual void    
                    
virtual void         setNormalVisual(XVisualInfo *vis)    
XVisualInfo *    
                    
XVisualInfo *        getNormalVisual()    
virtual void    
                    
virtual void         setOverlayVisual(XVisualInfo *vis)    
XVisualInfo *    
                    
XVisualInfo *        getOverlayVisual()
Specify exactly what the visual should be for the normal and overlay window. This allows the user to create all possible visuals supported by OpenGL. The XVisualInfo structure should be a valid OpenGL visual returned by glXChooseVisual(). This structure will be copied by the SoXtGLWidget; the application is responsible for freeing the visual info with XFree() when done. (The methods for setting the visual are virtual so that derived classes can know when the visual is changing.)

    void    
                    
void                 setDrawToFrontBufferEnable(SbBool enableFlag)    
SbBool    
                    
SbBool               isDrawToFrontBufferEnable() const
Inventor 2.1 changed the behavior of double buffered windows to redraw temporary to the front buffer when an expose event is received or when a new sceneGraph() is set on an SoXtRenderArea. This does not apply for general interactive rendering. The idea is that it is better to see something redraw (especially if it is slow) than to see garbage in the window (in the expose case) or an old invalid scene graph (in the SoXtRenderArea::setSceneGraph() case).

This API enables you to turn this functionality OFF if for some reason you are unable to prevent repeated expose from causing a redraw (which is bad and should be fixed, as it gets worse for large scenes). This will be the case for example if you can’t create a pulldown menu in the popup planes.

NOTE: this api might be removed in some future releases and is only intended as a porting help for Inventor 2.0 to 2.1

SEE ALSO

SoXtComponent, SoXtRenderArea

Search for    or go to Top of page |  Section 3 |  Main Index


SOXTGLWIDGET(3IV) (-->)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.