com.esri.arcgis.datasourcesraster
Interface IRasterBuilder

All Superinterfaces:
Serializable
All Known Implementing Classes:
ApplanixBuilder, IkonosBuilder, IRasterBuilderProxy, ISATBuilder, ISDefBuilder, LandsatBuilder, MatchATBuilder, NITFBuilder, OverviewBuilder, QuickBirdBuilder, RapidEyeBuilder, RasterDatasetBuilder, RasterType, RPDefBuilder, RPFBuilder, SpotBuilder, TableBuilder

public interface IRasterBuilder
extends Serializable

Provides access to members that control a raster builder.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.


Method Summary
 void beginConstruction(IDataSourceCrawler pCrawler)
          Initializes the raster builder for URI construction given a valid data source crawler object.
 IBuilderItem build(IItemURI pItemURI)
          Construct a builder item using the specified item URI.
 void constructURIs(Object crawlerItem)
          Constructs one or more item URI objects given the crawled data source item.
 IItemURIArray endConstruction()
          Shuts down the raster builder object upon completion of URI construction.
 IPropertySet getAuxiliaryFieldAlias()
          Optional look-up that maps field names to possile metadata property names.
 IFields getAuxiliaryFields()
          Fields to be created and populated in the raster catalog when a builder is used.
 IItemURI getNextURI()
          Returns the next available item URI object.
 IPropertySet getProperties()
          The raster dataset builder properties.
 IDataSourceCrawler getRecommendedCrawler(IPropertySet pDataSourceProperties)
          Returns a crawler best suited for data source as recommended by the raster builder.
 boolean isCanBuildInPlace()
          Indicates whether the raster type can build an item URI as soon as it is contructed.
 boolean isStale(IItemURI pItemURI)
          Indicates whether the data source referenced by the specified item URI has been updated since the item URI was last constructed.
 void setAuxiliaryFieldAliasByRef(IPropertySet ppFieldNameMap)
          Optional look-up that maps field names to possile metadata property names.
 void setAuxiliaryFieldsByRef(IFields ppAuxiliaryFields)
          Fields to be created and populated in the raster catalog when a builder is used.
 void setPropertiesByRef(IPropertySet ppBuilderPoperties)
          The raster dataset builder properties.
 

Method Detail

getRecommendedCrawler

IDataSourceCrawler getRecommendedCrawler(IPropertySet pDataSourceProperties)
                                         throws IOException,
                                                AutomationException
Returns a crawler best suited for data source as recommended by the raster builder.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
pDataSourceProperties - A reference to a com.esri.arcgis.system.IPropertySet (in)
Returns:
A reference to a com.esri.arcgis.datasourcesraster.IDataSourceCrawler
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

beginConstruction

void beginConstruction(IDataSourceCrawler pCrawler)
                       throws IOException,
                              AutomationException
Initializes the raster builder for URI construction given a valid data source crawler object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
pCrawler - A reference to a com.esri.arcgis.datasourcesraster.IDataSourceCrawler (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

constructURIs

void constructURIs(Object crawlerItem)
                   throws IOException,
                          AutomationException
Constructs one or more item URI objects given the crawled data source item.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
crawlerItem - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getNextURI

IItemURI getNextURI()
                    throws IOException,
                           AutomationException
Returns the next available item URI object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.datasourcesraster.IItemURI
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

endConstruction

IItemURIArray endConstruction()
                              throws IOException,
                                     AutomationException
Shuts down the raster builder object upon completion of URI construction. Once all item URIs are constructed and returned via repated calls to the GetNextURI, this method might return an array of item URIs possibly created as a result of the shut down process.????&

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.datasourcesraster.IItemURIArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isStale

boolean isStale(IItemURI pItemURI)
                throws IOException,
                       AutomationException
Indicates whether the data source referenced by the specified item URI has been updated since the item URI was last constructed.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
pItemURI - A reference to a com.esri.arcgis.datasourcesraster.IItemURI (in)
Returns:
The pIsStale
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

build

IBuilderItem build(IItemURI pItemURI)
                   throws IOException,
                          AutomationException
Construct a builder item using the specified item URI.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
pItemURI - A reference to a com.esri.arcgis.datasourcesraster.IItemURI (in)
Returns:
A reference to a com.esri.arcgis.datasourcesraster.IBuilderItem
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPropertiesByRef

void setPropertiesByRef(IPropertySet ppBuilderPoperties)
                        throws IOException,
                               AutomationException
The raster dataset builder properties.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
ppBuilderPoperties - A reference to a com.esri.arcgis.system.IPropertySet (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getProperties

IPropertySet getProperties()
                           throws IOException,
                                  AutomationException
The raster dataset builder properties.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.system.IPropertySet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAuxiliaryFieldsByRef

void setAuxiliaryFieldsByRef(IFields ppAuxiliaryFields)
                             throws IOException,
                                    AutomationException
Fields to be created and populated in the raster catalog when a builder is used.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
ppAuxiliaryFields - A reference to a com.esri.arcgis.geodatabase.IFields (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAuxiliaryFields

IFields getAuxiliaryFields()
                           throws IOException,
                                  AutomationException
Fields to be created and populated in the raster catalog when a builder is used.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.geodatabase.IFields
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAuxiliaryFieldAliasByRef

void setAuxiliaryFieldAliasByRef(IPropertySet ppFieldNameMap)
                                 throws IOException,
                                        AutomationException
Optional look-up that maps field names to possile metadata property names.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
ppFieldNameMap - A reference to a com.esri.arcgis.system.IPropertySet (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAuxiliaryFieldAlias

IPropertySet getAuxiliaryFieldAlias()
                                    throws IOException,
                                           AutomationException
Optional look-up that maps field names to possile metadata property names.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.system.IPropertySet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isCanBuildInPlace

boolean isCanBuildInPlace()
                          throws IOException,
                                 AutomationException
Indicates whether the raster type can build an item URI as soon as it is contructed.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The pbCanBuildInPlace
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.