CAD-VTracer.txt

■ VTracer

VTracer は、コマンドラインでのみ使える輪郭線用の
ラスベク変換ツールです。

https://github.com/visioncortex/vtracer/releases から、
vtracer-x86_64-pc-windows-msvc.zip をダウンロード。
解凍したファイル vtracer.exe がプログラム本体です。

vtracer.exe をフォームにドラッグ＆ドロップすると、
本ツールから起動できるようになります。

[CAD 切り取り] をクリックして、CAD 上の切り取り範囲を
左上、右下の順で指示します。

あとは、vtracer を起動->ベクトル化->DXFファイル出力が、
自動で行われます。
DXFファイルが作成されると、CAD の切り取り範囲の位置に
分解挿入されます。

期待どおりに動かないときは、DXF ファイル作成確認待ちの
設定を大きくしてみてください。

※起動オプションの指定を間違えると、起動できない（一瞬
で終了する）ことがあります。

■起動オプション（--help の翻訳のまとめ）
・基本構文
　vtracer.exe [OPTIONS] --input <input> --output <output>

・カラーモード関連
　--colormode color,フルカラー処理(デフォルト)
　--colormode bw 2値化処理(白黒)
　--color_precision <bits> RGB各チャンネルの有効ビット数(例:4?8)
　--gradient_step <value> グラデーション層の色差しきい値
　--hierarchical stacked 階層クラスタリング(デフォルト)
　--hierarchical cutout 非階層クラスタリング

・ノイズ除去・形状解析
　--filter_speckle <px> 指定px未満の小領域を除去
　--corner_threshold <deg> 角とみなす最小角度(度)
　--splice_threshold <deg> スプラインを接続する角度しきい値(度)

・曲線フィッティング(最重要)
　--mode pixel ピクセルベース(最も忠実)
　--mode polygon ポリゴン近似
　--mode spline スプライン曲線(滑らか)(デフォルト？)

・精度・出力制御
　--path_precision <digits> パスの小数点以下桁数
　--segment_length <len> 指定長以下になるまで分割平滑化
　--preset bw/poster/photo プリセット設定

・入出力
　--input <file> 入力画像(必須)
　--output <file> 出力SVG/JSON (必須)

・実用サンプル(未検証、by COPILOT なので正しいかどうか・・・)
　1. 白黒でシンプルにベクタ化
　　vtracer.exe --colormode bw --preset bw --input in.png --output out.svg
　2. スプラインで滑らかに
　　vtracer.exe --mode spline --segment_length 3 --input in.png --output out.svg
　3. 写真をポスター風に
　　vtracer.exe --preset poster --input photo.jpg --output poster.svg
