j3d.org Aviatrix3D

org.j3d.aviatrix3d
Class ByteTextureComponent2D

java.lang.Object
  extended byorg.j3d.aviatrix3d.SceneGraphObject
      extended byorg.j3d.aviatrix3d.NodeComponent
          extended byorg.j3d.aviatrix3d.TextureComponent
              extended byorg.j3d.aviatrix3d.TextureComponent2D
                  extended byorg.j3d.aviatrix3d.ByteTextureComponent2D

public class ByteTextureComponent2D
extends TextureComponent2D

A Texture component that uses raw byte data to be interpreted by the format IDs passed in.

Version:
$Revision: 1.4 $
Author:
Alan Hudson

Field Summary
 
Fields inherited from class org.j3d.aviatrix3d.TextureComponent2D
height
 
Fields inherited from class org.j3d.aviatrix3d.TextureComponent
data, format, FORMAT_BGR, FORMAT_BGRA, FORMAT_INTENSITY_ALPHA, FORMAT_RGB, FORMAT_RGBA, FORMAT_SINGLE_COMPONENT, invertY, numLevels, size, type, TYPE_BYTE, TYPE_INT, width
 
Fields inherited from class org.j3d.aviatrix3d.NodeComponent
liveCount
 
Fields inherited from class org.j3d.aviatrix3d.SceneGraphObject
alive, updateHandler, WRITE_TIMING_MSG
 
Constructor Summary
ByteTextureComponent2D()
          Constructs an image with default values.
ByteTextureComponent2D(boolean yUp)
          Constructs an image with default values.
ByteTextureComponent2D(int format, int width, int height, byte[] srcPixels)
          Constructs an Image2D using the specified format, width, height and rendered image.
ByteTextureComponent2D(int format, int width, int height, byte[][] srcPixels, int numLevels)
          Constructs an Image2D using the specified format, width, height and rendered image.
ByteTextureComponent2D(int format, int width, int height, byte[] srcPixels, boolean yUp)
          Constructs an Image2D using the specified format, width, height and rendered image.
 
Method Summary
protected  java.nio.ByteBuffer convertImage(int level)
          Convenience method to convert a buffered image into a NIO array of the corresponding type.
 void updateSubImage(int srcX, int srcY, int destX, int destY, int widht, int height, int lvl, byte[] img)
          Update a sub-section of the image data with the new pixel values.
 
Methods inherited from class org.j3d.aviatrix3d.TextureComponent2D
getHeight
 
Methods inherited from class org.j3d.aviatrix3d.TextureComponent
clearData, getData, getFormat, getNumLevels, getWidth, isYUp
 
Methods inherited from class org.j3d.aviatrix3d.NodeComponent
addParent, getParents, hasChanged, numParents, removeParent, renderState, restoreState
 
Methods inherited from class org.j3d.aviatrix3d.SceneGraphObject
checkForCyclicChild, checkForCyclicParent, dataChanged, getUserData, isLive, setLive, setUpdateHandler, setUserData
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ByteTextureComponent2D

public ByteTextureComponent2D()
Constructs an image with default values.


ByteTextureComponent2D

public ByteTextureComponent2D(boolean yUp)
Constructs an image with default values.

Parameters:
yUp - Change the image aroud the Y axis if needed

ByteTextureComponent2D

public ByteTextureComponent2D(int format,
                              int width,
                              int height,
                              byte[] srcPixels)
Constructs an Image2D using the specified format, width, height and rendered image. If the srcImage[0] is an instance of BufferedImage, the format passed is ignored and the image directly used.

Parameters:
format - The image format. RGB, RGBA currently
width - The width of the image
height - The height of the image
srcPixels - The image data

ByteTextureComponent2D

public ByteTextureComponent2D(int format,
                              int width,
                              int height,
                              byte[][] srcPixels,
                              int numLevels)
Constructs an Image2D using the specified format, width, height and rendered image. If the srcImage[0] is an instance of BufferedImage, the format passed is ignored and the image directly used.

Parameters:
format - The image format. RGB, RGBA currently
width - The width of the image
height - The height of the image
srcPixels - The image data
numLevels - The number of mip-map levels to generate

ByteTextureComponent2D

public ByteTextureComponent2D(int format,
                              int width,
                              int height,
                              byte[] srcPixels,
                              boolean yUp)
Constructs an Image2D using the specified format, width, height and rendered image. If the srcImage[0] is an instance of BufferedImage, the format passed is ignored and the image directly used.

Parameters:
format - The image format. RGB, RGBA currently
width - The width of the image
height - The height of the image
yUp - Change the image aroud the Y axis if needed
Method Detail

updateSubImage

public void updateSubImage(int srcX,
                           int srcY,
                           int destX,
                           int destY,
                           int widht,
                           int height,
                           int lvl,
                           byte[] img)
                    throws InvalidWriteTimingException
Update a sub-section of the image data with the new pixel values. Not implemented yet.

Parameters:
srcX - The starting X offset in the existing image space
srcY - The starting Y offset in the existing image space
destX - The starting X offset in the existing image space
destY - The starting Y offset in the existing image space
height - The height of the section to replace
img - The image to take data from
Throws:
InvalidWriteTimingException - An attempt was made to write outside of the NodeUpdateListener callback method

convertImage

protected java.nio.ByteBuffer convertImage(int level)
Convenience method to convert a buffered image into a NIO array of the corresponding type. Images typically need to be swapped when doing this by the Y axis is in the opposite direction to the one used by OpenGL.

Specified by:
convertImage in class TextureComponent
Parameters:
level - Which image level needs to be converted
Returns:
an appropriate array type - either IntBuffer or ByteBuffer

j3d.org Aviatrix3D

Latest Info from http://aviatrix3d.j3d.org/
Copyright © 2003 - j3d.org