| java.lang.Object com.sun.media.jai.rmi.JAIRMICRIF
JAIRMICRIF | public class JAIRMICRIF implements RemoteCRIF(Code) | | An implementation of the RemoteRIF interface for the
"jairmi" remote imaging protocol.
|
Constructor Summary | |
public | JAIRMICRIF() No arg constructor. |
Method Summary | |
public RemoteRenderedImage | create(String serverName, String operationName, ParameterBlock paramBlock, RenderingHints hints) Creates a RemoteRenderedImage representing the results
of an imaging operation (or chain of operations) for a given
ParameterBlock and RenderingHints . | public RemoteRenderedImage | create(PlanarImageServerProxy oldRendering, OperationNode node, PropertyChangeEventJAI event) Creates a RemoteRenderedImage representing the results
of an imaging operation, whose given old rendering is updated
according to the given PropertyChangeEventJAI . | public RemoteRenderedImage | create(String serverName, String operationName, RenderContext renderContext, ParameterBlock paramBlock) Creates a rendering, given a RenderContext and a
ParameterBlock containing the operation's sources
and parameters. | public Rectangle2D | getBounds2D(String serverName, String operationName, ParameterBlock paramBlock) Returns the bounding box for the output of the operation,
performed on a given set of sources, in rendering-independent
space. | public NegotiableCapabilitySet | getClientCapabilities() Returns the set of capabilities supported by the client object. | public Object | getProperty(String serverName, String operationName, ParameterBlock paramBlock, String name) Gets the appropriate instance of the property specified by the name
parameter. | public String[] | getPropertyNames(String serverName, String operationName) Returns a list of names recognized by getProperty. | public boolean | isDynamic(String serverName, String operationName) Returns true if successive renderings (that is, calls to
create(RenderContext, ParameterBlock)) with the same arguments
may produce different results. | public RenderContext | mapRenderContext(String serverName, String operationName, int i, RenderContext renderContext, ParameterBlock paramBlock, RenderableImage image) Maps the operation's output RenderContext into a
RenderContext for each of the operation's sources.
This is useful for operations that can be expressed in whole or in
part simply as alterations in the RenderContext , such as
an affine mapping, or operations that wish to obtain lower quality
renderings of their sources in order to save processing effort or
transmission bandwith. |
JAIRMICRIF | public JAIRMICRIF()(Code) | | No arg constructor.
|
create | public RemoteRenderedImage create(String serverName, String operationName, ParameterBlock paramBlock, RenderingHints hints) throws RemoteImagingException(Code) | | Creates a RemoteRenderedImage representing the results
of an imaging operation (or chain of operations) for a given
ParameterBlock and RenderingHints . The
RemoteRIF may also query any source images
referenced by the ParameterBlock for their dimensions,
SampleModel s, properties, etc., as necessary.
The create() method can return null if the
RemoteRIF (representing the server) is not capable of
producing output for the given set of source images and parameters.
For example, if a server (represented by a RemoteRIF ) is
only capable of performing a 3x3 convolution on single-banded image
data, and the source image has multiple bands or the convolution
Kernel is 5x5, null should be returned.
Hints should be taken into account, but can be ignored.
The created RemoteRenderedImage may have a property
identified by the String HINTS_OBSERVED to indicate which
RenderingHints were used to create the image. In addition
any RenderedImage s that are obtained via the getSources()
method on the created RemoteRenderedImage may have such
a property.
Parameters: serverName - A String specifying the name of theserver to perform the remote operation on. Parameters: operationName - The String specifying the name of theoperation to be performed remotely. Parameters: paramBlock - A ParameterBlock containing sourcesand parameters for theRemoteRenderedImage to be created. Parameters: hints - A RenderingHints object containinghints. A RemoteRenderedImage containing the desiredoutput. |
create | public RemoteRenderedImage create(PlanarImageServerProxy oldRendering, OperationNode node, PropertyChangeEventJAI event) throws RemoteImagingException(Code) | | Creates a RemoteRenderedImage representing the results
of an imaging operation, whose given old rendering is updated
according to the given PropertyChangeEventJAI . This
factory method should be used to create a new rendering updated
according to the changes reported by the given
PropertyChangeEventJAI . The RemoteRIF
can query the supplied PlanarImageServerProxy for
references to the server name, operation name, parameter block,
and rendering hints. The RemoteRIF may also query
any source images referenced by the ParameterBlock
for their dimensions, SampleModel s, properties, etc.,
as necessary.
The create() method can return null if the
RemoteRIF (representing the server) is not capable of
producing output for the given set of source images and parameters.
For example, if a server (represented by a RemoteRIF ) is
only capable of performing a 3x3 convolution on single-banded image
data, and the source image has multiple bands or the convolution
Kernel is 5x5, null should be returned.
Hints should be taken into account, but can be ignored.
The created RemoteRenderedImage may have a property
identified by the String HINTS_OBSERVED to indicate which
RenderingHints were used to create the image. In addition
any RenderedImage s that are obtained via the getSources()
method on the created RemoteRenderedImage may have such
a property.
Parameters: oldRendering - The old rendering of the imaging operation. Parameters: event - An event that specifies the changes made to theimaging operation. A RemoteRenderedImage containing the desiredoutput. |
create | public RemoteRenderedImage create(String serverName, String operationName, RenderContext renderContext, ParameterBlock paramBlock) throws RemoteImagingException(Code) | | Creates a rendering, given a RenderContext and a
ParameterBlock containing the operation's sources
and parameters. The output is a RemoteRenderedImage
that takes the RenderContext into account to
determine its dimensions and placement on the image plane.
This method houses the "intelligence" that allows a
rendering-independent operation to adapt to a specific
RenderContext .
Parameters: serverName - A String specifying the name of theserver to perform the remote operation on. Parameters: operationName - The String specifying the name of theoperation to be performed remotely. Parameters: renderContext - The RenderContext specifying therendering context. Parameters: paramBlock - A ParameterBlock containing theoperation's sources and parameters. |
getBounds2D | public Rectangle2D getBounds2D(String serverName, String operationName, ParameterBlock paramBlock) throws RemoteImagingException(Code) | | Returns the bounding box for the output of the operation,
performed on a given set of sources, in rendering-independent
space. The bounds are returned as a Rectangle2D ,
that is, an axis-aligned rectangle with floating-point corner
coordinates.
Parameters: serverName - A String specifying the name of theserver to perform the remote operation on. Parameters: operationName - The String specifying the name of theoperation to be performed remotely. Parameters: paramBlock - A ParameterBlock containing theoperation's sources and parameters. a Rectangle2D specifying the rendering-independentbounding box of the output. |
getClientCapabilities | public NegotiableCapabilitySet getClientCapabilities()(Code) | | Returns the set of capabilities supported by the client object.
|
getProperty | public Object getProperty(String serverName, String operationName, ParameterBlock paramBlock, String name) throws RemoteImagingException(Code) | | Gets the appropriate instance of the property specified by the name
parameter. This method must determine which instance of a property to
return when there are multiple sources that each specify the property.
Parameters: paramBlock - a ParameterBlock containing the operation'ssources and parameters. Parameters: name - a String naming the desired property. an object reference to the value of the property requested. |
isDynamic | public boolean isDynamic(String serverName, String operationName) throws RemoteImagingException(Code) | | Returns true if successive renderings (that is, calls to
create(RenderContext, ParameterBlock)) with the same arguments
may produce different results. This method may be used to
determine whether an existing rendering may be cached and
reused. It is always safe to return true.
|
mapRenderContext | public RenderContext mapRenderContext(String serverName, String operationName, int i, RenderContext renderContext, ParameterBlock paramBlock, RenderableImage image) throws RemoteImagingException(Code) | | Maps the operation's output RenderContext into a
RenderContext for each of the operation's sources.
This is useful for operations that can be expressed in whole or in
part simply as alterations in the RenderContext , such as
an affine mapping, or operations that wish to obtain lower quality
renderings of their sources in order to save processing effort or
transmission bandwith. Some operations, such as blur, can also
use this mechanism to avoid obtaining sources of higher quality
than necessary.
Parameters: serverName - A String specifying the name of theserver to perform the remote operation on. Parameters: operationName - The String specifying the name of theoperation to be performed remotely. Parameters: i - The index of the source image. Parameters: renderContext - The RenderContext being applied to theoperation. Parameters: paramBlock - A ParameterBlock containing theoperation's sources and parameters. Parameters: image - the RenderableImage being rendered. |
|
|