> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/visualize-predictions/line-counter-visualization.md).
# ラインカウンター可視化
画像上にラインゾーンを描画してカウント境界を可視化し、指定したラインを横切るオブジェクトを追跡するラインカウンターのワークフロー向けに、色付きのラインオーバーレイと in/out カウントラベルを表示します。
## このブロックの仕組み
このブロックは画像とラインゾーンの座標（ラインを定義する2点）を受け取り、カウント統計付きのカウントラインの視覚表現を描画します。このブロックは：
1. 画像とラインゾーンの座標（2点：\[x1, y1] と \[x2, y2]）を入力として受け取ります
2. 指定した色と太さを使って、ゾーン座標からラインマスクを作成します
3. 指定した不透明度でラインを画像に重ね、半透明のライン可視化を作成します
4. count\_in（ゾーンに入ったオブジェクト）と count\_out（ゾーンから出たオブジェクト）の値を示すテキストラベルを表示します
5. カウントテキストをラインの始点 (x1, y1) に配置し、テキストスタイルをカスタマイズできます
6. ラインゾーンとカウント統計を元画像に重ねた注釈付き画像を返します
このブロックは、定義された境界線を越えるオブジェクトの動きを追跡するために使用されるラインカウントゾーンを可視化します。ラインは、カスタマイズ可能な色、太さ、不透明度で2つの指定点の間に描画されます。カウント統計（in と out）はテキストラベルとして表示され、通常はオブジェクトの通過を追跡する Line Counter ブロックから接続されます。この可視化により、ユーザーはカウント境界を把握し、カウント結果をリアルタイムで監視できます。注: このブロックは通常、ワークフロー内で他の可視化ブロックの前に配置する必要があります。ラインゾーンは、オブジェクト検出の可視化のための背景参照レイヤーを提供するためです。
## 一般的な使用例
* **ラインカウンターの可視化**: 定義されたライン境界をオブジェクトが横切る、人数カウント、車両カウント、またはオブジェクト追跡のワークフロー向けに、カウントラインと in/out 統計を表示します
* **交通および移動の監視**: カウント境界と現在のカウントを可視化する必要がある交通監視、歩行者流量分析、または入退場追跡アプリケーション向けに、カウントラインを表示します
* **チェックポイントおよびアクセス制御**: チェックポイント、ゲート、またはアクセス地点におけるカウントラインを可視化し、監視境界を示して、セキュリティやアクセス制御のワークフローで入退場カウントを追跡します
* **小売・ビジネス分析**: 小売、ホスピタリティ、またはビジネスインテリジェンスのアプリケーションにおける歩行者流量分析、顧客動線監視、または在室状況追跡のために、カウントラインを表示します
* **群衆管理と安全**: 境界を越えるオブジェクトの動きを追跡することが重要な群衆管理、収容人数監視、または安全関連ワークフロー向けに、カウントラインを可視化します
* **リアルタイムカウントダッシュボード**: カウントラインと統計を明確に表示する必要があるリアルタイムカウントダッシュボード、監視インターフェース、またはライブ動画フィード向けに、視覚オーバーレイを作成します
## 他のブロックへの接続
このブロックの注釈付き画像は次に接続できます:
* **Line Counter ブロック** 可視化上に表示される count\_in と count\_out の値を受け取るために
* **他の可視化ブロック** （例: Bounding Box Visualization、Label Visualization、Polygon Visualization）を使って、ラインゾーンの可視化の上に物体検出アノテーションを追加します
* **データ保存ブロック** （例: Local File Sink、CSV Formatter、Roboflow Dataset Upload）を使って、ドキュメント作成、レポート、分析のためにラインゾーンの可視化付き画像を保存します
* **Webhookブロック** ラインゾーン付きの可視化結果を外部システム、API、または Web アプリケーションに送信し、ダッシュボードや監視ツールに表示します
* **通知ブロック** （例: Email Notification、Slack Notification）を使って、アラートやレポートの視覚的証拠としてラインゾーン付きの注釈画像を送信します
* **動画出力ブロック** ライブ監視、カウントの可視化、または後処理分析のために、ラインゾーンの可視化付き注釈動画ストリームや録画を作成します
### 型識別子
ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/line_counter_visualization@v1` ワークフローにこのブロックをステップとして追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ---------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `copy_image` | `bool` | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。 | ✅ |
| `zone` | `List[Any]` | ラインゾーンの座標は \[\[x1, y1], \[x2, y2]] の形式で、カウントラインを定義するちょうど2点から構成されます。ラインはこの2点の間に描画され、このラインを横切るオブジェクトがカウントされます。通常は Line Counter ブロックの zone 出力から接続されます。 | ✅ |
| `color` | `str` | ラインゾーンの色。色名（例: 'WHITE'、'RED'）、16進カラーコード（例: '#5bb573'、'#FFFFFF'）、または RGB 形式（例: 'rgb(255, 255, 255)'）で指定できます。ラインはこの色で指定した不透明度に従って描画されます。 | ✅ |
| `太さ` | `整数` | ラインゾーンの太さ（ピクセル単位）。カウントラインの見え方の太さを制御します。値を大きくすると太くて見やすい線になり、小さくすると細い線になります。一般的な値は 1〜10 ピクセルです。 | ✅ |
| `text_thickness` | `整数` | カウントテキストラベルの太さ（ピクセル単位）。テキストの太さ（文字の線幅）を制御します。値を大きくすると太くて強調されたテキストになり、小さくすると細いテキストになります。一般的な値は 1〜3 です。 | ✅ |
| `text_scale` | `float` | カウントテキストラベルのスケール係数。count\_in と count\_out の値を表示するテキストのサイズを制御します。1.0 より大きい値でテキストは大きくなり、1.0 より小さい値で小さくなります。一般的な値は 0.5〜2.0 です。 | ✅ |
| `count_in` | `整数` | ラインゾーンに入ったオブジェクト数（'in' 方向に一方から他方へ横切ったオブジェクト）。通常は Line Counter ブロックの count\_in 出力（例: '$steps.line\_counter.count\_in'）から接続されます。この値は可視化のテキストラベルに表示されます。 | ✅ |
| `count_out` | `整数` | ラインゾーンから出たオブジェクト数（'out' 方向に一方から他方へ横切ったオブジェクト）。通常は Line Counter ブロックの count\_out 出力（例: '$steps.line\_counter.count\_out'）から接続されます。この値は可視化のテキストラベルに表示されます。 | ✅ |
| `opacity` | `float` | ラインゾーンオーバーレイの不透明度。0.0（完全に透明）から 1.0（完全に不透明）までの範囲です。カウントラインが画像上でどれだけ透けて見えるかを制御します。値を低くすると背景と馴染むより透明なラインになり、値を高くするとより不透明で見やすいラインになります。一般的な値は、見やすさのバランスをとるために 0.2〜0.5 です。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `ラインカウンターの可視化` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `image` ([*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)): 可視化対象の画像。
* `copy_image` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)): このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元の画像を保持します。複数の可視化を重ねる場合に使用してください。
* `zone` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)): ラインゾーンの座標は \[\[x1, y1], \[x2, y2]] の形式で、カウントラインを定義するちょうど2点から構成されます。ラインはこの2点の間に描画され、このラインを横切るオブジェクトがカウントされます。通常は Line Counter ブロックの zone 出力から接続されます。
* `color` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)): ラインゾーンの色。色名（例: 'WHITE'、'RED'）、16進カラーコード（例: '#5bb573'、'#FFFFFF'）、または RGB 形式（例: 'rgb(255, 255, 255)'）で指定できます。ラインはこの色で指定した不透明度に従って描画されます。
* `太さ` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): ラインゾーンの太さ（ピクセル単位）。カウントラインの見え方の太さを制御します。値を大きくすると太くて見やすい線になり、小さくすると細い線になります。一般的な値は 1〜10 ピクセルです。
* `text_thickness` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): カウントテキストラベルの太さ（ピクセル単位）。テキストの太さ（文字の線幅）を制御します。値を大きくすると太くて強調されたテキストになり、小さくすると細いテキストになります。一般的な値は 1〜3 です。
* `text_scale` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)): カウントテキストラベルのスケール係数。count\_in と count\_out の値を表示するテキストのサイズを制御します。1.0 より大きい値でテキストは大きくなり、1.0 より小さい値で小さくなります。一般的な値は 0.5〜2.0 です。
* `count_in` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): ラインゾーンに入ったオブジェクト数（'in' 方向に一方から他方へ横切ったオブジェクト）。通常は Line Counter ブロックの count\_in 出力（例: '$steps.line\_counter.count\_in'）から接続されます。この値は可視化のテキストラベルに表示されます。
* `count_out` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): ラインゾーンから出たオブジェクト数（'out' 方向に一方から他方へ横切ったオブジェクト）。通常は Line Counter ブロックの count\_out 出力（例: '$steps.line\_counter.count\_out'）から接続されます。この値は可視化のテキストラベルに表示されます。
* `opacity` ([*`float_zero_to_one`*](/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)): ラインゾーンオーバーレイの不透明度。0.0（完全に透明）から 1.0（完全に不透明）までの範囲です。カウントラインが画像上でどれだけ透けて見えるかを制御します。値を低くすると背景と馴染むより透明なラインになり、値を高くするとより不透明で見やすいラインになります。一般的な値は、見やすさのバランスをとるために 0.2〜0.5 です。
* 出力
* `image` ([`image`](/workflows/ja/gaido/developer-guide/kinds/image.md)): ワークフロー内の画像。
JSON 定義の例
```json
{
"name": "",
"type": "roboflow_core/line_counter_visualization@v1",
"image": "$inputs.image",
"copy_image": true,
"zone": [
[
0,
50
],
[
500,
50
]
],
"color": "WHITE",
"thickness": 2,
"text_thickness": 1,
"text_scale": 1.0,
"count_in": "$steps.line_counter.count_in",
"count_out": "$steps.line_counter.count_out",
"opacity": 0.3
}
```