Package com.openinventor.inventor.image

Class SoDDSImageRW

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.image.SoRasterImageRW

com.openinventor.inventor.image.SoDDSImageRW

public class SoDDSImageRW
extends SoRasterImageRW

Class for decoding a DDS raster image. This class is used for decoding a DDS (DirectDraw Surface) raster image.

DDS files are faster to load and use less memory than other image file formats, because the compressed data is sent directly to the graphics device (no decompression is done on the CPU).

Formats:
This class is able to read DDS files compressed with DXT1 with 1-bit Alpha, DXT3, and DXT5 compression. The other formats which can be contained by a DDS file (e.g. DXT2 and DXT4) are not currently supported.

Mipmaps:
This format can also embed mipmaps (levels of resolution), but all levels (from higher resolution to a 1*1 pixel image) are not necessarily required. The SoComplexity.textureQuality field has no effect on mipmap generation if the DDS file already embeds mipmaps.

NOTE: File encoding and writing is not currently supported.

See SoRasterImageRW for more information and code examples.

See Also:

• SoRasterImageFile
• SoRasterImageRW
• SbRasterImage
• SoComplexity

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.image.SoRasterImageRW

SoRasterImageRW.OpenModes, SoRasterImageRW.ReadCapabilities, SoRasterImageRW.WriteCapabilities

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

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor	Description
SoDDSImageRW()	Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.image.SoRasterImageRW

checkRead, close, enableMultipleWriting, getReadCapability, getWriteCapability, isMultipleBufferInverted, isMultipleWritingEnabled, open, read, read, readRegion, write, write, write, writeFooter, writeHeader

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getNativeResourceHandle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SoDDSImageRW

public SoDDSImageRW()

Constructor.