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()

  • Field Details

    • 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 Details

    • SoFullSceneAntialiasing

      public SoFullSceneAntialiasing()
      Constructor.