SoTransparencyType.TransparencyTypes

java.lang.Object
- java.lang.Enum<SoTransparencyType.TransparencyTypes>
- - com.openinventor.inventor.nodes.SoTransparencyType.TransparencyTypes

All Implemented Interfaces:

IntegerValuedEnum, java.io.Serializable, java.lang.Comparable<SoTransparencyType.TransparencyTypes>

Enclosing class:

SoTransparencyType
```
public static enum SoTransparencyType.TransparencyTypes
extends java.lang.Enum<SoTransparencyType.TransparencyTypes>
implements IntegerValuedEnum
```
Various levels of transparency rendering quality.

Enum Constant Summary

Enum Constants
Enum Constant and Description
`ADD` Uses additive alpha blending.
`BLEND` Uses multiplicative alpha blending.
`DELAYED_ADD` Uses additive blending, rendering all transparent objects after opaque ones.
`DELAYED_BLEND` Uses multiplicative alpha blending, rendering all transparent objects after opaque ones.
`DELAYED_SORTED_LAYERS_BLEND` Deprecated. As of Open Inventor 9400 See documentation for more details
`DELAYED_SORTED_PIXELS_BLEND` Same as SORTED_PIXELS_BLEND but rendering all transparent objects after opaque ones.
`NO_TRANSPARENCY` Draw all objects as opaque ignoring their transparency.
`SCREEN_DOOR` Uses stipple patterns to simulate transparency.
`SORTED_LAYERS_BLEND` Deprecated. As of Open Inventor 9400 See documentation for more details
`SORTED_OBJECT_ADD` Same as DELAYED_ADD, but sorts transparent objects by distances of bounding boxes from camera.
`SORTED_OBJECT_BLEND` Same as DELAYED_BLEND, but sorts transparent objects by distances of bounding boxes from camera.
`SORTED_OBJECT_TRIANGLES_ADD` Renders all the transparent triangles of the scene using additive blending.
`SORTED_OBJECT_TRIANGLES_BLEND` Same as SORTED_OBJECT_TRIANGLES_ADD, but uses multiplicative alpha blending.
`SORTED_PIXELS_BLEND` Uses a fragment-level depth sorting technique.
`SORTED_TRIANGLES_ADD` Renders all the transparent triangles of the scene using additive blending.
`SORTED_TRIANGLES_BLEND` Same as SORTED_TRIANGLES_ADD, but uses multiplicative alpha blending.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static SoTransparencyType.TransparencyTypes`	`fromValue(int val)` Deprecated. Use `valueOf(int)` instead.
`int`	`getValue()` Returns the integer value of the enum constant.
`static SoTransparencyType.TransparencyTypes`	`valueOf(int val)` Returns the enum constant of this type with the specified integer value
`static SoTransparencyType.TransparencyTypes`	`valueOf(java.lang.String name)` Returns the enum constant of this type with the specified name.
`static SoTransparencyType.TransparencyTypes[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - SCREEN_DOOR
```
public static final SoTransparencyType.TransparencyTypes SCREEN_DOOR
```
    Uses stipple patterns to simulate transparency.
    Note: This algorithm is very fast because it does not require blending, shaders or sorting. However most applications should use one of the other algorithms. Screen door rendering is low quality and only works for polygons with a single transparency (alpha) value for the entire face. Screen door does not correctly handle the case of transparency per vertex or transparent textures.
  - ADD
```
public static final SoTransparencyType.TransparencyTypes ADD
```
    Uses additive alpha blending.
  - BLEND
```
public static final SoTransparencyType.TransparencyTypes BLEND
```
    Uses multiplicative alpha blending.
  - DELAYED_ADD
```
public static final SoTransparencyType.TransparencyTypes DELAYED_ADD
```
    Uses additive blending, rendering all transparent objects after opaque ones.
    Note: When using this algorithm the OpenGL depth buffer is not updated (depth buffer writes are disabled) while rendering transparent objects. As a result complex 3D shapes may not be rendered correctly.
  - DELAYED_BLEND
```
public static final SoTransparencyType.TransparencyTypes DELAYED_BLEND
```
    Uses multiplicative alpha blending, rendering all transparent objects after opaque ones.
    Note: When using this algorithm the OpenGL depth buffer is not updated (depth buffer writes are disabled) while rendering transparent objects. As a result complex 3D shapes may not be rendered correctly.
  - SORTED_OBJECT_ADD
```
public static final SoTransparencyType.TransparencyTypes SORTED_OBJECT_ADD
```
    Same as DELAYED_ADD, but sorts transparent objects by distances of bounding boxes from camera. Limitation : If the bounding box of a shape is ignored by setting its boundingBoxIgnoring field to true, the rendering won't be correct.
  - SORTED_OBJECT_BLEND
```
public static final SoTransparencyType.TransparencyTypes SORTED_OBJECT_BLEND
```
    Same as DELAYED_BLEND, but sorts transparent objects by distances of bounding boxes from camera. Limitation : If the bounding box of a shape is ignored by setting its boundingBoxIgnoring field to true, the rendering won't be correct.
  - SORTED_TRIANGLES_ADD
```
public static final SoTransparencyType.TransparencyTypes SORTED_TRIANGLES_ADD
```
    Renders all the transparent triangles of the scene using additive blending. All of the transparent triangles of all objects of the scene are collected, and then sorted by triangle position.
  - SORTED_TRIANGLES_BLEND
```
public static final SoTransparencyType.TransparencyTypes SORTED_TRIANGLES_BLEND
```
    Same as SORTED_TRIANGLES_ADD, but uses multiplicative alpha blending.
  - SORTED_OBJECT_TRIANGLES_ADD
```
public static final SoTransparencyType.TransparencyTypes SORTED_OBJECT_TRIANGLES_ADD
```
    Renders all the transparent triangles of the scene using additive blending. All of the triangles of all transparent objects of the scene are collected and then sorted by object.
  - SORTED_OBJECT_TRIANGLES_BLEND
```
public static final SoTransparencyType.TransparencyTypes SORTED_OBJECT_TRIANGLES_BLEND
```
    Same as SORTED_OBJECT_TRIANGLES_ADD, but uses multiplicative alpha blending.
  - SORTED_PIXELS_BLEND
```
public static final SoTransparencyType.TransparencyTypes SORTED_PIXELS_BLEND
```
    Uses a fragment-level depth sorting technique. This mode generally gives the best results for complex transparent objects.
    Since Open Inventor 9.4, if the hardware supports the necessary OpenGL features, this transparency mode (and DELAYED_SORTED_PIXELS_BLEND) is implemented using a single-pass, order-independent fragment sorting (K-buffer or A-buffer) algorithm. The required OpenGL hardware features are: shader_image_load_store, shader_atomic_counters and shading_language_420pack. These features are standard in core OpenGL 4.2. Use SoGLExtension, if necessary, to check if they are supported.
    If the hardware does not support single-pass transparency, then a multi-pass "depth peeling" algorithm is used. The required OpenGL hardware features are: Multi-Texture, Texture Environment Combine, Depth texture, and Shadow . These features are standard starting with OpenGL 1.4. The method setSortedLayersNumPasses() allows you to set the number of rendering passes for more correct transparency. Usually, four passes gives good results.
    Please note that since some transparency algorithms rely on multi-pass techniques based on the depth of the polygon, there can be issues if several polygons are rendered at the same depth, resulting in incorrect blending. However, rendering polygons at the same depth is highly discouraged even without using advanced transparency since it can result in Z-fighting. Consider using an SoPolygonOffset or SoDepthOffset node to alleviate this issue.
    If the graphics board does not support multi-pass transparency, SORTED_OBJECT_BLEND is used.
    Note: If the application uses fragment sorting transparency and specifies a custom fragment shader, the application shader must call an Open Inventor GLSL method instead of setting gl_FragData[0] directly. In the SDK installation, see shaders/include/Inventor/oivDepthPeeling_frag.h
    Limitations:
    - Antialiasing.
      This transparency type is not compatible with FSAA mode. Use SUPERSAMPLING, FXAA or SMAA instead.
    - Stereo.
      This transparency type is not compatible with interlaced stereo.
    - RenderToTarget.
      This transparency type is not compatible with SoRenderToTarget nodes. In this case, it won't be possible to achieve perfect Order Independent Transparency. Everything under the SoRenderToTarget will be rendered with basic BLEND transparency and in some cases (particularly in SORTED_PIXELS_BLEND) some graphical glitches may be unavoidable.
    - GPU memory.
      Using the single-pass algorithm, it is possible to run out of GPU memory for storing fragment transparency values. This should only happen for scenes with both high depth complexity and a large number of transparent objects. In this case fragments from the objects traversed last in the scene graph may not be sorted correctly, resulting in small artifacts.
  - SORTED_LAYERS_BLEND
```
public static final SoTransparencyType.TransparencyTypes SORTED_LAYERS_BLEND
```
    Deprecated. As of Open Inventor 9400 See documentation for more details
    
    Deprecated name of SORTED_PIXELS_BLEND. Deprecated since Open Inventor 9400
    It corresponds to the SORTED_PIXELS_BLEND transparency type.
  - DELAYED_SORTED_PIXELS_BLEND
```
public static final SoTransparencyType.TransparencyTypes DELAYED_SORTED_PIXELS_BLEND
```
    Same as SORTED_PIXELS_BLEND but rendering all transparent objects after opaque ones. See limitations section for SORTED_PIXELS_BLEND!
  - DELAYED_SORTED_LAYERS_BLEND
```
public static final SoTransparencyType.TransparencyTypes DELAYED_SORTED_LAYERS_BLEND
```
    Deprecated. As of Open Inventor 9400 See documentation for more details
    
    Deprecated name of DELAYED_SORTED_PIXELS_BLEND. Deprecated since Open Inventor 9400
    It corresponds to the DELAYED_SORTED_PIXELS_BLEND transparency type.
  - NO_TRANSPARENCY
```
public static final SoTransparencyType.TransparencyTypes NO_TRANSPARENCY
```
    Draw all objects as opaque ignoring their transparency.
- Method Detail
  - values
```
public static SoTransparencyType.TransparencyTypes[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (SoTransparencyType.TransparencyTypes c : SoTransparencyType.TransparencyTypes.values())
    System.out.println(c);
```
    Returns:
    
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static SoTransparencyType.TransparencyTypes valueOf(java.lang.String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    
    name - the name of the enum constant to be returned.
    
    Returns:
    
    the enum constant with the specified name
    
    Throws:
    
    java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
    
    java.lang.NullPointerException - if the argument is null
  - fromValue
```
@Deprecated
public static SoTransparencyType.TransparencyTypes fromValue(int val)
```
    Deprecated. Use valueOf(int) instead.
    
    Returns the enum constant of this type with the specified integer value
    
    Returns:
    
    the enum constant of this type with the specified integer value.
  - valueOf
```
public static SoTransparencyType.TransparencyTypes valueOf(int val)
```
    Returns the enum constant of this type with the specified integer value
    
    Returns:
    
    the enum constant of this type with the specified integer value.
  - getValue
```
public int getValue()
```
    Description copied from interface: IntegerValuedEnum
    
    Returns the integer value of the enum constant.
    
    Specified by:
    
    getValue in interface IntegerValuedEnum
    
    Returns:
    
    the integer value of the enum constant.

Enum SoTransparencyType.TransparencyTypes

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

SCREEN_DOOR

ADD

BLEND

DELAYED_ADD

DELAYED_BLEND

SORTED_OBJECT_ADD

SORTED_OBJECT_BLEND

SORTED_TRIANGLES_ADD

SORTED_TRIANGLES_BLEND

SORTED_OBJECT_TRIANGLES_ADD

SORTED_OBJECT_TRIANGLES_BLEND

SORTED_PIXELS_BLEND

SORTED_LAYERS_BLEND

DELAYED_SORTED_PIXELS_BLEND

DELAYED_SORTED_LAYERS_BLEND

NO_TRANSPARENCY

Method Detail

values

valueOf

fromValue

valueOf

getValue