com.openinventor.inventor.image

Class SbRasterImage

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.image.SbRasterImage

public class SbRasterImage
extends Inventor

Class encapsulating a raster image and its attributes. This class encapsulates a raster image, including its size and number of color components.

See also:

SoRasterImageRW

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SbRasterImage.Components Components type.
static class	SbRasterImage.CopyPolicies Copy policy.

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	COPY Deprecated. Use SbRasterImage.CopyPolicies.COPY instead.
static int	LUMINANCE Deprecated. Use SbRasterImage.Components.LUMINANCE instead.
static int	LUMINANCE_TRANSPARENCY Deprecated. Use SbRasterImage.Components.LUMINANCE_TRANSPARENCY instead.
static int	NO_COPY Deprecated. Use SbRasterImage.CopyPolicies.NO_COPY instead.
static int	RGB Deprecated. Use SbRasterImage.Components.RGB instead.
static int	RGB_TRANSPARENCY Deprecated. Use SbRasterImage.Components.RGB_TRANSPARENCY instead.
static int	RGBE Deprecated. Use SbRasterImage.Components.RGBE instead.
static int	UNKNOWN Deprecated. Use SbRasterImage.Components.UNKNOWN instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SbRasterImage() Constructor that creates an empty image.
SbRasterImage(SbVec2i32 size, SbRasterImage.Components components, byte[] bytes) Deprecated. As of Open Inventor 9400 See documentation for more details
SbRasterImage(SbVec2i32 size, SbRasterImage.Components components, SoBufferObject bufferObject) Constructor that initializes with an image.
SbRasterImage(SbVec2s size, SbRasterImage.Components components, byte[] bytes) Deprecated. As of Open Inventor 9400 See documentation for more details

Method Summary

Modifier and Type	Method and Description
byte[]	getBuffer() Deprecated. As of Open Inventor 9400 See documentation for more details
SoBufferObject	getBufferObject() Returns the pixel buffer of the raster image.
SbRasterImage.Components	getComponents() Returns the number of components of each pixel as an enum.
int	getComponentsCount() Returns the number of components of each pixel.
int	getComponentsSize() Returns the size in bytes of each pixel in the image.
SbRasterImage.CopyPolicies	getCopyPolicy() Returns the current buffer copy policy.
int	getNumMipmaps() Returns the number of mipmaps contained by the buffer.
SbVec2s	getSize() Returns the raster image size in pixels.
SbVec2i32	getSizei32() Returns the raster image size in pixels for large images.
boolean	removeAlphaChannel() Removes the Alpha channel from the current raster image.
void	setBuffer(SoBufferObject bufferObject) Sets the pixel buffer of the raster image.
void	setComponents(SbRasterImage.Components comp) Sets the number of components in each pixel of the raster image.
void	setSize(SbVec2s size) Sets the raster image size in pixels.
void	setSizei32(SbVec2i32 size) Sets the raster image size in pixels.

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

UNKNOWN

@Deprecated
public static final int UNKNOWN

Deprecated. Use SbRasterImage.Components.UNKNOWN instead.

LUMINANCE

@Deprecated
public static final int LUMINANCE

Deprecated. Use SbRasterImage.Components.LUMINANCE instead.

LUMINANCE_TRANSPARENCY

@Deprecated
public static final int LUMINANCE_TRANSPARENCY

Deprecated. Use SbRasterImage.Components.LUMINANCE_TRANSPARENCY instead.

RGB

@Deprecated
public static final int RGB

Deprecated. Use SbRasterImage.Components.RGB instead.

RGB_TRANSPARENCY

@Deprecated
public static final int RGB_TRANSPARENCY

Deprecated. Use SbRasterImage.Components.RGB_TRANSPARENCY instead.

RGBE

@Deprecated
public static final int RGBE

Deprecated. Use SbRasterImage.Components.RGBE instead.

COPY

@Deprecated
public static final int COPY

Deprecated. Use SbRasterImage.CopyPolicies.COPY instead.

NO_COPY

@Deprecated
public static final int NO_COPY

Deprecated. Use SbRasterImage.CopyPolicies.NO_COPY instead.

Constructor Detail

SbRasterImage

public SbRasterImage()

Constructor that creates an empty image.

SbRasterImage

public SbRasterImage(SbVec2i32 size,
                     SbRasterImage.Components components,
                     SoBufferObject bufferObject)

Constructor that initializes with an image. Image data is assumed to be packed (no padding between pixels or rows) and pixel components are assumed to be in RGBA order.

SbRasterImage

@Deprecated
public SbRasterImage(SbVec2s size,
                                  SbRasterImage.Components components,
                                  byte[] bytes)

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

Constructor that initializes with an image. Deprecated since Open Inventor 9400
Use SbRasterImage constructor with SoBufferObject instead.

SbRasterImage

@Deprecated
public SbRasterImage(SbVec2i32 size,
                                  SbRasterImage.Components components,
                                  byte[] bytes)

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

Constructor that initializes with a large image. Deprecated since Open Inventor 9400
Use SbRasterImage constructor with SoBufferObject instead.

Method Detail

getNumMipmaps

public int getNumMipmaps()

Returns the number of mipmaps contained by the buffer.

setSizei32

public void setSizei32(SbVec2i32 size)

Sets the raster image size in pixels.
The parameter is the size of the whole raster image to be saved. Use for sizes with at least one side greater than 32767.

setSize

public void setSize(SbVec2s size)

Sets the raster image size in pixels.
The parameter is the size of the whole raster image. The maximum size that can be specified using this method is 32767 by 32767 (because the parameter is an SbVec2s). To specify a larger image size use the method setSize_i32.

getCopyPolicy

public SbRasterImage.CopyPolicies getCopyPolicy()

Returns the current buffer copy policy.

getComponentsSize

public int getComponentsSize()

Returns the size in bytes of each pixel in the image.
Returns -1 in case of invalid or unknown components type.

E.g: For an RGB image containing byte data, the pixel size is 3 bytes.

removeAlphaChannel

public boolean removeAlphaChannel()

Removes the Alpha channel from the current raster image. If the copy policy is COPY (Open Inventor owns the memory) then the buffer is reallocated with the correct size. Otherwise the content of the buffer is just modified.

Returns:

True if the format contains an alpha channel and it was possible to remove it.

getBufferObject

public SoBufferObject getBufferObject()

Returns the pixel buffer of the raster image.

setBuffer

public void setBuffer(SoBufferObject bufferObject)

Sets the pixel buffer of the raster image.
Image data is assumed to be packed (no padding between pixels or rows) and pixel components are assumed to be in RGBA order.

getComponentsCount

public int getComponentsCount()

Returns the number of components of each pixel.
Returns -1 in case of invalid or unknown components type.

E.g: For an RGB image it returns 3 (R, G and B).

getComponents

public SbRasterImage.Components getComponents()

Returns the number of components of each pixel as an enum.
For example, an RGBA image returns RGB_TRANSPARENCY.

getSizei32

public SbVec2i32 getSizei32()

Returns the raster image size in pixels for large images.

getBuffer

@Deprecated
public byte[] getBuffer()

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

Returns the pixel buffer of the raster image. Deprecated since Open Inventor 9400
Use SbRasterImage.getBufferObject() instead.

getSize

public SbVec2s getSize()

Returns the raster image size in pixels.

setComponents

public void setComponents(SbRasterImage.Components comp)

Sets the number of components in each pixel of the raster image.
For example, an RGB image has 3 components.