| java.lang.Object
 javax.media.jai.OperationDescriptorImpl
javax.media.jai.operator.IIPResolutionDescriptor
| IIPResolutionDescriptor | | public class IIPResolutionDescriptor extends OperationDescriptorImpl (Code) | | An OperationDescriptor describing the "IIPResolution"
operation.
This operation provides client-side support of the Internet Imaging
Protocol (IIP) in the rendered mode. It is resolution-specific. It
requests from the IIP server an image at a particular resolution level,
and creates a java.awt.image.RenderedImage based on the
data received from the server. Once the RenderedImage
is created, the resolution level cannot be changed.
The layout of the created RenderedImage is set as
follows:
-
minX, minY, tileGridXOffset,
and tileGridYOffset are set to 0;
-
width and height are determined based
on the specified resolution level;
-
tileWidth and tileHeight are set to 64;
-
sampleModel is of the type
java.awt.image.PixelInterleavedSampleModel with byte
data type and the appropriate number of bands;
-
colorModel is of the type
java.awt.image.ComponentColorModel, with the
ColorSpace set to sRGB, PhotoYCC, or Grayscale, depending
on the color space of the remote image; if an alpha channel is
present, it will be premultiplied.
The "URL" parameter specifies the URL of the IIP image as a
java.lang.String. It must represent a valid URL, and
include any required FIF or SDS commands. It cannot be null.
The "resolution" parameter specifies the resolution level of the
requested IIP image from the server. The lowest resolution level is
0, with larger integers representing higher resolution levels. If the
requested resolution level does not exist, the nearest resolution level
is used. If this parameter is not specified, it is set to the default
value IIPResolutionDescriptor.MAX_RESOLUTION which indicates
the highest resolution level.
The "subImage" parameter indicates the sub-image to be used by the
server to get the image at the specified resolution level. This parameter
cannot be negative. If this parameter is not specified, it is set to
the default value 0.
There is no source image associated with this operation.
If available from the IIP server certain properties may be set on the
RenderedImage. The names of properties and the class types
of their associated values are listed in the following table.
Property List
| Property Name | Property Value Class Type |
|---|
| affine-transform | java.awt.geom.AffineTransform |
| app-name | java.lang.String |
| aspect-ratio | java.lang.Float |
| author | java.lang.String |
| colorspace | int[] |
| color-twist | float[16] |
| comment | java.lang.String |
| contrast-adjust | java.lang.Float |
| copyright | java.lang.String |
| create-dtm | java.lang.String |
| edit-time | java.lang.String |
| filtering-value | java.lang.Float |
| iip | java.lang.String |
| iip-server | java.lang.String |
| keywords | java.lang.String |
| last-author | java.lang.String |
| last-printed | java.lang.String |
| last-save-dtm | java.lang.String |
| max-size | int[2] |
| resolution-number | java.lang.Integer |
| rev-number | java.lang.String |
| roi-iip | java.awt.geom.Rectangle2D.Float |
| subject | java.lang.String |
| title | java.lang.String |
For information on the significance of each of the above properties please
refer to the IIP specification.
Resource List
| Name | Value |
|---|
| GlobalName | IIPResolution |
| LocalName | IIPResolution |
| Vendor | com.sun.media.jai |
| Description | Provides client-side support of the Internet
Imaging Protocol in the rendered mode. |
| DocURL | http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/operator/IIPResolutionDescriptor.html |
| Version | 1.0 |
| arg0Desc | The URL of the IIP image. |
| arg1Desc | The resolution level to request. |
| arg2Desc | The sub-image to be used by the
server. |
Parameter List
| Name | Class Type |
Default Value |
|---|
| URL | java.lang.String |
NO_PARAMETER_DEFAULT |
| resolution | java.lang.Integer |
IIPResolutionDescriptor.MAX_RESOLUTION |
| subImage | java.lang.Integer |
0 |
See Also: Digital Imaging Group
See Also: java.awt.image.RenderedImage
See Also: IIPDescriptor |
| Field Summary | |
| final public static Integer | MAX_RESOLUTION
Convenience name for Max Resolution of an image on an IIP server. |
| MAX_RESOLUTION | | final public static Integer MAX_RESOLUTION(Code) | | Convenience name for Max Resolution of an image on an IIP server.
|
| IIPResolutionDescriptor | | public IIPResolutionDescriptor()(Code) | | Constructor.
|
| getParamMinValue | | public Number getParamMinValue(int index)(Code) | | Returns the minimum legal value of a specified numeric parameter
for this operation. If the supplied index does not
correspond to a numeric parameter, this method returns
null.
An Integer of value 0 if indexis 1 or 2, or null if index is 0.
throws:
ArrayIndexOutOfBoundsException - if index is lessthan 0 or greater than 2. |
| validateParameters | | protected boolean validateParameters(ParameterBlock args, StringBuffer msg)(Code) | | Validates the input parameters.
In addition to the standard checks performed by the
superclass method, this method checks that the supplied URL
string specifies a valid protocol.
|
| Methods inherited from javax.media.jai.OperationDescriptorImpl | public boolean arePropertiesSupported()(Code)(Java Doc)
protected static Class getDefaultSourceClass(String modeName)(Code)(Java Doc)
public Class getDestClass(String modeName)(Code)(Java Doc)
public Class getDestClass()(Code)(Java Doc)
public Object getInvalidRegion(String modeName, ParameterBlock oldParamBlock, RenderingHints oldHints, ParameterBlock newParamBlock, RenderingHints newHints, OperationNode node)(Code)(Java Doc)
public String getName()(Code)(Java Doc)
public int getNumParameters()(Code)(Java Doc)
public int getNumSources()(Code)(Java Doc)
public Class[] getParamClasses()(Code)(Java Doc)
public Object getParamDefaultValue(int index)(Code)(Java Doc)
public Object[] getParamDefaults()(Code)(Java Doc)
public Number getParamMaxValue(int index)(Code)(Java Doc)
public Number getParamMinValue(int index)(Code)(Java Doc)
public String[] getParamNames()(Code)(Java Doc)
public ParameterListDescriptor getParameterListDescriptor(String modeName)(Code)(Java Doc)
public PropertyGenerator[] getPropertyGenerators(String modeName)(Code)(Java Doc)
public PropertyGenerator[] getPropertyGenerators()(Code)(Java Doc)
public Class getRenderableDestClass()(Code)(Java Doc)
public Class[] getRenderableSourceClasses()(Code)(Java Doc)
public ResourceBundle getResourceBundle(Locale locale)(Code)(Java Doc)
public String[][] getResources(Locale locale)(Code)(Java Doc)
public Class[] getSourceClasses(String modeName)(Code)(Java Doc)
public Class[] getSourceClasses()(Code)(Java Doc)
public String[] getSourceNames()(Code)(Java Doc)
public String[] getSupportedModes()(Code)(Java Doc)
public boolean isImmediate()(Code)(Java Doc)
public boolean isModeSupported(String modeName)(Code)(Java Doc)
public boolean isRenderableSupported()(Code)(Java Doc)
public boolean isRenderedSupported()(Code)(Java Doc)
protected static Class[][] makeDefaultSourceClassList(String[] supportedModes, int numSources)(Code)(Java Doc)
public boolean validateArguments(String modeName, ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
public boolean validateArguments(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateParameters(String modeName, ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateParameters(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
public boolean validateRenderableArguments(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateRenderableSources(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateSources(String modeName, ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateSources(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
|
|
|