Show Navigation | Hide Navigation
You are here:
Geoprocessing tool reference > Cartography toolbox > Masking toolset > Tools

Cul-de-Sac Masks (Cartography) (ArcInfo only)

Release 9.2
Last modified July 13, 2007
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

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.


Usage tips

Command line syntax
An overview of the Command Line window
CulDeSacMasks_cartography <input_layer> <output_fc> <reference_scale> <spatial_reference> <margin> {ONLY_FID | NO_FID | ALL}

Parameter Explanation Data Type
<input_layer>

Input line layer from which to create masks.

Layer
<output_fc>

The feature class that will contain the mask features.

Feature Class
<reference_scale>

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.

Double
<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.

Spatial Reference
<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.

Linear unit
{ONLY_FID | NO_FID | ALL}

Determines which attributes will be transferred from the input features to the output features.

  • ONLY_FID — Only the FID field from the input features will be transferred to the output features. This is the default.
  • NO_FID — All the attributes except the FID from the input features will be transferred to the output features.
  • ALL — All the attributes from the input features will be transferred to the output features.

String
Data types for geoprocessing tool parameters


Command line example

CulDeSacMasks_cartography d:\localroads.lyr d:\culdesacmasks.shp 1200 D:\utm17n.prj "2.0 Points" ONLY_FID

Scripting syntax
About getting started with writing geoprocessing scripts
CulDeSacMasks_cartography (input_layer, output_fc, reference_scale, spatial_reference, margin, attributes)

Parameter Explanation Data Type
input_layer (Required)

Input line layer from which to create masks.

Layer
output_fc (Required)

The feature class that will contain the mask features.

Feature Class
reference_scale (Required)

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.

Double
spatial_reference (Required)

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.

Spatial Reference
margin (Required)

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.

Linear unit
attributes (Optional)

Determines which attributes will be transferred from the input features to the output features.

  • ONLY_FID — Only the FID field from the input features will be transferred to the output features. This is the default.
  • NO_FID — All the attributes except the FID from the input features will be transferred to the output features.
  • ALL — All the attributes from the input features will be transferred to the output features.

String

Data types for geoprocessing tool parameters


Script example

import arcgisscripting
gp = arcgisscripting.create()

gp.workspace = "d:/"
gp.toolbox = "cartography"
gp.CulDeSacMasks("LocalRoads.lyr", "CulDeSacMasks.shp", "1200", "utm17N.prj" , "2.000000 Points", "ONLY_FID")

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.