SoWinGLWidget Class

SoWinGLWidget Class

Component for OpenGL rendering.

Inheritance Hierarchy

SystemObject
  OIV.InventorSoNetBase
    OIV.Inventor.WinSoWinComponent
      OIV.Inventor.WinSoWinGLWidget
        OIV.Inventor.WinSoWinRenderArea

Namespace: OIV.Inventor.Win
Assembly: OIV.Inventor.Win (in OIV.Inventor.Win.dll) Version: 2024.1.1.0 (2024.1.1)

Syntax

C++

Copy

public class SoWinGLWidget : SoWinComponent

Public Class SoWinGLWidget
	Inherits SoWinComponent

public ref class SoWinGLWidget : public SoWinComponent

type SoWinGLWidget =  
    class
        inherit SoWinComponent
    end

The SoWinGLWidget type exposes the following members.

Methods

	Name	Description
	AddHook	Adds an event handler that receives all messages dispatched to this window.
	BindNormalContext	Makes the normal rendering context the current context.
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Flush
	GetAntialiasingMode	Returns the antialiasing mode set using the setAntialiasing(float,AntialiasingMode) method.
	GetAntialiasingParameters	Returns the antialiasing parameters set using the OIV.Inventor.Win.SoWinGLWidget.SetAntialiasing(OIV.Inventor.Antialiasing.SoAntialiasingParameters) method.
	GetAntialiasingQuality	Returns the antialiasing quality set using the setAntialiasing(float,AntialiasingMode) method.
	GetBorderSize	Included for portability only.
	GetClassName	Returns the class name. (Inherited from SoWinComponent.)
	GetCursor	Obsolete. Returns the current cursor.
	GetFloatingColorBuffer	Returns true if floating point rendering is used and its precision.
	GetGraphicConfigTemplate	Gets the current graphics configuration template.
	GetHashCode	Overrides GetHashCode(). (Inherited from SoNetBase.)
	GetIconTitle	Included for portability only. (Inherited from SoWinComponent.)
	GetNormalDC	Returns the device context (which is needed for SbGlContextHelper.makeCurrent).
	GetNormalSoContext
	GetPixelFormat	Returns the current pixel format.
	GetSize	Convenience routine on the window handle. (Inherited from SoWinComponent.)
	GetTitle	Gets window title. (Inherited from SoWinComponent.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetWidgetName	Returns the window handle name. (Inherited from SoWinComponent.)
	Hide	This hides the component. (Inherited from SoWinComponent.)
	IsBorder	Included for portability only.
	IsDoubleBuffer	Returns whether double buffering is on or off.
	IsDrawToFrontBufferEnable	Returns whether drawing to the front buffer is enabled.
	IsFullScreen	Queries if the viewer is in fullscreen mode. (Inherited from SoWinComponent.)
	IsFullScreenEnable	Queries if it is possible to put the viewer in fullscreen mode. (Inherited from SoWinComponent.)
	IsTopLevelShell	Returns true if this component is a top level shell component (has its own window). (Inherited from SoWinComponent.)
	IsVisible	Returns true if this component is mapped onto the screen. (Inherited from SoWinComponent.)
	RemoveHook	Removes the event handlers that were added by AddHook.
	SaveSnapshot(String)	Calls SaveSnapshot(filename, true).
	SaveSnapshot(String, Boolean)	Save a snapshot of the current image displayed in the viewer.
	SetAntialiasing(Single)	Calls SetAntialiasing(quality, OIV.Inventor.SoSceneManager.AntialiasingModes( .SoSceneManager.AUTO )).
	SetAntialiasing(SoAntialiasingParameters)	Enable (or disable) antialiasing with specific parameters.
	SetAntialiasing(Single, SoSceneManagerAntialiasingModes)	Enable (or disable) antialiasing with specified quality and mode.
	SetBorder	Included for portability only.
	SetCursor	Obsolete. Sets the current cursor.
	SetDoubleBuffer	Routine that dynamically changes between single and double buffering.
	SetDrawToFrontBufferEnable	Sets drawing to the front buffer.
	SetFloatingColorBuffer(Boolean)	Calls SetFloatingColorBuffer(enable, OIV.Inventor.Win.SoWinGLWidget.FloatColorBufferSizes( .SoWinGLWidget.FLOAT_16_COLOR_BUFFER )).
	SetFloatingColorBuffer(Boolean, SoWinGLWidgetFloatColorBufferSizes)	Enables/disables floating point rendering using 16- or 32-bit components.
	SetFullScreen	Switches the viewer into (or out of) fullscreen mode. (Inherited from SoWinComponent.)
	SetFullScreenEnable	Enables/disables fullscreen mode. (Inherited from SoWinComponent.)
	SetGraphicConfigTemplate	Sets a new graphics configuration template.
	SetIconTitle	Included for portability only. (Inherited from SoWinComponent.)
	SetPixelFormat	Sets the current pixel format.
	SetSize	Convenience routine on the window handle. (Inherited from SoWinComponent.)
	SetStealFocus	By default the GLWidget "steals" focus whenever the cursor moves over it.
	SetTitle	Sets window title. (Inherited from SoWinComponent.)
	Show	This shows the component. (Inherited from SoWinComponent.)
	SwapNormalBuffers	Swaps the normal front and back buffers.
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	UnbindNormalContext	unbind the current context (previously bind with bindNormalContext );

Top

Properties

	Name	Description
	Cursor	Sets the current cursor.
	Handle	Implements Handle. (Inherited from SoWinComponent.)
	WindowCloseCallback	Sets the delegate to invoke when the user closes this component (double click in the upper left corner) - by default Hide() is called on this component, unless a delegate is specified. (Inherited from SoWinComponent.)

Top

Remarks

This abstract base class provides a C++ wrapper around an OpenGL drawing window. It allows OpenGL rendering to be performed within a Windows window and is used by the OIV.Inventor.Win.SoWinRenderArea. OIV.Inventor.Win.SoWinGLWidget uses a parent window with two separate OpenGL windows (one for single buffering 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 Windows messages.

Reference

OIV.Inventor.Win Namespace

OIV.Inventor.Win.SoWinComponent

OIV.Inventor.Win.SoWinRenderArea