com.esri.arcgis.geoprocessing.tools.analyst3dtools
Class HillShade

java.lang.Object
  extended by com.esri.arcgis.geoprocessing.AbstractGPTool
      extended by com.esri.arcgis.geoprocessing.tools.analyst3dtools.HillShade
All Implemented Interfaces:
GPTool

public class HillShade
extends AbstractGPTool

Creates a shaded relief from a surface raster by considering the illumination source angle and shadows. The Hillshade tool is contained in the 3D Analyst Tools tool box.

Usage tips:


Field Summary
 
Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool
vals
 
Constructor Summary
HillShade()
          Creates the Hillshade tool with defaults.
HillShade(Object inRaster, Object outRaster)
          Creates the Hillshade tool with the required parameters.
 
Method Summary
 double getAltitude()
          Returns the Altitude parameter of this tool .
 double getAzimuth()
          Returns the Azimuth parameter of this tool .
 Object getInRaster()
          Returns the Input raster parameter of this tool .
 String getModelShadows()
          Returns the Model shadows parameter of this tool .
 Object getOutRaster()
          Returns the Output raster parameter of this tool .
 String getToolboxAlias()
          Returns the alias of the tool box containing this tool.
 String getToolboxName()
          Returns the name of the tool box containing this tool.
 String getToolName()
          Returns the name of this tool.
 double getZFactor()
          Returns the Z factor parameter of this tool .
 void setAltitude(double altitude)
          Sets the Altitude parameter of this tool .
 void setAzimuth(double azimuth)
          Sets the Azimuth parameter of this tool .
 void setInRaster(Object inRaster)
          Sets the Input raster parameter of this tool .
 void setModelShadows(String modelShadows)
          Sets the Model shadows parameter of this tool .
 void setOutRaster(Object outRaster)
          Sets the Output raster parameter of this tool .
 void setZFactor(double zFactor)
          Sets the Z factor parameter of this tool .
 
Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool
getParameterValues, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

HillShade

public HillShade()
Creates the Hillshade tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.


HillShade

public HillShade(Object inRaster,
                 Object outRaster)
Creates the Hillshade tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:
inRaster - the input surface raster.
outRaster - the output hillshade raster. the hillshade raster has an integer value range of 0 to 255.
Method Detail

getInRaster

public Object getInRaster()
Returns the Input raster parameter of this tool . This parameter is the input surface raster. This is a required parameter.

Returns:
the Input raster

setInRaster

public void setInRaster(Object inRaster)
Sets the Input raster parameter of this tool . This parameter is the input surface raster. This is a required parameter.

Parameters:
inRaster - the input surface raster.

getOutRaster

public Object getOutRaster()
Returns the Output raster parameter of this tool . This parameter is the output hillshade raster. the hillshade raster has an integer value range of 0 to 255. This is a required parameter.

Returns:
the Output raster

setOutRaster

public void setOutRaster(Object outRaster)
Sets the Output raster parameter of this tool . This parameter is the output hillshade raster. the hillshade raster has an integer value range of 0 to 255. This is a required parameter.

Parameters:
outRaster - the output hillshade raster. the hillshade raster has an integer value range of 0 to 255.

getAzimuth

public double getAzimuth()
Returns the Azimuth parameter of this tool . This parameter is azimuth angle of the light source. the azimuth is expressed in positive degrees from 0 to 360, measured clockwise from north. the default is 315 degrees. This is an optional parameter.

Returns:
the Azimuth

setAzimuth

public void setAzimuth(double azimuth)
Sets the Azimuth parameter of this tool . This parameter is azimuth angle of the light source. the azimuth is expressed in positive degrees from 0 to 360, measured clockwise from north. the default is 315 degrees. This is an optional parameter.

Parameters:
azimuth - azimuth angle of the light source. the azimuth is expressed in positive degrees from 0 to 360, measured clockwise from north. the default is 315 degrees.

getAltitude

public double getAltitude()
Returns the Altitude parameter of this tool . This parameter is altitude angle of the light source above the horizon. the altitude is expressed in positive degrees, with 0 degrees at the horizon and 90 degrees directly overhead. the default is 45 degrees. This is an optional parameter.

Returns:
the Altitude

setAltitude

public void setAltitude(double altitude)
Sets the Altitude parameter of this tool . This parameter is altitude angle of the light source above the horizon. the altitude is expressed in positive degrees, with 0 degrees at the horizon and 90 degrees directly overhead. the default is 45 degrees. This is an optional parameter.

Parameters:
altitude - altitude angle of the light source above the horizon. the altitude is expressed in positive degrees, with 0 degrees at the horizon and 90 degrees directly overhead. the default is 45 degrees.

getModelShadows

public String getModelShadows()
Returns the Model shadows parameter of this tool . This parameter is type of shaded relief to be generated. This is an optional parameter.

Returns:
the Model shadows

setModelShadows

public void setModelShadows(String modelShadows)
Sets the Model shadows parameter of this tool . This parameter is type of shaded relief to be generated. This is an optional parameter.

Parameters:
modelShadows - type of shaded relief to be generated.

getZFactor

public double getZFactor()
Returns the Z factor parameter of this tool . This parameter is number of ground x,y units in one surface z unit. the z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. if the x,y units and z units are in the same units of measure, the z-factor is 1. This is the default. if the x,y units and z units are in different units of measure, the z-factor must be set to the appropriate factor, or the results will be incorrect. For example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). This is an optional parameter.

Returns:
the Z factor

setZFactor

public void setZFactor(double zFactor)
Sets the Z factor parameter of this tool . This parameter is number of ground x,y units in one surface z unit. the z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. if the x,y units and z units are in the same units of measure, the z-factor is 1. This is the default. if the x,y units and z units are in different units of measure, the z-factor must be set to the appropriate factor, or the results will be incorrect. For example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). This is an optional parameter.

Parameters:
zFactor - number of ground x,y units in one surface z unit. the z-factor adjusts the units of measure for the z units when they are different from the x,y units of the input surface. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. if the x,y units and z units are in the same units of measure, the z-factor is 1. This is the default. if the x,y units and z units are in different units of measure, the z-factor must be set to the appropriate factor, or the results will be incorrect. For example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter).

getToolName

public String getToolName()
Returns the name of this tool.

Returns:
the tool name

getToolboxName

public String getToolboxName()
Returns the name of the tool box containing this tool.

Returns:
the tool box name

getToolboxAlias

public String getToolboxAlias()
Returns the alias of the tool box containing this tool.

Returns:
the tool box alias