public class SoTexture3 extends SoTexture
The texture can be read from the file(s) specified by the filenames
field. Once the texture has been read, the images
field contains the texture data. However, this field is marked so the image is not written out when the texture node is written to a file. To turn off texturing, set the first value of the filenames
field to an empty string ("").
Textures can also be specified in memory by setting the images
field to contain the texture data. Doing so resets the filenames
field to the empty string.
Simply put, a 3D texture is a set of well-arranged 2D textures. Typically, 3D textures represent a set of image-slices of a given volume of data, and are used for mapping onto pieces of geometry. Note that this is different from direct volume rendering in that 3D textures need to be mapped onto a piece of geometry.
OpenGL requires all images in a 3D texture to have the same dimensions, and each dimension (X, Y, and Z) needs to be a power of 2. Also, images must have the same number of components (grayscale, grayscale with transparency, RGB, or RGB with transparency).
You should take this into account when setting texture coordinates. If your 3D image is not correctly dimensioned, you may want to consider either applying a ratio to your coordinates or adding an SoTexture3Transform
node with the field scaleFactor set to compensate.
The quality of the texturing is affected by the textureQuality field of the SoComplexity
node. The textureQuality field affects what kind of filtering is done to the texture when it must be minified or magnified. The mapping of a particular texture quality value to a particular OpenGL filtering technique is implementation dependent, and varies based on the texturing performance. If mipmap filtering is required, mipmaps are automatically created using the simple box filter.
Transparency Texture images can contain transparency (alpha values less than 1) and modify the transparency of geometry in the scene. Also note that some image file formats, for example JPEG, do not support transparency information (alpha channel).
LIMITATIONS
3D textures are only supported by the following shapes:
SoIndexedFaceSet
SoIndexedQuadMesh
SoIndexedTriangleStripSet
SoFaceSet
SoQuadMesh
SoTriangleStripSet
SoBufferedShape
Only SoIndexedFaceSet
shapes automatically compute texture coordinates if they are not specified either by a texture coordinate function (see SoTextureCoordinateFunction
) or by explicit texture coordinates (see SoTextureCoordinate3
).
File format/default:
Texture3 {
filenames | "" |
enableCompressedTexture | false |
images | 0 0 0 0 |
wrapS | REPEAT |
wrapT | REPEAT |
wrapR | REPEAT |
model | MODULATE |
blendColor | 0 0 0 |
enableBorder | false |
borderColor | 0 0 0 1 |
maxAnisotropy | 1.0 |
minFilter | AUTO |
magFilter | AUTO |
useAutoMipmap | false |
internalFormat | AUTO_INTERNAL_FORMAT |
layout | VOLUME |
Action behavior:
SoGLRenderAction
, SoCallbackAction
Sets current texture in state. Sets: SoTextureImage3Element
See also:
SoComplexity
, SoMaterial
, SoTextureCoordinate3
, SoTextureCoordinateBinding
, SoTextureCoordinateFunction
Modifier and Type | Class and Description |
---|---|
static class |
SoTexture3.Layouts
Texture layout.
|
SoTexture.FileTypes, SoTexture.Filters, SoTexture.HW_Features, SoTexture.InternalFormats, SoTexture.Models, SoTexture.WrapType
SoNode.RenderModes
Inventor.ConstructorCommand
Modifier and Type | Field and Description |
---|---|
SoMFFilePathString |
filenames
Names of file(s) from which to read texture image(s).
|
SoSFImage3 |
images
Contains an in-memory representation of the texture map.
|
SoSFEnum<SoTexture3.Layouts> |
layout
Indicates whether the data layout is a volumetric texture VOLUME or an array of bi-dimensional textures ARRAY.
|
SoSFEnum<SoTexture.WrapType> |
wrapR
Indicates what to do when texture coordinates in the R (depth) direction lie outside the range 0-1.
|
SoSFEnum<SoTexture.WrapType> |
wrapT
Indicates what to do when texture coordinates in the T (vertical) direction lie outside the range 0-1.
|
blendColor, borderColor, enableBorder, enableCompressedTexture, internalFormat, magFilter, maxAnisotropy, minFilter, model, wrapS
VERBOSE_LEVEL, ZeroHandle
Constructor and Description |
---|
SoTexture3()
Creates a texture node with default settings.
|
getBitmapFileType, isSupported, readTexture, readTexture, setBitmapFileType
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
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
getNativeResourceHandle
public final SoMFFilePathString filenames
SoRasterImageRW
for the list. If the filename is not an absolute path name, the list of directories maintained by SoInput
is searched. If the texture is not found in any of those directories, then the file is searched for relative to the directory from which the SoTexture3
node was read. For example, if an SoTexture3
node with a filename of "../tofu.rgb" is read from /usr/people/bob/models/food.iv, then /usr/people/bob/tofu.rgb will be read (assuming tofu.rgb isn't found in the directories maintained by SoInput
).
All images must have the same dimensions and number of components. Depth (number of slices) is determined by the number of file names.
Note that only 2D image file formats are currently supported. A 3D texture image can be read as a series of 2D image files.
public final SoSFImage3 images
filenames
, an image read directly from an Open Inventor file, or an image set programmatically using the methods provided by SoSFImage3
.public final SoSFEnum<SoTexture.WrapType> wrapT
public final SoSFEnum<SoTexture.WrapType> wrapR
public final SoSFEnum<SoTexture3.Layouts> layout
Note that if you use a SoTexture3
with a SoShaderProgram
, the layout value affects the type of sampler in GLSL: if the layout value is VOLUME, the sampler type is sampler3D; if the layout value is ARRAY, the sampler type is sampler2DArray.
Generated on July 31, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com