public abstract class Texture extends NodeComponent
Each Texture object has the following properties:
j0 = trunc(v - 0.5)
i1 = i0 + 1
j1 = j0 + 1
a = frac(u - 0.5)
b = frac(v - 0.5)
T' = (1-a)*(1-b)*Ti0j0 + a*(1-b)*Ti1j0 + (1-a)*b*Ti0j1 + a*b*Ti1j1
i1 = trunc(u - 0.5) | i2 = i1 + 1 | i3 = i2 + 1 | i0 = i1 - 1 |
j1 = trunc(v - 0.5) | j3 = j2 + 1 | j2 = j1 + 1 | j0 = j1 - 1 |
a = frac(u - 0.5) | |||
b = frac(v - 0.5) |
T' = f(1+a) * f(1+b) * Ti0j0 +
f(a) * f(1+b) * Ti1j0 +
f(1-a) * f(1+b) * Ti2j0 +
f(2-a) * f(1+b) * Ti3j0 +
f(1+a) * f(b) * Ti0j1 +
f(a) * f(b) * Ti1j1 +
f(1-a) * f(b) * Ti2j1 +
f(2-a) * f(b) * Ti3j1 +
f(1+a) * f(1-b) * Ti0j2 +
f(a) * f(1-b) * Ti1j2 +
f(1-a) * f(1-b) * Ti2j2 +
f(2-a) * f(1-b) * Ti3j2 +
f(1+a) * f(2-b) * Ti0j3 +
f(a) * f(2-b) * Ti1j3 +
f(1-a) * f(2-b) * Ti2j3 +
f(2-a) * f(2-b) * Ti3j3
Note that as of Java 3D 1.5, the texture width and height are no longer required to be an exact power of two. However, not all graphics devices supports non-power-of-two textures. If non-power-of-two texture mapping is unsupported on a particular Canvas3D, textures with a width or height that are not an exact power of two are ignored for that canvas.
Canvas3D.queryProperties()
Modifier and Type | Field and Description |
---|---|
static int |
ALLOW_ANISOTROPIC_FILTER_READ
Specifies that this Texture object allows reading its anistropic
filter information (e.g., anisotropic mode, anisotropic filter)
|
static int |
ALLOW_BOUNDARY_COLOR_READ
Specifies that this Texture object allows reading its
boundary color information.
|
static int |
ALLOW_BOUNDARY_MODE_READ
Specifies that this Texture object allows reading its
boundary mode information.
|
static int |
ALLOW_ENABLE_READ
Specifies that this Texture object allows reading its
enable flag.
|
static int |
ALLOW_ENABLE_WRITE
Specifies that this Texture object allows writing its
enable flag.
|
static int |
ALLOW_FILTER_READ
Specifies that this Texture object allows reading its
filter information.
|
static int |
ALLOW_FILTER4_READ
Specifies that this Texture object allows reading its filter4
function information.
|
static int |
ALLOW_FORMAT_READ
Specifies that this Texture object allows reading its
format information.
|
static int |
ALLOW_IMAGE_READ
Specifies that this Texture object allows reading its
image component information.
|
static int |
ALLOW_IMAGE_WRITE
Specifies that this Texture object allows writing its
image component information.
|
static int |
ALLOW_LOD_RANGE_READ
Specifies that this Texture object allows reading its LOD range
information (e.g., base level, maximum level, minimum lod,
maximum lod, lod offset)
|
static int |
ALLOW_LOD_RANGE_WRITE
Specifies that this Texture object allows writing its LOD range
information (e.g., base level, maximum level, minimum lod,
maximum lod, lod offset)
|
static int |
ALLOW_MIPMAP_MODE_READ
Specifies that this Texture object allows reading its
mipmap mode information.
|
static int |
ALLOW_SHARPEN_TEXTURE_READ
Specifies that this Texture object allows reading its sharpen
texture function information.
|
static int |
ALLOW_SIZE_READ
Specifies that this Texture object allows reading its
size information (e.g., width, height, number of mipmap levels,
boundary width).
|
static int |
ALPHA
Specifies Texture contains only Alpha values.
|
static int |
ANISOTROPIC_NONE
No anisotropic filter.
|
static int |
ANISOTROPIC_SINGLE_VALUE
Uses the degree of anisotropy in both the minification and
magnification filters.
|
static int |
BASE_LEVEL
Indicates that Texture object only has one level.
|
static int |
BASE_LEVEL_LINEAR
Performs bilinear interpolation on the four nearest texels
in level 0 texture map.
|
static int |
BASE_LEVEL_POINT
Select the nearest texel in level 0 texture map.
|
static int |
CLAMP
Clamps texture coordinates to be in the range [0, 1].
|
static int |
CLAMP_TO_BOUNDARY
Clamps texture coordinates such that filtering
will sample only texture boundary texels.
|
static int |
CLAMP_TO_EDGE
Clamps texture coordinates such that filtering
will not sample a texture boundary texel.
|
static int |
FASTEST
Uses the fastest available method for processing geometry.
|
static int |
FILTER4
Applies an application-supplied weight function
on the nearest 4x4 texels in the base level texture image.
|
static int |
INTENSITY
Specifies Texture contains only Intensity values.
|
static int |
LINEAR_SHARPEN
Sharpens the resulting image by extrapolating
from the base level plus one image to the base level image of this
texture object.
|
static int |
LINEAR_SHARPEN_ALPHA
Performs linear sharpen filter for the alpha
component only.
|
static int |
LINEAR_SHARPEN_RGB
Performs linear sharpen filter for the rgb
components only.
|
static int |
LUMINANCE
Specifies Texture contains only luminance values.
|
static int |
LUMINANCE_ALPHA
Specifies Texture contains Luminance and Alpha values.
|
static int |
MULTI_LEVEL_LINEAR
Performs tri-linear interpolation of texels between four
texels each from two nearest mipmap levels.
|
static int |
MULTI_LEVEL_MIPMAP
Indicates that this Texture object has multiple images, one for
each mipmap level.
|
static int |
MULTI_LEVEL_POINT
Selects the nearest texel in the nearest mipmap.
|
static int |
NICEST
Uses the nicest available method for processing geometry.
|
static int |
RGB
Specifies Texture contains Red, Green and Blue color values.
|
static int |
RGBA
Specifies Texture contains Red, Green, Blue color values
and Alpha value.
|
static int |
WRAP
Repeats the texture by wrapping texture coordinates that are outside
the range [0,1].
|
Constructor and Description |
---|
Texture()
Constructs a Texture object with default parameters.
|
Texture(int mipMapMode,
int format,
int width,
int height)
Constructs an empty Texture object with specified mipMapMode,
format, width and height.
|
Texture(int mipMapMode,
int format,
int width,
int height,
int boundaryWidth)
Constructs an empty Texture object with specified mipMapMode,
format, width, height, and boundaryWidth.
|
Modifier and Type | Method and Description |
---|---|
float |
getAnisotropicFilterDegree()
Retrieves the anisotropic filter degree for this texture object.
|
int |
getAnisotropicFilterMode()
Retrieves the anisotropic filter mode for this texture object.
|
int |
getBaseLevel()
Retrieves the base level for this texture object.
|
void |
getBoundaryColor(Color4f boundaryColor)
Retrieves the texture boundary color for this texture object.
|
int |
getBoundaryModeS()
Retrieves the boundary mode for the S coordinate.
|
int |
getBoundaryModeT()
Retrieves the boundary mode for the T coordinate.
|
int |
getBoundaryWidth()
Retrieves the width of the boundary of this Texture object.
|
boolean |
getEnable()
Retrieves the state of the texture enable flag.
|
void |
getFilter4Func(float[] weights)
Copies the array of filter4 function values into the specified
array.
|
int |
getFilter4FuncPointsCount()
Retrieves the number of filter4 function values for this
texture object.
|
int |
getFormat()
Retrieves the format of this Texture object.
|
int |
getHeight()
Retrieves the height of this Texture object.
|
ImageComponent |
getImage(int level)
Retrieves the image for a specified mipmap level.
|
ImageComponent[] |
getImages()
Retrieves the array of images for all mipmap levels.
|
void |
getLodOffset(Tuple3f offset)
Retrieves the LOD offset for this texture object.
|
int |
getMagFilter()
Retrieves the magnification filter.
|
int |
getMaximumLevel()
Retrieves the maximum level for this texture object.
|
float |
getMaximumLOD()
Retrieves the maximum level-of-detail for this texture object.
|
int |
getMinFilter()
Retrieves the minification filter.
|
float |
getMinimumLOD()
Retrieves the minimum level-of-detail for this texture object.
|
int |
getMipMapMode()
Retrieves current mipmap mode.
|
void |
getSharpenTextureFunc(float[] lod,
float[] pts)
Copies the array of sharpen texture LOD function points into the
specified arrays.
|
void |
getSharpenTextureFunc(Point2f[] pts)
Copies the array of sharpen texture LOD function points including
the lod values and the corresponding function values into the
specified array.
|
int |
getSharpenTextureFuncPointsCount()
Gets the number of points in the sharpen texture LOD function for this
texture object.
|
int |
getWidth()
Retrieves the width of this Texture object.
|
int |
numMipMapLevels()
Retrieves the number of mipmap levels needed for this Texture object.
|
void |
setAnisotropicFilterDegree(float degree)
Specifies the degree of anisotropy to be
used when the anisotropic filter mode specifies
ANISOTROPIC_SINGLE_VALUE.
|
void |
setAnisotropicFilterMode(int mode)
Specifies the anisotropic filter mode for this texture object.
|
void |
setBaseLevel(int baseLevel)
Specifies the base level for this texture object.
|
void |
setBoundaryColor(Color4f boundaryColor)
Sets the texture boundary color for this texture object.
|
void |
setBoundaryColor(float r,
float g,
float b,
float a)
Sets the texture boundary color for this texture object.
|
void |
setBoundaryModeS(int boundaryModeS)
Sets the boundary mode for the S coordinate in this texture object.
|
void |
setBoundaryModeT(int boundaryModeT)
Sets the boundary mode for the T coordinate in this texture object.
|
void |
setEnable(boolean state)
Enables or disables texture mapping for this
appearance component object.
|
void |
setFilter4Func(float[] weights)
sets the filter4 function for this texture object.
|
void |
setImage(int level,
ImageComponent image)
Sets the image for a specified mipmap level.
|
void |
setImages(ImageComponent[] images)
Sets the array of images for all mipmap levels.
|
void |
setLodOffset(float s,
float t,
float r)
Specifies the LOD offset for this texture object.
|
void |
setLodOffset(Tuple3f offset)
Specifies the LOD offset for this texture object.
|
void |
setMagFilter(int magFilter)
Sets the magnification filter function.
|
void |
setMaximumLevel(int maximumLevel)
Specifies the maximum level for this texture object.
|
void |
setMaximumLOD(float maximumLod)
Specifies the maximum level-of-detail for this texture object.
|
void |
setMinFilter(int minFilter)
Sets the minification filter function.
|
void |
setMinimumLOD(float minimumLod)
Specifies the minimum level-of-detail for this texture object.
|
void |
setMipMapMode(int mipMapMode)
Sets mipmap mode for texture mapping for this texture object.
|
void |
setSharpenTextureFunc(float[] lod,
float[] pts)
sets the sharpen texture LOD function for this texture object.
|
void |
setSharpenTextureFunc(Point2f[] pts)
sets the sharpen texture LOD function for this texture object.
|
cloneNodeComponent, cloneNodeComponent, duplicateNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTree
clearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferences
public static final int ALLOW_ENABLE_READ
public static final int ALLOW_ENABLE_WRITE
public static final int ALLOW_BOUNDARY_MODE_READ
public static final int ALLOW_FILTER_READ
public static final int ALLOW_IMAGE_READ
public static final int ALLOW_IMAGE_WRITE
public static final int ALLOW_FORMAT_READ
public static final int ALLOW_SIZE_READ
public static final int ALLOW_MIPMAP_MODE_READ
public static final int ALLOW_BOUNDARY_COLOR_READ
public static final int ALLOW_LOD_RANGE_READ
public static final int ALLOW_LOD_RANGE_WRITE
public static final int ALLOW_ANISOTROPIC_FILTER_READ
public static final int ALLOW_SHARPEN_TEXTURE_READ
public static final int ALLOW_FILTER4_READ
public static final int FASTEST
setMinFilter(int)
,
setMagFilter(int)
,
Constant Field Valuespublic static final int NICEST
setMinFilter(int)
,
setMagFilter(int)
,
Constant Field Valuespublic static final int BASE_LEVEL_POINT
setMinFilter(int)
,
setMagFilter(int)
,
Constant Field Valuespublic static final int BASE_LEVEL_LINEAR
setMinFilter(int)
,
setMagFilter(int)
,
Constant Field Valuespublic static final int MULTI_LEVEL_POINT
setMinFilter(int)
,
Constant Field Valuespublic static final int MULTI_LEVEL_LINEAR
setMinFilter(int)
,
Constant Field Valuespublic static final int LINEAR_SHARPEN
setMagFilter(int)
,
Constant Field Valuespublic static final int LINEAR_SHARPEN_RGB
setMagFilter(int)
,
Constant Field Valuespublic static final int LINEAR_SHARPEN_ALPHA
setMagFilter(int)
,
Constant Field Valuespublic static final int FILTER4
setMinFilter(int)
,
setMagFilter(int)
,
Constant Field Valuespublic static final int CLAMP
public static final int WRAP
public static final int CLAMP_TO_EDGE
public static final int CLAMP_TO_BOUNDARY
public static final int BASE_LEVEL
public static final int MULTI_LEVEL_MIPMAP
log2(max(width,height))+1
separate images.public static final int INTENSITY
public static final int LUMINANCE
public static final int ALPHA
public static final int LUMINANCE_ALPHA
public static final int RGB
public static final int RGBA
public static final int ANISOTROPIC_NONE
setAnisotropicFilterMode(int)
,
Constant Field Valuespublic static final int ANISOTROPIC_SINGLE_VALUE
setAnisotropicFilterMode(int)
,
Constant Field Valuespublic Texture()
log2(max(width,height))
Note that the default constructor creates a texture object with a width and height of 0 and is, therefore, not useful.
public Texture(int mipMapMode, int format, int width, int height)
mipMapMode
is set to
BASE_LEVEL
, then the image at level 0 must be set
by the application (using either the setImage
or
setImages
method). If mipMapMode
is
set to MULTI_LEVEL_MIPMAP
, then images for levels
Base Level through Maximum Level must be set.
Note that a texture with a non-power-of-two width or height will
only be rendered on a graphics device that supports non-power-of-two
textures.mipMapMode
- type of mipmap for this Texture: one of
BASE_LEVEL, MULTI_LEVEL_MIPMAPformat
- data format of Textures saved in this object.
One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBAwidth
- width of image at level 0.height
- height of image at level 0.IllegalArgumentException
- if width or height are not greater
than 0, or if an invalid format or mipMapMode is specified.public Texture(int mipMapMode, int format, int width, int height, int boundaryWidth)
mipMapMode
is set to
BASE_LEVEL
, then the image at level 0 must be set
by the application (using either the setImage
or
setImages
method). If mipMapMode
is
set to MULTI_LEVEL_MIPMAP
, then images for levels
Base Level through Maximum Level must be set.
Note that a texture with a non-power-of-two width or height will
only be rendered on a graphics device that supports non-power-of-two
textures.mipMapMode
- type of mipmap for this Texture: one of
BASE_LEVEL, MULTI_LEVEL_MIPMAPformat
- data format of Textures saved in this object.
One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBAwidth
- width of image at level 0. This
does not include the width of the boundary.height
- height of image at level 0. This
does not include the width of the boundary.boundaryWidth
- width of the boundary, which must be 0 or 1.IllegalArgumentException
- if width or height are not greater
than 0, if an invalid format or mipMapMode is specified, or
if the boundaryWidth is < 0 or > 1public void setBoundaryModeS(int boundaryModeS)
boundaryModeS
- the boundary mode for the S coordinate.
One of: CLAMP, WRAP, CLAMP_TO_EDGE, or CLAMP_TO_BOUNDARY.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if boundaryModeS
is a value other than CLAMP
, WRAP
,
CLAMP_TO_EDGE
, or CLAMP_TO_BOUNDARY
.public int getBoundaryModeS()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setBoundaryModeT(int boundaryModeT)
boundaryModeT
- the boundary mode for the T coordinate.
One of: CLAMP, WRAP, CLAMP_TO_EDGE, or CLAMP_TO_BOUNDARY.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if boundaryModeT
is a value other than CLAMP
, WRAP
,
CLAMP_TO_EDGE
, or CLAMP_TO_BOUNDARY
.public int getBoundaryModeT()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setMinFilter(int minFilter)
minFilter
- the minification filter. One of:
FASTEST, NICEST, BASE_LEVEL_POINT, BASE_LEVEL_LINEAR,
MULTI_LEVEL_POINT, MULTI_LEVEL_LINEAR, or FILTER4RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if minFilter
is a value other than FASTEST
, NICEST
,
BASE_LEVEL_POINT
, BASE_LEVEL_LINEAR
,
MULTI_LEVEL_POINT
, MULTI_LEVEL_LINEAR
, or
FILTER4
.Canvas3D.queryProperties()
public int getMinFilter()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setMagFilter(int magFilter)
magFilter
- the magnification filter, one of:
FASTEST, NICEST, BASE_LEVEL_POINT, BASE_LEVEL_LINEAR,
LINEAR_SHARPEN, LINEAR_SHARPEN_RGB, LINEAR_SHARPEN_ALPHA, or FILTER4.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if magFilter
is a value other than FASTEST
, NICEST
,
BASE_LEVEL_POINT
, BASE_LEVEL_LINEAR
,
LINEAR_SHARPEN
, LINEAR_SHARPEN_RGB
,
LINEAR_SHARPEN_ALPHA
, or
FILTER4
.Canvas3D.queryProperties()
public int getMagFilter()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setImage(int level, ImageComponent image)
size[n] = floor(size[n-1]/2)
, exluding
the border.level
- mipmap level to set: 0 is the base levelimage
- ImageComponent object containing the texture image
for the specified mipmap levelCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphIllegalArgumentException
- if an ImageComponent3D is
used in a Texture2D object or if an ImageComponent2D is used in a
Texture3D object.IllegalArgumentException
- if the image being set at this
level is not the correct size for this level.IllegalSharingException
- if this Texture is live and
the specified image is being used by a Canvas3D as an off-screen buffer.IllegalSharingException
- if this Texture is
being used by an immediate mode context and
the specified image is being used by a Canvas3D as an off-screen buffer.public ImageComponent getImage(int level)
level
- mipmap level to get: 0 is the base levelCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setImages(ImageComponent[] images)
images[0]
, must be the same size
in each dimension (width, height, depth) as this
texture, excluding the border, if any.
Each successive mipmap level must be 1/2 the size of the previous level,
such that size[n] = floor(size[n-1]/2)
, exluding
the border.images
- array of ImageComponent objects
containing the texture images for all mipmap levelsCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphIllegalArgumentException
- if an ImageComponent3D is
used in a Texture2D object or if an ImageComponent2D is used in a
Texture3D object.IllegalArgumentException
- if images.length
is
not equal to the total number of mipmap levels.IllegalArgumentException
- if the size of each dimension
of the image at a given level in the
images
array is not the correct size.IllegalSharingException
- if this Texture is live and
any of the specified images are being used by a Canvas3D as an
off-screen buffer.IllegalSharingException
- if this Texture is
being used by an immediate mode context and
any of the specified images are being used by a Canvas3D as an
off-screen buffer.public ImageComponent[] getImages()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic int getFormat()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic int getWidth()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic int getHeight()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic int getBoundaryWidth()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic int numMipMapLevels()
mipMapMode
is
MULTI_LEVEL_MIPMAP
; otherwise it returns 1.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setMipMapMode(int mipMapMode)
mipMapMode
- the new mipmap mode for this object. One of:
BASE_LEVEL or MULTI_LEVEL_MIPMAP.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if mipMapMode
is a value other than BASE_LEVEL
or
MULTI_LEVEL_MIPMAP
.public int getMipMapMode()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setEnable(boolean state)
state
- true or false to enable or disable texture mappingCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic boolean getEnable()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setBoundaryColor(Color4f boundaryColor)
boundaryColor
- the new texture boundary color.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.public void setBoundaryColor(float r, float g, float b, float a)
r
- the red component of the color.g
- the green component of the color.b
- the blue component of the color.a
- the alpha component of the color.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.public void getBoundaryColor(Color4f boundaryColor)
boundaryColor
- the vector that will receive the
current texture boundary color.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setBaseLevel(int baseLevel)
baseLevel
- index of the lowest defined mipmap level.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphIllegalArgumentException
- if specified baseLevel < 0, or
if baseLevel > maximumLevelCanvas3D.queryProperties()
public int getBaseLevel()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setMaximumLevel(int maximumLevel)
maximumLevel
- index of the highest defined mipmap level.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphIllegalArgumentException
- if specified
maximumLevel < baseLevel, or
if maximumLevel > log2(max(width,height))
IllegalArgumentException
- if mipMipMapMode is equal to BASE_LEVEL
and maximumLevel is not equal to zero.Canvas3D.queryProperties()
public int getMaximumLevel()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setMinimumLOD(float minimumLod)
minimumLod
- the minimum level-of-detail.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphIllegalArgumentException
- if specified lod > maximum lodCanvas3D.queryProperties()
public float getMinimumLOD()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setMaximumLOD(float maximumLod)
maximumLod
- the maximum level-of-detail.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphIllegalArgumentException
- if specified lod < minimum lodCanvas3D.queryProperties()
public float getMaximumLOD()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setLodOffset(float s, float t, float r)
s
- the s component of the LOD offsett
- the t component of the LOD offsetr
- the r component of the LOD offsetCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphCanvas3D.queryProperties()
public void setLodOffset(Tuple3f offset)
offset
- the LOD offsetCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphCanvas3D.queryProperties()
public void getLodOffset(Tuple3f offset)
offset
- the vector that will receive the
current LOD offset.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setAnisotropicFilterMode(int mode)
mode
- the anisotropic filter mode. One of
ANISOTROPIC_NONE or ANISOTROPIC_SINGLE_VALUE.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if
mode
is a value other than
ANISOTROPIC_NONE
or ANISOTROPIC_SINGLE_VALUE
Canvas3D.queryProperties()
public int getAnisotropicFilterMode()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setAnisotropicFilterDegree(float degree)
degree
- degree of anisotropyRestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.IllegalArgumentException
- if
degree
< 1.0 or
degree
> the maximum degree of anisotropy.Canvas3D.queryProperties()
public float getAnisotropicFilterDegree()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setSharpenTextureFunc(float[] lod, float[] pts)
lod
- array containing the level-of-detail values.pts
- array containing the function values for the corresponding
level-of-detail values.IllegalStateException
- if the length of lod
does not match the length of pts
RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()
public void setSharpenTextureFunc(Point2f[] pts)
pts
- array of Point2f containing the lod as well as the
corresponding function value.RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()
public int getSharpenTextureFuncPointsCount()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void getSharpenTextureFunc(float[] lod, float[] pts)
lod
- the array to receive the level-of-detail values.pts
- the array to receive the function values for the
corresponding level-of-detail values.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void getSharpenTextureFunc(Point2f[] pts)
pts
- the array to receive the sharpen texture LOD function pointsCapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void setFilter4Func(float[] weights)
weights
- array containing samples of the filter4 function.IllegalArgumentException
- if the length of
weight
< 4RestrictedAccessException
- if the method is called
when this object is part of live or compiled scene graph.Canvas3D.queryProperties()
public int getFilter4FuncPointsCount()
CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphpublic void getFilter4Func(float[] weights)
weights
- the array to receive the function values.CapabilityNotSetException
- if appropriate capability is
not set and this object is part of live or compiled scene graphCopyright © 2016–2022 SciJava. All rights reserved.