com.openinventor.inventor.nodes

Class SoTextureCoordinate3

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.SoTextureCoordinate3

All Implemented Interfaces:

SafeDisposable

public class SoTextureCoordinate3
extends SoNode

3D texture coordinate node. This node defines a set of 3D coordinates to be used to map textures to subsequent vertex-based shapes (those derived from SoVertexShape). It replaces the current texture coordinates in the rendering state for the shapes to use.

The current texture coordinate binding (see SoTextureCoordinateBinding) determines how texture coordinates are mapped to vertices of shapes. An alternative to using explicit texture coordinates is to generate them using a function; see SoTextureCoordinateFunction.

Texture coordinates range from 0 to 1 across the texture. The horizontal coordinate, called S, is specified first, then the vertical coordinate, T, and finally the depth coordinate, R.

File format/default:

TextureCoordinate3 {

point	[ ]
forceSending	false

}

Action behavior:

SoGLRenderAction, SoCallbackAction
Sets the current texture coordinates in the state. Sets: SoTextureCoordinate3Element

See also:

SoTexture3, SoTextureCoordinateBinding, SoTextureCoordinateFunction, SoVertexProperty, SoVertexShape

Nested Class Summary

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 and Description
SoSFBool	forceSending Forces the texture coordinates to be sent to OpenGL even if no texture is bound.
SoMFVec3f	point Texture coordinate points.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoTextureCoordinate3() Creates a texture coordinate node with default settings.

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

point

public final SoMFVec3f point

Texture coordinate points.

forceSending

public final SoSFBool forceSending

Forces the texture coordinates to be sent to OpenGL even if no texture is bound. Default is false. The default value can be set using the environment variable OIV_FORCE_TEX_COORD_SENDING. See SoPreferences.

Since:

Open Inventor 5.0.3

Constructor Detail

SoTextureCoordinate3

public SoTextureCoordinate3()

Creates a texture coordinate node with default settings.