ライン キャップの計算 (Calculate Line Caps) (カートグラフィ)

サマリー

入力レイヤーのライン シンボルで、ストローク シンボル レイヤーのキャップの種類を変更します。

ライン キャップの計算ツールの例
正方形またはバットのキャップが、袋小路に適用され、二条線ラインの道路が緑色の単一ラインの道路に接続するオプションを表示します。

使用法

  • [入力フィーチャ] パラメーターの値をシンボル表示するストローク シンボル レイヤーでは、式を適用せずに、[キャップの種類] プロパティを属性フィールドに接続する必要があります。 このフィールドの値は、このツールによって更新されます。

  • 比較的に幅広で、複数のストローク シンボル レイヤーを用いて描画することによって「道路 2 条線」効果を表すライン シンボルは多くの場合、フィーチャ間の鋭角にシンボル ギャップが出現するのを防ぐ目的から、終端部で連結し、ライン キャップの終端部が角丸になります。 ただし、角丸の端点キャップは、(ダングル ライン フィーチャがエンドポイント部分で別のフィーチャに連結されない) 袋小路のカートグラフィックス表現としては一般に望ましくありません。このような状況では、ライン キャップ スタイルがバット スタイルまたは矩形スタイルにオーバーライドされることがよくあります。 このツールはダングルを検出し、ストローク シンボル レイヤーのキャップの種類を無効にします。

  • ライン フィーチャの 1 つの端点キャップのみを変更することはできません。 ライン フィーチャに終端がある場合、このツールは、ラインが他のラインと接続されている方法に関係なく、両方の端点キャップを変更します。 確実に正しい端点キャップが更新されるようにするには、すべての真の交点でライン フィーチャを分割します。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

ライン シンボルを格納する入力フィーチャ レイヤー。 ストローク シンボル レイヤーでは、式を適用せずに、[キャップの種類] プロパティを 1 つの属性フィールドに接続する必要があります。 このフィールドの値は、このツールによって更新されます。

Layer
キャップの種類
(オプション)

ストローク シンボル レイヤーの終端部の描画方法を指定します。 ストロークのデフォルトのキャップの種類は角丸です。この場合、シンボルは、ストローク幅に等しい半径の半円で終了し、ラインの終端部で中央揃えにされます。

  • バットストローク シンボルが正確にライン ジオメトリの終端部で終了します。 これがデフォルトです。
  • 四角ストローク シンボルが、閉じた矩形キャップで終了します。この矩形キャップは、ライン端点からシンボル幅の半分だけ突き出しています。
String
ダングル オプション
(オプション)

隣接したライン フィーチャ同士 (それぞれが端点を共有しながら、別々のシンボルで描画されている場合) に対するライン キャップの計算方法を指定します。

  • 二条線ライン ダングル端点で別のラインに接続していないダングル ラインのほか、二条線ライン シンボルがシングルストローク レイヤーのライン シンボルの端点で連結しているラインのキャップ スタイルを変更します。 これがデフォルトです。
  • トゥルー ダングル別のフィーチャに接続されていない端点のみでキャップ スタイルを変更します。
String

派生した出力

ラベル説明データ タイプ
更新された入力フィーチャ

更新された入力ライン フィーチャ レイヤー。

Layer

arcpy.cartography.CalculateLineCaps(in_features, {cap_type}, {dangle_option})
名前説明データ タイプ
in_features

ライン シンボルを格納する入力フィーチャ レイヤー。 ストローク シンボル レイヤーでは、式を適用せずに、[キャップの種類] プロパティを 1 つの属性フィールドに接続する必要があります。 このフィールドの値は、このツールによって更新されます。

Layer
cap_type
(オプション)

ストローク シンボル レイヤーの終端部の描画方法を指定します。 ストロークのデフォルトのキャップの種類は角丸です。この場合、シンボルは、ストローク幅に等しい半径の半円で終了し、ラインの終端部で中央揃えにされます。

  • BUTTストローク シンボルが正確にライン ジオメトリの終端部で終了します。 これがデフォルトです。
  • SQUAREストローク シンボルが、閉じた矩形キャップで終了します。この矩形キャップは、ライン端点からシンボル幅の半分だけ突き出しています。
String
dangle_option
(オプション)

隣接したライン フィーチャ同士 (それぞれが端点を共有しながら、別々のシンボルで描画されている場合) に対するライン キャップの計算方法を指定します。

  • CASED_LINE_DANGLE端点で別のラインに接続していないダングル ラインのほか、二条線ライン シンボルがシングルストローク レイヤーのライン シンボルの端点で連結しているラインのキャップ スタイルを変更します。 これがデフォルトです。
  • TRUE_DANGLE別のフィーチャに接続されていない端点のみでキャップ スタイルを変更します。
String

派生した出力

名前説明データ タイプ
out_representations

更新された入力ライン フィーチャ レイヤー。

Layer

コードのサンプル

CalculateLineCaps の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで CalculateLineCaps 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:\data"
arcpy.cartography.CalculateLineCaps("roads.lyr", "BUTT", "CASED_LINE_DANGLE")
CalculateLineCaps の例 2 (スタンドアロン スクリプト)

このスタンドアロン スクリプトは、CalculateLineCaps 関数の使用例を示しています。

# Name: CalculateLineCaps_standalone_script.py
# Description: Calculates the cap type for stroke symbol layers in the line 
#              symbols of the input layer
 
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "roads.lyrx"
cap_type = "BUTT"
dangle_option = "CASED_LINE_DANGLE"

# Execute Calculate Line Caps
arcpy.CalculateLineCaps_cartography(in_features, cap_type, dangle_option)

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

関連トピック