# ベクターからSVGへの変換 - クイックガイド

このツールは、QGIS のベクターレイヤーを SVG に書き出します。背景、境界線、ラベル、フィーチャごとの出力オプションに対応しています。

## 使い方

1. `Cadmus > ベクターからSVGへの変換` を開きます。
2. 入力ベクターレイヤーを選択します。
3. 必要に応じて `選択フィーチャのみ` を有効にします。
4. 背景色、境界線の色と太さ、ラベルの色とサイズを設定します。
5. 透明背景、境界線表示、ラベル表示、フィーチャごとに SVG を生成するかを切り替えます。
6. 出力フォルダーを選択するか、プロジェクトフォルダーを使用します。
7. ツールを実行します。

## プラグインが実際に行うこと

- 入力が有効なベクターレイヤーであり、フィーチャを持つことを確認します。
- このオプションが有効な場合、選択されたフィーチャのみを使用します。
- SVG を生成する前にジオメトリを WGS84 に再投影します。
- レイヤー全体を 1 つの SVG として出力するか、フィーチャごとに 1 つの SVG を出力します。
- 透明背景または単色背景を適用します。
- ユーザーが指定した色と太さでジオメトリの境界線を制御します。
- QGIS のラベリング設定から実際のラベルを描画しようとし、必要に応じて `displayExpression()` と `Name` フィールドをフォールバックとして使います。

## ファイル名のルール

- 単一 SVG の出力では、QGIS レイヤー名を使用します。
- フィーチャごとの出力では:
  - `Name` フィールドが存在し、値がある場合はそれを使用します。
  - そうでない場合は `LayerName_1`、`LayerName_2`、`LayerName_3`... を使用します。
- 既に同名ファイルがある場合、上書きせずに連番付きの名前を作成します。

## 重要な挙動

- `背景を透明にする` が有効な場合、SVG に背景塗りは書き込まれません。
- `境界線を表示` が無効な場合、ジオメトリの輪郭は描画されません。
- `ラベルを表示` が無効な場合、文字は出力されません。
- ラベルサイズはツール上で直接制御できます。
- 最終結果は必ず選択したフォルダーにファイルとして保存されます。

## どんなときに使うか

次のような場合に便利です:

- プロジェクトのベクターデータから SVG アイコンや図形を作成したいとき
- レイアウト、Web、または自動処理のためにフィーチャを個別に書き出したいとき
- レイヤーの基本的なシンボル表現を軽量なベクター出力として再利用したいとき

## 注意点

- ラベルを表示したい場合は、レイヤーのラベリング設定を確認してください。
- フィーチャごとの出力を有効にすると、多数のフィーチャを持つレイヤーでは大量のファイルが生成される可能性があります。
- より分かりやすいファイル名にしたい場合は、フィーチャごとに SVG を出力する前に `Name` フィールドを設定することをおすすめします。
