com.esri.arcgis.datasourcesraster
Class RasterGeometryProc

java.lang.Object
  extended by com.esri.arcgis.datasourcesraster.RasterGeometryProc
All Implemented Interfaces:
IRasterGeometryProc, IRasterGeometryProc3, com.esri.arcgis.interop.RemoteObjRef, ISupportErrorInfo, Serializable

public class RasterGeometryProc
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IRasterGeometryProc, IRasterGeometryProc3, ISupportErrorInfo

A mechanism to perform raster geometric operations, such as flip, rotate, and merge on rasters.

Description

The RasterGeometryProc object performs geometric processing, such as flipping, scaling, rotation, and polynomial warping, on a Raster. It is a wrapper of the PolynomialXform class for end users to perform polynomial transformation with raster data

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:
Serialized Form

Constructor Summary
RasterGeometryProc()
          Constructs a RasterGeometryProc using ArcGIS Engine.
RasterGeometryProc(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
RasterGeometryProc theRasterGeometryProc = (RasterGeometryProc) obj;
 
Method Summary
 void clip(IEnvelope ipRectangle, IRaster pRaster)
          Clips the input raster based on the specified envelope.
 boolean equals(Object o)
          Compare this object with another
 void flip(IRaster pRaster)
          Flips the input raster.
static String getClsid()
          getClsid.
 void getRasterXFormByIndex(IRaster pRaster, int band, boolean forward, int index, int[] order, Object[] pVar)
          Gets the polynomial order and the polynomial coefficients of the indexed transformation.
 int getRasterXFormCount(IRaster pRaster, int band)
          Gets the number of transformations.
 int getRasterXFormOrderByIndex(IRaster pRaster, int band, int index)
          Gets the polynomial order of the indexed transformation.
 int hashCode()
          the hashcode for this object
 void interfaceSupportsErrorInfo(GUID riid)
          interfaceSupportsErrorInfo
 boolean isPixelToMapTransSimple(IRaster pRaster)
          Indicates if the transformation of pixel to map is simple.
 Object leastSquareFit(IPointCollection sourceControlPoints, IPointCollection targetControlPoints, int transformType, boolean forwardTransformation, boolean returnTransformationCoef)
          Computes a least squares fit for the input control points.
 IRaster merge(String saveas_name, IWorkspace ipWorkspace, String outRasterFormat, double cellSize, ISpatialReference ipSR, IRaster pRaster)
          Merges the input rasters into a single dataset.
 void mirror(IRaster pRaster)
          Mirrors the input raster.
 IRaster mosaic(String saveas_name, IWorkspace pWorkspace, String outRasterFormat, double cellSize, ISpatialReference pSR, IRaster pRaster)
          Mosaics the input rasters into a single dataset.
 IPointCollection pointsMap2PixelTransform(IPointCollection pInPoints, boolean isForward, IRaster pRaster)
          Performs the map to pixel transformation.
 IPointCollection pointsTransform(IPointCollection inPoints, boolean isForward, IRaster pRaster)
          Transforms a set of points based upon the transformation being applied to the input raster.
 void projectFast(ISpatialReference pNewSR, int resampleType, Object pCellsize, IRaster pRaster)
          Projects the input raster using a single polynomial fit to compute the adjustment between coordinate systems.
 void putRasterXForm(IRaster pRaster, boolean clean, int order, Object pVar)
          Sets a polynomial transformation to the Raster.
 void rectify(String saveas_name, String format, IRaster pRaster)
          Persists the input raster to a new dataset of the specified format.
 void register(IRaster pRaster)
          Outputs the current transformation properties to the dataset header or auxilliary file.
 void resample(int resampleType, double newCellsize, IRaster pRaster)
          Resamples the input raster to a new cellsize.
 void reScale(double xScale, double yScale, IRaster pRaster)
          Scales the input raster by the specified x and y scale factors.
 void reset(IRaster pRaster)
          Resets the input raster to its native coordinate space.
 void rotate(IPoint pPivotPoint, double rotateAngle, IRaster pRaster)
          Rotates the input raster around the specified pivot by an angle specified in degrees.
 void shift(double deltaX, double deltaY, IRaster pRaster)
          Shifts the input raster by deltaX and deltaY map units.
 void twoPointsAdjust(IPointCollection sourceControlPoints, IPointCollection targetControlPoints, IRaster pRaster)
          Performs a Hermite transformation on the input raster based upon the 2 input control point pairs.
 void warp(IPointCollection sourceControlPoints, IPointCollection targetControlPoints, int transformType, IRaster pRaster)
          Warps the input raster based upon the input control points using the transformation type specified.
 
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

RasterGeometryProc

public RasterGeometryProc()
                   throws IOException,
                          UnknownHostException
Constructs a RasterGeometryProc using ArcGIS Engine.

Throws:
IOException - if there are interop problems
UnknownHostException - if there are interop problems

RasterGeometryProc

public RasterGeometryProc(Object obj)
                   throws IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
RasterGeometryProc theRasterGeometryProc = (RasterGeometryProc) obj;

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

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

flip

public void flip(IRaster pRaster)
          throws IOException,
                 AutomationException
Flips the input raster.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
flip in interface IRasterGeometryProc
Specified by:
flip in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

mirror

public void mirror(IRaster pRaster)
            throws IOException,
                   AutomationException
Mirrors the input raster.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
mirror in interface IRasterGeometryProc
Specified by:
mirror in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

shift

public void shift(double deltaX,
                  double deltaY,
                  IRaster pRaster)
           throws IOException,
                  AutomationException
Shifts the input raster by deltaX and deltaY map units.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
shift in interface IRasterGeometryProc
Specified by:
shift in interface IRasterGeometryProc3
Parameters:
deltaX - The deltaX (in)
deltaY - The deltaY (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

reScale

public void reScale(double xScale,
                    double yScale,
                    IRaster pRaster)
             throws IOException,
                    AutomationException
Scales the input raster by the specified x and y scale factors.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
reScale in interface IRasterGeometryProc
Specified by:
reScale in interface IRasterGeometryProc3
Parameters:
xScale - The xScale (in)
yScale - The yScale (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

rotate

public void rotate(IPoint pPivotPoint,
                   double rotateAngle,
                   IRaster pRaster)
            throws IOException,
                   AutomationException
Rotates the input raster around the specified pivot by an angle specified in degrees.

Remarks

The Rotate method rotates the raster by the angle input in degrees around the input pivot point, if specified. If no pivot point is specified, the raster is rotated around its center point. Positive rotateAngle rotates the raster counter-clockwise, while negative rotateAngle rotates the raster clockwise.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
rotate in interface IRasterGeometryProc
Specified by:
rotate in interface IRasterGeometryProc3
Parameters:
pPivotPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
rotateAngle - The rotateAngle (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

warp

public void warp(IPointCollection sourceControlPoints,
                 IPointCollection targetControlPoints,
                 int transformType,
                 IRaster pRaster)
          throws IOException,
                 AutomationException
Warps the input raster based upon the input control points using the transformation type specified.

Remarks

Warp method computes a polynomial transformation based on the input links, then applies this transformation to the input raster. The polynomial transformation specified can be first, second, or third order polynomials. Each transformation order requires a minimum number of control links. They are 3, 6, and 10 for order 1,2, and 3, respectively.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
warp in interface IRasterGeometryProc
Specified by:
warp in interface IRasterGeometryProc3
Parameters:
sourceControlPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
targetControlPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
transformType - A com.esri.arcgis.datasourcesraster.esriGeoTransTypeEnum constant (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

twoPointsAdjust

public void twoPointsAdjust(IPointCollection sourceControlPoints,
                            IPointCollection targetControlPoints,
                            IRaster pRaster)
                     throws IOException,
                            AutomationException
Performs a Hermite transformation on the input raster based upon the 2 input control point pairs.

Remarks

The TwoPointsAdjust method computes a Hermite transformation from a pair of links and applies to the raster. A Hermite transformation can shift, rotate, and scale a raster.
es a minimum number of control links. They are 3, 6, and 10 for order 1,2, and 3, respectively.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
twoPointsAdjust in interface IRasterGeometryProc
Specified by:
twoPointsAdjust in interface IRasterGeometryProc3
Parameters:
sourceControlPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
targetControlPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

pointsTransform

public IPointCollection pointsTransform(IPointCollection inPoints,
                                        boolean isForward,
                                        IRaster pRaster)
                                 throws IOException,
                                        AutomationException
Transforms a set of points based upon the transformation being applied to the input raster.

Remarks

The PointsTransform method transforms a set of points and using the transformations currently held in the input raster. The points can be transformed forwards or backwards.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
pointsTransform in interface IRasterGeometryProc
Specified by:
pointsTransform in interface IRasterGeometryProc3
Parameters:
inPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
isForward - The isForward (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Returns:
A reference to a com.esri.arcgis.geometry.IPointCollection
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

leastSquareFit

public Object leastSquareFit(IPointCollection sourceControlPoints,
                             IPointCollection targetControlPoints,
                             int transformType,
                             boolean forwardTransformation,
                             boolean returnTransformationCoef)
                      throws IOException,
                             AutomationException
Computes a least squares fit for the input control points.

Remarks

The numbers of points in the SourceControlPoints and targetControlPoints must be equal. To create a first order polynomial transformation, there should be at least 3 un-correlated points for both source and target control points. For the second order and third order polynomial transformations, the minimum number of un-correlated points are 6 and 10 respectively.

Setting the argument forwardTransformation to be true indicates the transformation will be computed from SourceControls to targetControlPoints, while setting it to be false indicates the transformation will be computed from targetControlPoints to SourceControlPoints.

Setting the argument ReturnTransformationCoef to be true indicates the returned variant will be the coefficients of the transformation polynomial, while setting it to be false indicates that the returned variant will be residual.

The returned coefficients are represented as a Nx2 array with N varies with the transformation order. The returned residual is represented as a one-dimensional array. The number of the element in the array equals the number of the control points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
leastSquareFit in interface IRasterGeometryProc
Specified by:
leastSquareFit in interface IRasterGeometryProc3
Parameters:
sourceControlPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
targetControlPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
transformType - A com.esri.arcgis.datasourcesraster.esriGeoTransTypeEnum constant (in)
forwardTransformation - The forwardTransformation (in)
returnTransformationCoef - The returnTransformationCoef (in)
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

reset

public void reset(IRaster pRaster)
           throws IOException,
                  AutomationException
Resets the input raster to its native coordinate space.

Remarks

The Reset method sets the raster back to its initial state. The transformations that have been put to the raster but have not been persisted to the raster dataset will be gone after calling this method

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
reset in interface IRasterGeometryProc
Specified by:
reset in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

rectify

public void rectify(String saveas_name,
                    String format,
                    IRaster pRaster)
             throws IOException,
                    AutomationException
Persists the input raster to a new dataset of the specified format.

Remarks

The output formats as well as the strings used for the supported formats are below, and they are case sensitive:

Format Name String Used
Imagine "IMAGINE Image"
TIFF "TIFF"
GRID "GRID"
JPEG "JPG"
JP2000 "JP2"
BMP "BMP"
PNG "PNG"
GIF "GIF"
PCI Raster "PIX"
USGS ASCII DEM "DEM"
X11 Pixmap "XPM"
PCRaster "MAP"
USGS ASCII DEM "DEM"

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
rectify in interface IRasterGeometryProc
Specified by:
rectify in interface IRasterGeometryProc3
Parameters:
saveas_name - The saveas_name (in)
format - The format (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

register

public void register(IRaster pRaster)
              throws IOException,
                     AutomationException
Outputs the current transformation properties to the dataset header or auxilliary file.

Remarks

To prevent the need for resampling, the Register method persists the transformation into the auxiliary file associated with the dataset on disk. The presence of this transformation on disk means that the data can be transformed on-the-fly to its correct position for display and analysis. However, because the transformation is stored in the auxiliary file, only ArcGIS, ArcObjects, and ERDAS IMAGINE will be able to use this information. Register will not correctly maintain the transformation for rasters that have been clipped. To provide compatibility with ArcGIS for Desktop Advanced Workstation, complex transformations cannot be written to GRID-format datasets.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
register in interface IRasterGeometryProc
Specified by:
register in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

clip

public void clip(IEnvelope ipRectangle,
                 IRaster pRaster)
          throws IOException,
                 AutomationException
Clips the input raster based on the specified envelope.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
clip in interface IRasterGeometryProc
Specified by:
clip in interface IRasterGeometryProc3
Parameters:
ipRectangle - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

projectFast

public void projectFast(ISpatialReference pNewSR,
                        int resampleType,
                        Object pCellsize,
                        IRaster pRaster)
                 throws IOException,
                        AutomationException
Projects the input raster using a single polynomial fit to compute the adjustment between coordinate systems.

Remarks

The ProjectFast method projects a raster to a new spatial reference with a specified cell size. ProjectFast method does not project a raster cell by cell, instead, this method divides the whole raster into 64 x 64 pixel blocks and projects a raster based on a piecewise polynomial transformation algorithm, whereby each block is transformed using a polynomial warp. Altough this method is not as accurate as the cell by cell projection (PROJECT command in ArcGrid™), it is faster and accurate enough for most application and analysis.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
projectFast in interface IRasterGeometryProc
Specified by:
projectFast in interface IRasterGeometryProc3
Parameters:
pNewSR - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
resampleType - A com.esri.arcgis.geodatabase.rstResamplingTypes constant (in)
pCellsize - A Variant (in, optional, pass null if not required)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in, optional, pass null if not required)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

merge

public IRaster merge(String saveas_name,
                     IWorkspace ipWorkspace,
                     String outRasterFormat,
                     double cellSize,
                     ISpatialReference ipSR,
                     IRaster pRaster)
              throws IOException,
                     AutomationException
Merges the input rasters into a single dataset.

Remarks

Merge only work with single band images. It is recomended to use MosaicRaster object, which handles both single band and multiple band images,to perform merge operation.

The Merge method combines multiple adjacent single band raster datasets into a single output raster dataset. Merge determines the value of an overlapping output cell from the last NoData cell input of the input rasters.

The ipRaster is a Raster object that contains two or more bands, and the Merge operation combines all the bands of this raster into a single band raster dataset on disk.

Passing Nothing to the ipSR will result in an output with an unknown spatial reference.

The OutRasterFormat can only be one of the following formats. The format strings used for the supported formats are below, and they are case sensitive:

Format Name String Used
Imagine "IMAGINE Image"
TIFF "TIFF"
GRID "GRID"
JPEG "JPG"
JP2000 "JP2"
BMP "BMP"
PNG "PNG"
GIF "GIF"
PCI Raster "PIX"
USGS ASCII DEM "DEM"
X11 Pixmap "XPM"
PCRaster "MAP"
USGS ASCII DEM "DEM"
Memory Raster "MEM"
Geodatabase Raster "GDB"

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
merge in interface IRasterGeometryProc
Specified by:
merge in interface IRasterGeometryProc3
Parameters:
saveas_name - The saveas_name (in)
ipWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)
outRasterFormat - The outRasterFormat (in)
cellSize - The cellSize (in)
ipSR - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IRaster
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

mosaic

public IRaster mosaic(String saveas_name,
                      IWorkspace pWorkspace,
                      String outRasterFormat,
                      double cellSize,
                      ISpatialReference pSR,
                      IRaster pRaster)
               throws IOException,
                      AutomationException
Mosaics the input rasters into a single dataset.

Remarks

Mosaic only work with single band images. It is recomended to use MosaicRaster object, which handles both single band and multiple band images,to perform mosaic operation.

The Mosaic method combines multiple adjacent single band raster datasets into a single output raster dataset. Mosaic determines the value of an output call by averaging the values of the overlapping input cells.

The ipRaster is a Raster object that contains two or more raster bands, and the Mosaic operation combines all the bands of the raster into one single band raster dataset on disk.

Passing Nothing to the ipSR will result in an output with an unknown spatial reference.

The OutRasterFormat can only be one of the following formats. The format strings used for the supported formats are below, and they are case sensitive:

Format Name String Used
Imagine "IMAGINE Image"
TIFF "TIFF"
GRID "GRID"
JPEG "JPG"
JP2000 "JP2"
BMP "BMP"
PNG "PNG"
GIF "GIF"
PCI Raster "PIX"
USGS ASCII DEM "DEM"
X11 Pixmap "XPM"
PCRaster "MAP"
USGS ASCII DEM "DEM"
Memory Raster "MEM"
Geodatabase Raster "GDB"

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
mosaic in interface IRasterGeometryProc
Specified by:
mosaic in interface IRasterGeometryProc3
Parameters:
saveas_name - The saveas_name (in)
pWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)
outRasterFormat - The outRasterFormat (in)
cellSize - The cellSize (in)
pSR - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IRaster
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

resample

public void resample(int resampleType,
                     double newCellsize,
                     IRaster pRaster)
              throws IOException,
                     AutomationException
Resamples the input raster to a new cellsize.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
resample in interface IRasterGeometryProc
Specified by:
resample in interface IRasterGeometryProc3
Parameters:
resampleType - A com.esri.arcgis.geodatabase.rstResamplingTypes constant (in)
newCellsize - The newCellsize (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isPixelToMapTransSimple

public boolean isPixelToMapTransSimple(IRaster pRaster)
                                throws IOException,
                                       AutomationException
Indicates if the transformation of pixel to map is simple.

Product Availability

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

Specified by:
isPixelToMapTransSimple in interface IRasterGeometryProc
Specified by:
isPixelToMapTransSimple in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Returns:
The isSimple
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRasterXFormCount

public int getRasterXFormCount(IRaster pRaster,
                               int band)
                        throws IOException,
                               AutomationException
Gets the number of transformations.

Remarks

The GetRasterXFormCount method returns the number of geometric transformations on a specified raster band.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getRasterXFormCount in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
band - The band (in)
Returns:
The xFormCount
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRasterXFormOrderByIndex

public int getRasterXFormOrderByIndex(IRaster pRaster,
                                      int band,
                                      int index)
                               throws IOException,
                                      AutomationException
Gets the polynomial order of the indexed transformation.

Remarks

The GetRasterXFormOrderByIndex method returns the order of a specified geometric transformation on a raster band.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getRasterXFormOrderByIndex in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
band - The band (in)
index - The index (in)
Returns:
A com.esri.arcgis.datasourcesraster.esriGeoTransTypeEnum constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRasterXFormByIndex

public void getRasterXFormByIndex(IRaster pRaster,
                                  int band,
                                  boolean forward,
                                  int index,
                                  int[] order,
                                  Object[] pVar)
                           throws IOException,
                                  AutomationException
Gets the polynomial order and the polynomial coefficients of the indexed transformation.

Remarks

GetRasterXFormByIndex method returns the transformation coefficients and the order of transformation on a specified raster band. The transformation coefficients are returned as a variant, which is an n x 2 array where n varies with the transformation order. First order transformation returns a 3 x 2 array, second order and third order transformations return 6 x 2 and 10 x 2 arrays, respectively.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getRasterXFormByIndex in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
band - The band (in)
forward - The forward (in)
index - The index (in)
order - A com.esri.arcgis.datasourcesraster.esriGeoTransTypeEnum constant (in/out: use single element array)
pVar - A Variant (in/out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

putRasterXForm

public void putRasterXForm(IRaster pRaster,
                           boolean clean,
                           int order,
                           Object pVar)
                    throws IOException,
                           AutomationException
Sets a polynomial transformation to the Raster.

Remarks

The PutRasterXForm method appends a polynomial transformation to a raster. You can also clean the existing transformations on the raster by setting parameter clean to be true. Since calling this method does not automatically update the cell size and extent of the raster like other geometric operations (Shift, Rotate, etc.) do, Rectify or SaveAs will not persist the transformations to a raster dataset directly. Therefore, this method is not recommended for ourside developers.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
putRasterXForm in interface IRasterGeometryProc3
Parameters:
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
clean - The clean (in)
order - A com.esri.arcgis.datasourcesraster.esriGeoTransTypeEnum constant (in)
pVar - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

pointsMap2PixelTransform

public IPointCollection pointsMap2PixelTransform(IPointCollection pInPoints,
                                                 boolean isForward,
                                                 IRaster pRaster)
                                          throws IOException,
                                                 AutomationException
Performs the map to pixel transformation.

Remarks

The PointsMap2PixelTransform method takes all the transformations on a Raster, and then performs transformations between map space and pixel space. This method works better for rasters with square cell size.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
pointsMap2PixelTransform in interface IRasterGeometryProc3
Parameters:
pInPoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
isForward - The isForward (in)
pRaster - A reference to a com.esri.arcgis.geodatabase.IRaster (in)
Returns:
A reference to a com.esri.arcgis.geometry.IPointCollection
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws IOException,
                                       AutomationException
interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
interfaceSupportsErrorInfo in interface ISupportErrorInfo
Parameters:
riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.