com.openinventor.inventor.nodes

Class SoTexture

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

All Implemented Interfaces:

SafeDisposable

Direct Known Subclasses:

SoExtTexture2, SoIndexedTexture2, SoTexture2, SoTexture3, SoTextureCubeMap

public abstract class SoTexture
extends SoNode

Abstract base class for texture mapping nodes. This is the abstract base class for all texture image nodes. It defines the common methods and fields that all texture image nodes have. When a texture image node is encountered during traversal, the associated image and parameters are applied to the current texture unit (see SoTextureUnit) and used to apply the texture to subsequent shapes.

Open Inventor provides multiple texture image nodes optimized for different purposes, including:

• SoTexture2
  The basic 2D texture image node. The image may be loaded from a file, loaded from an image in memory or created by rendering a scene graph.
• SoExtTexture2
  This node is similar to SoTexture2, but has specific optimizations that are valuable for applications that load a large number of textures from files.
• SoIndexedTexture2
  The first two nodes load an image containing color values that are directly applied to the geometry. This node considers each texel to be a data value that is mapped to a color using the color map defined by an SoColorMap node. This is very useful for "intensity" data sets.
• SoTextureCubeMap
  This node loads a set of six images representing the faces of a cube. These are "shrink wrapped" onto the geometry similar to environment mapping, but without the need for a single specially warped environment image.
• SoTexture3
  This node defines a 3D texture map. The image may be loaded from a set of files or loaded directly from memory. A 3D texture may be used to load a volume data set, but note that the Open Inventor VolumeViz nodes are specifically implemented for this purpose (see SoVolumeData).

Applications may use the isSupported() method to check if the graphics hardware supports a specific texture mapping feature.

File format/default:

This is an abstract class. See the reference page of a derived class for the format and default values.

See also:

SoComplexity, SoExtTexture2, SoIndexedTexture2, SoMaterial, SoTexture2, SoTexture2Transform, SoTexture3, SoTextureCombiner, SoTextureCoordinate2, SoTextureCoordinateBinding, SoTextureCoordinateFunction, SoTextureCubeMap, SoTextureUnit

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoTexture.FileTypes File Type possible values.
static class	SoTexture.Filters Specifies the OpenGL filtering method for minification and magnification.
static class	SoTexture.HW_Features
static class	SoTexture.InternalFormats Texture internal storage format.
static class	SoTexture.Models Texture model.
static class	SoTexture.WrapType Texture wrap type.

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	ADD Deprecated. Use SoTexture.Models.ADD instead.
static int	ALPHA_FLOAT16 Deprecated. Use SoTexture.InternalFormats.ALPHA_FLOAT16 instead.
static int	ALPHA_FLOAT32 Deprecated. Use SoTexture.InternalFormats.ALPHA_FLOAT32 instead.
static int	ALPHA_FORMAT Deprecated. Use SoTexture.InternalFormats.ALPHA_FORMAT instead.
static int	ALPHA12 Deprecated. Use SoTexture.InternalFormats.ALPHA12 instead.
static int	ALPHA16 Deprecated. Use SoTexture.InternalFormats.ALPHA16 instead.
static int	ALPHA4 Deprecated. Use SoTexture.InternalFormats.ALPHA4 instead.
static int	ALPHA8 Deprecated. Use SoTexture.InternalFormats.ALPHA8 instead.
static int	AUTO Deprecated. Use SoTexture.Filters.AUTO instead.
static int	AUTO_INTERNAL_FORMAT Deprecated. Use SoTexture.InternalFormats.AUTO_INTERNAL_FORMAT instead.
static int	BLEND Deprecated. Use SoTexture.Models.BLEND instead.
SoSFColor	blendColor Color used for BLEND model.
static int	BMP Deprecated. Use SoTexture.FileTypes.BMP instead.
SoSFVec4f	borderColor Defines border color used for border texture filtering.
static int	CLAMP Deprecated. Use SoTexture.WrapType.CLAMP instead.
static int	CLAMP_TO_BORDER Deprecated. Use SoTexture.WrapType.CLAMP_TO_BORDER instead.
static int	CLAMP_TO_EDGE Deprecated. Use SoTexture.WrapType.CLAMP_TO_EDGE instead.
static int	COMBINE Deprecated. Use SoTexture.Models.COMBINE instead.
static int	COMPRESSED_ALPHA Deprecated. Use SoTexture.InternalFormats.COMPRESSED_ALPHA instead.
static int	COMPRESSED_INTENSITY Deprecated. Use SoTexture.InternalFormats.COMPRESSED_INTENSITY instead.
static int	COMPRESSED_LUMINANCE Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE instead.
static int	COMPRESSED_LUMINANCE_ALPHA Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE_ALPHA instead.
static int	COMPRESSED_LUMINANCE_ALPHA_LATC2 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE_ALPHA_LATC2 instead.
static int	COMPRESSED_LUMINANCE_LATC1 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE_LATC1 instead.
static int	COMPRESSED_RED_GREEN_RGTC2 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RED_GREEN_RGTC2 instead.
static int	COMPRESSED_RED_RGTC1 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RED_RGTC1 instead.
static int	COMPRESSED_RGB Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RGB instead.
static int	COMPRESSED_RGBA Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RGBA instead.
static int	COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2 instead.
static int	COMPRESSED_SIGNED_LUMINANCE_LATC1 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_LUMINANCE_LATC1 instead.
static int	COMPRESSED_SIGNED_RED_GREEN_RGTC2 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_RED_GREEN_RGTC2 instead.
static int	COMPRESSED_SIGNED_RED_RGTC1 Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_RED_RGTC1 instead.
static int	DDS Deprecated. Use SoTexture.FileTypes.DDS instead.
static int	DECAL Deprecated. Use SoTexture.Models.DECAL instead.
static int	DEPTH_COMPONENT16 Deprecated. Use SoTexture.InternalFormats.DEPTH_COMPONENT16 instead.
static int	DEPTH_COMPONENT24 Deprecated. Use SoTexture.InternalFormats.DEPTH_COMPONENT24 instead.
static int	DEPTH24_STENCIL8 Deprecated. Use SoTexture.InternalFormats.DEPTH24_STENCIL8 instead.
SoSFBool	enableBorder Enables borders for textures.
SoSFBool	enableCompressedTexture Enables storage of textures on the graphics board in compressed form.
static int	GIF Deprecated. Use SoTexture.FileTypes.GIF instead.
static int	HDRI Deprecated. Use SoTexture.FileTypes.HDRI instead.
static int	HW_AUTOMIPMAP Deprecated. Use SoTexture.HW_Features.HW_AUTOMIPMAP instead.
static int	HW_BORDER_CLAMP Deprecated. Use SoTexture.HW_Features.HW_BORDER_CLAMP instead.
static int	HW_COMPRESSION_LATC Deprecated. Use SoTexture.HW_Features.HW_COMPRESSION_LATC instead.
static int	HW_COMPRESSION_RGTC Deprecated. Use SoTexture.HW_Features.HW_COMPRESSION_RGTC instead.
static int	HW_COMPRESSION_S3TC Deprecated. Use SoTexture.HW_Features.HW_COMPRESSION_S3TC instead.
static int	HW_DEPTHFORMAT Deprecated. Use SoTexture.HW_Features.HW_DEPTHFORMAT instead.
static int	HW_EDGE_CLAMP Deprecated. Use SoTexture.HW_Features.HW_EDGE_CLAMP instead.
static int	HW_FLOATFORMAT Deprecated. Use SoTexture.HW_Features.HW_FLOATFORMAT instead.
static int	HW_LAST Deprecated. Use SoTexture.HW_Features.HW_LAST instead.
static int	HW_MIRRORED_REPEAT Deprecated. Use SoTexture.HW_Features.HW_MIRRORED_REPEAT instead.
static int	HW_NPOT Deprecated. Use SoTexture.HW_Features.HW_NPOT instead.
static int	INTENSITY_FLOAT16 Deprecated. Use SoTexture.InternalFormats.INTENSITY_FLOAT16 instead.
static int	INTENSITY_FLOAT32 Deprecated. Use SoTexture.InternalFormats.INTENSITY_FLOAT32 instead.
static int	INTENSITY_FORMAT Deprecated. Use SoTexture.InternalFormats.INTENSITY_FORMAT instead.
static int	INTENSITY12 Deprecated. Use SoTexture.InternalFormats.INTENSITY12 instead.
static int	INTENSITY16 Deprecated. Use SoTexture.InternalFormats.INTENSITY16 instead.
static int	INTENSITY4 Deprecated. Use SoTexture.InternalFormats.INTENSITY4 instead.
static int	INTENSITY8 Deprecated. Use SoTexture.InternalFormats.INTENSITY8 instead.
SoSFEnum<SoTexture.InternalFormats>	internalFormat Internal format for texture storage.
static int	JPEG Deprecated. Use SoTexture.FileTypes.JPEG instead.
static int	JPEG2000 Deprecated. Use SoTexture.FileTypes.JPEG2000 instead.
static int	LINEAR Deprecated. Use SoTexture.Filters.LINEAR instead.
static int	LINEAR_MIPMAP_LINEAR Deprecated. Use SoTexture.Filters.LINEAR_MIPMAP_LINEAR instead.
static int	LINEAR_MIPMAP_NEAREST Deprecated. Use SoTexture.Filters.LINEAR_MIPMAP_NEAREST instead.
static int	LUMINANCE_ALPHA Deprecated. Use SoTexture.InternalFormats.LUMINANCE_ALPHA instead.
static int	LUMINANCE_ALPHA_FLOAT16 Deprecated. Use SoTexture.InternalFormats.LUMINANCE_ALPHA_FLOAT16 instead.
static int	LUMINANCE_ALPHA_FLOAT32 Deprecated. Use SoTexture.InternalFormats.LUMINANCE_ALPHA_FLOAT32 instead.
static int	LUMINANCE_FLOAT16 Deprecated. Use SoTexture.InternalFormats.LUMINANCE_FLOAT16 instead.
static int	LUMINANCE_FLOAT32 Deprecated. Use SoTexture.InternalFormats.LUMINANCE_FLOAT32 instead.
static int	LUMINANCE_FORMAT Deprecated. Use SoTexture.InternalFormats.LUMINANCE_FORMAT instead.
static int	LUMINANCE12 Deprecated. Use SoTexture.InternalFormats.LUMINANCE12 instead.
static int	LUMINANCE12_ALPHA12 Deprecated. Use SoTexture.InternalFormats.LUMINANCE12_ALPHA12 instead.
static int	LUMINANCE12_ALPHA4 Deprecated. Use SoTexture.InternalFormats.LUMINANCE12_ALPHA4 instead.
static int	LUMINANCE16 Deprecated. Use SoTexture.InternalFormats.LUMINANCE16 instead.
static int	LUMINANCE16_ALPHA16 Deprecated. Use SoTexture.InternalFormats.LUMINANCE16_ALPHA16 instead.
static int	LUMINANCE4 Deprecated. Use SoTexture.InternalFormats.LUMINANCE4 instead.
static int	LUMINANCE4_ALPHA4 Deprecated. Use SoTexture.InternalFormats.LUMINANCE4_ALPHA4 instead.
static int	LUMINANCE6_ALPHA2 Deprecated. Use SoTexture.InternalFormats.LUMINANCE6_ALPHA2 instead.
static int	LUMINANCE8 Deprecated. Use SoTexture.InternalFormats.LUMINANCE8 instead.
static int	LUMINANCE8_ALPHA8 Deprecated. Use SoTexture.InternalFormats.LUMINANCE8_ALPHA8 instead.
SoSFEnum<SoTexture.Filters>	magFilter Specifies the OpenGL magFilter.
SoSFFloat	maxAnisotropy Specifies on a per-texture object basis, the maximum degree of anisotropy to account for in texture filtering.
SoSFEnum<SoTexture.Filters>	minFilter Specifies the OpenGL minFilter.
static int	MIRRORED_REPEAT Deprecated. Use SoTexture.WrapType.MIRRORED_REPEAT instead.
SoSFEnum<SoTexture.Models>	model Specifies how to map texture onto surface.
static int	MODULATE Deprecated. Use SoTexture.Models.MODULATE instead.
static int	NEAREST Deprecated. Use SoTexture.Filters.NEAREST instead.
static int	NEAREST_MIPMAP_LINEAR Deprecated. Use SoTexture.Filters.NEAREST_MIPMAP_LINEAR instead.
static int	NEAREST_MIPMAP_NEAREST Deprecated. Use SoTexture.Filters.NEAREST_MIPMAP_NEAREST instead.
static int	NUM_FILETYPES Deprecated. Use SoTexture.FileTypes.NUM_FILETYPES instead.
static int	PGX Deprecated. Use SoTexture.FileTypes.PGX instead.
static int	PNG Deprecated. Use SoTexture.FileTypes.PNG instead.
static int	PNM Deprecated. Use SoTexture.FileTypes.PNM instead.
static int	R3_G3_B2 Deprecated. Use SoTexture.InternalFormats.R3_G3_B2 instead.
static int	RAS Deprecated. Use SoTexture.FileTypes.RAS instead.
static int	REPEAT Deprecated. Use SoTexture.WrapType.REPEAT instead.
static int	REPLACE Deprecated. Use SoTexture.Models.REPLACE instead.
static int	RGB Deprecated. Use SoTexture.FileTypes.RGB instead.
static int	RGB_FLOAT16 Deprecated. Use SoTexture.InternalFormats.RGB_FLOAT16 instead.
static int	RGB_FLOAT32 Deprecated. Use SoTexture.InternalFormats.RGB_FLOAT32 instead.
static int	RGB_FORMAT Deprecated. Use SoTexture.InternalFormats.RGB_FORMAT instead.
static int	RGB10 Deprecated. Use SoTexture.InternalFormats.RGB10 instead.
static int	RGB10_ALPHA2 Deprecated. Use SoTexture.InternalFormats.RGB10_ALPHA2 instead.
static int	RGB12 Deprecated. Use SoTexture.InternalFormats.RGB12 instead.
static int	RGB16 Deprecated. Use SoTexture.InternalFormats.RGB16 instead.
static int	RGB4 Deprecated. Use SoTexture.InternalFormats.RGB4 instead.
static int	RGB5 Deprecated. Use SoTexture.InternalFormats.RGB5 instead.
static int	RGB5_ALPHA1 Deprecated. Use SoTexture.InternalFormats.RGB5_ALPHA1 instead.
static int	RGB8 Deprecated. Use SoTexture.InternalFormats.RGB8 instead.
static int	RGBA_FLOAT16 Deprecated. Use SoTexture.InternalFormats.RGBA_FLOAT16 instead.
static int	RGBA_FLOAT32 Deprecated. Use SoTexture.InternalFormats.RGBA_FLOAT32 instead.
static int	RGBA_FORMAT Deprecated. Use SoTexture.InternalFormats.RGBA_FORMAT instead.
static int	RGBA12 Deprecated. Use SoTexture.InternalFormats.RGBA12 instead.
static int	RGBA16 Deprecated. Use SoTexture.InternalFormats.RGBA16 instead.
static int	RGBA2 Deprecated. Use SoTexture.InternalFormats.RGBA2 instead.
static int	RGBA4 Deprecated. Use SoTexture.InternalFormats.RGBA4 instead.
static int	RGBA8 Deprecated. Use SoTexture.InternalFormats.RGBA8 instead.
static int	SGI Deprecated. Use SoTexture.FileTypes.SGI instead.
static int	TIFF Deprecated. Use SoTexture.FileTypes.TIFF instead.
static int	UNKNOWN Deprecated. Use SoTexture.FileTypes.UNKNOWN instead.
SoSFBool	useAutoMipmap Deprecated. As of Open Inventor 9620 See documentation for more details
SoSFEnum<SoTexture.WrapType>	wrapS Indicates what to do when texture coordinates in the S (horizontal) direction lie outside the range 0-1.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
SoTexture.FileTypes	getBitmapFileType() Gets the texture file format.
static boolean	isSupported(SoTexture.HW_Features feature) Returns information about hardware support for various texture features.
void	setBitmapFileType(SoTexture.FileTypes in_type) Sets the texture file format.

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

AUTO_INTERNAL_FORMAT

@Deprecated
public static final int AUTO_INTERNAL_FORMAT

Deprecated. Use SoTexture.InternalFormats.AUTO_INTERNAL_FORMAT instead.

ALPHA_FORMAT

@Deprecated
public static final int ALPHA_FORMAT

Deprecated. Use SoTexture.InternalFormats.ALPHA_FORMAT instead.

ALPHA4

@Deprecated
public static final int ALPHA4

Deprecated. Use SoTexture.InternalFormats.ALPHA4 instead.

ALPHA8

@Deprecated
public static final int ALPHA8

Deprecated. Use SoTexture.InternalFormats.ALPHA8 instead.

ALPHA12

@Deprecated
public static final int ALPHA12

Deprecated. Use SoTexture.InternalFormats.ALPHA12 instead.

ALPHA16

@Deprecated
public static final int ALPHA16

Deprecated. Use SoTexture.InternalFormats.ALPHA16 instead.

LUMINANCE_FORMAT

@Deprecated
public static final int LUMINANCE_FORMAT

Deprecated. Use SoTexture.InternalFormats.LUMINANCE_FORMAT instead.

LUMINANCE4

@Deprecated
public static final int LUMINANCE4

Deprecated. Use SoTexture.InternalFormats.LUMINANCE4 instead.

LUMINANCE8

@Deprecated
public static final int LUMINANCE8

Deprecated. Use SoTexture.InternalFormats.LUMINANCE8 instead.

LUMINANCE12

@Deprecated
public static final int LUMINANCE12

Deprecated. Use SoTexture.InternalFormats.LUMINANCE12 instead.

LUMINANCE16

@Deprecated
public static final int LUMINANCE16

Deprecated. Use SoTexture.InternalFormats.LUMINANCE16 instead.

LUMINANCE_ALPHA

@Deprecated
public static final int LUMINANCE_ALPHA

Deprecated. Use SoTexture.InternalFormats.LUMINANCE_ALPHA instead.

LUMINANCE4_ALPHA4

@Deprecated
public static final int LUMINANCE4_ALPHA4

Deprecated. Use SoTexture.InternalFormats.LUMINANCE4_ALPHA4 instead.

LUMINANCE6_ALPHA2

@Deprecated
public static final int LUMINANCE6_ALPHA2

Deprecated. Use SoTexture.InternalFormats.LUMINANCE6_ALPHA2 instead.

LUMINANCE8_ALPHA8

@Deprecated
public static final int LUMINANCE8_ALPHA8

Deprecated. Use SoTexture.InternalFormats.LUMINANCE8_ALPHA8 instead.

LUMINANCE12_ALPHA4

@Deprecated
public static final int LUMINANCE12_ALPHA4

Deprecated. Use SoTexture.InternalFormats.LUMINANCE12_ALPHA4 instead.

LUMINANCE12_ALPHA12

@Deprecated
public static final int LUMINANCE12_ALPHA12

Deprecated. Use SoTexture.InternalFormats.LUMINANCE12_ALPHA12 instead.

LUMINANCE16_ALPHA16

@Deprecated
public static final int LUMINANCE16_ALPHA16

Deprecated. Use SoTexture.InternalFormats.LUMINANCE16_ALPHA16 instead.

INTENSITY_FORMAT

@Deprecated
public static final int INTENSITY_FORMAT

Deprecated. Use SoTexture.InternalFormats.INTENSITY_FORMAT instead.

INTENSITY4

@Deprecated
public static final int INTENSITY4

Deprecated. Use SoTexture.InternalFormats.INTENSITY4 instead.

INTENSITY8

@Deprecated
public static final int INTENSITY8

Deprecated. Use SoTexture.InternalFormats.INTENSITY8 instead.

INTENSITY12

@Deprecated
public static final int INTENSITY12

Deprecated. Use SoTexture.InternalFormats.INTENSITY12 instead.

INTENSITY16

@Deprecated
public static final int INTENSITY16

Deprecated. Use SoTexture.InternalFormats.INTENSITY16 instead.

R3_G3_B2

@Deprecated
public static final int R3_G3_B2

Deprecated. Use SoTexture.InternalFormats.R3_G3_B2 instead.

RGB_FORMAT

@Deprecated
public static final int RGB_FORMAT

Deprecated. Use SoTexture.InternalFormats.RGB_FORMAT instead.

RGB4

@Deprecated
public static final int RGB4

Deprecated. Use SoTexture.InternalFormats.RGB4 instead.

RGB5

@Deprecated
public static final int RGB5

Deprecated. Use SoTexture.InternalFormats.RGB5 instead.

RGB8

@Deprecated
public static final int RGB8

Deprecated. Use SoTexture.InternalFormats.RGB8 instead.

RGB10

@Deprecated
public static final int RGB10

Deprecated. Use SoTexture.InternalFormats.RGB10 instead.

RGB12

@Deprecated
public static final int RGB12

Deprecated. Use SoTexture.InternalFormats.RGB12 instead.

RGB16

@Deprecated
public static final int RGB16

Deprecated. Use SoTexture.InternalFormats.RGB16 instead.

RGBA_FORMAT

@Deprecated
public static final int RGBA_FORMAT

Deprecated. Use SoTexture.InternalFormats.RGBA_FORMAT instead.

RGBA2

@Deprecated
public static final int RGBA2

Deprecated. Use SoTexture.InternalFormats.RGBA2 instead.

RGBA4

@Deprecated
public static final int RGBA4

Deprecated. Use SoTexture.InternalFormats.RGBA4 instead.

RGB5_ALPHA1

@Deprecated
public static final int RGB5_ALPHA1

Deprecated. Use SoTexture.InternalFormats.RGB5_ALPHA1 instead.

RGBA8

@Deprecated
public static final int RGBA8

Deprecated. Use SoTexture.InternalFormats.RGBA8 instead.

RGB10_ALPHA2

@Deprecated
public static final int RGB10_ALPHA2

Deprecated. Use SoTexture.InternalFormats.RGB10_ALPHA2 instead.

RGBA12

@Deprecated
public static final int RGBA12

Deprecated. Use SoTexture.InternalFormats.RGBA12 instead.

RGBA16

@Deprecated
public static final int RGBA16

Deprecated. Use SoTexture.InternalFormats.RGBA16 instead.

RGBA_FLOAT32

@Deprecated
public static final int RGBA_FLOAT32

Deprecated. Use SoTexture.InternalFormats.RGBA_FLOAT32 instead.

RGB_FLOAT32

@Deprecated
public static final int RGB_FLOAT32

Deprecated. Use SoTexture.InternalFormats.RGB_FLOAT32 instead.

ALPHA_FLOAT32

@Deprecated
public static final int ALPHA_FLOAT32

Deprecated. Use SoTexture.InternalFormats.ALPHA_FLOAT32 instead.

INTENSITY_FLOAT32

@Deprecated
public static final int INTENSITY_FLOAT32

Deprecated. Use SoTexture.InternalFormats.INTENSITY_FLOAT32 instead.

LUMINANCE_FLOAT32

@Deprecated
public static final int LUMINANCE_FLOAT32

Deprecated. Use SoTexture.InternalFormats.LUMINANCE_FLOAT32 instead.

LUMINANCE_ALPHA_FLOAT32

@Deprecated
public static final int LUMINANCE_ALPHA_FLOAT32

Deprecated. Use SoTexture.InternalFormats.LUMINANCE_ALPHA_FLOAT32 instead.

RGBA_FLOAT16

@Deprecated
public static final int RGBA_FLOAT16

Deprecated. Use SoTexture.InternalFormats.RGBA_FLOAT16 instead.

RGB_FLOAT16

@Deprecated
public static final int RGB_FLOAT16

Deprecated. Use SoTexture.InternalFormats.RGB_FLOAT16 instead.

ALPHA_FLOAT16

@Deprecated
public static final int ALPHA_FLOAT16

Deprecated. Use SoTexture.InternalFormats.ALPHA_FLOAT16 instead.

INTENSITY_FLOAT16

@Deprecated
public static final int INTENSITY_FLOAT16

Deprecated. Use SoTexture.InternalFormats.INTENSITY_FLOAT16 instead.

LUMINANCE_FLOAT16

@Deprecated
public static final int LUMINANCE_FLOAT16

Deprecated. Use SoTexture.InternalFormats.LUMINANCE_FLOAT16 instead.

LUMINANCE_ALPHA_FLOAT16

@Deprecated
public static final int LUMINANCE_ALPHA_FLOAT16

Deprecated. Use SoTexture.InternalFormats.LUMINANCE_ALPHA_FLOAT16 instead.

COMPRESSED_ALPHA

@Deprecated
public static final int COMPRESSED_ALPHA

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_ALPHA instead.

COMPRESSED_LUMINANCE

@Deprecated
public static final int COMPRESSED_LUMINANCE

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE instead.

COMPRESSED_LUMINANCE_ALPHA

@Deprecated
public static final int COMPRESSED_LUMINANCE_ALPHA

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE_ALPHA instead.

COMPRESSED_INTENSITY

@Deprecated
public static final int COMPRESSED_INTENSITY

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_INTENSITY instead.

COMPRESSED_RGB

@Deprecated
public static final int COMPRESSED_RGB

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RGB instead.

COMPRESSED_RGBA

@Deprecated
public static final int COMPRESSED_RGBA

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RGBA instead.

COMPRESSED_LUMINANCE_LATC1

@Deprecated
public static final int COMPRESSED_LUMINANCE_LATC1

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE_LATC1 instead.

COMPRESSED_SIGNED_LUMINANCE_LATC1

@Deprecated
public static final int COMPRESSED_SIGNED_LUMINANCE_LATC1

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_LUMINANCE_LATC1 instead.

COMPRESSED_LUMINANCE_ALPHA_LATC2

@Deprecated
public static final int COMPRESSED_LUMINANCE_ALPHA_LATC2

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_LUMINANCE_ALPHA_LATC2 instead.

COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2

@Deprecated
public static final int COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2 instead.

COMPRESSED_RED_RGTC1

@Deprecated
public static final int COMPRESSED_RED_RGTC1

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RED_RGTC1 instead.

COMPRESSED_SIGNED_RED_RGTC1

@Deprecated
public static final int COMPRESSED_SIGNED_RED_RGTC1

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_RED_RGTC1 instead.

COMPRESSED_RED_GREEN_RGTC2

@Deprecated
public static final int COMPRESSED_RED_GREEN_RGTC2

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_RED_GREEN_RGTC2 instead.

COMPRESSED_SIGNED_RED_GREEN_RGTC2

@Deprecated
public static final int COMPRESSED_SIGNED_RED_GREEN_RGTC2

Deprecated. Use SoTexture.InternalFormats.COMPRESSED_SIGNED_RED_GREEN_RGTC2 instead.

DEPTH_COMPONENT16

@Deprecated
public static final int DEPTH_COMPONENT16

Deprecated. Use SoTexture.InternalFormats.DEPTH_COMPONENT16 instead.

DEPTH_COMPONENT24

@Deprecated
public static final int DEPTH_COMPONENT24

Deprecated. Use SoTexture.InternalFormats.DEPTH_COMPONENT24 instead.

DEPTH24_STENCIL8

@Deprecated
public static final int DEPTH24_STENCIL8

Deprecated. Use SoTexture.InternalFormats.DEPTH24_STENCIL8 instead.

MODULATE

@Deprecated
public static final int MODULATE

Deprecated. Use SoTexture.Models.MODULATE instead.

DECAL

@Deprecated
public static final int DECAL

Deprecated. Use SoTexture.Models.DECAL instead.

BLEND

@Deprecated
public static final int BLEND

Deprecated. Use SoTexture.Models.BLEND instead.

REPLACE

@Deprecated
public static final int REPLACE

Deprecated. Use SoTexture.Models.REPLACE instead.

ADD

@Deprecated
public static final int ADD

Deprecated. Use SoTexture.Models.ADD instead.

COMBINE

@Deprecated
public static final int COMBINE

Deprecated. Use SoTexture.Models.COMBINE instead.

REPEAT

@Deprecated
public static final int REPEAT

Deprecated. Use SoTexture.WrapType.REPEAT instead.

CLAMP

@Deprecated
public static final int CLAMP

Deprecated. Use SoTexture.WrapType.CLAMP instead.

CLAMP_TO_BORDER

@Deprecated
public static final int CLAMP_TO_BORDER

Deprecated. Use SoTexture.WrapType.CLAMP_TO_BORDER instead.

CLAMP_TO_EDGE

@Deprecated
public static final int CLAMP_TO_EDGE

Deprecated. Use SoTexture.WrapType.CLAMP_TO_EDGE instead.

MIRRORED_REPEAT

@Deprecated
public static final int MIRRORED_REPEAT

Deprecated. Use SoTexture.WrapType.MIRRORED_REPEAT instead.

AUTO

@Deprecated
public static final int AUTO

Deprecated. Use SoTexture.Filters.AUTO instead.

NEAREST

@Deprecated
public static final int NEAREST

Deprecated. Use SoTexture.Filters.NEAREST instead.

LINEAR

@Deprecated
public static final int LINEAR

Deprecated. Use SoTexture.Filters.LINEAR instead.

NEAREST_MIPMAP_NEAREST

@Deprecated
public static final int NEAREST_MIPMAP_NEAREST

Deprecated. Use SoTexture.Filters.NEAREST_MIPMAP_NEAREST instead.

NEAREST_MIPMAP_LINEAR

@Deprecated
public static final int NEAREST_MIPMAP_LINEAR

Deprecated. Use SoTexture.Filters.NEAREST_MIPMAP_LINEAR instead.

LINEAR_MIPMAP_NEAREST

@Deprecated
public static final int LINEAR_MIPMAP_NEAREST

Deprecated. Use SoTexture.Filters.LINEAR_MIPMAP_NEAREST instead.

LINEAR_MIPMAP_LINEAR

@Deprecated
public static final int LINEAR_MIPMAP_LINEAR

Deprecated. Use SoTexture.Filters.LINEAR_MIPMAP_LINEAR instead.

HW_NPOT

@Deprecated
public static final int HW_NPOT

Deprecated. Use SoTexture.HW_Features.HW_NPOT instead.

HW_FLOATFORMAT

@Deprecated
public static final int HW_FLOATFORMAT

Deprecated. Use SoTexture.HW_Features.HW_FLOATFORMAT instead.

HW_DEPTHFORMAT

@Deprecated
public static final int HW_DEPTHFORMAT

Deprecated. Use SoTexture.HW_Features.HW_DEPTHFORMAT instead.

HW_AUTOMIPMAP

@Deprecated
public static final int HW_AUTOMIPMAP

Deprecated. Use SoTexture.HW_Features.HW_AUTOMIPMAP instead.

HW_BORDER_CLAMP

@Deprecated
public static final int HW_BORDER_CLAMP

Deprecated. Use SoTexture.HW_Features.HW_BORDER_CLAMP instead.

HW_EDGE_CLAMP

@Deprecated
public static final int HW_EDGE_CLAMP

Deprecated. Use SoTexture.HW_Features.HW_EDGE_CLAMP instead.

HW_MIRRORED_REPEAT

@Deprecated
public static final int HW_MIRRORED_REPEAT

Deprecated. Use SoTexture.HW_Features.HW_MIRRORED_REPEAT instead.

HW_COMPRESSION_S3TC

@Deprecated
public static final int HW_COMPRESSION_S3TC

Deprecated. Use SoTexture.HW_Features.HW_COMPRESSION_S3TC instead.

HW_COMPRESSION_LATC

@Deprecated
public static final int HW_COMPRESSION_LATC

Deprecated. Use SoTexture.HW_Features.HW_COMPRESSION_LATC instead.

HW_COMPRESSION_RGTC

@Deprecated
public static final int HW_COMPRESSION_RGTC

Deprecated. Use SoTexture.HW_Features.HW_COMPRESSION_RGTC instead.

HW_LAST

@Deprecated
public static final int HW_LAST

Deprecated. Use SoTexture.HW_Features.HW_LAST instead.

UNKNOWN

@Deprecated
public static final int UNKNOWN

Deprecated. Use SoTexture.FileTypes.UNKNOWN instead.

RGB

@Deprecated
public static final int RGB

Deprecated. Use SoTexture.FileTypes.RGB instead.

SGI

@Deprecated
public static final int SGI

Deprecated. Use SoTexture.FileTypes.SGI instead.

TIFF

@Deprecated
public static final int TIFF

Deprecated. Use SoTexture.FileTypes.TIFF instead.

GIF

@Deprecated
public static final int GIF

Deprecated. Use SoTexture.FileTypes.GIF instead.

JPEG

@Deprecated
public static final int JPEG

Deprecated. Use SoTexture.FileTypes.JPEG instead.

BMP

@Deprecated
public static final int BMP

Deprecated. Use SoTexture.FileTypes.BMP instead.

PNG

@Deprecated
public static final int PNG

Deprecated. Use SoTexture.FileTypes.PNG instead.

JPEG2000

@Deprecated
public static final int JPEG2000

Deprecated. Use SoTexture.FileTypes.JPEG2000 instead.

PGX

@Deprecated
public static final int PGX

Deprecated. Use SoTexture.FileTypes.PGX instead.

PNM

@Deprecated
public static final int PNM

Deprecated. Use SoTexture.FileTypes.PNM instead.

RAS

@Deprecated
public static final int RAS

Deprecated. Use SoTexture.FileTypes.RAS instead.

DDS

@Deprecated
public static final int DDS

Deprecated. Use SoTexture.FileTypes.DDS instead.

HDRI

@Deprecated
public static final int HDRI

Deprecated. Use SoTexture.FileTypes.HDRI instead.

NUM_FILETYPES

@Deprecated
public static final int NUM_FILETYPES

Deprecated. Use SoTexture.FileTypes.NUM_FILETYPES instead.

useAutoMipmap

@Deprecated
public final SoSFBool useAutoMipmap

Deprecated. As of Open Inventor 9620 See documentation for more details

Sets OpenGL auto-mipmap generation (if supported). false by default.

Since:

Open Inventor 6.0Deprecated since Open Inventor 9620
No longer used. mip map are always generated if needed.

internalFormat

public final SoSFEnum<SoTexture.InternalFormats> internalFormat

Internal format for texture storage. If not available on the graphics device, internalFormat is set back to AUTO_INTERNAL_FORMAT. Use enum InternalFormat. Default is AUTO_INTERNAL_FORMAT. If internal format is set to AUTO_INTERNAL_FORMAT texture precision could only be 16-bit maximum. To go beyond this limitation, you must set the internal format to the needed value.

Since:

Open Inventor 6.0

enableCompressedTexture

public final SoSFBool enableCompressedTexture

Enables storage of textures on the graphics board in compressed form. The application supplies textures as usual, then OpenGL compresses the textures. This can reduce usage of texture memory significantly, depending on the texture image.

To use this option, you must be using OpenGL 1.3 or higher, or your board must support the OpenGL GL_ARB_texture_compression extension.

Since:

Open Inventor 4.0

wrapS

public final SoSFEnum<SoTexture.WrapType> wrapS

Indicates what to do when texture coordinates in the S (horizontal) direction lie outside the range 0-1. Use enum Wrap. Default is REPEAT.

model

public final SoSFEnum<SoTexture.Models> model

Specifies how to map texture onto surface. Use enum Model. Default is MODULATE.

blendColor

public final SoSFColor blendColor

Color used for BLEND model.

enableBorder

public final SoSFBool enableBorder

Enables borders for textures. This means that the border is already in the texture.

Since:

Open Inventor 5.0

borderColor

public final SoSFVec4f borderColor

Defines border color used for border texture filtering. This value is only used if enableBorder is false.

Since:

Open Inventor 5.0

maxAnisotropy

public final SoSFFloat maxAnisotropy

Specifies on a per-texture object basis, the maximum degree of anisotropy to account for in texture filtering. If the specified value is greater than the maximum supported by the graphics board, the value is clamped to GL_MAX_TEXTURE_MAX_ANISOTROPY_EXT.

To use this option, you must be using OpenGL 1.1 or higher, or your board must support the OpenGL GL_EXT_filter_anisotropic extension.

Since:

Open Inventor 5.0

minFilter

public final SoSFEnum<SoTexture.Filters> minFilter

Specifies the OpenGL minFilter. Use enum Filter. Default is AUTO. The minification filter is used when the rendered size of the geometry is smaller than the texture image to be applied (typically far away objects). Effectively controls whether the GPU will select the "nearest" texel in the texture image or do linear interpolation (smoothing) or even interpolate between mipmap levels (subsampled versions of the base image). Using NEAREST may allow better performance, but the LINEAR options produce much higher quality rendering.

The default value (AUTO) means that the minification filter setting is actually controlled by the SoComplexity.textureQuality field.

Since:

Open Inventor 5.0

magFilter

public final SoSFEnum<SoTexture.Filters> magFilter

Specifies the OpenGL magFilter. Use enum Filter. Default is AUTO. Only the following Filter values are valid: AUTO, NEAREST, and LINEAR.

The magnification filter is used when the rendered size of the geometry is larger than the texture image to be applied (typically near objects). Effectively controls whether the GPU will select the "nearest" texel in the texture image or do linear interpolation (smoothing). Using NEAREST may allow better performance, but the LINEAR options produce much higher quality rendering.

Only the values NEAREST and LINEAR are valid in this field (see OpenGL specification).

The default value (AUTO) means that the magnification filter setting is actually controlled by the SoComplexity.textureQuality field.

Since:

Open Inventor 5.0

Method Detail

getBitmapFileType

public SoTexture.FileTypes getBitmapFileType()

Gets the texture file format.

isSupported

public static boolean isSupported(SoTexture.HW_Features feature)

Returns information about hardware support for various texture features. When using a debug build of Open Inventor, some "no context available" warning messages may be generated. You can ignore them or see SoGLExtension for an example of using SoGLContext to avoid them.

setBitmapFileType

public void setBitmapFileType(SoTexture.FileTypes in_type)

Sets the texture file format. Default is UNKNOWN. If file type is set to UNKNOWN, Open Inventor tries to determine the file type from the file name extension (e.g., foo. gif implies a GIF file). If the set or determined file type is not UNKNOWN, Open Inventor attempts to read the file as that format. If this fails, Open Inventor will try reading the file as each possible format in turn. It is not necessary to set the file type if the image file has the standard file name extension.