![](https://products-qa.fileformat.com/ja/pdf/ruby/prawn/header-image.png)
Prawn
オープンソースの Ruby ライブラリによる迅速な PDF 生成
プログラマーが PDF ファイルを作成および変更できるようにする無料の Ruby PDF API。 Ruby アプリ内の PDF ページにグラフィックを挿入、編集、およびテキストを描画します。
Portable Document Format (PDF) は、世界中でファイルを表示、共有、および印刷するための、信頼性が高く安全なファイル形式として非常に人気があります。オープン ソースの Ruby ライブラリ Prawn は、Ruby ライブラリを使用して PDF ドキュメントを操作するための完全な機能を提供しています。ライブラリは非常に使いやすく、よく文書化されているため、開発者の仕事が簡単になります。開発者が非常に柔軟な PDF ドキュメント生成システムを簡単に作成するのに役立ちます。
Prawn ライブラリには、ソフトウェア開発者が PDF ドキュメントを簡単に処理できるようにするいくつかの重要な機能が含まれています。たとえば、PDF をゼロから作成する、PNG および JPG 画像を埋め込む、組み込みフォントと TrueType フォントを使用して PDF にベクター描画を追加する、暗号化をサポートするなどです。 、パスワードを使用した安全な PDF ドキュメント、テキスト レンダリングのサポート、UTF-8 ベースのフォントのサポート、右から左へのテキストのレンダリング、アウトラインのサポートなど。
えびをはじめる
システムに Prawn をインストールするには、次のコマンドを実行してください。
RubyGems 経由で Prawn をインストールする
gem install prawn
Ruby ライブラリを使用して PDF ファイルを作成する
オープン ソースの Ruby ライブラリ Prawn を使用すると、ソフトウェア開発者は数行の Ruby コードを使用してプログラムで PDF ドキュメントを作成できます。ライブラリは、デフォルト設定とフォントを使用して PDF ドキュメントを作成するための 3 つの異なる方法を提供しています。これらは、代入、暗黙的ブロック、または明示的ブロックによって行われます。作成したら、PDF ドキュメントの各部分に簡単にアクセスして変更できます。新しいページの追加、ページ サイズと余白の設定、フォント スタイルの変更、書式設定の適用などを簡単に行うことができます。
Ruby 経由で PDF ファイルを作成 & レンダリング
# Using explicit block form and rendering to a file
content = "Hello World"
Prawn::Document.generate "example.pdf" do |pdf|
# self here is left alone
pdf.font "Times-Roman"
pdf.draw_text content, :at => [200,720], :size => 32
end
PDF 内のグラフィックの挿入と編集
Prawn ライブラリは、ソフトウェア開発者が Ruby コードを使用して PDF ドキュメントに Vector 図面を追加する機能を提供します。開発者は、PDF ページ内の任意の場所に線、多角形、曲線、円などを簡単に描画できます。ライブラリには、塗りつぶしの色、破線のスタイルとパターンの適用、線の太さの設定と色の適用、ブレンド モードの使用、変換と透明度の適用など、グラフィックスを操作するための重要な関数がいくつか含まれています。
PDF ドキュメントでの画像の使用
オープン ソースの Ruby ライブラリ Prawn は、Ruby コマンドを使用して PDF ファイルに画像を挿入するためのサポートを提供しています。現在、ライブラリには JPEG および PNG 画像のサポートが含まれています。位置の調整、画像のスケーリングのサポート、画像の幅と高さの個別設定、画像のプロポーショナル フィッティングなど、PDF ファイル内の画像を管理するための重要な機能がいくつか用意されています。
Ruby 経由で画像を生成し、PDF に収まるように拡大縮小します
Prawn::Document.generate("image2.pdf", :page_layout => :landscape) do
pigs = "#{Prawn::DATADIR}/images/pigs.jpg"
image pigs, :at => [50,450], :width => 450
dice = "#{Prawn::DATADIR}/images/dice.png"
image dice, :at => [50, 450], :scale => 0.75
end
PDF ページにテキストを描画する
Prawn ライブラリを使用すると、ソフトウェアの専門家は、Ruby アプリケーション内の PDF ページにテキストを簡単に描画できます。 PDFページの指定した位置に簡単に文字を描き始めることができます。テキストの位置を簡単に調整したり、必要に応じてテキストを回転させたり、フォント サイズを適用したり、1 行と複数行をサポートしたりできます。
Ruby ライブラリを介して PDF ページにテキストを描画する
def draw_text!(text, options)
unless font.unicode? || font.class.hide_m17n_warning || text.ascii_only?
warn "PDF's built-in fonts have very limited support for " \
"internationalized text.\nIf you need full UTF-8 support, " \
"consider using an external font instead.\n\nTo disable this " \
"warning, add the following line to your code:\n" \
"Prawn::Fonts::AFM.hide_m17n_warning = true\n"
font.class.hide_m17n_warning = true
end
x, y = map_to_absolute(options[:at])
add_text_content(text, x, y, options)
end