| java.lang.Object
 javax.media.j3d.IndexedObject
javax.media.j3d.SceneGraphObjectRetained
javax.media.j3d.NodeComponentRetained
javax.media.j3d.TextureRetained
All known Subclasses: javax.media.j3d.TextureCubeMapRetained, javax.media.j3d.Texture3DRetained, javax.media.j3d.Texture2DRetained,
| TextureRetained | | abstract class TextureRetained extends NodeComponentRetained (Code) | | The Texture object is a component object of an Appearance object
that defines the texture properties used when texture mapping is
enabled. Texture object is an abstract class and all texture
objects must be created as either a Texture2D object or a
Texture3D object.
|
| Method Summary | |
| void | addImageUpdateInfo(int level, int face, ImageComponentUpdateInfo arg)
addImageUpdateInfo(int level) is to update a particular level. | | void | bindTexture(Context ctx, int objectId, boolean enable)
| | void | bindTexture(Canvas3D cv)
| | final void | checkImageSize(int level, ImageComponent image)
| | final void | checkSizes(ImageComponentRetained images)
| | void | clearLive(int refCount)
| | synchronized void | createMirrorObject()
| | void | decTextureBinRefCount(TextureBin tb)
| | void | freeTextureId(int id)
| | final float | getAnisotropicFilterDegree()
| | final int | getAnisotropicFilterMode()
| | final int | getBaseLevel()
| | final void | getBoundaryColor(Color4f boundaryColor)
Retrieves the texture boundary color for this texture object. | | final int | getBoundaryModeS()
Retrieves the boundary mode for the S coordinate. | | final int | getBoundaryModeT()
Retrieves the boundary mode for the T coordinate. | | final int | getBoundaryWidth()
Retrieves the boundary width. | | final boolean | getEnable()
Retrieves the state of the texture enable flag. | | final void | getFilter4Func(float[] weights)
| | final float[] | getFilter4Func()
| | final int | getFilter4FuncPointsCount()
| | final int | getFormat()
| | final int | getHeight()
| | final ImageComponent | getImage(int level)
Gets a specified mipmap level. | | final ImageComponent[] | getImages()
| | final void | getLodOffset(Tuple3f offset)
| | final int | getMagFilter()
Retrieves the magnification filter. | | final float | getMaximumLOD()
| | final int | getMaximumLevel()
| | final int | getMinFilter()
Retrieves the minification filter. | | final float | getMinimumLOD()
| | final int | getMipMapMode()
Retrieves current mipmap mode. | | final void | getSharpenTextureFunc(float[] lod, float[] pts)
| | final void | getSharpenTextureFunc(Point2f[] pts)
| | final float[] | getSharpenTextureFunc()
| | final int | getSharpenTextureFuncPointsCount()
| | int | getTextureBinRefCount(TextureBin tb)
| | int | getTextureId()
| | final int | getWidth()
| | void | handleFrequencyChange(int bit)
| | void | incTextureBinRefCount(TextureBin tb)
| | final void | initAnisotropicFilterDegree(float degree)
| | final void | initAnisotropicFilterMode(int mode)
| | final void | initBaseLevel(int level)
| | final void | initBoundaryColor(Color4f boundaryColor)
Sets the texture boundary color for this texture object. | | final void | initBoundaryColor(float r, float g, float b, float a)
Sets the texture boundary color for this texture object. | | final void | initBoundaryModeS(int boundaryModeS)
Sets the boundary mode for the S coordinate in this texture object. | | final void | initBoundaryModeT(int boundaryModeT)
Sets the boundary mode for the T coordinate in this texture object. | | final void | initEnable(boolean state)
Enables or disables texture mapping for this
appearance component object. | | final void | initFilter4Func(float[] weights)
| | void | initImage(int level, ImageComponent image)
Sets a specified mipmap level. | | void | initImages(ImageComponent[] images)
| | final void | initLodOffset(float s, float t, float r)
| | final void | initMagFilter(int magFilter)
Sets the magnification filter function. | | final void | initMaximumLOD(float lod)
| | final void | initMaximumLevel(int level)
| | final void | initMinFilter(int minFilter)
Sets the minification filter function. | | final void | initMinimumLOD(float lod)
| | final void | initMipMapMode(int mipmapMode)
Sets mipmap mode for texture mapping for this texture object. | | synchronized void | initMirrorObject()
| | final void | initSharpenTextureFunc(float[] lod, float[] pts)
| | final void | initSharpenTextureFunc(Point2f[] pts)
| | final void | initSharpenTextureFunc(float[] pts)
| | void | initialize(int format, int width, int widLevels, int height, int heiLevels, int mipmapMode, int boundaryWidth)
| | boolean | isUseAsRaster()
| | void | notifyImageComponentImageChanged(ImageComponentRetained image, ImageComponentUpdateInfo value)
| | final int | numMipMapLevels()
| | void | pruneImageUpdateInfo()
| | void | reloadTexture(Canvas3D cv)
| | void | reloadTextureImage(Canvas3D cv, int face, int level, ImageComponentRetained image, int numLevels)
| | void | reloadTextureSharedContext(Canvas3D cv)
reloadTextureSharedContext is called to reload texture
on a shared context. | | void | reloadTextureSubImage(Canvas3D cv, int face, int level, ImageComponentUpdateInfo info, ImageComponentRetained image)
| | final void | sendMessage(int attrMask, Object attr)
| | final void | setBaseLevel(int level)
| | final void | setEnable(boolean state)
Enables or disables texture mapping for this
appearance component object and sends a
message notifying the interested structures of the change. | | final void | setImage(int level, ImageComponent image)
| | final void | setImages(ImageComponent[] images)
| | void | setLive(boolean backgroundGroup, int refCount)
| | final void | setLodOffset(float s, float t, float r)
| | final void | setMaximumLOD(float lod)
| | final void | setMaximumLevel(int level)
| | final void | setMinimumLOD(float lod)
| | void | setUseAsRaster(boolean useAsRaster)
| | synchronized void | updateMirrorObject(int component, Object value)
| | void | updateNative(Canvas3D cv)
| | void | updateResourceCreationMask()
| | void | updateTexture(Canvas3D cv, int resourceBit)
| | void | updateTextureAnisotropicFilter(Context ctx, float degree)
| | void | updateTextureBoundary(Context ctx, int boundaryModeS, int boundaryModeT, float boundaryRed, float boundaryGreen, float boundaryBlue, float boundaryAlpha)
| | void | updateTextureBoundary(Canvas3D cv)
| | void | updateTextureDimensions(Canvas3D cv)
| | void | updateTextureFields(Canvas3D cv)
| | void | updateTextureFilter4Func(Context ctx, int numFilter4FuncPts, float[] filter4FuncPts)
| | void | updateTextureFilterModes(Context ctx, int minFilter, int magFilter)
| | void | updateTextureImage(Canvas3D cv, int face, int numLevels, int level, int textureFormat, int imageFormat, int width, int height, int boundaryWidth, int imageDataType, Object data)
| | void | updateTextureLOD(Canvas3D cv)
| | void | updateTextureLodOffset(Context ctx, float lodOffsetX, float lodOffsetY, float lodOffsetZ)
| | void | updateTextureLodRange(Context ctx, int baseLevel, int maximumLevel, float minimumLod, float maximumLod)
| | void | updateTextureSharpenFunc(Context ctx, int numSharpenTextureFuncPts, float[] sharpenTextureFuncPts)
| | void | updateTextureSubImage(Canvas3D cv, int face, int level, int xoffset, int yoffset, int textureFormat, int imageFormat, int imgXOffset, int imgYOffset, int tilew, int width, int height, int imageDataType, Object data)
| | boolean | useAutoMipMapGeneration(Canvas3D cv)
| | void | validate()
|
| BASE_LEVEL_CHANGED | | final static int BASE_LEVEL_CHANGED(Code) | | |
| COLOR_CHANGED | | final static int COLOR_CHANGED(Code) | | |
| ENABLE_CHANGED | | final static int ENABLE_CHANGED(Code) | | |
| IMAGES_CHANGED | | final static int IMAGES_CHANGED(Code) | | |
| IMAGE_CHANGED | | final static int IMAGE_CHANGED(Code) | | |
| LOD_OFFSET_CHANGED | | final static int LOD_OFFSET_CHANGED(Code) | | |
| MAG_FILTER | | final static int MAG_FILTER(Code) | | |
| MAX_LEVEL_CHANGED | | final static int MAX_LEVEL_CHANGED(Code) | | |
| MAX_LOD_CHANGED | | final static int MAX_LOD_CHANGED(Code) | | |
| MIN_FILTER | | final static int MIN_FILTER(Code) | | |
| MIN_LOD_CHANGED | | final static int MIN_LOD_CHANGED(Code) | | |
| STATE_CHANGED | | final static int STATE_CHANGED(Code) | | |
| UPDATE_IMAGE | | final static int UPDATE_IMAGE(Code) | | |
| anisotropicFilterDegree | | float anisotropicFilterDegree(Code) | | |
| anisotropicFilterMode | | int anisotropicFilterMode(Code) | | |
| boundaryColor | | Color4f boundaryColor(Code) | | |
| boundaryModeS | | int boundaryModeS(Code) | | |
| boundaryModeT | | int boundaryModeT(Code) | | |
| boundaryWidth | | int boundaryWidth(Code) | | |
| filter4FuncPts | | float filter4FuncPts(Code) | | |
| imageUpdatePruneMask | | int imageUpdatePruneMask(Code) | | |
| isAlphaNeedUpdate | | boolean isAlphaNeedUpdate(Code) | | |
| lodOffset | | Point3f lodOffset(Code) | | |
| maximumLevel | | int maximumLevel(Code) | | |
| maximumLod | | float maximumLod(Code) | | |
| minimumLod | | float minimumLod(Code) | | |
| mipmapMode | | int mipmapMode(Code) | | |
| numSharpenTextureFuncPts | | int numSharpenTextureFuncPts(Code) | | |
| resourceCreationMask | | int resourceCreationMask(Code) | | |
| resourceInReloadList | | int resourceInReloadList(Code) | | |
| resourceLodUpdatedMask | | int resourceLodUpdatedMask(Code) | | |
| resourceUpdatedMask | | int resourceUpdatedMask(Code) | | |
| sharpenTextureFuncPts | | float sharpenTextureFuncPts(Code) | | |
| userSpecifiedEnable | | boolean userSpecifiedEnable(Code) | | |
| addImageUpdateInfo | | void addImageUpdateInfo(int level, int face, ImageComponentUpdateInfo arg)(Code) | | addImageUpdateInfo(int level) is to update a particular level.
In this case, it supercedes all the subImage update for this level,
and all those update info can be removed from the update list.
Note: this method is called from mirror only
|
| bindTexture | | void bindTexture(Context ctx, int objectId, boolean enable)(Code) | | |
| clearLive | | void clearLive(int refCount)(Code) | | |
| createMirrorObject | | synchronized void createMirrorObject()(Code) | | |
| freeTextureId | | void freeTextureId(int id)(Code) | | |
| getAnisotropicFilterDegree | | final float getAnisotropicFilterDegree()(Code) | | |
| getAnisotropicFilterMode | | final int getAnisotropicFilterMode()(Code) | | |
| getBaseLevel | | final int getBaseLevel()(Code) | | |
| getBoundaryColor | | final void getBoundaryColor(Color4f boundaryColor)(Code) | | Retrieves the texture boundary color for this texture object.
Parameters:
boundaryColor - the vector that will receive thecurrent texture boundary color. |
| getBoundaryModeS | | final int getBoundaryModeS()(Code) | | Retrieves the boundary mode for the S coordinate.
the current boundary mode for the S coordinate.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| getBoundaryModeT | | final int getBoundaryModeT()(Code) | | Retrieves the boundary mode for the T coordinate.
the current boundary mode for the T coordinate.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| getBoundaryWidth | | final int getBoundaryWidth()(Code) | | Retrieves the boundary width.
the boundary width of this texture. |
| getEnable | | final boolean getEnable()(Code) | | Retrieves the state of the texture enable flag.
true if texture mapping is enabled,false if texture mapping is disabled |
| getFilter4Func | | final void getFilter4Func(float[] weights)(Code) | | |
| getFilter4Func | | final float[] getFilter4Func()(Code) | | |
| getFilter4FuncPointsCount | | final int getFilter4FuncPointsCount()(Code) | | |
| getFormat | | final int getFormat()(Code) | | |
| getHeight | | final int getHeight()(Code) | | |
| getImage | | final ImageComponent getImage(int level)(Code) | | Gets a specified mipmap level.
Parameters:
level - mipmap level to get: 0 is the base level the pixel array object containing the texture image
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| getLodOffset | | final void getLodOffset(Tuple3f offset)(Code) | | |
| getMagFilter | | final int getMagFilter()(Code) | | Retrieves the magnification filter.
the current magnification filter function.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| getMaximumLOD | | final float getMaximumLOD()(Code) | | |
| getMaximumLevel | | final int getMaximumLevel()(Code) | | |
| getMinFilter | | final int getMinFilter()(Code) | | Retrieves the minification filter.
the current minification filter function.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| getMinimumLOD | | final float getMinimumLOD()(Code) | | |
| getMipMapMode | | final int getMipMapMode()(Code) | | Retrieves current mipmap mode.
current mipmap mode of this texture object.
exception:
RestrictedAccessException - if the method is called |
| getSharpenTextureFunc | | final void getSharpenTextureFunc(float[] lod, float[] pts)(Code) | | Copies the array of sharpen texture LOD function points into the
specified arrays
|
| getSharpenTextureFunc | | final void getSharpenTextureFunc(Point2f[] pts)(Code) | | |
| getSharpenTextureFunc | | final float[] getSharpenTextureFunc()(Code) | | internal method only -- returns internal function points
|
| getSharpenTextureFuncPointsCount | | final int getSharpenTextureFuncPointsCount()(Code) | | Get number of points in the sharpen texture LOD function
|
| getTextureId | | int getTextureId()(Code) | | |
| getWidth | | final int getWidth()(Code) | | |
| handleFrequencyChange | | void handleFrequencyChange(int bit)(Code) | | |
| initAnisotropicFilterDegree | | final void initAnisotropicFilterDegree(float degree)(Code) | | |
| initAnisotropicFilterMode | | final void initAnisotropicFilterMode(int mode)(Code) | | Set Anisotropic Filter
|
| initBaseLevel | | final void initBaseLevel(int level)(Code) | | |
| initBoundaryColor | | final void initBoundaryColor(Color4f boundaryColor)(Code) | | Sets the texture boundary color for this texture object. The
texture boundary color is used when boundaryModeS or boundaryModeT
is set to CLAMP.
Parameters:
boundaryColor - the new texture boundary color. |
| initBoundaryColor | | final void initBoundaryColor(float r, float g, float b, float a)(Code) | | Sets the texture boundary color for this texture object. The
texture boundary color is used when boundaryModeS or boundaryModeT
is set to CLAMP.
Parameters:
r - the red component of the color.
Parameters:
g - the green component of the color.
Parameters:
b - the blue component of the color.
Parameters:
a - the alpha component of the color. |
| initBoundaryModeS | | final void initBoundaryModeS(int boundaryModeS)(Code) | | Sets the boundary mode for the S coordinate in this texture object.
Parameters:
boundaryModeS - the boundary mode for the S coordinate,one of: CLAMP or WRAP.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| initBoundaryModeT | | final void initBoundaryModeT(int boundaryModeT)(Code) | | Sets the boundary mode for the T coordinate in this texture object.
Parameters:
boundaryModeT - the boundary mode for the T coordinate,one of: CLAMP or WRAP.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| initEnable | | final void initEnable(boolean state)(Code) | | Enables or disables texture mapping for this
appearance component object.
Parameters:
state - true or false to enable or disable texture mapping |
| initFilter4Func | | final void initFilter4Func(float[] weights)(Code) | | |
| initImage | | void initImage(int level, ImageComponent image)(Code) | | Sets a specified mipmap level.
Parameters:
level - mipmap level to set: 0 is the base level
Parameters:
image - pixel array object containing the texture image
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph.
exception:
IllegalArgumentException - if an ImageComponent3Dis used in a Texture2D or ImageComponent2D in Texture3Dpower of 2 OR invalid format/mipmapMode is specified. |
| initLodOffset | | final void initLodOffset(float s, float t, float r)(Code) | | |
| initMagFilter | | final void initMagFilter(int magFilter)(Code) | | Sets the magnification filter function. This
function is used when the pixel being rendered maps to an area
less than or equal to one texel.
Parameters:
magFilter - the magnification filter, one of:FASTEST, NICEST, BASE_LEVEL_POINT, or BASE_LEVEL_LINEAR.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| initMaximumLOD | | final void initMaximumLOD(float lod)(Code) | | |
| initMaximumLevel | | final void initMaximumLevel(int level)(Code) | | |
| initMinFilter | | final void initMinFilter(int minFilter)(Code) | | Sets the minification filter function. This
function is used when the pixel being rendered maps to an area
greater than one texel.
Parameters:
minFilter - the minification filter, one of:FASTEST, NICEST, BASE_LEVEL_POINT, BASE_LEVEL_LINEAR, MULTI_LEVEL_POINT, MULTI_LEVEL_LINEAR.
exception:
RestrictedAccessException - if the method is calledwhen this object is part of live or compiled scene graph. |
| initMinimumLOD | | final void initMinimumLOD(float lod)(Code) | | |
| initMipMapMode | | final void initMipMapMode(int mipmapMode)(Code) | | Sets mipmap mode for texture mapping for this texture object.
Parameters:
mipMapMode - the new mipmap mode for this object. One of:BASE_LEVEL or MULTI_LEVEL_MIPMAP.
exception:
RestrictedAccessException - if the method is called |
| initMirrorObject | | synchronized void initMirrorObject()(Code) | | Initializes a mirror object, point the mirror object to the retained
object if the object is not editable
|
| initSharpenTextureFunc | | final void initSharpenTextureFunc(float[] lod, float[] pts)(Code) | | Set Sharpen Texture function
|
| initSharpenTextureFunc | | final void initSharpenTextureFunc(Point2f[] pts)(Code) | | |
| initSharpenTextureFunc | | final void initSharpenTextureFunc(float[] pts)(Code) | | |
| initialize | | void initialize(int format, int width, int widLevels, int height, int heiLevels, int mipmapMode, int boundaryWidth)(Code) | | |
| isUseAsRaster | | boolean isUseAsRaster()(Code) | | |
| numMipMapLevels | | final int numMipMapLevels()(Code) | | |
| pruneImageUpdateInfo | | void pruneImageUpdateInfo()(Code) | | Go through the image update info list
and remove those that are already done
by all the resources
|
| reloadTextureImage | | void reloadTextureImage(Canvas3D cv, int face, int level, ImageComponentRetained image, int numLevels)(Code) | | reloadTextureImage is used to load a particular level of image
This method needs to take care of RenderedImage as well as
BufferedImage
|
| reloadTextureSharedContext | | void reloadTextureSharedContext(Canvas3D cv)(Code) | | reloadTextureSharedContext is called to reload texture
on a shared context. It is invoked from the Renderer
before traversing the RenderBin. The idea is to reload
all necessary textures up front for all shared contexts
in order to minimize the context switching overhead.
|
| sendMessage | | final void sendMessage(int attrMask, Object attr)(Code) | | |
| setBaseLevel | | final void setBaseLevel(int level)(Code) | | |
| setEnable | | final void setEnable(boolean state)(Code) | | Enables or disables texture mapping for this
appearance component object and sends a
message notifying the interested structures of the change.
Parameters:
state - true or false to enable or disable texture mapping |
| setLive | | void setLive(boolean backgroundGroup, int refCount)(Code) | | |
| setLodOffset | | final void setLodOffset(float s, float t, float r)(Code) | | |
| setMaximumLOD | | final void setMaximumLOD(float lod)(Code) | | |
| setMaximumLevel | | final void setMaximumLevel(int level)(Code) | | |
| setMinimumLOD | | final void setMinimumLOD(float lod)(Code) | | |
| setUseAsRaster | | void setUseAsRaster(boolean useAsRaster)(Code) | | |
| updateMirrorObject | | synchronized void updateMirrorObject(int component, Object value)(Code) | | Update the "component" field of the mirror object with the
given "value"
|
| updateNative | | void updateNative(Canvas3D cv)(Code) | | updateNative is called while traversing the RenderBin to
update the texture state
|
| updateResourceCreationMask | | void updateResourceCreationMask()(Code) | | |
| updateTextureAnisotropicFilter | | void updateTextureAnisotropicFilter(Context ctx, float degree)(Code) | | |
| updateTextureBoundary | | void updateTextureBoundary(Context ctx, int boundaryModeS, int boundaryModeT, float boundaryRed, float boundaryGreen, float boundaryBlue, float boundaryAlpha)(Code) | | |
| updateTextureDimensions | | void updateTextureDimensions(Canvas3D cv)(Code) | | load level 0 explicitly with null pointer to enable
mipmapping when level 0 is not the base level
|
| updateTextureFilter4Func | | void updateTextureFilter4Func(Context ctx, int numFilter4FuncPts, float[] filter4FuncPts)(Code) | | |
| updateTextureFilterModes | | void updateTextureFilterModes(Context ctx, int minFilter, int magFilter)(Code) | | |
| updateTextureImage | | void updateTextureImage(Canvas3D cv, int face, int numLevels, int level, int textureFormat, int imageFormat, int width, int height, int boundaryWidth, int imageDataType, Object data)(Code) | | |
| updateTextureLodOffset | | void updateTextureLodOffset(Context ctx, float lodOffsetX, float lodOffsetY, float lodOffsetZ)(Code) | | |
| updateTextureLodRange | | void updateTextureLodRange(Context ctx, int baseLevel, int maximumLevel, float minimumLod, float maximumLod)(Code) | | |
| updateTextureSharpenFunc | | void updateTextureSharpenFunc(Context ctx, int numSharpenTextureFuncPts, float[] sharpenTextureFuncPts)(Code) | | |
| updateTextureSubImage | | void updateTextureSubImage(Canvas3D cv, int face, int level, int xoffset, int yoffset, int textureFormat, int imageFormat, int imgXOffset, int imgYOffset, int tilew, int width, int height, int imageDataType, Object data)(Code) | | |
| useAutoMipMapGeneration | | boolean useAutoMipMapGeneration(Canvas3D cv)(Code) | | |
| validate | | void validate()(Code) | | |
| Fields inherited from javax.media.j3d.IndexedObject | int[][] listIdx(Code)(Java Doc)
|
|
|