com.esri.arcgis.datasourcesraster
Class ImageRegistration

java.lang.Object
  com.esri.arcgis.datasourcesraster.ImageRegistration

All Implemented Interfaces:

IImageRegistration, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class ImageRegistration
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IImageRegistration

The Image Registration class.

Product Availability

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

See Also:

Serialized Form

Constructor Summary

ImageRegistration()
Constructs a ImageRegistration using ArcGIS Engine.

ImageRegistration(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ImageRegistration theImageRegistration = (ImageRegistration) obj;

Method Summary

void	adjust(IDataset pCatalog, IQueryFilter pQueryFilter, int type, ITable pSolutionTable, ITrackCancel pTrackCancel) Applies adjustments from a solution table.
void	computeAdjustments(IDataset pCatalog, IQueryFilter pQueryFilter, ITable pSolutionTable, int order, ITrackCancel pTrackCancel) Computes simple polynomial adjustments.
void	computeFeaturePoints(IDataset pCatalog, IQueryFilter pQueryFilter, ITable pAOI, IQueryFilter pAOIQueryFilter, ITable pFeaturePointTable, ITrackCancel pTrackCancel) Computes feature points for a collection of images.
void	computeLinks(ITable pControlPointTable, IQueryFilter pQueryFilter, ITable pSolutionTable, ITrackCancel pTrackCancel) Computes links from a list control points.
void	computeTiePoints(ITable pFeaturePointTable, IQueryFilter pQueryFilter, ITable pTiePointTable, ITrackCancel pTrackCancel) Computes matching/tie points from a collection of feature points.
ITable	createControlPointTable(IWorkspace pWorkspace, String name, ISpatialReference pSpatialReference, String configKeyword) Creates a control point table.
ITable	createFeaturePointTable(IWorkspace pWorkspace, String name, ISpatialReference pSpatialReference, String configKeyword) Creates a feature point table.
ITable	createSolutionTable(IWorkspace pWorkspace, String name, ISpatialReference pSpatialReference, String configKeyword) Creates a solution table.
boolean	equals(Object o) Compare this object with another
IImageMatchPoints	extractAllMatchPoints(IRaster pImage, IArray pRefImages) Extracts all match points between a collection of reference images, and a raw image.
IImageFeaturePoints	extractFeaturePoints(IRaster pImage) Extracts feature points from a given image.
IImageMatchPoints	extractMatchPoints(IRaster pImage, IRaster pRefImage) Extracts match points between a reference image, and a raw image.
IImageFeaturePoint	findClosestFeaturePoint(IRaster pImage, IPoint pPoint) Finds the closest feature point from an images around the given point.
int	getBlockingType() The blocking/sampling type for large images.
static String	getClsid() getClsid.
Object	getParameter(String name) Gets a named parameter.
IPropertySet	getParameters() The image registration parameters.
int	getRefinement() The match point refinement to be applied.
IName	getServerObjectName() The ArcGIS server object to perform image registration.
int	getThreadCount() The number of instances for image registration.
int	hashCode() the hashcode for this object
IImageMatchPoints	matchFeaturePoints(IImageFeaturePoints pFeaturePoints, IImageFeaturePoints pOthers) Matches two sets of feature points.
void	refineMatchPoints(IRaster pImage, IRaster pRefImage, IImageMatchPoints[] pMatchPoints) Refines given match points between source and target images.
void	setBlockingType(int pBlockingType) The blocking/sampling type for large images.
void	setParameter(String name, Object value) Sets a named parameter.
void	setParametersByRef(IPropertySet ppParameters) The image registration parameters.
void	setRefinement(int pRefinement) The match point refinement to be applied.
void	setServerObjectNameByRef(IName ppName) The ArcGIS server object to perform image registration.
void	setThreadCount(int pThreadCount) The number of instances for image registration.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

ImageRegistration

public ImageRegistration()
                  throws IOException,
                         UnknownHostException

Constructs a ImageRegistration using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

ImageRegistration

public ImageRegistration(Object obj)
                  throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ImageRegistration theImageRegistration = (ImageRegistration) obj;

Construct a ImageRegistration using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to ImageRegistration.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

getRefinement

public int getRefinement()
                  throws IOException,
                         AutomationException

The match point refinement to be applied.

Product Availability

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

Specified by:

getRefinement in interface IImageRegistration

Returns:

A com.esri.arcgis.datasourcesraster.esriMatchPointRefinementType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setRefinement

public void setRefinement(int pRefinement)
                   throws IOException,
                          AutomationException

The match point refinement to be applied.

Product Availability

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

Specified by:

setRefinement in interface IImageRegistration

Parameters:

pRefinement - A com.esri.arcgis.datasourcesraster.esriMatchPointRefinementType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getParameters

public IPropertySet getParameters()
                           throws IOException,
                                  AutomationException

The image registration parameters.

Product Availability

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

Specified by:

getParameters in interface IImageRegistration

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.

setParametersByRef

public void setParametersByRef(IPropertySet ppParameters)
                        throws IOException,
                               AutomationException

The image registration parameters.

Product Availability

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

Specified by:

setParametersByRef in interface IImageRegistration

Parameters:

ppParameters - 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.

getParameter

public Object getParameter(String name)
                    throws IOException,
                           AutomationException

Gets a named parameter.

Product Availability

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

Specified by:

getParameter in interface IImageRegistration

Parameters:

name - The name (in)

Returns:

A Variant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setParameter

public void setParameter(String name,
                         Object value)
                  throws IOException,
                         AutomationException

Sets a named parameter.

Product Availability

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

Specified by:

setParameter in interface IImageRegistration

Parameters:

name - The name (in)

value - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBlockingType

public int getBlockingType()
                    throws IOException,
                           AutomationException

The blocking/sampling type for large images.

Product Availability

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

Specified by:

getBlockingType in interface IImageRegistration

Returns:

A com.esri.arcgis.datasourcesraster.esriImageBlockingType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBlockingType

public void setBlockingType(int pBlockingType)
                     throws IOException,
                            AutomationException

The blocking/sampling type for large images.

Product Availability

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

Specified by:

setBlockingType in interface IImageRegistration

Parameters:

pBlockingType - A com.esri.arcgis.datasourcesraster.esriImageBlockingType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getThreadCount

public int getThreadCount()
                   throws IOException,
                          AutomationException

The number of instances for image registration.

Product Availability

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

Specified by:

getThreadCount in interface IImageRegistration

Returns:

The pThreadCount

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setThreadCount

public void setThreadCount(int pThreadCount)
                    throws IOException,
                           AutomationException

The number of instances for image registration.

Product Availability

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

Specified by:

setThreadCount in interface IImageRegistration

Parameters:

pThreadCount - The pThreadCount (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getServerObjectName

public IName getServerObjectName()
                          throws IOException,
                                 AutomationException

The ArcGIS server object to perform image registration.

Product Availability

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

Specified by:

getServerObjectName in interface IImageRegistration

Returns:

A reference to a com.esri.arcgis.system.IName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setServerObjectNameByRef

public void setServerObjectNameByRef(IName ppName)
                              throws IOException,
                                     AutomationException

The ArcGIS server object to perform image registration.

Product Availability

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

Specified by:

setServerObjectNameByRef in interface IImageRegistration

Parameters:

ppName - A reference to a com.esri.arcgis.system.IName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

extractFeaturePoints

public IImageFeaturePoints extractFeaturePoints(IRaster pImage)
                                         throws IOException,
                                                AutomationException

Extracts feature points from a given image.

Product Availability

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

Specified by:

extractFeaturePoints in interface IImageRegistration

Parameters:

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

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IImageFeaturePoints

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

matchFeaturePoints

public IImageMatchPoints matchFeaturePoints(IImageFeaturePoints pFeaturePoints,
                                            IImageFeaturePoints pOthers)
                                     throws IOException,
                                            AutomationException

Matches two sets of feature points.

Product Availability

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

Specified by:

matchFeaturePoints in interface IImageRegistration

Parameters:

pFeaturePoints - A reference to a com.esri.arcgis.datasourcesraster.IImageFeaturePoints (in)

pOthers - A reference to a com.esri.arcgis.datasourcesraster.IImageFeaturePoints (in)

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IImageMatchPoints

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

extractMatchPoints

public IImageMatchPoints extractMatchPoints(IRaster pImage,
                                            IRaster pRefImage)
                                     throws IOException,
                                            AutomationException

Extracts match points between a reference image, and a raw image.

Product Availability

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

Specified by:

extractMatchPoints in interface IImageRegistration

Parameters:

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

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

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IImageMatchPoints

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

extractAllMatchPoints

public IImageMatchPoints extractAllMatchPoints(IRaster pImage,
                                               IArray pRefImages)
                                        throws IOException,
                                               AutomationException

Extracts all match points between a collection of reference images, and a raw image.

Product Availability

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

Specified by:

extractAllMatchPoints in interface IImageRegistration

Parameters:

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

pRefImages - A reference to a com.esri.arcgis.system.IArray (in)

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IImageMatchPoints

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findClosestFeaturePoint

public IImageFeaturePoint findClosestFeaturePoint(IRaster pImage,
                                                  IPoint pPoint)
                                           throws IOException,
                                                  AutomationException

Finds the closest feature point from an images around the given point.

Product Availability

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

Specified by:

findClosestFeaturePoint in interface IImageRegistration

Parameters:

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

pPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

Returns:

A reference to a com.esri.arcgis.datasourcesraster.IImageFeaturePoint

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

refineMatchPoints

public void refineMatchPoints(IRaster pImage,
                              IRaster pRefImage,
                              IImageMatchPoints[] pMatchPoints)
                       throws IOException,
                              AutomationException

Refines given match points between source and target images.

Product Availability

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

Specified by:

refineMatchPoints in interface IImageRegistration

Parameters:

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

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

pMatchPoints - A reference to a com.esri.arcgis.datasourcesraster.IImageMatchPoints (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createFeaturePointTable

public ITable createFeaturePointTable(IWorkspace pWorkspace,
                                      String name,
                                      ISpatialReference pSpatialReference,
                                      String configKeyword)
                               throws IOException,
                                      AutomationException

Creates a feature point table.

Product Availability

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

Specified by:

createFeaturePointTable in interface IImageRegistration

Parameters:

pWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)

name - The name (in)

pSpatialReference - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)

configKeyword - The configKeyword (in)

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.

createControlPointTable

public ITable createControlPointTable(IWorkspace pWorkspace,
                                      String name,
                                      ISpatialReference pSpatialReference,
                                      String configKeyword)
                               throws IOException,
                                      AutomationException

Creates a control point table.

Product Availability

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

Specified by:

createControlPointTable in interface IImageRegistration

Parameters:

pWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)

name - The name (in)

pSpatialReference - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)

configKeyword - The configKeyword (in)

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.

createSolutionTable

public ITable createSolutionTable(IWorkspace pWorkspace,
                                  String name,
                                  ISpatialReference pSpatialReference,
                                  String configKeyword)
                           throws IOException,
                                  AutomationException

Creates a solution table.

Product Availability

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

Specified by:

createSolutionTable in interface IImageRegistration

Parameters:

pWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)

name - The name (in)

pSpatialReference - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)

configKeyword - The configKeyword (in)

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.

computeFeaturePoints

public void computeFeaturePoints(IDataset pCatalog,
                                 IQueryFilter pQueryFilter,
                                 ITable pAOI,
                                 IQueryFilter pAOIQueryFilter,
                                 ITable pFeaturePointTable,
                                 ITrackCancel pTrackCancel)
                          throws IOException,
                                 AutomationException

Computes feature points for a collection of images.

Product Availability

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

Specified by:

computeFeaturePoints in interface IImageRegistration

Parameters:

pCatalog - A reference to a com.esri.arcgis.geodatabase.IDataset (in)

pQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

pAOI - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pAOIQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

pFeaturePointTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

computeTiePoints

public void computeTiePoints(ITable pFeaturePointTable,
                             IQueryFilter pQueryFilter,
                             ITable pTiePointTable,
                             ITrackCancel pTrackCancel)
                      throws IOException,
                             AutomationException

Computes matching/tie points from a collection of feature points.

Product Availability

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

Specified by:

computeTiePoints in interface IImageRegistration

Parameters:

pFeaturePointTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

pTiePointTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

computeLinks

public void computeLinks(ITable pControlPointTable,
                         IQueryFilter pQueryFilter,
                         ITable pSolutionTable,
                         ITrackCancel pTrackCancel)
                  throws IOException,
                         AutomationException

Computes links from a list control points.

Product Availability

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

Specified by:

computeLinks in interface IImageRegistration

Parameters:

pControlPointTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

pSolutionTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

computeAdjustments

public void computeAdjustments(IDataset pCatalog,
                               IQueryFilter pQueryFilter,
                               ITable pSolutionTable,
                               int order,
                               ITrackCancel pTrackCancel)
                        throws IOException,
                               AutomationException

Computes simple polynomial adjustments.

Product Availability

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

Specified by:

computeAdjustments in interface IImageRegistration

Parameters:

pCatalog - A reference to a com.esri.arcgis.geodatabase.IDataset (in)

pQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

pSolutionTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

order - The order (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

adjust

public void adjust(IDataset pCatalog,
                   IQueryFilter pQueryFilter,
                   int type,
                   ITable pSolutionTable,
                   ITrackCancel pTrackCancel)
            throws IOException,
                   AutomationException

Applies adjustments from a solution table.

Product Availability

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

Specified by:

adjust in interface IImageRegistration

Parameters:

pCatalog - A reference to a com.esri.arcgis.geodatabase.IDataset (in)

pQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

type - A com.esri.arcgis.datasourcesraster.esriImageAdjustmentType constant (in)

pSolutionTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.