public abstract class SoTexture extends SoNode
SoTextureUnit) and used to apply the texture to subsequent shapes.
Open Inventor provides multiple texture image nodes optimized for different purposes, including:
SoTexture2SoExtTexture2SoTexture2, but has specific optimizations that are valuable for applications that load a large number of textures from files.
SoIndexedTexture2SoColorMap node. This is very useful for "intensity" data sets.
SoTextureCubeMapSoTexture3SoVolumeData).
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
| 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.
|
Inventor.ConstructorCommandVERBOSE_LEVEL, ZeroHandle| 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.
|
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, writecopyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaultsdispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizablegetAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads@Deprecated public static final int AUTO_INTERNAL_FORMAT
SoTexture.InternalFormats.AUTO_INTERNAL_FORMAT instead.@Deprecated public static final int ALPHA_FORMAT
SoTexture.InternalFormats.ALPHA_FORMAT instead.@Deprecated public static final int ALPHA4
SoTexture.InternalFormats.ALPHA4 instead.@Deprecated public static final int ALPHA8
SoTexture.InternalFormats.ALPHA8 instead.@Deprecated public static final int ALPHA12
SoTexture.InternalFormats.ALPHA12 instead.@Deprecated public static final int ALPHA16
SoTexture.InternalFormats.ALPHA16 instead.@Deprecated public static final int LUMINANCE_FORMAT
SoTexture.InternalFormats.LUMINANCE_FORMAT instead.@Deprecated public static final int LUMINANCE4
SoTexture.InternalFormats.LUMINANCE4 instead.@Deprecated public static final int LUMINANCE8
SoTexture.InternalFormats.LUMINANCE8 instead.@Deprecated public static final int LUMINANCE12
SoTexture.InternalFormats.LUMINANCE12 instead.@Deprecated public static final int LUMINANCE16
SoTexture.InternalFormats.LUMINANCE16 instead.@Deprecated public static final int LUMINANCE_ALPHA
SoTexture.InternalFormats.LUMINANCE_ALPHA instead.@Deprecated public static final int LUMINANCE4_ALPHA4
SoTexture.InternalFormats.LUMINANCE4_ALPHA4 instead.@Deprecated public static final int LUMINANCE6_ALPHA2
SoTexture.InternalFormats.LUMINANCE6_ALPHA2 instead.@Deprecated public static final int LUMINANCE8_ALPHA8
SoTexture.InternalFormats.LUMINANCE8_ALPHA8 instead.@Deprecated public static final int LUMINANCE12_ALPHA4
SoTexture.InternalFormats.LUMINANCE12_ALPHA4 instead.@Deprecated public static final int LUMINANCE12_ALPHA12
SoTexture.InternalFormats.LUMINANCE12_ALPHA12 instead.@Deprecated public static final int LUMINANCE16_ALPHA16
SoTexture.InternalFormats.LUMINANCE16_ALPHA16 instead.@Deprecated public static final int INTENSITY_FORMAT
SoTexture.InternalFormats.INTENSITY_FORMAT instead.@Deprecated public static final int INTENSITY4
SoTexture.InternalFormats.INTENSITY4 instead.@Deprecated public static final int INTENSITY8
SoTexture.InternalFormats.INTENSITY8 instead.@Deprecated public static final int INTENSITY12
SoTexture.InternalFormats.INTENSITY12 instead.@Deprecated public static final int INTENSITY16
SoTexture.InternalFormats.INTENSITY16 instead.@Deprecated public static final int R3_G3_B2
SoTexture.InternalFormats.R3_G3_B2 instead.@Deprecated public static final int RGB_FORMAT
SoTexture.InternalFormats.RGB_FORMAT instead.@Deprecated public static final int RGB4
SoTexture.InternalFormats.RGB4 instead.@Deprecated public static final int RGB5
SoTexture.InternalFormats.RGB5 instead.@Deprecated public static final int RGB8
SoTexture.InternalFormats.RGB8 instead.@Deprecated public static final int RGB10
SoTexture.InternalFormats.RGB10 instead.@Deprecated public static final int RGB12
SoTexture.InternalFormats.RGB12 instead.@Deprecated public static final int RGB16
SoTexture.InternalFormats.RGB16 instead.@Deprecated public static final int RGBA_FORMAT
SoTexture.InternalFormats.RGBA_FORMAT instead.@Deprecated public static final int RGBA2
SoTexture.InternalFormats.RGBA2 instead.@Deprecated public static final int RGBA4
SoTexture.InternalFormats.RGBA4 instead.@Deprecated public static final int RGB5_ALPHA1
SoTexture.InternalFormats.RGB5_ALPHA1 instead.@Deprecated public static final int RGBA8
SoTexture.InternalFormats.RGBA8 instead.@Deprecated public static final int RGB10_ALPHA2
SoTexture.InternalFormats.RGB10_ALPHA2 instead.@Deprecated public static final int RGBA12
SoTexture.InternalFormats.RGBA12 instead.@Deprecated public static final int RGBA16
SoTexture.InternalFormats.RGBA16 instead.@Deprecated public static final int RGBA_FLOAT32
SoTexture.InternalFormats.RGBA_FLOAT32 instead.@Deprecated public static final int RGB_FLOAT32
SoTexture.InternalFormats.RGB_FLOAT32 instead.@Deprecated public static final int ALPHA_FLOAT32
SoTexture.InternalFormats.ALPHA_FLOAT32 instead.@Deprecated public static final int INTENSITY_FLOAT32
SoTexture.InternalFormats.INTENSITY_FLOAT32 instead.@Deprecated public static final int LUMINANCE_FLOAT32
SoTexture.InternalFormats.LUMINANCE_FLOAT32 instead.@Deprecated public static final int LUMINANCE_ALPHA_FLOAT32
SoTexture.InternalFormats.LUMINANCE_ALPHA_FLOAT32 instead.@Deprecated public static final int RGBA_FLOAT16
SoTexture.InternalFormats.RGBA_FLOAT16 instead.@Deprecated public static final int RGB_FLOAT16
SoTexture.InternalFormats.RGB_FLOAT16 instead.@Deprecated public static final int ALPHA_FLOAT16
SoTexture.InternalFormats.ALPHA_FLOAT16 instead.@Deprecated public static final int INTENSITY_FLOAT16
SoTexture.InternalFormats.INTENSITY_FLOAT16 instead.@Deprecated public static final int LUMINANCE_FLOAT16
SoTexture.InternalFormats.LUMINANCE_FLOAT16 instead.@Deprecated public static final int LUMINANCE_ALPHA_FLOAT16
SoTexture.InternalFormats.LUMINANCE_ALPHA_FLOAT16 instead.@Deprecated public static final int COMPRESSED_ALPHA
SoTexture.InternalFormats.COMPRESSED_ALPHA instead.@Deprecated public static final int COMPRESSED_LUMINANCE
SoTexture.InternalFormats.COMPRESSED_LUMINANCE instead.@Deprecated public static final int COMPRESSED_LUMINANCE_ALPHA
SoTexture.InternalFormats.COMPRESSED_LUMINANCE_ALPHA instead.@Deprecated public static final int COMPRESSED_INTENSITY
SoTexture.InternalFormats.COMPRESSED_INTENSITY instead.@Deprecated public static final int COMPRESSED_RGB
SoTexture.InternalFormats.COMPRESSED_RGB instead.@Deprecated public static final int COMPRESSED_RGBA
SoTexture.InternalFormats.COMPRESSED_RGBA instead.@Deprecated public static final int COMPRESSED_LUMINANCE_LATC1
SoTexture.InternalFormats.COMPRESSED_LUMINANCE_LATC1 instead.@Deprecated public static final int COMPRESSED_SIGNED_LUMINANCE_LATC1
SoTexture.InternalFormats.COMPRESSED_SIGNED_LUMINANCE_LATC1 instead.@Deprecated public static final int COMPRESSED_LUMINANCE_ALPHA_LATC2
SoTexture.InternalFormats.COMPRESSED_LUMINANCE_ALPHA_LATC2 instead.@Deprecated public static final int COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2
SoTexture.InternalFormats.COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2 instead.@Deprecated public static final int COMPRESSED_RED_RGTC1
SoTexture.InternalFormats.COMPRESSED_RED_RGTC1 instead.@Deprecated public static final int COMPRESSED_SIGNED_RED_RGTC1
SoTexture.InternalFormats.COMPRESSED_SIGNED_RED_RGTC1 instead.@Deprecated public static final int COMPRESSED_RED_GREEN_RGTC2
SoTexture.InternalFormats.COMPRESSED_RED_GREEN_RGTC2 instead.@Deprecated public static final int COMPRESSED_SIGNED_RED_GREEN_RGTC2
SoTexture.InternalFormats.COMPRESSED_SIGNED_RED_GREEN_RGTC2 instead.@Deprecated public static final int DEPTH_COMPONENT16
SoTexture.InternalFormats.DEPTH_COMPONENT16 instead.@Deprecated public static final int DEPTH_COMPONENT24
SoTexture.InternalFormats.DEPTH_COMPONENT24 instead.@Deprecated public static final int DEPTH24_STENCIL8
SoTexture.InternalFormats.DEPTH24_STENCIL8 instead.@Deprecated public static final int MODULATE
SoTexture.Models.MODULATE instead.@Deprecated public static final int DECAL
SoTexture.Models.DECAL instead.@Deprecated public static final int BLEND
SoTexture.Models.BLEND instead.@Deprecated public static final int REPLACE
SoTexture.Models.REPLACE instead.@Deprecated public static final int ADD
SoTexture.Models.ADD instead.@Deprecated public static final int COMBINE
SoTexture.Models.COMBINE instead.@Deprecated public static final int REPEAT
SoTexture.WrapType.REPEAT instead.@Deprecated public static final int CLAMP
SoTexture.WrapType.CLAMP instead.@Deprecated public static final int CLAMP_TO_BORDER
SoTexture.WrapType.CLAMP_TO_BORDER instead.@Deprecated public static final int CLAMP_TO_EDGE
SoTexture.WrapType.CLAMP_TO_EDGE instead.@Deprecated public static final int MIRRORED_REPEAT
SoTexture.WrapType.MIRRORED_REPEAT instead.@Deprecated public static final int AUTO
SoTexture.Filters.AUTO instead.@Deprecated public static final int NEAREST
SoTexture.Filters.NEAREST instead.@Deprecated public static final int LINEAR
SoTexture.Filters.LINEAR instead.@Deprecated public static final int NEAREST_MIPMAP_NEAREST
SoTexture.Filters.NEAREST_MIPMAP_NEAREST instead.@Deprecated public static final int NEAREST_MIPMAP_LINEAR
SoTexture.Filters.NEAREST_MIPMAP_LINEAR instead.@Deprecated public static final int LINEAR_MIPMAP_NEAREST
SoTexture.Filters.LINEAR_MIPMAP_NEAREST instead.@Deprecated public static final int LINEAR_MIPMAP_LINEAR
SoTexture.Filters.LINEAR_MIPMAP_LINEAR instead.@Deprecated public static final int HW_NPOT
SoTexture.HW_Features.HW_NPOT instead.@Deprecated public static final int HW_FLOATFORMAT
SoTexture.HW_Features.HW_FLOATFORMAT instead.@Deprecated public static final int HW_DEPTHFORMAT
SoTexture.HW_Features.HW_DEPTHFORMAT instead.@Deprecated public static final int HW_AUTOMIPMAP
SoTexture.HW_Features.HW_AUTOMIPMAP instead.@Deprecated public static final int HW_BORDER_CLAMP
SoTexture.HW_Features.HW_BORDER_CLAMP instead.@Deprecated public static final int HW_EDGE_CLAMP
SoTexture.HW_Features.HW_EDGE_CLAMP instead.@Deprecated public static final int HW_MIRRORED_REPEAT
SoTexture.HW_Features.HW_MIRRORED_REPEAT instead.@Deprecated public static final int HW_COMPRESSION_S3TC
SoTexture.HW_Features.HW_COMPRESSION_S3TC instead.@Deprecated public static final int HW_COMPRESSION_LATC
SoTexture.HW_Features.HW_COMPRESSION_LATC instead.@Deprecated public static final int HW_COMPRESSION_RGTC
SoTexture.HW_Features.HW_COMPRESSION_RGTC instead.@Deprecated public static final int HW_LAST
SoTexture.HW_Features.HW_LAST instead.@Deprecated public static final int UNKNOWN
SoTexture.FileTypes.UNKNOWN instead.@Deprecated public static final int RGB
SoTexture.FileTypes.RGB instead.@Deprecated public static final int SGI
SoTexture.FileTypes.SGI instead.@Deprecated public static final int TIFF
SoTexture.FileTypes.TIFF instead.@Deprecated public static final int GIF
SoTexture.FileTypes.GIF instead.@Deprecated public static final int JPEG
SoTexture.FileTypes.JPEG instead.@Deprecated public static final int BMP
SoTexture.FileTypes.BMP instead.@Deprecated public static final int PNG
SoTexture.FileTypes.PNG instead.@Deprecated public static final int JPEG2000
SoTexture.FileTypes.JPEG2000 instead.@Deprecated public static final int PGX
SoTexture.FileTypes.PGX instead.@Deprecated public static final int PNM
SoTexture.FileTypes.PNM instead.@Deprecated public static final int RAS
SoTexture.FileTypes.RAS instead.@Deprecated public static final int DDS
SoTexture.FileTypes.DDS instead.@Deprecated public static final int HDRI
SoTexture.FileTypes.HDRI instead.@Deprecated public static final int NUM_FILETYPES
SoTexture.FileTypes.NUM_FILETYPES instead.@Deprecated public final SoSFBool useAutoMipmap
public final SoSFEnum<SoTexture.InternalFormats> internalFormat
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.
public final SoSFBool enableCompressedTexture
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.
public final SoSFEnum<SoTexture.WrapType> wrapS
Wrap. Default is REPEAT.public final SoSFEnum<SoTexture.Models> model
Model. Default is MODULATE.public final SoSFColor blendColor
public final SoSFBool enableBorder
public final SoSFVec4f borderColor
enableBorder is false.
public final SoSFFloat maxAnisotropy
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.
public final SoSFEnum<SoTexture.Filters> minFilter
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.
public final SoSFEnum<SoTexture.Filters> magFilter
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.
public SoTexture.FileTypes getBitmapFileType()
public static boolean isSupported(SoTexture.HW_Features feature)
SoGLExtension for an example of using SoGLContext to avoid them.public void setBitmapFileType(SoTexture.FileTypes in_type)
Generated on July 23, 2025, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com