POTRACE - ビットマップをベクターグラフィックに変換

* * *

説明

Potrace はビットマップをトレースするツールです。
つまり、ビットマップを滑らかでスケーラブルな画像に変換します。
入力はビットマップ（PBM、PGM、PPM、または BMP）で、デフォルトの出力は複数のベクターファイル形式のいずれかです。
典型的な用途は、スキャンしたデータ（企業や大学のロゴ、手書きのメモなど）から EPS ファイルを作成することです。
生成される画像はビットマップのような「ギザギザ」ではなく、滑らかです。
そして、任意の解像度でレンダリングできます。

Potrace は現在、以下の出力形式に対応しています：
EPS、PostScript、PDF、SVG（スケーラブルベクターグラフィック）、DXF、GeoJSON、
PGM（ピクセルベースの画像に簡単にアンチエイリアスを適用）、Gimppath、XFig。
将来的には、追加のバックエンドが追加される可能性があります。

mkbitmap という別のプログラムも提供されています。
このプログラムは Potrace のプリプロセッサとして動作し、画像をビットマップに変換する前に、
スケーリングや各種フィルタを適用します。
これは、グレースケール画像やカラー画像の Potrace に便利です。

依存関係

Potrace は、PostScript レベル 3 圧縮に zlib ライブラリを使用しています。
このライブラリは、ほとんどの最新システムにプリインストールされています。
インストールされていない場合は、http://www.gzip.org/zlib/ から入手できます。

コンパイル

一般的なコンパイル手順については、INSTALL ファイルを参照してください。
さらに、以下のコンパイル時オプション（./configure のオプション）がサポートされています。

--with-libpotrace Potrace ライブラリとヘッダーをインストールします (デフォルト: no)
--disable-zlib PostScript レベル 3 圧縮を無効にします
--enable-metric デフォルトでメートル法単位 (センチメートル) を使用します
--enable-a4 デフォルトの用紙サイズとして A4 を使用します
--enable-dumb-tty 簡略化された ASCII のみのプログレスバーを使用します

./configure --help も参照してください。

インストール

ソースからインストールする場合は、root で "make install" を実行してください。
バイナリディストリビューションからインストールする場合は、"potrace" と "mkbitmap" のバイナリを、
オペレーティングシステムが想定する場所 (/usr/local/bin など) にコピーしてください。
また、"potrace.1" と "mkbitmap.1" のファイルを、オペレーティングシステムがマニュアルページを検索するディレクトリ 
(/usr/local/man/man1 など) にコピーしてください。 
Windows への Potrace のインストール手順については、ファイル README-WIN を参照してください。

使用方法

詳細な使用方法については、man ページを参照してください。

使用方法: potrace [オプション] [ファイル名...]
一般オプション:
 -h, --help - このヘルプメッセージを表示して終了します。
 -v, --version - バージョン情報を表示して終了します。
 -l, --license - ライセンス情報を表示して終了します。
ファイル選択:
 <ファイル名> - 入力ファイル
 -o, --output <ファイル名> - すべての出力をこのファイルに書き込みます。
 -- - オプション終了; 0個以上の入力ファイル名が続きます
バックエンドの選択:
 -b, --backend <name> - バックエンドを名前で選択
 -e, --eps - EPSバックエンド (Encapsulated PostScript) (デフォルト)
 -p, --postscript - PostScriptバックエンド
 -s, --svg - SVGバックエンド (Scalable Vector Graphics)
 -g, --pgm - PGMバックエンド (Portable Greymap)
 -b pdf - PDFバックエンド (Portable Document Format)
 -b pdfpage - 固定ページサイズPDFバックエンド
 -b dxf - DXFバックエンド (Drawing Interchange Format)
 -b geojson - GeoJSONバックエンド
 -b gimppath - Gimppathバックエンド (GNU Gimp)
 -b xfig - XFigバックエンド

アルゴリズムのオプション:
 -z, --turnpolicy <policy> - パス分解における曖昧さの解決方法
 -t, --turdsize <n> - スペックルを抑制このサイズまで（デフォルトは2）
 -a, --alphamax <n> - コーナー閾値パラメータ（デフォルトは1）
 -n, --longcurve - カーブ最適化を無効にします
 -O, --opttolerance <n> - カーブ最適化の許容値（デフォルトは0.2）
 -u, --unit <n> - 出力を1/ユニットピクセルに量子化します（デフォルトは10）
 -d, --debug <n> - n型のデバッグ出力を生成します（n=1,2,3）

スケーリングと配置のオプション：
 -P, --pagesize <format> - ページサイズ（デフォルトはレター）
 -W, --width <dim> - 出力画像の幅
 -H, --height <dim> - 出力画像の高さ
 -r, --resolution <n>[x<n>] - 解像度（dpi単位）（ディメンションベースのバックエンド）
 -x, --scale <n>[x<n>] - スケーリング係数（ピクセルベースのバックエンド）
 -S, --stretch <n> - y解像度/x解像度
 -A, --rotate <angle> - 反時計回りに角度だけ回転
 -M, --margin <dim> - マージン
 -L, --leftmargin <dim> - 左マージン
 -R, --rightmargin <dim> - 右マージン
 -T, --topmargin <dim> - 上マージン
 -B, --bottommargin <dim> - 下マージン
 --tight - 入力画像の周囲の空白を削除
一部のバックエンドでサポートされているカラーオプション:
 -C, --color #rrggbb - 前景色を設定 (デフォルト: 黒)
 --fillcolor #rrggbb - 塗りつぶし色を設定 (デフォルト: 透明)
 --opaque - 白い図形を不透明にする
SVGオプション:
 --group - 関連するパスをグループ化します
 --flat - 画像全体を単一のパスとして出力します
Postscript/EPS/PDF オプション:
-c, --cleartext - 出力を圧縮しません
-2, --level2 - Postscript レベル 2 圧縮を使用します (デフォルト)
-3, --level3 - Postscript レベル 3 圧縮を使用します
-q, --longcoding - ファイルサイズを最適化しません
PGM オプション:
 -G, --gamma <n> - アンチエイリアシングのガンマ値 (デフォルト 2.2)
フロントエンド オプション:
 -k, --blacklevel <n> - 入力ファイルの白黒のカットオフ (デフォルト 0.5)
 -i, --invert - ビットマップを反転します
プログレスバー オプション:
 --progress - プログレスバーを表示します
 --tty <mode> - プログレスバーのレンダリング: vt100 または dumb

寸法には、6.5in、15cm、100pt などの任意の単位を指定できます。
デフォルトはインチ（pgm、dxf、gimppath バックエンドの場合はピクセル）です。
入力ファイル形式は pnm（pbm、pgm、ppm）、bmp です。
バックエンドは eps、postscript、ps、pdf、pdfpage、svg、dxf、geojson、pgm、gimppath、xfig です。

POTRACE ライブラリ（開発者向け）

Potrace リリース 1.6 以降、Potrace のコア機能はライブラリ libpotrace.a に分離されました。
これにより、トレース機能を他の GPL プログラムに簡単に統合できます。
ライブラリの API はヘッダーファイル potracelib.h で定義されており、doc/potracelib.pdf にドキュメントが記載されています。
デフォルトではインストールされませんが、--with-libpotrace 設定オプションを使用してインストールできます。

ドキュメント

使用方法はマニュアルページに記載されています。
http://potrace.sourceforge.net/potrace.html

よくある質問への回答はFAQに記載されています。
http://potrace.sourceforge.net/faq.html

いくつかの例は、以下のWebページに掲載されています。
http://potrace.sourceforge.net/samples.html
http://potrace.sourceforge.net/mkbitmap.html

potraceアルゴリズムの内部動作については、こちらで説明しています。
http://potrace.sourceforge.net/potrace.pdf

potraceライブラリのドキュメントについては、こちらで説明しています。
http://potrace.sourceforge.net/potracelib.pdf

著作権

Copyright (C) 2001-2013 Peter Selinger

このプログラムはフリーソフトウェアです。
フリーソフトウェア財団が発行したGNU一般公衆利用許諾契約書の条項に従って、再配布および／または改変することができます。
ライセンスのバージョン2、または（お客様の選択により）それ以降のバージョンのいずれか。

このプログラムは有用であることを期待して配布されていますが、いかなる保証もなしに配布されています。
商品性または特定目的への適合性に関する暗黙の保証さえも含まれていません。
詳細については、GNU 一般公衆利用許諾書を参照してください。

このプログラムにはGNU 一般公衆利用許諾書のコピーが付属しているはずです。
お持ちでない場合は、Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USAまでご連絡ください。7
http://www.gnu.org/ も参照してください。

詳細については、COPYING ファイルを参照してください。

GPGキー

Peter SelingerのGPGキーのキーフィンガープリントは次のとおりです。
12A2 4B3C 3790 B688 E484 7A98 A68B CC37 CA31 696A
これは、Potraceの将来のバージョンの認証に役立つ可能性があります。
