| java.lang.Object
 javax.media.jai.registry.RIFRegistry
| RIFRegistry | | final public class RIFRegistry (Code) | | 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.
since:
JAI 1.1 |
| Method Summary | |
| public static void | clearPreferences(OperationRegistry registry, String operationName, String productName)
Removes all preferences between RIFs within a product registered
under a particular OperationDescriptor. | | public 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. | | public static RenderedImageFactory | get(OperationRegistry registry, String operationName)
Returns the the most preferred RenderedImageFactory
object registered against the operation name. | | public static Iterator | getIterator(OperationRegistry registry, String operationName)
Returns an Iterator over all
RenderedImageFactory objects registered under the
operation name over all products. | | public 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. | | public static PropertySource | getPropertySource(RenderedOp op)
Constructs and returns a PropertySource suitable for
use by a given RenderedOp. | | public static void | register(OperationRegistry registry, String operationName, String productName, RenderedImageFactory rif)
Register a RIF with a particular product and operation
against a specified mode. | | public 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. | | public 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. | | public 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. |
| clearPreferences | | public static void clearPreferences(OperationRegistry registry, String operationName, String productName)(Code) | | Removes all preferences between RIFs within a product registered
under a particular OperationDescriptor.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
productName - the product name as a String
throws:
IllegalArgumentException - if operationName or productNameis null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName |
| create | | public static RenderedImage create(OperationRegistry registry, String operationName, ParameterBlock paramBlock, RenderingHints renderHints)(Code) | | Constructs a 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.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
paramBlock - the operation's ParameterBlock.
Parameters:
renderHints - a RenderingHints objectcontaining rendering hints.
throws:
IllegalArgumentException - if operationName is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName |
| get | | public static RenderedImageFactory get(OperationRegistry registry, String operationName)(Code) | | Returns the the most preferred 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.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String a registered RenderedImageFactory object
throws:
IllegalArgumentException - if operationName is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName |
| getIterator | | public static Iterator getIterator(OperationRegistry registry, String operationName)(Code) | | Returns an 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.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String an Iterator over RenderedImageFactory objects
throws:
IllegalArgumentException - if operationName is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName
since:
JAI 1.1 |
| getOrderedList | | public static List getOrderedList(OperationRegistry registry, String operationName, String productName)(Code) | | 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. Returns null if cycles exist. Returns
null, if the product does not exist under this
operationName.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
productName - the product name as a String an ordered List of RIFs
throws:
IllegalArgumentException - if operationName or productNameis null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName |
| getPropertySource | | public static PropertySource getPropertySource(RenderedOp op)(Code) | | Constructs and returns a 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.
Parameters:
op - the RenderedOp requesting its PropertySource.
throws:
IllegalArgumentException - if op is null |
| register | | public static void register(OperationRegistry registry, String operationName, String productName, RenderedImageFactory rif)(Code) | | Register a RIF with a particular product and operation
against a specified mode. This is JAI 1.0.x equivalent
of registry.registerRIF(...)
Parameters:
registry - the OperationRegistry to register with.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
productName - the product name as a String
Parameters:
rif - the RenderedImageFactory to be registered
throws:
IllegalArgumentException - if operationName, productName,or rif is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName |
| setPreference | | public static void setPreference(OperationRegistry registry, String operationName, String productName, RenderedImageFactory preferredRIF, RenderedImageFactory otherRIF)(Code) | | Sets a preference between two rifs for a given operation under a
specified product.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
productName - the product name as a String
Parameters:
preferredRIF - the preferred rif
Parameters:
otherRIF - the other rif
throws:
IllegalArgumentException - if operationName, productName,preferredRIF or otherRIF is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName
throws:
IllegalArgumentException - if either of the rifswere not previously registered againstoperationName and productName |
| unregister | | public static void unregister(OperationRegistry registry, String operationName, String productName, RenderedImageFactory rif)(Code) | | Unregister a RIF previously registered with a product
and operation against the specified mode.
Parameters:
registry - the OperationRegistry to unregister from.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
productName - the product name as a String
Parameters:
rif - the RenderedImageFactory to be unregistered
throws:
IllegalArgumentException - if operationName, productName,or rif is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName
throws:
IllegalArgumentException - if the rif was not previouslyregistered against operationName and productName |
| unsetPreference | | public static void unsetPreference(OperationRegistry registry, String operationName, String productName, RenderedImageFactory preferredRIF, RenderedImageFactory otherRIF)(Code) | | Unsets a preference between two rifs for a given operation under
a specified product.
Parameters:
registry - the OperationRegistry to use.if this is null, then JAI.getDefaultInstance().getOperationRegistry()will be used.
Parameters:
operationName - the operation name as a String
Parameters:
productName - the product name as a String
Parameters:
preferredRIF - the factory object formerly preferred
Parameters:
otherRIF - the other factory object
throws:
IllegalArgumentException - if operationName, productName,preferredRIF or otherRIF is null
throws:
IllegalArgumentException - if there is no OperationDescriptor registered againstthe operationName
throws:
IllegalArgumentException - if either of the rifswere not previously registered againstoperationName and productName |
|
|