com.esri.arcgis.carto
Class RasterDefaultsEnv

java.lang.Object
  extended by com.esri.arcgis.carto.RasterDefaultsEnv
All Implemented Interfaces:
IRasterDefaultsEnv, IRasterDefaultsEnv2, IRasterDefaultsEnv3, IRasterDefaultsEnv4, IRasterDefaultsEnv5, IRasterDefaultsEnv6, IRasterDefaultsEnv7, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class RasterDefaultsEnv
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IRasterDefaultsEnv, IRasterDefaultsEnv2, IRasterDefaultsEnv3, IRasterDefaultsEnv4, IRasterDefaultsEnv5, IRasterDefaultsEnv6, IRasterDefaultsEnv7

A container for default raster environmental variables.

Description

The RasterDefaultsEnv object allows you to customize raster default behavior in the ArcGIS user interface.

 

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Singleton:

This type is a singleton.

See Also:
Serialized Form

Constructor Summary
RasterDefaultsEnv()
          Constructs a RasterDefaultsEnv using ArcGIS Engine.
RasterDefaultsEnv(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
RasterDefaultsEnv theRasterDefaultsEnv = (RasterDefaultsEnv) obj;
 
Method Summary
 boolean equals(Object o)
          Compare this object with another
 IColor getBackgroundColor()
          The color of background.
static String getClsid()
          getClsid.
 IRasterFormatInfo getFormat(int i)
          Information about the format indicated by index i.
 double getGammaBlueValue()
          Gamma blue value.
 double getGammaGreenValue()
          Gamma green value.
 double getGammaRedValue()
          Gamma red value.
 int getMaximumBuildAttributeTableSize()
          The maximum attribute table size that can be built.
 int getMaximumRastersColorMatching()
          The maximum number of rasters for color matching.
 double getMaxPercent()
          The maximum (high) percent value.
 int getMaxTableSize()
          Default maximum table size.
 double getMinPercent()
          The minimum (low) percent value.
 IColor getNoDataColor()
          Nodata color for a raster layer.
 int getNumFormats()
          Number of supported raster formats.
 String getProxyFilePath()
          Default proxy file path.
 int getPyramidCreateOpt()
          Default pyramid creation option.
 int getRenderingMode()
          Default rendering mode.
 int getResampling()
          Default resampling for display.
 double getStandardDeviationsParam()
          Standard deviation parameter for the stretch renderer.
 int getStretchType()
          Indicate stretch type.
 int hashCode()
          the hashcode for this object
 boolean isAskSubdatasetSelection()
          Indicates if the subdataset selection dialog should pop up.
 boolean isAssumeHomogeneousCatalog()
          Indicates if raster catalogs can be assumed to be homogeneous.
 boolean isBoundarySubLayerIsVisible()
          Indicates if the boundary sub-layer of a mosaic layer is visible by default.
 boolean isCreateTiledTIFF()
          Indicates if newly created TIFF images should be tiled.
 boolean isDisplayBackground()
          Indicates if a background value is being used.
 boolean isDisplayWithContrastStretch()
          Indicates if displaying raster datasets with contrast stretching as default.
 boolean isFavorWorldFile()
          Indicates if the world file should overrides the raster dataset internal georeferencing.
 boolean isFootprintSubLayerIsVisible()
          Indicates if the footprint sub-layer of a mosaic layer is visible by default.
 boolean isMosaicLayerIsExpanded()
          Indicates if a mosaic layer should be expanded or collapsed by default.
 boolean isPreviewSubLayerIsVisible()
          Indicates if the preview sub-layer of a mosaic layer is visible by default.
 boolean isSeamlineSubLayerIsVisible()
          Indicates if the seamline sub-layer of a mosaic layer is visible by default.
 boolean isUseExtChecking()
          Indicates if extension checking is on.
 boolean isUseGamma()
          Indicates if Gamma stretch should be applied.
 void query3BandRGB(int[] redIndex, int[] greenIndex, int[] blueIndex)
          Default zero indexed bands for a 3 band raster.
 void query4BandRGB(int[] redIndex, int[] greenIndex, int[] blueIndex)
          Default zero indexed bands for a 4 or more band raster.
 void queryBackgroundValues(double[] pRed, double[] pGreen, double[] pBlue)
          background value.
 void set3BandRGB(int redIndex, int greenIndex, int blueIndex)
          Default zero indexed bands for a 3 band raster.
 void set4BandRGB(int redIndex, int greenIndex, int blueIndex)
          Default zero indexed bands for a 4 or more band raster.
 void setAskSubdatasetSelection(boolean pAsk)
          Indicates if the subdataset selection dialog should pop up.
 void setAssumeHomogeneousCatalog(boolean pHomogeneous)
          Indicates if raster catalogs can be assumed to be homogeneous.
 void setBackgroundColor(IColor ppColor)
          The color of background.
 void setBackgroundValues(double red, double green, double blue)
          background value.
 void setBoundarySubLayerIsVisible(boolean pIsVisible)
          Indicates if the boundary sub-layer of a mosaic layer is visible by default.
 void setCreateTiledTIFF(boolean pTiled)
          Indicates if newly created TIFF images should be tiled.
 void setDisplayBackground(boolean b)
          Indicates if a background value is being used.
 void setDisplayWithContrastStretch(boolean pStretch)
          Indicates if displaying raster datasets with contrast stretching as default.
 void setFavorWorldFile(boolean pFavor)
          Indicates if the world file should overrides the raster dataset internal georeferencing.
 void setFootprintSubLayerIsVisible(boolean pIsVisible)
          Indicates if the footprint sub-layer of a mosaic layer is visible by default.
 void setGammaBlueValue(double pBlueGamma)
          Gamma blue value.
 void setGammaGreenValue(double pGreenGamma)
          Gamma green value.
 void setGammaRedValue(double pRedGamma)
          Gamma red value.
 void setMaximumBuildAttributeTableSize(int pSize)
          The maximum attribute table size that can be built.
 void setMaximumRastersColorMatching(int pSize)
          The maximum number of rasters for color matching.
 void setMaxPercent(double pPercent)
          The maximum (high) percent value.
 void setMaxTableSize(int pMaxTableSize)
          Default maximum table size.
 void setMinPercent(double pPercent)
          The minimum (low) percent value.
 void setMosaicLayerIsExpanded(boolean pIsExpanded)
          Indicates if a mosaic layer should be expanded or collapsed by default.
 void setNoDataColor(IColor ppColor)
          Nodata color for a raster layer.
 void setPreviewSubLayerIsVisible(boolean pIsVisible)
          Indicates if the preview sub-layer of a mosaic layer is visible by default.
 void setProxyFilePath(String pProxyFilePath)
          Default proxy file path.
 void setPyramidCreateOpt(int opt)
          Default pyramid creation option.
 void setRenderingMode(int pRenderingMode)
          Default rendering mode.
 void setResampling(int pDefaultResampling)
          Default resampling for display.
 void setSeamlineSubLayerIsVisible(boolean pIsVisible)
          Indicates if the seamline sub-layer of a mosaic layer is visible by default.
 void setStandardDeviationsParam(double param)
          Standard deviation parameter for the stretch renderer.
 void setStretchType(int en_stretch)
          Indicate stretch type.
 void setUseExtChecking(boolean useExts)
          Indicates if extension checking is on.
 void setUseGamma(boolean pUseGamma)
          Indicates if Gamma stretch should be applied.
 void updateAll()
          Updates the registry with all changes to the raster environment in the current session.
 
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

RasterDefaultsEnv

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

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

RasterDefaultsEnv

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

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

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

getPyramidCreateOpt

public int getPyramidCreateOpt()
                        throws IOException,
                               AutomationException
Default pyramid creation option.

Description

The PyramidCreateOpt property is used to set the pyramid options for displaying a large raster dataset, which has a dimension greater than 1024 and does not have pyramids, in ArcCatalog or ArcMap.
Pyramids is used to enhance display performance. For displaying raster datasets that do not have pyramids, ArcMap provides the following options: always build pyramids, never build pyramids, prompt a dialog box asking to build or not.
This method does not control pyramid building when you save as a raster dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getPyramidCreateOpt in interface IRasterDefaultsEnv
Returns:
A com.esri.arcgis.carto.esriRasterPyramidOptEnum constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPyramidCreateOpt

public void setPyramidCreateOpt(int opt)
                         throws IOException,
                                AutomationException
Default pyramid creation option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setPyramidCreateOpt in interface IRasterDefaultsEnv
Parameters:
opt - A com.esri.arcgis.carto.esriRasterPyramidOptEnum constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

query3BandRGB

public void query3BandRGB(int[] redIndex,
                          int[] greenIndex,
                          int[] blueIndex)
                   throws IOException,
                          AutomationException
Default zero indexed bands for a 3 band raster.

Remarks

The Query3BandRGB, Query4BandRGB, Set3BandRGB, and Set4BandRGB methods allow you to view or set the default band combinations used to display rasters with three or more bands. The indices set for these defaults will populate the red, green, and blue channels of the RGB renderer when a raster is initially displayed.

The Query3BandRGB and Set3BandRGB methods apply only to three band rasters, while the Query4BandRGB and Set4BandRGB methods apply to all rasters containing four or more bands.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
query3BandRGB in interface IRasterDefaultsEnv
Parameters:
redIndex - The redIndex (out: use single element array)
greenIndex - The greenIndex (out: use single element array)
blueIndex - The blueIndex (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

set3BandRGB

public void set3BandRGB(int redIndex,
                        int greenIndex,
                        int blueIndex)
                 throws IOException,
                        AutomationException
Default zero indexed bands for a 3 band raster.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
set3BandRGB in interface IRasterDefaultsEnv
Parameters:
redIndex - The redIndex (in)
greenIndex - The greenIndex (in)
blueIndex - The blueIndex (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

query4BandRGB

public void query4BandRGB(int[] redIndex,
                          int[] greenIndex,
                          int[] blueIndex)
                   throws IOException,
                          AutomationException
Default zero indexed bands for a 4 or more band raster.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
query4BandRGB in interface IRasterDefaultsEnv
Parameters:
redIndex - The redIndex (out: use single element array)
greenIndex - The greenIndex (out: use single element array)
blueIndex - The blueIndex (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

set4BandRGB

public void set4BandRGB(int redIndex,
                        int greenIndex,
                        int blueIndex)
                 throws IOException,
                        AutomationException
Default zero indexed bands for a 4 or more band raster.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
set4BandRGB in interface IRasterDefaultsEnv
Parameters:
redIndex - The redIndex (in)
greenIndex - The greenIndex (in)
blueIndex - The blueIndex (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isUseExtChecking

public boolean isUseExtChecking()
                         throws IOException,
                                AutomationException
Indicates if extension checking is on.

Description

This method is used to specify whether using file extension checking or not when you browse file based raster data such as .img, .tif, and jp2 etc.

Using file extension checking (true) is faster in browsing raster datasets, and this is the default.

Remarks

The UseExtChecking property specifies how ArcCatalog and the GxBrowser search for raster datasets. A True value for extension checking means that files or folders will be identified as raster datasets only if their extension matches the list of supported raster format extensions. A False value means that all files and folders will be opened to determine whether they are a raster dataset in any of the supported raster formats. This is more reliable but is much slower than extension checking only. Extension checking only is the default.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isUseExtChecking in interface IRasterDefaultsEnv
Returns:
The useExts
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setUseExtChecking

public void setUseExtChecking(boolean useExts)
                       throws IOException,
                              AutomationException
Indicates if extension checking is on.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setUseExtChecking in interface IRasterDefaultsEnv
Parameters:
useExts - The useExts (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getNumFormats

public int getNumFormats()
                  throws IOException,
                         AutomationException
Number of supported raster formats.

Remarks

The NumFormats property returns the number of supported raster formats, and the Format method returns a RasterFormatInfo object specific to one raster format, which can specify default properties for that format.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getNumFormats in interface IRasterDefaultsEnv
Returns:
The pNumFormats
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFormat

public IRasterFormatInfo getFormat(int i)
                            throws IOException,
                                   AutomationException
Information about the format indicated by index i.

Product Availability

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

Specified by:
getFormat in interface IRasterDefaultsEnv
Parameters:
i - The i (in)
Returns:
A reference to a com.esri.arcgis.carto.IRasterFormatInfo
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setRenderingMode

public void setRenderingMode(int pRenderingMode)
                      throws IOException,
                             AutomationException
Default rendering mode.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setRenderingMode in interface IRasterDefaultsEnv2
Parameters:
pRenderingMode - A com.esri.arcgis.carto.esriRasterRenderingModeEnum constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRenderingMode

public int getRenderingMode()
                     throws IOException,
                            AutomationException
Default rendering mode.

Description

The RenderingMode property specifies the drawing mode used when displaying a raster dataset. The full option waits until the entire raster has been drawn to a backing store, then displays it to the screen at once.

Block mode draws the raster one block at a time, starting at the upper left and progressing left to right and then down. Top-to-bottom mode begins at the top and draws a few lines at a time as it progresses down the screen.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getRenderingMode in interface IRasterDefaultsEnv2
Returns:
A com.esri.arcgis.carto.esriRasterRenderingModeEnum constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setResampling

public void setResampling(int pDefaultResampling)
                   throws IOException,
                          AutomationException
Default resampling for display.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setResampling in interface IRasterDefaultsEnv2
Parameters:
pDefaultResampling - A com.esri.arcgis.geodatabase.rstResamplingTypes constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getResampling

public int getResampling()
                  throws IOException,
                         AutomationException
Default resampling for display.

Description

The Resampling property controls the default resampling technique used when a raster is first displayed. Single-band rasters are displayed using the stretched renderer or unique value renderer by default.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getResampling in interface IRasterDefaultsEnv2
Returns:
A com.esri.arcgis.geodatabase.rstResamplingTypes constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setProxyFilePath

public void setProxyFilePath(String pProxyFilePath)
                      throws IOException,
                             AutomationException
Default proxy file path.

Remarks

The ProxyFilePath property controls the directory location where these proxy files, as well as any auxiliary or pyramid files for these datasets, are located. This property can only be set by users with Administrator access to their computer. The rest of these properties control the appearance of raster datasets when first viewed in ArcGIS.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setProxyFilePath in interface IRasterDefaultsEnv2
Parameters:
pProxyFilePath - The pProxyFilePath (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getProxyFilePath

public String getProxyFilePath()
                        throws IOException,
                               AutomationException
Default proxy file path.

Remarks

This method is used to set the path for proxy files, e.g. files generated in the local proxy folder when accessing read only raster datasets. This applies to ArcGIS 9.1 and older version only.

ArcGIS 9.2 always use Windows system default temp folder for writting proxy files.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getProxyFilePath in interface IRasterDefaultsEnv2
Returns:
The pProxyFilePath
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMaxTableSize

public void setMaxTableSize(int pMaxTableSize)
                     throws IOException,
                            AutomationException
Default maximum table size.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setMaxTableSize in interface IRasterDefaultsEnv2
Parameters:
pMaxTableSize - The pMaxTableSize (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaxTableSize

public int getMaxTableSize()
                    throws IOException,
                           AutomationException
Default maximum table size.

Remarks

If a dataset has more entries in its table then the MaxTableSize property, it will be displayed by default using the stretched renderer. A dataset with fewer unique values than this threshold will display using the unique value renderer. This value is 25 by default.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getMaxTableSize in interface IRasterDefaultsEnv2
Returns:
The pMaxTableSize
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

updateAll

public void updateAll()
               throws IOException,
                      AutomationException
Updates the registry with all changes to the raster environment in the current session.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
updateAll in interface IRasterDefaultsEnv2
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMaximumBuildAttributeTableSize

public void setMaximumBuildAttributeTableSize(int pSize)
                                       throws IOException,
                                              AutomationException
The maximum attribute table size that can be built.

Product Availability

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

Specified by:
setMaximumBuildAttributeTableSize in interface IRasterDefaultsEnv3
Parameters:
pSize - The pSize (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaximumBuildAttributeTableSize

public int getMaximumBuildAttributeTableSize()
                                      throws IOException,
                                             AutomationException
The maximum attribute table size that can be built.

Remarks

This property specifies the maximum limit for building a raster attribute table. The default is 65536.

Product Availability

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

Specified by:
getMaximumBuildAttributeTableSize in interface IRasterDefaultsEnv3
Returns:
The pSize
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFavorWorldFile

public void setFavorWorldFile(boolean pFavor)
                       throws IOException,
                              AutomationException
Indicates if the world file should overrides the raster dataset internal georeferencing.

Product Availability

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

Specified by:
setFavorWorldFile in interface IRasterDefaultsEnv3
Parameters:
pFavor - The pFavor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isFavorWorldFile

public boolean isFavorWorldFile()
                         throws IOException,
                                AutomationException
Indicates if the world file should overrides the raster dataset internal georeferencing.

Remarks

By default (returns as false), ArcGIS will read the internal spatial reference (map extent or projection info) of a raster dataset. If you want ArcGIS reads the world file of the raster dataset, set it to be true.

Product Availability

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

Specified by:
isFavorWorldFile in interface IRasterDefaultsEnv3
Returns:
The pFavor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isAssumeHomogeneousCatalog

public boolean isAssumeHomogeneousCatalog()
                                   throws IOException,
                                          AutomationException
Indicates if raster catalogs can be assumed to be homogeneous.

Product Availability

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

Specified by:
isAssumeHomogeneousCatalog in interface IRasterDefaultsEnv3
Returns:
The pHomogeneous
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAssumeHomogeneousCatalog

public void setAssumeHomogeneousCatalog(boolean pHomogeneous)
                                 throws IOException,
                                        AutomationException
Indicates if raster catalogs can be assumed to be homogeneous.

Product Availability

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

Specified by:
setAssumeHomogeneousCatalog in interface IRasterDefaultsEnv3
Parameters:
pHomogeneous - The pHomogeneous (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAskSubdatasetSelection

public void setAskSubdatasetSelection(boolean pAsk)
                               throws IOException,
                                      AutomationException
Indicates if the subdataset selection dialog should pop up.

Product Availability

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

Specified by:
setAskSubdatasetSelection in interface IRasterDefaultsEnv4
Parameters:
pAsk - The pAsk (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isAskSubdatasetSelection

public boolean isAskSubdatasetSelection()
                                 throws IOException,
                                        AutomationException
Indicates if the subdataset selection dialog should pop up.

Product Availability

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

Specified by:
isAskSubdatasetSelection in interface IRasterDefaultsEnv4
Returns:
The pAsk
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDisplayWithContrastStretch

public void setDisplayWithContrastStretch(boolean pStretch)
                                   throws IOException,
                                          AutomationException
Indicates if displaying raster datasets with contrast stretching as default.

Product Availability

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

Specified by:
setDisplayWithContrastStretch in interface IRasterDefaultsEnv4
Parameters:
pStretch - The pStretch (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isDisplayWithContrastStretch

public boolean isDisplayWithContrastStretch()
                                     throws IOException,
                                            AutomationException
Indicates if displaying raster datasets with contrast stretching as default.

Product Availability

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

Specified by:
isDisplayWithContrastStretch in interface IRasterDefaultsEnv4
Returns:
The pStretch
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMaximumRastersColorMatching

public void setMaximumRastersColorMatching(int pSize)
                                    throws IOException,
                                           AutomationException
The maximum number of rasters for color matching.

Product Availability

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

Specified by:
setMaximumRastersColorMatching in interface IRasterDefaultsEnv4
Parameters:
pSize - The pSize (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaximumRastersColorMatching

public int getMaximumRastersColorMatching()
                                   throws IOException,
                                          AutomationException
The maximum number of rasters for color matching.

Product Availability

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

Specified by:
getMaximumRastersColorMatching in interface IRasterDefaultsEnv4
Returns:
The pSize
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDisplayBackground

public void setDisplayBackground(boolean b)
                          throws IOException,
                                 AutomationException
Indicates if a background value is being used.

Product Availability

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

Specified by:
setDisplayBackground in interface IRasterDefaultsEnv5
Parameters:
b - The b (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isDisplayBackground

public boolean isDisplayBackground()
                            throws IOException,
                                   AutomationException
Indicates if a background value is being used.

Product Availability

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

Specified by:
isDisplayBackground in interface IRasterDefaultsEnv5
Returns:
The b
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryBackgroundValues

public void queryBackgroundValues(double[] pRed,
                                  double[] pGreen,
                                  double[] pBlue)
                           throws IOException,
                                  AutomationException
background value.

Product Availability

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

Specified by:
queryBackgroundValues in interface IRasterDefaultsEnv5
Parameters:
pRed - The pRed (out: use single element array)
pGreen - The pGreen (out: use single element array)
pBlue - The pBlue (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setBackgroundValues

public void setBackgroundValues(double red,
                                double green,
                                double blue)
                         throws IOException,
                                AutomationException
background value.

Product Availability

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

Specified by:
setBackgroundValues in interface IRasterDefaultsEnv5
Parameters:
red - The red (in)
green - The green (in)
blue - The blue (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getBackgroundColor

public IColor getBackgroundColor()
                          throws IOException,
                                 AutomationException
The color of background.

Product Availability

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

Specified by:
getBackgroundColor in interface IRasterDefaultsEnv5
Returns:
A reference to a com.esri.arcgis.display.IColor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setBackgroundColor

public void setBackgroundColor(IColor ppColor)
                        throws IOException,
                               AutomationException
The color of background.

Product Availability

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

Specified by:
setBackgroundColor in interface IRasterDefaultsEnv5
Parameters:
ppColor - A reference to a com.esri.arcgis.display.IColor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getNoDataColor

public IColor getNoDataColor()
                      throws IOException,
                             AutomationException
Nodata color for a raster layer.

Product Availability

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

Specified by:
getNoDataColor in interface IRasterDefaultsEnv5
Returns:
A reference to a com.esri.arcgis.display.IColor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setNoDataColor

public void setNoDataColor(IColor ppColor)
                    throws IOException,
                           AutomationException
Nodata color for a raster layer.

Product Availability

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

Specified by:
setNoDataColor in interface IRasterDefaultsEnv5
Parameters:
ppColor - A reference to a com.esri.arcgis.display.IColor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isCreateTiledTIFF

public boolean isCreateTiledTIFF()
                          throws IOException,
                                 AutomationException
Indicates if newly created TIFF images should be tiled.

Product Availability

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

Specified by:
isCreateTiledTIFF in interface IRasterDefaultsEnv5
Returns:
The pTiled
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCreateTiledTIFF

public void setCreateTiledTIFF(boolean pTiled)
                        throws IOException,
                               AutomationException
Indicates if newly created TIFF images should be tiled.

Product Availability

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

Specified by:
setCreateTiledTIFF in interface IRasterDefaultsEnv5
Parameters:
pTiled - The pTiled (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMosaicLayerIsExpanded

public void setMosaicLayerIsExpanded(boolean pIsExpanded)
                              throws IOException,
                                     AutomationException
Indicates if a mosaic layer should be expanded or collapsed by default.

Product Availability

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

Specified by:
setMosaicLayerIsExpanded in interface IRasterDefaultsEnv6
Parameters:
pIsExpanded - The pIsExpanded (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isMosaicLayerIsExpanded

public boolean isMosaicLayerIsExpanded()
                                throws IOException,
                                       AutomationException
Indicates if a mosaic layer should be expanded or collapsed by default.

Product Availability

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

Specified by:
isMosaicLayerIsExpanded in interface IRasterDefaultsEnv6
Returns:
The pIsExpanded
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setBoundarySubLayerIsVisible

public void setBoundarySubLayerIsVisible(boolean pIsVisible)
                                  throws IOException,
                                         AutomationException
Indicates if the boundary sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
setBoundarySubLayerIsVisible in interface IRasterDefaultsEnv6
Parameters:
pIsVisible - The pIsVisible (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isBoundarySubLayerIsVisible

public boolean isBoundarySubLayerIsVisible()
                                    throws IOException,
                                           AutomationException
Indicates if the boundary sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
isBoundarySubLayerIsVisible in interface IRasterDefaultsEnv6
Returns:
The pIsVisible
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFootprintSubLayerIsVisible

public void setFootprintSubLayerIsVisible(boolean pIsVisible)
                                   throws IOException,
                                          AutomationException
Indicates if the footprint sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
setFootprintSubLayerIsVisible in interface IRasterDefaultsEnv6
Parameters:
pIsVisible - The pIsVisible (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isFootprintSubLayerIsVisible

public boolean isFootprintSubLayerIsVisible()
                                     throws IOException,
                                            AutomationException
Indicates if the footprint sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
isFootprintSubLayerIsVisible in interface IRasterDefaultsEnv6
Returns:
The pIsVisible
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPreviewSubLayerIsVisible

public void setPreviewSubLayerIsVisible(boolean pIsVisible)
                                 throws IOException,
                                        AutomationException
Indicates if the preview sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
setPreviewSubLayerIsVisible in interface IRasterDefaultsEnv6
Parameters:
pIsVisible - The pIsVisible (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isPreviewSubLayerIsVisible

public boolean isPreviewSubLayerIsVisible()
                                   throws IOException,
                                          AutomationException
Indicates if the preview sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
isPreviewSubLayerIsVisible in interface IRasterDefaultsEnv6
Returns:
The pIsVisible
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSeamlineSubLayerIsVisible

public void setSeamlineSubLayerIsVisible(boolean pIsVisible)
                                  throws IOException,
                                         AutomationException
Indicates if the seamline sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
setSeamlineSubLayerIsVisible in interface IRasterDefaultsEnv6
Parameters:
pIsVisible - The pIsVisible (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isSeamlineSubLayerIsVisible

public boolean isSeamlineSubLayerIsVisible()
                                    throws IOException,
                                           AutomationException
Indicates if the seamline sub-layer of a mosaic layer is visible by default.

Product Availability

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

Specified by:
isSeamlineSubLayerIsVisible in interface IRasterDefaultsEnv6
Returns:
The pIsVisible
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setStretchType

public void setStretchType(int en_stretch)
                    throws IOException,
                           AutomationException
Indicate stretch type.

Product Availability

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

Specified by:
setStretchType in interface IRasterDefaultsEnv7
Parameters:
en_stretch - A com.esri.arcgis.carto.esriRasterStretchTypesEnum constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getStretchType

public int getStretchType()
                   throws IOException,
                          AutomationException
Indicate stretch type.

Product Availability

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

Specified by:
getStretchType in interface IRasterDefaultsEnv7
Returns:
A com.esri.arcgis.carto.esriRasterStretchTypesEnum constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setStandardDeviationsParam

public void setStandardDeviationsParam(double param)
                                throws IOException,
                                       AutomationException
Standard deviation parameter for the stretch renderer.

Product Availability

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

Specified by:
setStandardDeviationsParam in interface IRasterDefaultsEnv7
Parameters:
param - The param (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getStandardDeviationsParam

public double getStandardDeviationsParam()
                                  throws IOException,
                                         AutomationException
Standard deviation parameter for the stretch renderer.

Product Availability

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

Specified by:
getStandardDeviationsParam in interface IRasterDefaultsEnv7
Returns:
The param
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setUseGamma

public void setUseGamma(boolean pUseGamma)
                 throws IOException,
                        AutomationException
Indicates if Gamma stretch should be applied.

Product Availability

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

Specified by:
setUseGamma in interface IRasterDefaultsEnv7
Parameters:
pUseGamma - The pUseGamma (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isUseGamma

public boolean isUseGamma()
                   throws IOException,
                          AutomationException
Indicates if Gamma stretch should be applied.

Product Availability

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

Specified by:
isUseGamma in interface IRasterDefaultsEnv7
Returns:
The pUseGamma
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setGammaRedValue

public void setGammaRedValue(double pRedGamma)
                      throws IOException,
                             AutomationException
Gamma red value.

Product Availability

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

Specified by:
setGammaRedValue in interface IRasterDefaultsEnv7
Parameters:
pRedGamma - The pRedGamma (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getGammaRedValue

public double getGammaRedValue()
                        throws IOException,
                               AutomationException
Gamma red value.

Product Availability

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

Specified by:
getGammaRedValue in interface IRasterDefaultsEnv7
Returns:
The pRedGamma
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setGammaGreenValue

public void setGammaGreenValue(double pGreenGamma)
                        throws IOException,
                               AutomationException
Gamma green value.

Product Availability

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

Specified by:
setGammaGreenValue in interface IRasterDefaultsEnv7
Parameters:
pGreenGamma - The pGreenGamma (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getGammaGreenValue

public double getGammaGreenValue()
                          throws IOException,
                                 AutomationException
Gamma green value.

Product Availability

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

Specified by:
getGammaGreenValue in interface IRasterDefaultsEnv7
Returns:
The pGreenGamma
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setGammaBlueValue

public void setGammaBlueValue(double pBlueGamma)
                       throws IOException,
                              AutomationException
Gamma blue value.

Product Availability

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

Specified by:
setGammaBlueValue in interface IRasterDefaultsEnv7
Parameters:
pBlueGamma - The pBlueGamma (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getGammaBlueValue

public double getGammaBlueValue()
                         throws IOException,
                                AutomationException
Gamma blue value.

Product Availability

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

Specified by:
getGammaBlueValue in interface IRasterDefaultsEnv7
Returns:
The pBlueGamma
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMinPercent

public void setMinPercent(double pPercent)
                   throws IOException,
                          AutomationException
The minimum (low) percent value.

Product Availability

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

Specified by:
setMinPercent in interface IRasterDefaultsEnv7
Parameters:
pPercent - The pPercent (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMinPercent

public double getMinPercent()
                     throws IOException,
                            AutomationException
The minimum (low) percent value.

Product Availability

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

Specified by:
getMinPercent in interface IRasterDefaultsEnv7
Returns:
The pPercent
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMaxPercent

public void setMaxPercent(double pPercent)
                   throws IOException,
                          AutomationException
The maximum (high) percent value.

Product Availability

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

Specified by:
setMaxPercent in interface IRasterDefaultsEnv7
Parameters:
pPercent - The pPercent (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaxPercent

public double getMaxPercent()
                     throws IOException,
                            AutomationException
The maximum (high) percent value.

Product Availability

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

Specified by:
getMaxPercent in interface IRasterDefaultsEnv7
Returns:
The pPercent
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.