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.
The Cul-De-Sac Masks tool is contained in the Cartography Tools tool box.
Usage tips:
- This tool only creates masks at the unconnected ends of lines (also called cul-de-sacs). A line end is considered connected if it shares its endpoint with the endpoint of another line. This tool only accepts line layers as input.
- 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.
- 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.
- 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.
Constructor Summary |
CulDeSacMasks()
Creates the Cul-De-Sac Masks tool with defaults. |
CulDeSacMasks(java.lang.Object inputLayer,
java.lang.Object outputFc,
double referenceScale,
java.lang.Object spatialReference,
java.lang.Object margin)
Creates the Cul-De-Sac Masks tool with the required parameters. |
Method Summary |
java.lang.String |
getAttributes()
Returns the Transfer Attributes parameter of this tool . |
java.lang.Object |
getInputLayer()
Returns the Input Layer parameter of this tool . |
java.lang.Object |
getMargin()
Returns the Margin parameter of this tool . |
java.lang.Object |
getOutputFc()
Returns the Output Feature Class parameter of this tool . |
double |
getReferenceScale()
Returns the Reference Scale parameter of this tool . |
java.lang.Object |
getSpatialReference()
Returns the Calculation coordinate system parameter of this tool . |
java.lang.String |
getToolboxAlias()
Returns the alias of the tool box containing this tool. |
java.lang.String |
getToolboxName()
Returns the name of the tool box containing this tool. |
java.lang.String |
getToolName()
Returns the name of this tool. |
void |
setAttributes(java.lang.String attributes)
Sets the Transfer Attributes parameter of this tool . |
void |
setInputLayer(java.lang.Object inputLayer)
Sets the Input Layer parameter of this tool . |
void |
setMargin(java.lang.Object margin)
Sets the Margin parameter of this tool . |
void |
setOutputFc(java.lang.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(java.lang.Object spatialReference)
Sets the Calculation coordinate system parameter of this tool . |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
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(java.lang.Object inputLayer,
java.lang.Object outputFc,
double referenceScale,
java.lang.Object spatialReference,
java.lang.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
- input line layer from which to create masks.outputFc
- the feature class that will contain the mask features.referenceScale
- 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
- 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
- the space in page units surrounding the symbolized input features used to create the mask polygon. Typically, masking polygons are created with a small margin around the symbol to improve visual appearance. 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.
getInputLayer
public java.lang.Object getInputLayer()
- Returns the Input Layer parameter of this tool .
This parameter is input line layer from which to create masks.
This is a required parameter.
- Returns:
- the Input Layer
setInputLayer
public void setInputLayer(java.lang.Object inputLayer)
- Sets the Input Layer parameter of this tool .
This parameter is input line layer from which to create masks.
This is a required parameter.
- Parameters:
inputLayer
- input line layer from which to create masks.
getOutputFc
public java.lang.Object getOutputFc()
- Returns the Output Feature Class parameter of this tool .
This parameter is the feature class that will contain the mask features.
This is a required parameter.
- Returns:
- the Output Feature Class
setOutputFc
public void setOutputFc(java.lang.Object outputFc)
- Sets the Output Feature Class parameter of this tool .
This parameter is the feature class that will contain the mask features.
This is a required parameter.
- Parameters:
outputFc
- the feature class that will contain the mask features.
getReferenceScale
public double getReferenceScale()
- Returns the Reference Scale parameter of this tool .
This parameter is 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 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
- 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 java.lang.Object getSpatialReference()
- Returns the Calculation coordinate system parameter of this tool .
This parameter is 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(java.lang.Object spatialReference)
- Sets the Calculation coordinate system parameter of this tool .
This parameter is 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
- 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 java.lang.Object getMargin()
- Returns the Margin parameter of this tool .
This parameter is the space in page units surrounding the symbolized input features used to create the mask polygon. Typically, masking polygons are created with a small margin around the symbol to improve visual appearance. 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.
This is a required parameter.
- Returns:
- the Margin
setMargin
public void setMargin(java.lang.Object margin)
- Sets the Margin parameter of this tool .
This parameter is the space in page units surrounding the symbolized input features used to create the mask polygon. Typically, masking polygons are created with a small margin around the symbol to improve visual appearance. 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.
This is a required parameter.
- Parameters:
margin
- the space in page units surrounding the symbolized input features used to create the mask polygon. Typically, masking polygons are created with a small margin around the symbol to improve visual appearance. 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.
getAttributes
public java.lang.String getAttributes()
- Returns the Transfer Attributes parameter of this tool .
This parameter is 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(java.lang.String attributes)
- Sets the Transfer Attributes parameter of this tool .
This parameter is determines which attributes will be transferred from the input features to the output features.
This is an optional parameter.
- Parameters:
attributes
- determines which attributes will be transferred from the input features to the output features.
getToolName
public java.lang.String getToolName()
- Returns the name of this tool.
- Returns:
- the tool name
getToolboxName
public java.lang.String getToolboxName()
- Returns the name of the tool box containing this tool.
- Returns:
- the tool box name
getToolboxAlias
public java.lang.String getToolboxAlias()
- Returns the alias of the tool box containing this tool.
- Returns:
- the tool box alias