Pillow PSDraw モジュール
PSDraw は Python Pillow ライブラリのモジュールで、PostScript 形式の描画ファイルを生成するために特化しています。
PostScript はページ記述言語およびプログラミング言語であり、デスクトップパブリッシングや印刷分野で広く使用されています。
PSDraw モジュールでは、次のことができます:
- ベクターグラフィックの作成
- 基本図形(線、長方形、円など)の描画
- テキストコンテンツの追加
- ページレイアウトと形式の制御
インポート方法:
from PIL import PSDraw
PSDraw モジュールの主なメソッド
以下は、PSDraw モジュールでよく使用されるメソッドとその機能の説明です:
| メソッド | 説明 | パラメータ | 戻り値 |
|---|---|---|---|
| PSDraw.begin_document() | 新しい PostScript ドキュメントを開始します | 无 | 无 |
| PSDraw.end_document() | 現在の PostScript ドキュメントを終了します | 无 | 无 |
| PSDraw.setfont(font, size) | テキストのフォントとサイズを設定します | font: フォント名 size: フォントサイズ(ポイント) |
无 |
| PSDraw.text(position, text) | 指定した位置にテキストを描画します | position: (x,y) 座標 text: 描画するテキスト |
无 |
| PSDraw.line(from_pos, to_pos) | 直線を描画します | from_pos: 始点座標 to_pos: 終点座標 |
无 |
| PSDraw.rectangle(box) | 長方形を描画します | box: (x0,y0,x1,y1) 座標 | 无 |
| PSDraw.setink(color) | 描画色を設定します | color: 色の値(RGBタプルまたは色名) | 无 |
| PSDraw.setfill(onoff) | 図形を塗りつぶすかどうかを設定します | onoff: ブール値(True/False) | 无 |
基本的な使用例
簡単なPostScriptドキュメントの作成
例
from PIL import PSDraw
# PSDrawオブジェクトを作成
ps = PSDraw.PSDraw() # デフォルトでは標準出力に出力
# ドキュメントを開始
ps.begin_document()
# フォントを設定
ps.setfont("Helvetica", 12)
# テキストを描画
ps.text((100, 100), "Hello, PostScript!")
# 線を描画
ps.line((100, 120), (200, 120))
# 長方形を描画
ps.rectangle((100, 150, 200, 200))
# ドキュメントを終了
ps.end_document()
# PSDrawオブジェクトを作成
ps = PSDraw.PSDraw() # デフォルトでは標準出力に出力
# ドキュメントを開始
ps.begin_document()
# フォントを設定
ps.setfont("Helvetica", 12)
# テキストを描画
ps.text((100, 100), "Hello, PostScript!")
# 線を描画
ps.line((100, 120), (200, 120))
# 長方形を描画
ps.rectangle((100, 150, 200, 200))
# ドキュメントを終了
ps.end_document()
ファイルへの出力
例
from PIL import PSDraw
# ファイル出力を作成
with open("output.ps", "wb") as f:
ps = PSDraw.PSDraw(f)
# ページサイズを設定(A4)
ps.begin_document("A4")
# 色を赤に設定
ps.setink("red")
# 塗りつぶした長方形を描画
ps.setfill(True)
ps.rectangle((100, 100, 300, 200))
# ドキュメントを終了
ps.end_document()
# ファイル出力を作成
with open("output.ps", "wb") as f:
ps = PSDraw.PSDraw(f)
# ページサイズを設定(A4)
ps.begin_document("A4")
# 色を赤に設定
ps.setink("red")
# 塗りつぶした長方形を描画
ps.setfill(True)
ps.rectangle((100, 100, 300, 200))
# ドキュメントを終了
ps.end_document()
高度な機能
座標系
PSDraw は PostScript のデフォルトの座標系を使用します。原点 (0,0) はページの左下にあり、x 軸は右に増加し、y 軸は上に増加します。座標の単位はポイント(1ポイント = 1/72 インチ)です。
グラフィック変換
PSDraw には変換メソッドは直接用意されていませんが、PostScript コマンドを使用して平行移動、回転、拡大縮小を実現できます:
例
ps.text((100, 100), "gsave 45 rotate Hello, World! grestore")
カスタムPostScriptコマンド
PSDraw では、元の PostScript コマンドを直接挿入できます:
例
ps.text((0, 0), "% カスタムPostScriptコマンド\n/showpage {} def")
注意事項
- PSDraw モジュールは主に PostScript ファイルを生成するために使用され、図形の表示には使用されません。
- 生成された PostScript ファイルは、Ghostscript や他の PostScript インタープリタで表示できます。
- 一部の複雑なグラフィック操作では、PostScript コマンドを直接使用する必要がある場合があります。
- 現代のアプリケーションでは、SVG などより現代的なベクターグラフィック形式の使用を検討してください。
PSDraw モジュールを習得することで、Python で高品質な PostScript ドキュメントを簡単に生成でき、印刷や専門的な出版のニーズに対応できます。
その他の拡張