04. ImageMagick で帳票作成 (準備編)

2017/07/24 -- Posted by : bitset

概要

ImageMagick を使ったPDF帳票方法を説明します。

この方法を使うと以下のメリットがあります。

1. ShellScriptで帳票作成ができる。

帳票作成ライブラリ/フレームワーク不要になり、システムが身軽になります。

帳票サーバが不要で、ターミナル上で実行可能なので動作検証・デバッグが楽です。

2. 並列処理しやすく、高速な帳票作成が可能。

xargsコマンドで並列化することでCPUコアの数だけ高速化出来ます。

ImageMagickのconvertコマンドを実行するだけなので、並列化が容易です。

ImageMagickが多機能なため2回に分け、今回は convertコマンドの使い方を説明し、
次回でPDF帳票を作成します。

準備

Imagemagick をインストールするだけです。

Ubuntu Linuxの場合、パッケージからインストールできます。

$ sudo apt install imagemagick

必要に応じて、日本語フォントを追加インストールします。

(例：Rictyフォントをインストール)

$ sudo apt install fonts-ricty-diminished

使ってみる

まずは簡単な出力を試してみます。

$ convert -font Ricty-Diminished-Regular label:日本語 output.png

引数の最後に指定したファイルに結果画像が出力されます。

（出力結果)

... これだけだと小さくて寂しいですが、以降オプションを増やして見栄えを良くしていきます。

画像フォーマット

拡張子を png の代わりに pdf を指定すると PDFファイルが作成されます。他にも jpg, gif, tiff, bmp, ps(PostScript), ... 等、多くの画像フォーマットを指定出来ます。画像の種類は拡張子で自動的に判断されます。

対応している画像フォーマットは -list format オプションで確認できます。

$ convert -list format

   Format  Module    Mode  Description
-------------------------------------------------------------------------------
      3FR  DNG       r--   Hasselblad CFV/H3D39II
      AAI* AAI       rw+   AAI Dune image
       AI  PDF       rw-   Adobe Illustrator CS2
      ART* ART       rw-   PFS: 1st Publisher Clip Art
      ARW  DNG       r--   Sony Alpha Raw Image Format
      AVI  MPEG      r--   Microsoft Audio/Visual Interleaved
      AVS* AVS       rw+   AVS X image
...

色指定

文字と背景色を指定できます。

-fill 文字の色
-background 背景色

指定できる色は -list color オプションで確認できます。

$ convert -list color

Path: [built-in]

Name                  Color                                         Compliance
-------------------------------------------------------------------------------
AliceBlue             srgb(240,248,255)                             SVG X11 XPM 
AntiqueWhite          srgb(250,235,215)                             SVG X11 XPM 
AntiqueWhite1         srgb(255,239,219)                             X11 
AntiqueWhite2         srgb(238,223,204)                             X11 
AntiqueWhite3         srgb(205,192,176)                             X11 
...

フォント指定

-font でフォント指定できます。
フォントの一覧も -list font オプションで確認できます。

$ convert -list font

Path: /etc/ImageMagick-6/type-ghostscript.xml
  Font: AvantGarde-Book
    family: AvantGarde
    style: Normal
    stretch: Normal
    weight: 400
    glyphs: /usr/share/fonts/type1/gsfonts/a010013l.pfb
  Font: AvantGarde-BookOblique
    ...

Path: System Fonts
  ...
  Font: Ricty-Diminished-Bold  
    family: Ricty Diminished
    style: Normal
    stretch: Normal
    weight: 700
    glyphs: /usr/share/fonts/truetype/ricty-diminished/RictyDiminished-Bold.ttf

Font: の行に出力されているフォント名が指定できます。

一覧に出てこないフォントを使用したい場合、-font の後にフォントファイルへのパスを指定します。

$ convert -font "$HOME/fonts/RictyDiminished-Regular.ttf" label:日本語 output.png