もしあなたがBatikのバイナリ ディストリビューションをダウンロードしたのであれば、あなたはbatik-1.1.zipと呼ばれるファイルを入手しているはずで、これを展開すると、batik-rasterizer.jar と呼ばれるJAR (Java ARchive) ファイルが生成されます。ラスタライザを起動するには、コンソールを開いて、あなたがこのディストリビューションを解凍した（そしてbatik-rasterizer.jarが見つかる）ディレクトリに移動し、ただコマンドプロンプトから以下を打ち込んで下さい :

java -jar batik-rasterizer.jar [@files]

たとえば、次のようにタイプすると:

java -jar batik-rasterizer.jar samples/batikFX.svg

以下のような出力が見えることでしょう:

Converting file: samples/BatikFX.svg to samples/BatikFX.png

コンバートが完了すると、あなたはsamplesディレクトリにbatikFX.pngファイルを見つけることになるでしょう。

コマンドラインにオプションを渡すことも出来ます:

java -jar batik-rasterizer.jar [options] [@files]

ここで、オプションは:

• -d <dir|file>. 出力ディレクトリ。もし入力ファイルが単数であれば、これはファイルでも良いです。
• -m <mimeType>. 出力mimeタイプで、image/png, image/jpeg, application/pdf, image/tiff のいずれかになります。
• -w <width>. 出力の幅で、浮動小数点値になります。
• -h <height>. 出力の高さで、浮動小数点値になります。
• -a <area>. 出力エリア。<area> のフォーマットは x,y,w,hで、x, y, w, hはそれぞれ浮動小数点値です。
• -bg <color>. Uuput color（訳注: アウトプットカラー？）。<color> のフォーマットは a.r.g.bで、a, r, g, b は整数値です。
• -cssMedia <media>. ソースSVGファイルがコンバートされる先のCSS メディア タイプ。
• -cssAlternate <alternate>. ソースSVG ファイルがコンバートされるときに使用される代替スタイルシート。
• -cssUser <userStylesheet>. 他の参照スタイルシートあるいは埋め込みスタイルシートに加えてコンバートされたSVGドキュメントに適用されることになる、CSSユーザースタイルシートのURI。
• -lang <userLanguage>. SVGドキュメントをコンバートする際に用いられるユーザー言語。
• -q <quality>. 出力イメージのクォリティ。これはimage/jpeg mimeタイプの場合にのみ意味があります。
• -dpi <resolution>. 出力イメージの解像度。
• -validate. ソースSVGファイルがバリデーションされるべきかどうかを制御します。

例:

• java -jar batik-rasterizer.jar -d myDir -m image/jpg samples\*.svg は、samplesディレクトリ中にある全てのSVGファイルからJPEGイメージを生成します。

もしあなたがBatikの開発者ディストリビューションをダウンロードしたのであれば、解凍したzipまたはtarファイルをxml-batikディレクトリに落としたとします。このディレクトリで、あなたは実行しているプラットフォームに合ったビルド スクリプトを見つけることが出来ます。たとえば、Windowsプラットフォームのユーザーのためのスクリプトはbuild.batですし、UNIXユーザーのためのスクリプトはbuild.shです。

ラスタライザを起動するには、あなたがしなければならないことは:

• xml-batikディレクトリがあなたのPATH環境変数に含まれていることを確認してください
• ANT_HOME環境変数がxml-batikディレクトリにセットされていることを確認してください
• JAVA_HOME環境変数があなたのJDKのインストレーション ディレクトリにセットされていることを確認してください
• コマンドライン ウィンドウを開いて、Batikディストリビューションが解凍されたxml-batikディレクトリに移動してください
• UNIX ユーザーは、もしまだ未設定であれば、build.shスクリプトを実行可能にしてください:
  chmod +x build.sh
• コマンドラインから打ってください:
  Windows: build svgrasterizer.
  UNIX: build.sh svgrasterizer.
  これはラスタライザのヘルプメッセージを出力します。

次のように、ラスタライザにオプションを渡すこともできます:

Windows: build svgrasterizer [options] [@files]

UNIX: build.sh svgrasterizer [options] [@files]

これらのオプションについては、"バイナリ ディストリビューションを利用する" の説明を参照してください。

あなたのAntプロジェクトでこのタスクを利用する前に最初にやらなければならないことは、batik-rasterizer.jar とラスタライザのクラスをあなたのCLASSPATHに含めておくことです。

そうしたら、次はあなたのAntプロジェクトの中にこのタスクを定義しなければなりません。これには、以下の行を、あなたがラスタライザ タスクを使用したいターゲットのproject 開始タグあるいはtarget 開始タグのどちらかの後に追加してください:

	<taskdef name="rasterize" classname="org.apache.tools.ant.taskdefs.optional.RasterizerTask" />

これでラスタライザ タスクがあなたのプロジェクトの中で使えるようになりました! 利用可能なパラメータの説明についてはパラメータのセクション を、あるいは些かな使用例については使用例のセクション を、それぞれ参照してください。

fileset 要素を使って、入力ファイルあるいはディレクトリを選択することもできます。filesetsの使い方については、Antのドキュメントを参照してください。

以下の例はSVGイメージ(input.svgとする) を PNG イメージ(output.pngとする)にコンバートする、完全なAntプロジェクトです:

	<?xml version="1.0"?> <project name="RasterizerExample" default="main" basedir="."> <taskdef name="rasterize" classname="org.apache.tools.ant.taskdefs.optional.RasterizerTask" /> <target name="main"> <rasterize result="image/png" src="input.svg" dest="output.png" /> </target> </project>

次の例はプロジェクト中のただ1つのタスクです。これはimages ディレクトリ中の.svg のサフィクスが付いた全てのファイルを、images2 ディレクトリにTIFFイメージとしてコンバートします。結果イメージ ファイルはresults ディレクトリに置かれます。

	<rasterize result="image/tiff" destdir="results"> <fileset dir="images"> <include name="**/*.svg" /> </fileset> <fileset dir="images2" /> </rasterize>