com.esri.arcgis.geoprocessing.tools.cartographytools
Class CulDeSacMasks

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.cartographytools.CulDeSacMasks

All Implemented Interfaces:

GPTool

public class CulDeSacMasks
extends AbstractGPTool

Creates a feature class of polygon masks from a symbolized input line layer. This tool is specifically designed to provide line end masks in cases in which lines have been symbolized using a rounded end cap to smooth the transition of line connections. Rather than having lines end with a rounded end cap, the end of the line can be masked using the polygon feature class created with this tool. The Cul-De-Sac Masks tool is contained in the Cartography Tools tool box.

Software restrictions: ArcInfo only

Usage tips:

• This tool only accepts line layers as input.
• This tool only creates masks at the unconnected ends of lines in the input layer. These unconnected ends in the input layer are referred to as cul-de-sacs.
• A line end is considered connected if it shares its endpoint with the endpoint of another line.
• If the input line layer contains multipart line geometries, then cul-de-sac masks are created for all unconnected line ends, including the ends of parts within multipart lines.
• When creating masks, it is important to know that adding masks to maps adds complexity that will slow map drawing and affect map printing and exporting. Generally there are three things to consider when creating masks for a map: (1) the number of masks, (2) the complexity of the masks, and (3) whether the masks will be used to mask polygon features filled with marker or line symbols. An increase in the number of masks, having more complex masks, and/or masking against marker or polygon fill symbols will result in slower drawing on your screen. In addition, printing and exporting performance can be poor and even fail to produce valid output, first, because of the large amount of processing required to print and export maps with masks, and second, because of known limitations in how graphic file formats store map export results that have many complicated masks.
• Margin values are specified in either page units or map units. Most of the time you will want to specify your margin distance value in page units. Margin value units are interpreted differently depending on which units you choose. If you choose points, inches, millimeters, or centimeters, then masks are created using the margin distance as calculated in page space (you can think of the margin as a distance measured on the paper). The reference scale parameter value is accounted for in this calculation. If you choose any other units for your margin, then masks are created using the margin distance as calculated in map space (you can think of the margin as a real world distance measure on the earth). Also, in this case, the reference scale parameter value is not used as part of the calculation.
• Masks will be created if the margin distance is 0 or negative. A margin size of 0 will create a polygon that represents the exact shape of the symbolized feature. A negative margin will result in a polygon smaller than the symbolized feature. Generally, a margin value larger than 0 will be specified to produce the desired masking effect.
• The following environment settings affect this tool: referenceScale; cartographicCoordinateSystem;

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

CulDeSacMasks()
Creates the Cul-De-Sac Masks tool with defaults.

CulDeSacMasks(Object inputLayer, Object outputFc, double referenceScale, Object spatialReference, Object margin)
Creates the Cul-De-Sac Masks tool with the required parameters.

Method Summary

String	getAttributes() Returns the Transfer Attributes parameter of this tool .
Object	getInputLayer() Returns the Input Layer parameter of this tool .
Object	getMargin() Returns the Margin parameter of this tool .
Object	getOutputFc() Returns the Output Feature Class parameter of this tool .
double	getReferenceScale() Returns the Reference Scale parameter of this tool .
Object	getSpatialReference() Returns the Calculation coordinate system 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.
void	setAttributes(String attributes) Sets the Transfer Attributes parameter of this tool .
void	setInputLayer(Object inputLayer) Sets the Input Layer parameter of this tool .
void	setMargin(Object margin) Sets the Margin parameter of this tool .
void	setOutputFc(Object outputFc) Sets the Output Feature Class parameter of this tool .
void	setReferenceScale(double referenceScale) Sets the Reference Scale parameter of this tool .
void	setSpatialReference(Object spatialReference) Sets the Calculation coordinate system 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

CulDeSacMasks

public CulDeSacMasks()

Creates the Cul-De-Sac Masks tool with defaults.

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

CulDeSacMasks

public CulDeSacMasks(Object inputLayer,
                     Object outputFc,
                     double referenceScale,
                     Object spatialReference,
                     Object margin)

Creates the Cul-De-Sac Masks 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:

inputLayer - Layer, input line layer from which to create masks.

outputFc - Feature Class, the feature class that will contain the mask features.

referenceScale - Double, the reference scale used for calculating the masking geometry when masks are specified in page units. This is typically the reference scale of the map.

spatialReference - Spatial Reference, the spatial reference for which the masking polygons will be created. This is not the spatial reference that will be assigned to the output feature class. It is the spatial reference of the map in which the masking polygons will be used since the position of symbology may change when features are projected.

margin - Linear unit, if you choose any other units for your margin, then masks are created using the margin distance as calculated in map space (you can think of the margin as a real world distance measure on the earth). Also, in this case, the reference scale parameter value is not used as part of the calculation.

Method Detail

getInputLayer

public Object getInputLayer()

Returns the Input Layer parameter of this tool . This parameter is Layer, input line layer from which to create masks. This is a required parameter.

Returns:

the Input Layer

setInputLayer

public void setInputLayer(Object inputLayer)

Sets the Input Layer parameter of this tool . This parameter is Layer, input line layer from which to create masks. This is a required parameter.

Parameters:

inputLayer - Layer, input line layer from which to create masks.

getOutputFc

public Object getOutputFc()

Returns the Output Feature Class parameter of this tool . This parameter is Feature Class, the feature class that will contain the mask features. This is a required parameter.

Returns:

the Output Feature Class

setOutputFc

public void setOutputFc(Object outputFc)

Sets the Output Feature Class parameter of this tool . This parameter is Feature Class, the feature class that will contain the mask features. This is a required parameter.

Parameters:

outputFc - Feature Class, the feature class that will contain the mask features.

getReferenceScale

public double getReferenceScale()

Returns the Reference Scale parameter of this tool . This parameter is Double, the reference scale used for calculating the masking geometry when masks are specified in page units. This is typically the reference scale of the map. This is a required parameter.

Returns:

the Reference Scale

setReferenceScale

public void setReferenceScale(double referenceScale)

Sets the Reference Scale parameter of this tool . This parameter is Double, the reference scale used for calculating the masking geometry when masks are specified in page units. This is typically the reference scale of the map. This is a required parameter.

Parameters:

referenceScale - Double, the reference scale used for calculating the masking geometry when masks are specified in page units. This is typically the reference scale of the map.

getSpatialReference

public Object getSpatialReference()

Returns the Calculation coordinate system parameter of this tool . This parameter is Spatial Reference, the spatial reference for which the masking polygons will be created. This is not the spatial reference that will be assigned to the output feature class. It is the spatial reference of the map in which the masking polygons will be used since the position of symbology may change when features are projected. This is a required parameter.

Returns:

the Calculation coordinate system

setSpatialReference

public void setSpatialReference(Object spatialReference)

Sets the Calculation coordinate system parameter of this tool . This parameter is Spatial Reference, the spatial reference for which the masking polygons will be created. This is not the spatial reference that will be assigned to the output feature class. It is the spatial reference of the map in which the masking polygons will be used since the position of symbology may change when features are projected. This is a required parameter.

Parameters:

spatialReference - Spatial Reference, the spatial reference for which the masking polygons will be created. This is not the spatial reference that will be assigned to the output feature class. It is the spatial reference of the map in which the masking polygons will be used since the position of symbology may change when features are projected.

getMargin

public Object getMargin()

Returns the Margin parameter of this tool . This parameter is Linear unit, if you choose any other units for your margin, then masks are created using the margin distance as calculated in map space (you can think of the margin as a real world distance measure on the earth). Also, in this case, the reference scale parameter value is not used as part of the calculation. This is a required parameter.

Returns:

the Margin

setMargin

public void setMargin(Object margin)

Sets the Margin parameter of this tool . This parameter is Linear unit, if you choose any other units for your margin, then masks are created using the margin distance as calculated in map space (you can think of the margin as a real world distance measure on the earth). Also, in this case, the reference scale parameter value is not used as part of the calculation. This is a required parameter.

Parameters:

margin - Linear unit, if you choose any other units for your margin, then masks are created using the margin distance as calculated in map space (you can think of the margin as a real world distance measure on the earth). Also, in this case, the reference scale parameter value is not used as part of the calculation.

getAttributes

public String getAttributes()

Returns the Transfer Attributes parameter of this tool . This parameter is String, determines which attributes will be transferred from the input features to the output features. This is an optional parameter.

Returns:

the Transfer Attributes

setAttributes

public void setAttributes(String attributes)

Sets the Transfer Attributes parameter of this tool . This parameter is String, determines which attributes will be transferred from the input features to the output features. This is an optional parameter.

Parameters:

attributes - String, determines which attributes will be transferred from the input features to the output features.

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