com.esri.arcgis.datasourcesraster
Interface IRasterCatalogTable

All Superinterfaces:
Serializable
All Known Implementing Classes:
RasterCatalogTable, SdeRasterCatalogTable

public interface IRasterCatalogTable
extends Serializable

Provides access to members that control a raster catalog table.

Description

A raster catalog is a table in any supported table format (including INFO, dbf, access, text, and others) that contains a list of raster datasets and their geographic extents.

The first five columns of the table must be called "Image", "Xmin", "Ymin", "Xmax", and "YMax" for the table to be identified as a raster catalog. The first column contains the path to a dataset on disk, while the next four contain the bounding box of the dataset. Additional fields in the table are allowed but will have no effect on the display of the raster catalog.

Remarks

The IRasterCatalogTable object allows you to access information about a raster catalog including the extent and name for each dataset in the catalog and the number of datasets (Size) and Extent of the entire raster catalog.

You can also provide a table in the correct format to be used as the RasterCatalogTable (The counterpart for 8.x tyle ArcSDE raster catalog is SdeRasterCatalogTable). You must call the Update method after putting a table in the RasterCatalogTable.

Product Availability

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


Method Summary
 void getFieldBoundsLocation(int[] pLocXmin, int[] pLocYmin, int[] pLocXmax, int[] pLocYMax)
          Bounds of the field location of the raster catalog.
 int getFieldNameLocation()
          Location of the field name of the raster catalog.
 int getOID(int idx)
          OID of the ith raster in the raster catalog.
 IRasterDataset getRasterDataset(int idx)
          Reference to the ith raster dataset in the raster catalog.
 IEnvelope getRasterExtent(int idx)
          Extent of the ith raster in the catalog.
 String getRasterName(int idx)
          Name of the ith raster in the raster catalog.
 int getSize()
          Number of rasters in the raster catalog.
 ITable getTable()
          The table object underlying the raster catalog table.
 String getWhereClause()
          A SQL expression limiting the list of rasters currently viewed.
 void setTableByRef(ITable ppTable)
          The table object underlying the raster catalog table.
 void setWhereClause(String whereClause)
          A SQL expression limiting the list of rasters currently viewed.
 void update()
          Updates the object after the table is changed.
 

Method Detail

getTable

ITable getTable()
                throws IOException,
                       AutomationException
The table object underlying the raster catalog table.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setTableByRef

void setTableByRef(ITable ppTable)
                   throws IOException,
                          AutomationException
The table object underlying the raster catalog table.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

update

void update()
            throws IOException,
                   AutomationException
Updates the object after the table is changed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getSize

int getSize()
            throws IOException,
                   AutomationException
Number of rasters in the raster catalog.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getRasterExtent

IEnvelope getRasterExtent(int idx)
                          throws IOException,
                                 AutomationException
Extent of the ith raster in the catalog.

Product Availability

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

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

getRasterName

String getRasterName(int idx)
                     throws IOException,
                            AutomationException
Name of the ith raster in the raster catalog.

Product Availability

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

Parameters:
idx - The idx (in)
Returns:
The name
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRasterDataset

IRasterDataset getRasterDataset(int idx)
                                throws IOException,
                                       AutomationException
Reference to the ith raster dataset in the raster catalog.

Product Availability

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

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

getFieldNameLocation

int getFieldNameLocation()
                         throws IOException,
                                AutomationException
Location of the field name of the raster catalog.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getFieldBoundsLocation

void getFieldBoundsLocation(int[] pLocXmin,
                            int[] pLocYmin,
                            int[] pLocXmax,
                            int[] pLocYMax)
                            throws IOException,
                                   AutomationException
Bounds of the field location of the raster catalog.

Product Availability

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

Parameters:
pLocXmin - The pLocXmin (out: use single element array)
pLocYmin - The pLocYmin (out: use single element array)
pLocXmax - The pLocXmax (out: use single element array)
pLocYMax - The pLocYMax (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setWhereClause

void setWhereClause(String whereClause)
                    throws IOException,
                           AutomationException
A SQL expression limiting the list of rasters currently viewed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getWhereClause

String getWhereClause()
                      throws IOException,
                             AutomationException
A SQL expression limiting the list of rasters currently viewed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getOID

int getOID(int idx)
           throws IOException,
                  AutomationException
OID of the ith raster in the raster catalog.

Product Availability

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

Parameters:
idx - The idx (in)
Returns:
The oID
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.