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()

ファイルへの出力

例

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()

高度な機能

座標系

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")

注意事項

  1. PSDraw モジュールは主に PostScript ファイルを生成するために使用され、図形の表示には使用されません。
  2. 生成された PostScript ファイルは、Ghostscript や他の PostScript インタープリタで表示できます。
  3. 一部の複雑なグラフィック操作では、PostScript コマンドを直接使用する必要がある場合があります。
  4. 現代のアプリケーションでは、SVG などより現代的なベクターグラフィック形式の使用を検討してください。

PSDraw モジュールを習得することで、Python で高品質な PostScript ドキュメントを簡単に生成でき、印刷や専門的な出版のニーズに対応できます。

その他の拡張