com.esri.arcgis.geodatabase
Class IRasterWorkspaceExProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geodatabase.IRasterWorkspaceExProxy

All Implemented Interfaces:

IRasterWorkspaceEx, Externalizable, Serializable

public class IRasterWorkspaceExProxy
extends com.esri.arcgis.interop.Dispatch
implements IRasterWorkspaceEx, Serializable

Provides access to members that create and open raster catalogs and datasets.

Remarks

The IRasterWorkspaceEx interface works with raster datasets and raster catalogs in the geodatabase. It allows the creation of new raster datasets and raster catalogs in the geodatabase, it also opens and deletes existing raster datasets and raster catalogs in the geodatabase. The IRasterWorkspaceEx interface also allows saving a given raster to a raster dataset in the geodatabase. Its counterpart is IRasterWorkspace and IRasterWorkspace2 that works with file-based rasters.

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IRasterWorkspaceExProxy()
	IRasterWorkspaceExProxy(Object obj)
protected	IRasterWorkspaceExProxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
IRasterCatalog	createRasterCatalog(String name, IFields fields, String shapeFieldName, String rasterFieldName, String configKeyword) Creates a new raster catalog.
IRasterDataset	createRasterDataset(String name, int numBands, int pixelType, IRasterStorageDef storageDef, String configKeyword, IRasterDef rasterDef, IGeometryDef geometryDef) Creates a new raster dataset.
void	deleteRasterCatalog(String name) Deletes a raster catalog.
void	deleteRasterDataset(String name) Deletes a raster dataset.
IRasterCatalog	openRasterCatalog(String name) Opens an existing raster catalog.
IRasterDataset	openRasterDataset(String name) Opens an existing raster dataset.
void	registerAsRasterCatalog(String name, String oIDFieldName, IGeometryDef geometryDef) Registers as a RasterCatalog.
void	registerAsRasterDataset(String name, IGeometryDef geometryDef) Registers as a RasterDataset.
void	removeListener(String iidStr, Object theListener)
IRasterDataset	saveAsRasterDataset(String name, IRaster raster, IRasterStorageDef storageDef, String configKeyword, IRasterDef rasterDef, IGeometryDef geometryDef) Creates a new raster dataset from another seed Raster.

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IRasterWorkspaceExProxy

public IRasterWorkspaceExProxy()

IRasterWorkspaceExProxy

public IRasterWorkspaceExProxy(Object obj)
                        throws IOException

Throws:

IOException

IRasterWorkspaceExProxy

protected IRasterWorkspaceExProxy(Object obj,
                                  String iid)
                           throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

createRasterDataset

public IRasterDataset createRasterDataset(String name,
                                          int numBands,
                                          int pixelType,
                                          IRasterStorageDef storageDef,
                                          String configKeyword,
                                          IRasterDef rasterDef,
                                          IGeometryDef geometryDef)
                                   throws IOException,
                                          AutomationException

Creates a new raster dataset.

Description

The CreateRasterDataset method creates a new empty raster dataset in the geodatabase, whereby it is basically a placeholder for some attributes of a raster dataset, such as the number of bands, pixel type, RASTER column properties, and GEOMETRY column properties. Once you have created an empty raster dataset in the geodatabase, you can append raster data to it by mosaicking. If the GeometryDef argument is not specified, a default GeometryDef will be created using the according values (for example, spatial reference) set in the RasterDef argument. Since the geometry column is not accessed or updated, there is no need to set the GeometryDef when creating a raster dataset.

If cellsize in the RasterStorageDef is not specified or set to NULL, the new raster dataset will have an undefined cellsize, the cellsize will be set to the cellsize of the first raster that is mosaicked to it.

If spatial reference in the RasterDef is not specified or set to NULL, the new raster dataset will have an unknown spatial reference, the spatial reference will be set to the spatial reference of the first raster that is mosaicked to it.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

createRasterDataset in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

numBands - The numBands (in)

pixelType - A com.esri.arcgis.geodatabase.rstPixelType constant (in)

storageDef - A reference to a com.esri.arcgis.geodatabase.IRasterStorageDef (in)

configKeyword - The configKeyword (in)

rasterDef - A reference to a com.esri.arcgis.geodatabase.IRasterDef (in)

geometryDef - A reference to a com.esri.arcgis.geodatabase.IGeometryDef (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.

saveAsRasterDataset

public IRasterDataset saveAsRasterDataset(String name,
                                          IRaster raster,
                                          IRasterStorageDef storageDef,
                                          String configKeyword,
                                          IRasterDef rasterDef,
                                          IGeometryDef geometryDef)
                                   throws IOException,
                                          AutomationException

Creates a new raster dataset from another seed Raster.

Remarks

The SaveAsRasterDataset method provides a way to save any raster as a raster dataset in the geodatabase. It is similar to the CreateRasterDataset method, but instead of creating an empty raster dataset, it copies the input raster properties and pixels to the output raster dataset in the geodatabase. If you want to keep the spatial reference of the input raster dataset for both raster column and geometry column, you can pass nothing to the RasterDef argument and GeometryDef argument.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

saveAsRasterDataset in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

raster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)

storageDef - A reference to a com.esri.arcgis.geodatabase.IRasterStorageDef (in)

configKeyword - The configKeyword (in)

rasterDef - A reference to a com.esri.arcgis.geodatabase.IRasterDef (in)

geometryDef - A reference to a com.esri.arcgis.geodatabase.IGeometryDef (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.

openRasterDataset

public IRasterDataset openRasterDataset(String name)
                                 throws IOException,
                                        AutomationException

Opens an existing raster dataset.

Remarks

The OpenRasterDataset method opens a raster dataset in the geodatabase. It provides access to the RasterDataset geodatabase workspace.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

openRasterDataset in interface IRasterWorkspaceEx

Parameters:

name - The name (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.

deleteRasterDataset

public void deleteRasterDataset(String name)
                         throws IOException,
                                AutomationException

Deletes a raster dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

deleteRasterDataset in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

registerAsRasterDataset

public void registerAsRasterDataset(String name,
                                    IGeometryDef geometryDef)
                             throws IOException,
                                    AutomationException

Registers as a RasterDataset.

Remarks

The RegisterAsRasterDataset method allows you to upgrade an 8.x raster dataset to a 9.x raster dataset in ArcSDE geodatabase, because an 8.x raster dataset doesn’t have a GEOMETRY column in its business table while a 9.x raster dataset does. This method only applies to ArcSDE geodatabase raster dataset. It is necessary to register an 8.x raster dataset to a 9.x raster dataset in order for the raster dataset to be recognized in any Geoprocessing tools.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

registerAsRasterDataset in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

geometryDef - A reference to a com.esri.arcgis.geodatabase.IGeometryDef (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createRasterCatalog

public IRasterCatalog createRasterCatalog(String name,
                                          IFields fields,
                                          String shapeFieldName,
                                          String rasterFieldName,
                                          String configKeyword)
                                   throws IOException,
                                          AutomationException

Creates a new raster catalog.

Remarks

The CreateRasterCatalog method creates a new empty raster catalog in a Personal, File or ArcSDE geodatabase. At releases prior to 9.2, When you create a raster catalog, you need to set the x/y domain on the GeometryDef properly to cover the extents of all the rasters you will be loading to the raster catalog. If the extent of a raster dataset is beyond the specified x/y domain of the GeometryDef, it will not be loaded. Since 9.2, the x/y domain is optimized according to the spatial reference of the geometry column, so you do not need to set it manually.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

createRasterCatalog in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

fields - A reference to a com.esri.arcgis.geodatabase.IFields (in)

shapeFieldName - The shapeFieldName (in)

rasterFieldName - The rasterFieldName (in)

configKeyword - The configKeyword (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IRasterCatalog

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

openRasterCatalog

public IRasterCatalog openRasterCatalog(String name)
                                 throws IOException,
                                        AutomationException

Opens an existing raster catalog.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

openRasterCatalog in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IRasterCatalog

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteRasterCatalog

public void deleteRasterCatalog(String name)
                         throws IOException,
                                AutomationException

Deletes a raster catalog.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

deleteRasterCatalog in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

registerAsRasterCatalog

public void registerAsRasterCatalog(String name,
                                    String oIDFieldName,
                                    IGeometryDef geometryDef)
                             throws IOException,
                                    AutomationException

Registers as a RasterCatalog.

Remarks

The RegisterAsRasterCatalog method provides a way to upgrade an 8.x embedded raster catalog to a 9.x raster catalog, because an 8.x raster catalog doesn’t have an OID or a GEOMETRY type column in its business table while a 9.x raster catalog does. This method will add these two columns to the raster catalog table and populate the Geometry column with the extent of each raster dataset in the raster catalog. This method works only with ArcSDE geodatabase.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

registerAsRasterCatalog in interface IRasterWorkspaceEx

Parameters:

name - The name (in)

oIDFieldName - The oIDFieldName (in)

geometryDef - A reference to a com.esri.arcgis.geodatabase.IGeometryDef (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.