Package com.openinventor.inventor.nodes

Class SoFullSceneAntialiasing

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoFullSceneAntialiasing

All Implemented Interfaces:

SafeDisposable

public class SoFullSceneAntialiasing
extends SoNode

Node that controls full-scene antialiasing. This class controls full-scene antialiasing. This node can be used to enable or disable the antialiasing mode on a part of a scene graph.

This node has no effect if full-scene antialiasing is not supported in the graphics hardware or has not been enabled. Full-scene antialiasing can be enabled by defining a graphic configuration template, by calling the setAntialiasing() method in SoSceneManager and some viewer classes, or (on some systems) by the user through the system display properties dialog.

The filter field allows you to select what kind of nodes (derived from SoShape) will be antialiased. For certain primitives antialiasing may be undesirable. For example, bitmap text (SoText2, etc.) may be "blurred" by antialiasing.

The filter result is highly dependent on your graphics hardware.

Note: The quality level specified by the setAntialiasing() method cannot be changed during a traversal because it depends on the pixel format.

File format/default:

FullSceneAntialiasing {

on	true
filter	ALL

}

Action behavior:

Sets: SoFullSceneAntialiasingElement

SoGLGraphicConfigTemplate SoWinGLWidget.setAntialiasing()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SoFullSceneAntialiasing.Filters	Defines the types of rendering shapes.

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode

SoNode.RenderModes

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field	Description
SoSFBitMask<SoFullSceneAntialiasing.Filters>	filter	A bit-wise combination of LINES, POINTS, POLYGONS, and TEXT that determines which primitive types should be antialiased.
SoSFBool	on	Enables/disables full-scene antialiasing.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor	Description
SoFullSceneAntialiasing()	Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getNativeResourceHandle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

on

public final SoSFBool on

Enables/disables full-scene antialiasing.

Default = true. The default value can be set using the environment variable OIV_FULL_SCENE_ANTIALIASING (0 = false, 1 = true).

filter

public final SoSFBitMask<SoFullSceneAntialiasing.Filters> filter

A bit-wise combination of LINES, POINTS, POLYGONS, and TEXT that determines which primitive types should be antialiased.

Default = ALL. The default value can be set using the environment variable OIV_FULL_SCENE_ANTIALIASING_FILTER. Valid values are ALL, or any combination of LINES, POINTS, POLYGONS, and TEXT.

The rules to determine if the antialiasing extension should stay enabled or should be disabled are described in the following tables:

<html> <head> <title>ShapeFilterTable</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> </head> <body bgcolor="#FFFFFF" text="#000000"> <table width="100%" border="0" cellspacing="0" cellpadding="3"> <tr valign="top"> <td width="50%" height="320"> <div align="left"> <table width="350" border="1" cellspacing="0" cellpadding="3"> <tr valign="top"> <td> <div align="center"><i><font size="2">Shape Type</font></i></div> </td> <td> <div align="center"><i><font size="2">Draw Style</font></i></div> </td> <td> <div align="center"><i><font size="2">Filter</font></i></div> </td> <td align="center" width="80"> <div align="center"><i><font size="2">Enable AA</font></i></div> </td> </tr> <tr valign="top"> <td rowspan="4"><font size="2">POLYGON</font><font size="2"></font><font size="2"></font><font size="2"></font></td> <td><font size="2">FILLED</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL <br> </font></td> <td align="center" width="80"> <div align="center"><font size="2"><br> <br> X<br> <br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">LINES</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL </font></td> <td align="center" width="80"> <div align="center"><font size="2">X<br> <br> <br> <br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">POINTS</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL </font></td> <td align="center" width="80"> <div align="center"><font size="2"><br> X<br> <br> <br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">INVISIBLE</font></td> <td> <div align="center"><font size="2">-</font></div> </td> <td align="center" width="80">&nbsp; <div align="center"></div> </td> </tr> </table> </div> </td> <td width="50%" height="320"> <div align="left"> <table width="350" border="1" cellspacing="0" cellpadding="3"> <tr valign="top"> <td> <div align="center"><i><font size="2">Shape Type</font></i></div> </td> <td> <div align="center"><i><font size="2">Draw Style</font></i></div> </td> <td> <div align="center"><i><font size="2">Filter</font></i></div> </td> <td align="center" width="80"> <div align="center"><i><font size="2">Enable AA</font></i></div> </td> </tr> <tr valign="top"> <td rowspan="4"><font size="2">TEXT</font></td> <td><font size="2">FILLED</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL <br> </font></td> <td align="center" width="30"> <div align="center"><font size="2"><br> <br> X<br> X<br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">LINES</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL </font></td> <td align="center" width="30"> <div align="center"><font size="2">X<br> <br> <br> X<br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">POINTS</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL </font></td> <td align="center" width="30"> <div align="center"><font size="2"><br> X<br> <br> X<br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">INVISIBLE</font></td> <td> <div align="center"><font size="2">-</font></div> </td> <td align="center" width="30">&nbsp; <div align="center"></div> </td> </tr> </table> All text are antialiased when the SoFullSceneAntialiasing filter is set to TEXT Otherwise, the AA is made considering the draw style element state.</div> </td> </tr> <tr valign="top"> <td width="50%"> <div align="left"> <table width="350" border="1" cellspacing="0" cellpadding="3"> <tr valign="top"> <td> <div align="center"><i><font size="2">Shape Type</font></i></div> </td> <td> <div align="center"><i><font size="2">Draw Style</font></i></div> </td> <td> <div align="center"><i><font size="2">Filter</font></i></div> </td> <td align="center" width="80"> <div align="center"><i><font size="2">Enable AA</font></i></div> </td> </tr> <tr valign="top"> <td rowspan="3"><font size="2">LINE</font></td> <td><font size="2">FILLED<br> LINES </font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL <br> </font></td> <td align="center" width="30"> <div align="center"><font size="2">X<br> <br> <br> <br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">POINTS</font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL </font></td> <td align="center" width="30"> <div align="center"><font size="2"><br> X<br> <br> <br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">INVISIBLE</font></td> <td> <div align="center"><font size="2">-</font></div> </td> <td align="center" width="30">&nbsp; <div align="center"></div> </td> </tr> </table> </div> </td> <td width="50%"> <div align="left"> <table width="350" border="1" cellspacing="0" cellpadding="3"> <tr valign="top"> <td> <div align="center"><i><font size="2">Shape Type</font></i></div> </td> <td> <div align="center"><i><font size="2">Draw Style</font></i></div> </td> <td> <div align="center"><i><font size="2">Filter</font></i></div> </td> <td align="center" width="80"> <div align="center"><i><font size="2">Enable AA</font></i></div> </td> </tr> <tr valign="top"> <td rowspan="2"><font size="2">POINT</font></td> <td><font size="2">FILLED<br> LINES<br> POINTS </font></td> <td><font size="2">LINES<br> POINTS<br> POLYGONS<br> TEXT<br> ALL <br> </font></td> <td align="center" width="30"> <div align="center"><font size="2"><br> X<br> <br> <br> X</font></div> </td> </tr> <tr valign="top"> <td><font size="2">INVISIBLE</font></td> <td> <div align="center"><font size="2">-</font></div> </td> <td align="center" width="30">&nbsp; <div align="center"></div> </td> </tr> </table> </div> </td> </tr> </table> <p>&nbsp;</p> </body> </html>

Constructor Detail

SoFullSceneAntialiasing

public SoFullSceneAntialiasing()

Constructor.