|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.media.jai.PlanarImage
javax.media.jai.OpImage
javax.media.jai.PointOpImage
javax.media.jai.NullOpImage
public class NullOpImage
A trivial OpImage
subclass that simply transmits its
source unchanged. This may be useful when an interface requires an
OpImage
but another sort of RenderedImage
(such as a BufferedImage
or TiledImage
)
is available. Additionally, NullOpImage
is able to
make use of JAI's tile caching mechanisms.
Methods that get or set properties are implemented to forward
the requests to the source image; no independent property information
is stored in the NullOpImage
itself.
PointOpImage
Field Summary | |
---|---|
protected int |
computeType
|
Fields inherited from class javax.media.jai.OpImage |
---|
cache, cobbleSources, OP_COMPUTE_BOUND, OP_IO_BOUND, OP_NETWORK_BOUND, tileCacheMetric, tileRecycler |
Fields inherited from class javax.media.jai.PlanarImage |
---|
colorModel, eventManager, height, minX, minY, properties, sampleModel, tileFactory, tileGridXOffset, tileGridYOffset, tileHeight, tileWidth, width |
Constructor Summary | |
---|---|
NullOpImage(RenderedImage source,
ImageLayout layout,
Map configuration,
int computeType)
Constructs a NullOpImage . |
|
NullOpImage(RenderedImage source,
TileCache cache,
int computeType,
ImageLayout layout)
Deprecated. as of JAI 1.1. |
Method Summary | |
---|---|
boolean |
computesUniqueTiles()
Returns false as NullOpImage can return via computeTile() tiles that are internally cached. |
Raster |
computeTile(int tileX,
int tileY)
Returns a tile for reading. |
int |
getOperationComputeType()
Returns one of OP_COMPUTE_BOUND, OP_IO_BOUND, or OP_NETWORK_BOUND to indicate how the operation is likely to spend its time. |
protected Hashtable |
getProperties()
Returns the properties from the source image. |
Object |
getProperty(String name)
Retrieves a property from the source image by name or java.awt.Image.UndefinedProperty if the property
with the specified name is not defined. |
Class |
getPropertyClass(String name)
Returns the class of the specified property from the source image. |
String[] |
getPropertyNames()
Returns the property names from the source image or null
if no property names are recognized. |
String[] |
getPropertyNames(String prefix)
Returns the property names with the supplied prefix from the source image or null if no property names
are recognized. |
void |
removeProperty(String name)
Removes a property from the source image by name. |
protected void |
setProperties(Hashtable properties)
Set the properties Hashtable of the source image
to the supplied Hashtable . |
void |
setProperty(String name,
Object value)
Sets a property on the source image by name. |
Methods inherited from class javax.media.jai.PointOpImage |
---|
dispose, isColormapOperation, mapDestRect, mapSourceRect, permitInPlaceOperation |
Methods inherited from class javax.media.jai.OpImage |
---|
addTileToCache, cancelTiles, computeRect, computeRect, createTile, getExpandedNumBands, getFormatTags, getTile, getTileCache, getTileCacheMetric, getTileDependencies, getTileFromCache, getTileRecycler, getTiles, hasExtender, mapDestPoint, mapSourcePoint, prefetchTiles, queueTiles, recycleTile, setTileCache, vectorize, vectorize, vectorize |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected int computeType
Constructor Detail |
---|
public NullOpImage(RenderedImage source, ImageLayout layout, Map configuration, int computeType)
NullOpImage
. The superclass
constructor will be passed a new ImageLayout
object with all of its fields filled in. The ColorModel
may be overridden via the supplied ImageLayout
; all
other layout fields are derived from the source image. Any
specified ColorModel
will be used if and only if it
is compatible with the source image SampleModel
.
layout
- An ImageLayout
optionally specifying
the image ColorModel
; all other fields are
ignored. This parameter may be null
.source
- A RenderedImage
; must not be
null
or a IllegalArgumentException
will be thrown.configuration
- Configurable attributes of the image including
configuration variables indexed by
RenderingHints.Key
s and image properties indexed
by String
s or CaselessStringKey
s.
This is simply forwarded to the superclass constructor.computeType
- A tag indicating whether the source
is OpImage.OP_COMPUTE_BOUND
,
OpImage.OP_IO_BOUND
or
OpImage.OP_NETWORK_BOUND
. This information is
used as a hint to optimize OpImage
computation.
IllegalArgumentException
- if source
is null
.
IllegalArgumentException
- if computeType
is not one of the known OP_*_BOUND
values.public NullOpImage(RenderedImage source, TileCache cache, int computeType, ImageLayout layout)
NullOpImage
. The superclass
constructor will be passed a new ImageLayout
object with all of its fields filled in. The ColorModel
may be overridden via the supplied ImageLayout
; all
other layout fields are derived from the source image. Any
specified ColorModel
will be used if and only if it
is compatible with the source image SampleModel
.
source
- A RenderedImage
; must not be
null
or a IllegalArgumentException
will be thrown.cache
- a TileCache object to store tiles from this OpImage,
or null. If null, a default cache will be used.computeType
- A tag indicating whether the source
is OpImage.OP_COMPUTE_BOUND
,
OpImage.OP_IO_BOUND
or
OpImage.OP_NETWORK_BOUND
. This information is
used as a hint to optimize OpImage
computation.layout
- An ImageLayout
optionally specifying
the image ColorModel
; all other fields are
ignored. This parameter may be null
.
IllegalArgumentException
- if source
is null
.
IllegalArgumentException
- if computeType
is not one of the known OP_*_BOUND
values.Method Detail |
---|
public Raster computeTile(int tileX, int tileY)
computeTile
in class PointOpImage
tileX
- The X index of the tile.tileY
- The Y index of the tile.
Raster
.public boolean computesUniqueTiles()
computesUniqueTiles
in class OpImage
protected Hashtable getProperties()
getProperties
in class PlanarImage
protected void setProperties(Hashtable properties)
Hashtable
of the source image
to the supplied Hashtable
.
setProperties
in class PlanarImage
public String[] getPropertyNames()
null
if no property names are recognized.
getPropertyNames
in interface RenderedImage
getPropertyNames
in interface PropertySource
getPropertyNames
in class PlanarImage
String
s containing valid
property names or null
.public String[] getPropertyNames(String prefix)
null
if no property names
are recognized.
getPropertyNames
in interface PropertySource
getPropertyNames
in class PlanarImage
String
s giving the valid
property names.public Class getPropertyClass(String name)
getPropertyClass
in interface PropertySource
getPropertyClass
in class PlanarImage
name
- the name of the property, as a String
.
Class
expected to be return by a
request for the value of this property or null
.public Object getProperty(String name)
java.awt.Image.UndefinedProperty
if the property
with the specified name is not defined.
getProperty
in interface RenderedImage
getProperty
in interface PropertySource
getProperty
in class PlanarImage
name
- the name of the property to get, as a String
.
Object
, or the value
java.awt.Image.UndefinedProperty
.public void setProperty(String name, Object value)
setProperty
in interface WritablePropertySource
setProperty
in class PlanarImage
name
- a String
containing the property's name.value
- the property, as a general Object
.public void removeProperty(String name)
removeProperty
in interface WritablePropertySource
removeProperty
in class PlanarImage
name
- the name of the property, as a String
.public int getOperationComputeType()
getOperationComputeType
in class OpImage
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |