|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.media.jai.registry.RIFRegistry
Utility class to provide type-safe interaction with the
OperationRegistry
for RenderedImageFactory
objects.
If the OperationRegistry
is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.
Constructor Summary | |
RIFRegistry()
|
Method Summary | |
static void |
clearPreferences(OperationRegistry registry,
String operationName,
String productName)
Removes all preferences between RIFs within a product registered under a particular OperationDescriptor . |
static RenderedImage |
create(OperationRegistry registry,
String operationName,
ParameterBlock paramBlock,
RenderingHints renderHints)
Constructs a RenderedImage (usually a
RenderedOp ) representing the results of applying
a given operation to a particular ParameterBlock and rendering
hints. |
static RenderedImageFactory |
get(OperationRegistry registry,
String operationName)
Returns the the most preferred RenderedImageFactory
object registered against the operation name. |
static Iterator |
getIterator(OperationRegistry registry,
String operationName)
Returns an Iterator over all
RenderedImageFactory objects registered under the
operation name over all products. |
static List |
getOrderedList(OperationRegistry registry,
String operationName,
String productName)
Returns a list of the RIFs of a product registered under a particular OperationDescriptor , in an ordering
that satisfies all of the pairwise preferences that have
been set. |
static PropertySource |
getPropertySource(RenderedOp op)
Constructs and returns a PropertySource suitable for
use by a given RenderedOp . |
static void |
register(OperationRegistry registry,
String operationName,
String productName,
RenderedImageFactory rif)
Register a RIF with a particular product and operation against a specified mode. |
static void |
setPreference(OperationRegistry registry,
String operationName,
String productName,
RenderedImageFactory preferredRIF,
RenderedImageFactory otherRIF)
Sets a preference between two rifs for a given operation under a specified product. |
static void |
unregister(OperationRegistry registry,
String operationName,
String productName,
RenderedImageFactory rif)
Unregister a RIF previously registered with a product and operation against the specified mode. |
static void |
unsetPreference(OperationRegistry registry,
String operationName,
String productName,
RenderedImageFactory preferredRIF,
RenderedImageFactory otherRIF)
Unsets a preference between two rifs for a given operation under a specified product. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public RIFRegistry()
Method Detail |
public static void register(OperationRegistry registry, String operationName, String productName, RenderedImageFactory rif)
registry.registerRIF(...)
registry
- the OperationRegistry
to register with.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
productName
- the product name as a String
rif
- the RenderedImageFactory
to be registeredIllegalArgumentException
- if operationName, productName,
or rif is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
public static void unregister(OperationRegistry registry, String operationName, String productName, RenderedImageFactory rif)
registry
- the OperationRegistry
to unregister from.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
productName
- the product name as a String
rif
- the RenderedImageFactory
to be unregisteredIllegalArgumentException
- if operationName, productName,
or rif is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
IllegalArgumentException
- if the rif was not previously
registered against operationName and productNamepublic static void setPreference(OperationRegistry registry, String operationName, String productName, RenderedImageFactory preferredRIF, RenderedImageFactory otherRIF)
registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
productName
- the product name as a String
preferredRIF
- the preferred rifotherRIF
- the other rifIllegalArgumentException
- if operationName, productName,
preferredRIF or otherRIF is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
IllegalArgumentException
- if either of the rifs
were not previously registered against
operationName and productNamepublic static void unsetPreference(OperationRegistry registry, String operationName, String productName, RenderedImageFactory preferredRIF, RenderedImageFactory otherRIF)
registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
productName
- the product name as a String
preferredRIF
- the factory object formerly preferredotherRIF
- the other factory objectIllegalArgumentException
- if operationName, productName,
preferredRIF or otherRIF is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
IllegalArgumentException
- if either of the rifs
were not previously registered against
operationName and productNamepublic static void clearPreferences(OperationRegistry registry, String operationName, String productName)
OperationDescriptor
.registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
productName
- the product name as a String
IllegalArgumentException
- if operationName or productName
is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
public static List getOrderedList(OperationRegistry registry, String operationName, String productName)
OperationDescriptor
, in an ordering
that satisfies all of the pairwise preferences that have
been set. Returns null
if cycles exist. Returns
null
, if the product does not exist under this
operationName.registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
productName
- the product name as a String
List
of RIFsIllegalArgumentException
- if operationName or productName
is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
public static Iterator getIterator(OperationRegistry registry, String operationName)
Iterator
over all
RenderedImageFactory
objects registered under the
operation name over all products. The order of objects in
the iteration will be according to the pairwise preferences
among products and image factories within a product. The
remove()
method of the Iterator
may not be implemented.registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
Iterator
over RenderedImageFactory
objectsIllegalArgumentException
- if operationName is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
public static RenderedImageFactory get(OperationRegistry registry, String operationName)
RenderedImageFactory
object registered against the operation name. This
method will return the first object that would be
encountered by the Iterator
returned by the
getIterator()
method.registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
RenderedImageFactory
objectIllegalArgumentException
- if operationName is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
public static RenderedImage create(OperationRegistry registry, String operationName, ParameterBlock paramBlock, RenderingHints renderHints)
RenderedImage
(usually a
RenderedOp
) representing the results of applying
a given operation to a particular ParameterBlock and rendering
hints. The registry is used to determine the RIF to be used to
instantiate the operation.
If none of the RIFs registered with this
OperationRegistry
returns a non-null value, null is
returned. Exceptions thrown by the RIFs will be caught by this
method and will not be propagated.
registry
- the OperationRegistry
to use.
if this is null
, then
JAI.getDefaultInstance().getOperationRegistry()
will be used.operationName
- the operation name as a String
paramBlock
- the operation's ParameterBlock.renderHints
- a RenderingHints
object
containing rendering hints.IllegalArgumentException
- if operationName is null
IllegalArgumentException
- if there is no
OperationDescriptor
registered against
the operationName
public static PropertySource getPropertySource(RenderedOp op)
PropertySource
suitable for
use by a given RenderedOp
. The
PropertySource
includes properties copied from prior
nodes as well as those generated at the node itself. Additionally,
property suppression is taken into account. The actual
implementation of getPropertySource()
may make use
of deferred execution and caching.op
- the RenderedOp
requesting its
PropertySource
.IllegalArgumentException
- if op
is null
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |