javax.media.jai.operator
Class URLDescriptor

java.lang.Object
  extended byjavax.media.jai.OperationDescriptorImpl
      extended byjavax.media.jai.operator.URLDescriptor
All Implemented Interfaces:
OperationDescriptor, RegistryElementDescriptor, Serializable

public class URLDescriptor
extends OperationDescriptorImpl

An OperationDescriptor describing the "URL" operation.

The URL operation creates an output image whose source is specified by a Uniform Resource Locator (URL).

The allowable formats are those registered with the com.sun.media.jai.codec.ImageCodec class.

The second parameter contains an instance of ImageDecodeParam to be used during the decoding. It may be set to null in order to perform default decoding, or equivalently may be omitted.

The classes in the com.sun.media.jai.codec package are not a committed part of the JAI API. Future releases of JAI will make use of new classes in their place. This class will change accordingly.

Resource List
Name Value
GlobalName fileload
LocalName fileload
Vendor com.sun.media.jai
Description Reads an image from a file.
DocURL http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/operator/URLDescriptor.html
Version 1.0
arg0Desc The path of the file to read from.
arg1Desc The ImageDecodeParam to use.

Parameter List
Name Class Type Default Value
URL java.net.URL NO_PARAMETER_DEFAULT
param com.sun.media.jai.codec.ImageDecodeParam null

See Also:
OperationDescriptor, Serialized Form

Field Summary
 
Fields inherited from class javax.media.jai.OperationDescriptorImpl
sourceNames, supportedModes
 
Fields inherited from interface javax.media.jai.OperationDescriptor
NO_PARAMETER_DEFAULT
 
Constructor Summary
URLDescriptor()
          Constructor.
 
Method Summary
static RenderedOp create(URL URL, ImageDecodeParam param, RenderingHints hints)
          Reads an image from a URL.
 
Methods inherited from class javax.media.jai.OperationDescriptorImpl
arePropertiesSupported, getDefaultSourceClass, getDestClass, getDestClass, getInvalidRegion, getName, getNumParameters, getNumSources, getParamClasses, getParamDefaults, getParamDefaultValue, getParameterListDescriptor, getParamMaxValue, getParamMinValue, getParamNames, getPropertyGenerators, getPropertyGenerators, getRenderableDestClass, getRenderableSourceClasses, getResourceBundle, getResources, getSourceClasses, getSourceClasses, getSourceNames, getSupportedModes, isImmediate, isModeSupported, isRenderableSupported, isRenderedSupported, makeDefaultSourceClassList, validateArguments, validateArguments, validateParameters, validateParameters, validateRenderableArguments, validateRenderableSources, validateSources, validateSources
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

URLDescriptor

public URLDescriptor()
Constructor.

Method Detail

create

public static RenderedOp create(URL URL,
                                ImageDecodeParam param,
                                RenderingHints hints)
Reads an image from a URL.

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.create(String,ParameterBlock,RenderingHints).

Parameters:
URL - The URL to read from.
param - The ImageDecodeParam to use. May be null.
hints - The RenderingHints to use. May be null.
Returns:
The RenderedOp destination.
Throws:
IllegalArgumentException - if URL is null.
See Also:
JAI, ParameterBlockJAI, RenderedOp