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

See also:

SoGLGraphicConfigTemplate, SoWinGLWidget.setFullSceneAntialiasing(), SoWinGLWidget.getFullSceneAntialiasing(), SoWinGLWidget.isFullSceneAntialiasingAvailable(), SoWinGLWidget.isFullSceneAntialiasingEnabled()

Nested Class Summary

Nested Classes

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

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

Inventor.ConstructorCommand

Field Summary

Fields

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

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and 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, 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, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

POINTS

@Deprecated
public static final int POINTS

Deprecated. Use SoFullSceneAntialiasing.Filters.POINTS instead.

LINES

@Deprecated
public static final int LINES

Deprecated. Use SoFullSceneAntialiasing.Filters.LINES instead.

POLYGONS

@Deprecated
public static final int POLYGONS

Deprecated. Use SoFullSceneAntialiasing.Filters.POLYGONS instead.

TEXT

@Deprecated
public static final int TEXT

Deprecated. Use SoFullSceneAntialiasing.Filters.TEXT instead.

ALL

@Deprecated
public static final int ALL

Deprecated. Use SoFullSceneAntialiasing.Filters.ALL instead.

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.