1.1 では、-d/--dialog オプションを追加した。このオプションを指定すると、プリントダイアログを表示して、印刷を行うことができる。コマンドラインから直接 Web ページを印刷するときに便利。

また、印刷をサポートしていないアプリケーションのためのヘルパーとしても利用できる。アプリケーションの書類を HTML として出力して、coral に -d オプションとともに出力すれば、印刷ダイアログを利用できる。

また、1.1 では Universal Binary になっている。

Coral は、コマンドラインから起動するユーティリティだ。Coral をダウンロードして解凍すると、coral というフォルダができあがる。ターミナルを起動して、その中に移動しよう。そうすると、bin フォルダの下に coral というファイルがある。これを使って Coral を起動するんだ。

画像として保存

まず、指定した URL を画像として保存するには、こうだ。

これで、Apple の Web ページを、画像として保存する。この場合、画像フォーマットはデフォルトの JPEG、ファイル名は、Web ページのタイトルを使って、'Apple.jpg' になる。

画像フォーマットの指定

画像フォーマットを指定するには、-f オプションを使うんだ。

これで、PNG フォーマットで保存することになる。サポートしているフォーマットは、以下の通りだ。

• JPEG
• PNG
• GIF
• TIFF
• PDF

PDF を指定すると、そのページすべての領域が保存される。それ以外のフォーマットだと、スクリーンサイズ、デフォルトでは 800 x 600、の領域だけだ。スクリーンサイズの変更の仕方は、後で説明しよう。

出力ファイル名の指定

出力ファイル名は、デフォルトだと Web ページのタイトルを使う。日本語でも、そのまま使ってしまっているぜ。出力ファイル名をを指定する場合は、-o オプションを使う。

ここで、出力ファイル名に拡張子をつけると、それが自動的に画像フォーマットとして使われるんだ。この場合、-f オプションを使ってフォーマットを指定する必要がなくなるわけだ。

レンダリングサイズの指定

HTML をレンダリングするときは、そのサイズをあらかじめ決めておかなくてはいけない。デフォルトでは 800 x 600 のサイズにしている。この大きさを変更したいときは、-s オプションを使う。

出力画像サイズの指定

画像として保存するときに、画像サイズを縮小することもできます。サムネイルを作るときとかに便利だ。-S オプションを使おう。レンダリングサイズとの比率か、絶対値で指定する。

こんな感じで、Coral を使える。

文法

オプション

-c/--compress
圧縮率を指定する。0.0から1.0の少数で指定する。JPG、PNG、TIFF フォーマットで適用される。デフォルトは 1.0。

-f/--format <format>
画像フォーマットを指定する。有効な値は、次の通り。

このオプションが指定されていない場合、JPEG フォーマットになる。

-h/--help
ヘルプを表示する。

-s/--screen <width height>
レンダリングするスクリーンのサイズを指定する。デフォルトは 800 x 600。

-S/--SIZE <ratio> | <width height>
出力する画像のサイズを指定する。もとの画像との比率で指定する場合は、0.0 から 1.0 の値を指定する。絶対値で指定する場合は、幅と高さを指定する。デフォルトは 1.0。PDF で保存するときは、無視される。

-d/--dialog
印刷ダイアログを表示する。

-v/--verbose
Web ページの読み込み状況を表示する。

Coral はコマンドラインから使えるようにしているけど、実体は Cocoa アプリケーションだ。ウィンドウを表示せず、Dock にも現れない、フェィスレスのアプリケーションということになる。

Coral の起動に使っている coral ファイルは、シェルスクリプトだ。ここから、coral.app/Contents/MacOS にある、実行ファイルである coral を呼び出している。

Cocoa アプリケーションなんで、NSApplicationMain を呼び出して、Cocoa のランループを走らせている。Web Kit のレンダリングが、これがないと動かないんでね。だから、通常のコマンドラインとは違うところが多いので、注意してください。