GSSBC マニュアル

2013/06/27

1.1

目

次

第 1 章 概要
1–1 GSSBC とは
1–2 新たに追加される変換元と変換先のファイル形式

第 2 章 準備112
3

2–1 必要なソフト
2–2 環境変数の設定

3

第 3 章 変換の流れ

7

3–1 PDF 出力
3–2 イメージ出力
3–3 Flash(SWF), SVG, INX, and XPS 出力

第 4 章 実行
4–1 プログラムの起動
4–2 環境変数
4–3 実行例

第 5 章 コマンドラインオプション
第 6 章 技術資料
6–1 スペースを含むファイル名について
6–2 ソースパスワードとターゲットパスワードの違い
6–3 出力ファイル名の決定方法
6–4 Server Based Converter のオプションファイル
6–5 GhostScript のオプションファイル
改訂履歴

4789111111121618181919202126iii

図一覧索引iv

2830

第1章 概要

1–1 GSSBC とはGSSBC は、Server Based Converter, GhostScript を使って、次の変換を可能にするソフトです。
1） 現在の Server Based Converter の Linux 版は、各種イメージ形式への変換をサポートしていませんが、GSSBC を使うと、Linux でも各種イメージ形式への変換ができます。
2） MS Office から PDF への変換など、Server Based Converterで可能な変換は、GSSBC でも可能です。
以上のように、GSSBC は、Server Based Converter の機能を拡張し、利用範囲を広げるソフトです。
以下の説明では、Server Based Converter を SBC と略します。
GhostScript を GS と略します。

図 1.1 GSSBC components

1

1–2 新たに追加される変換元と変換先のファイル形式
GSSBC が変換できる変換元、変換先のファイル形式は、以下の通りです。
これらは、すでに SBC がサポートしているものに追加されるものです。

新たな変換元ファイル形式
特になし
新たな変換先ファイル形式
GS がサポートしている出力ファイル形式2

第2章 準備

2–1 必要なソフト
GSSBC を実行するには、以下のソフトがインストールされていて、正常に動作することが必要です。
Server Based Converter
Server Based Converter V4.0 以上。日本語を正しく処理する
ためには、あなたのフォント環境に合わせて、font-config.xml
でフォントを適切に設定してください。フォントの設定については、Server Based Converter のマニュアルを参照してください。
JavaJDK 1.7.0_05 以上
GhostScript
GhostScript 9.06 以上。日本語 Windows で、日本語を正しく処理するためには、日本語 Windows 用 GPL GhostScript を使ってください。その他のプラットフォーム用 GPL GhostScript で、日本語を正しく処理するためには、あなたのフォント環境に合わせて、フォントを適切に設定してください。フォントの設定については、GhostScript のマニュアルを参照してください。
ダウンロード場所Java
http://www.oracle.com/technetwork/java/javase/downloads/index.html
日本語 Windows 用 GPL GhostScript
http://www.khotta.org/ghost/index.html
その他のプラットフォーム用 GPL GhostScript
http://www.ghostscript.com/download/gsdnld.html

3

我々のテスト環境
Ssrver Based Converter V4.0MR2 日本語版
Window 7 Professional 32bit
JDK 1.7.0_05
GhostScript 9.06 日本語版

2–2 環境変数の設定
GSSBC の実行前に、以下の環境変数を設定してください。
パスが空白を含む場合は、ダブルクォート (") で括ってください。
SBC の環境変数
SBC の Java インターフェースが実行できるように、SBC のマニュアルにしたがって、環境変数を設定してください。
JAVA_HOME
JAVA_HOME には、Java がインストールされているフォルダ/ディレクトリを設定してください。
WindowsJava が、
c:\jdk1.7.0にインストールされているなら、
set JAVA_HOME=c:\jdk1.7.0
LinuxJava が、/usr/local/java/jdk1.7.0にインストールされているなら、
export JAVA_HOME=/usr/local/java/jdk1.7.0

4

第 2 章 準備

GSSBC_HOMEGSSBC_HOME には、GSSBC がインストールされているフォルダ/ディレクトリを設定してください。
Windows
GSSBC が、c:\gssbcにインストールされているなら、
set GSSBC_HOME=c:\gssbc
Linux
GSSBC が、~/gssbcにインストールされているなら、
export GSSBC_HOME=~/gssbc

GS_PROG_PATH
GS_PROG_PATH には、GS の実行プログラムのパスを設定してください。
GS によるイメージ出力をしないのなら、このステップは省略できます。
Windows
GS の実行プログラムが、C:\Program Files\gs\gs9.06\bin\gswin32c.exe
なら、
set GS_PROG_PATH="C:\Program Files\gs\gs9.06\bin\gswin32c.exe"5LinuxGS の実行プログラムが、/opt/ghostscript-9.06-linux_x86_64/gs-906-linux_x86_64
なら、export GS_PROG_PATH=/opt/ghostscript-9.06-linux_x86_64/gs-906-linux_x86_64

6

第3章 変 換 の 流 れ
GSSBC は、次のように、SBC と GS を使って変換を実行します。

図 3.1 GSSBC のコンポーネント

3–1 P D F 出 力(1-1) 入力が MS Office など SBC がサポートしているファイルの場合

図 3.2 MS Office ファイルなどから PDF へ7

3–2 イメージ出力
イメージ出力に、SBC を使うか、GS を使うかは、コマンドライン
オプションの -p に指定された値で決まります。 @で始まる SBC のプリンタ名なら、SBC を使います。それ以外は、GS のデバイス名とみなして GS を使います。
Linux では、SBC によるイメージ出力はできません。GS によるイメージ出力のみです。 Windows では、SBC によるイメージ出力と GSによるイメージ出力の両方が可能です。
(2-1) 入力が PDF の場合

図 3.3 PDF からイメージへ(2-2) 入力が MS Office など SBC がサポートしているファイルの場合

8

第 3 章 変換の流れ

図 3.4 MS Office ファイルなどからイメージへ

3–3 Flash(SWF), SVG, INX, and XPS 出力(3-1) 入力が PDF の場合

図 3.5 PDF から Flash(SWF), SVG, INX, XPS へ(3-2) 入力が MS Office など SBC がサポートしているファイルの場合

9

図 3.6 MS Office ファイルなどから Flash(SWF), SVG, INX, XPS へ

10

第4章 実行

4–1 プログラムの起動
GSSBC の実行には、%GSSBC_HOME%\bin\gssbc.bat (Windows の場合)
または、
$GSSBC_HOME/bin/gssbc.sh (Linux の場合)を使います。

4–2 環 境 変 数
Linux では、$GSSBC_HOME/bin/*.sh には、実行可能パーミッションをつけてください。
cd $GSSBC_HOME/binchmod +x *.sh
必要に応じて、%GSSBC_HOME%\bin (Windows の場合)
または、$GSSBC_HOME/bin (Linux の場合)
を環境変数 PATH に追加してください。
次のコマンドを実行して、GSSBC のヘルプが出るか確認してくだ
さい。
Windows の場合%GSSBC_HOME%\bin\gssbc.bat -?
Linux の場合
$GSSBC_HOME/bin/gssbc.sh -?

11

4–3 実 行 例
以下の例にあるコマンドラインオプションの説明は、「コマンドラインオプション」（p. 16） を読んでください。
出力ファイル名が決まるルールの説明は、「出力ファイル名の決定方法」（p. 19） を読んでください。
１つのファイルを変換
gssbc test.doc
こ れ は 、 SBC を 使 っ て 、 MS Office フ ァ イ ル 'test.doc' を'test.odt.pdf'に変換します。
１つのファイルを変換 (詳細表示モード、MS Office ファイル)gssbc -v test.doc
これは、実行の詳細を表示し、SBC を使って、MS Office ファイ
ル'test.doc'を'test.doc.pdf'に変換します。
１つのファイルを変換 (出力ファイル名を指定)
gssbc -o my-test.pdf test.doc
これは、SBC を使って、MS Office ファイル'test.doc'を'mytest.pdf'に変換します。
１つのファイルを変換 (出力形式を指定。GS によるイメージ出力)GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
gssbc -p jpeg test.doc

12

第 4 章 実行

こ れ は 、 MS Office フ ァ イ ル 'test.doc' を 、 GS を 使 っ て 、'test.doc.jpeg'に変換します。
１つのファイルを変換 (出力形式を指定。出力ファイル名を指定。
GS によるイメージ出力、MS Office ファイル)
GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
gssbc -p png16m -o my-test.png test.doc
これは、MS Office ファイル'test.doc'を、GS を使って、'mytest.png'に変換します。
複数のファイルを変換
gssbc test.doc test1.doc
こ れ は 、 SBC を 使 っ て 、 MS Office フ ァ イ ル 'test.doc' を'test.doc.pdf', 'test1.doc'を'test1.doc.pdf'に変換します。
複数のファイルを変換 (出力ディレクトリ指定、GS によるイメージ出力)
GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
Windows
gssbc -d \temp -p jpeg test*.pdf
PDF ファイル'test.pdf', 'test1.pdf'がある場合、これは、\tempの下に、GS を使って、test.pdf.jpeg、test1.pdf.jpeg を作ります。

13

Linux
gssbc -d /temp -p jpeg test*.pdf
PDF ファイル'test.pdf', 'test1.pdf'がある場合、これは、/tempの下に、GS を使って、test.pdf.jpeg、test1.pdf.jpeg を作ります。
複数のファイルを変換 (出力ディレクトリ指定、SBC によるイメージ出力)
SBC によるイメージ出力は、SBC Windows 版では動きますが、Linux版では動きません。
SBC によるイメージ出力は、-p で、@で始まる SBC のプリンタ名を指定します。
Windows
gssbc -d \temp -p @JPEG test*.pdf
PDF ファイル'test.pdf', 'test1.pdf'がある場合、これは、\tempの下に、SBC を使って、test.pdf.jpeg、test1.pdf.jpeg を作ります。
Linux
gssbc -d /temp -p @JPEG test*.pdf
PDF ファイル'test.pdf', 'test1.pdf'がある場合、これは、/tempの下に、SBC を使って、test.pdf.jpeg、test1.pdf.jpeg を作ります。
複数のファイルを変換 (GS オプションファイル指定。GS によるイメージ出力)
GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
gssbc -gsopt my-gs.opt -p jpeg test*.doc
MS Office ファイル'test.doc', 'test1.doc'がある場合、GS オプ
シ ョ ン フ ァ イ ル と GS を 使 っ て 、 'test.doc.jpeg',14

第 4 章 実行'test1.doc.jpeg'を作ります。

15

第 5 章 コマンドラインオプション
GSSBC のコマンドラインオプション
gssbc[-?][-doutput_dir][-gsopt
gs_option_file][-ooutput_file][-p output_format][-password password][-sbcopt
sbc_option_file][-v][-x level] input_files-?
ヘルプメッセージを出します。
-d
出力ディレクトリを指定します。デフォルトは、各入力ファイルと同じディレクトリになります。これは、複数の入力ファイルのときのみ、有効です。入力ファイルが１つだけのときは、無視されます。
-gsoptGS のオプションファイルを指定します。
-o
出力ファイルを指定します。これは、入力ファイルが１つだけのときに有効です。複数ファイルのときは、無視されます。
-p
出力形式を指定します。デフォルトは@PDF です。GS によってイメージファイルを作りたいときは、GS の出力デバイス名を指定します。例 jpeg, png16m。あるいは、SBC によってイメージファイルを作りたいときは、SBC のプリンタ名を指定します。
例 @JPEG, @PNG。SBC のプリンタ名@JPEG, @PNG などは、GSSBCが Windows で動いているときに有効です。
Ghostscript のデバイス名について詳しい情報は、以下を参照してください。
http://www.gnu.org/software/ghostscript/devices.html
SBC のプリンタ名について詳しい情報は、以下を参照してくださ16

第 5 章 コマンドラインオプションい。
日 本 語 :
http://www.antenna.co.jp/sbc/manual/sbcxslcmd.html
英語: http://rainbowpdf.com/serverdoc/sbc-xslcmd.html-password
ソースパスワード (変換元ファイルのパスワード) を指定します。
-sbcopt
SBC のオプションファイルを指定します。
-v
詳細表示モードにします。
-versionバージョン情報を表示します。
-x
SBC のエラー終了レベルを指定します。デフォルトは、2 です。
input_files
入力ファイルです。
詳細表示メッセージ、エラーメッセージなどは、標準エラー出力に出力されます。
これらのメッセージを、ファイルにリダイレクトするには、gssbc
コマンドを次のように使います。
例１ 標準エラー出力のみリダイレクト
gssbc input_file 2>error.txt
例２ 標準出力、標準エラー出力の両方をリダイレクト
gssbc input_file >error.txt 2>&1

17

第6章 技 術 資 料
6–1 スペースを含むファイル名についてスペースを含むファイル名は、トラブルの元です。スペースを含むファイル名は、使わないほうが賢明です。
bin ディレクトリの下の gssbc.sh は、スペースを含むファイル名を処理できません。スペースを含むファイル名を処理するためには、あなたが、シェルスクリプトを書く必要があります。
サンプルとして、bin ディレクトリの下に、space-gssbc.sh があります。必要に応じて、これを変更してください。
最後の方法として、シェルスクリプトを使わずに、Java を直接起動する方法があります。
例
export GSSBC_HOME=~/gsoosbc-top/gssbc
export GS_PROG_PATH=/usr/bin/gs
export SBC_HOME=/usr/ServerBasedConverter
export SBC_LIC_PATH=$SBC_HOME/etc
export SBC_DMC_TBLPATH=$SBC_HOME/sdata/base2
export AHFS10_64_FONT_CONFIGFILE=$SBC_HOME/etc/fontconfig.xml
export PATH=$SBC_HOME/bin:$PATH
export LD_LIBRARY_PATH=$SBC_HOME/lib:$LD_LIBRARY_PATH
export CLASSPATH=$SBC_HOME/lib/DfvJavaCtl.jar:$CLASSPATH
export JRE_HOME=${JAVA_HOME}/jre
export MY_JAR=${GSSBC_HOME}/lib/gssbc-1.0.4.jar

これらの環境変数を設定して、Java を直接実行。

18

第 6 章 技術資料${JRE_HOME}/bin/java -cp ${CLASSPATH}:${MY_JAR} -Dgspath=${GS_PROG_PATH} jp.co.antenna.gssbc.GsSbc -v "~/test-data/dir with space/test.doc"

6–2 ソースパスワードとターゲットパスワードの違い
暗号化された入力ファイルに設定されているパスワードを、ソースパスワードと呼びます。
出力する PDF に設定するパスワードを、ターゲットパスワードと呼びます。
ソースパスワードは、-password オプションで指定します。
SBC で PDF を出力する場合、ターゲットパスワードは、-sbcopt オプションで指定します。

6–3 出力ファイル名の決定方法
出力ファイル名は、以下のように決まります。
(1) 入力ファイルが１つだけの場合(1-1) -o で出力ファイルが指定されている
出力ファイル名は、-o で指定されたファイル(1-2) -o がない(1-2-1) -d で出力ディレクトリが指定されている
出力ファイル名は、-d で指定された出力ディレクトリ + 入力ファイル名+ 出力形式の拡張子(1-2-2) -d がない
出力ファイル名は、
入力ファイル名 + 出力形式の拡張子(2) 入力ファイルが複数の場合-o は、無視される。
(2-1) -d で出力ディレクトリが指定されている
出力ファイル名は、
19

-d で指定された出力ディレクトリ + 各入力ファイル名 +出力形式の拡張子(2-2) -d がない
出力ファイル名は、各入力ファイル名 + 出力形式の拡張子
入力ファイルのディレクトリが違えば、出力ファイルも違うディレクトリになる。

6–4 Server Based Converter のオプションファイル
コマンドラインオプションの-sbcopt は、SBC に対するオプションを書いたファイルを指定します。
-sbcopt は、SBC で、PDF, イメージ、Flash(SWF), SVG, INX, XPSを出力するときに使います。
SBC の Java イ ン タ ー フ ェ ー ス の オ ブ ジ ェ ク ト
jp.co.antenna.DfvObj に対して、API を呼び出すことで、オプションを指定します。
jp.co.antenna.DfvObj の API については、以下を参照してください。
英語版 API 仕様
http://rainbowpdf.com/serverdoc/javadoc/index.html
日本語版 API 仕様
http://www.antenna.co.jp/sbc/manual/V4.0/javadoc/index.html
ファイルの形式
オプションファイルは、UTF-8 で書いてください。
英語だけなら ASCII で書くことが可能です。
行頭に#があるとコメント行です。
各行に API 名とパラメータを、空白かタブで区切って並べます。
パラメータの形式は、次の通り。
10 進数は、'0'から'9'の数字の列。例 10。
文字列は、" でくくる。例 "MyString"。
ブール値は、true か false。
20

第 6 章 技術資料

API の例
setStartPage
setWatermarkText
setOmitBlankPages

10"My Test Document"
true

サンプルファイルは、bin/sbcopt-sample.opt です。
注意API の指定が、DfvObj の API 仕様と合ってないと結果は保証されません。
API が呼ばれていることを表示するには、コマンドラインオプシ
ョン -v が必要です。
setPdf で始まる API は、OpenOffice/LibreOffice 以外のファイルを、SBC を使って PDF に変換するときに有効です。
DfvObj の API のうち、以下は、無効です。
excute, releaseObjectEx, render, getXXX
set で始まる XXX のうち、以下は、無効です。
setDocumentURI, setExitLevel, setMessageListener
setOutputFilePath, setFormatPageListener, setPrinterName
設定

例

例1
１ページのみ出力。濃い透かし「Test」を入れる。
setEndPage
1
setWatermarkText"Test"
setWatermarkOpacity"100%"

6–5 GhostScript のオプションファイル
コマンドラインオプションの-gsopt は、GS に対するオプションを書いたファイルを指定します。
-gsopt は、GS で、イメージを出力するときに使います。「変換の流れ」の「イメージ出力」（p. 8）を参照してください。
21

SBC で、イメージを出力するときは、-gsopt ではなく、-sbcoptを使います。
GhostScript の使い方、オプションについては、以下を参照してください。
GNU GhostScript
http://www.gnu.org/software/ghostscript/
How to use Ghostscript
http://www.ghostscript.com/doc/current/Use.htm
注意
GS の出力イメージフォーマットは、このファイルではなく、GSSBCのコマンドラインの-p オプションの引数で指定します。
使用できる出力イメージフォーマットは、GS の出力デバイス名です。
例１: JPEG 出力-p jpeg
例２: PNG 出力-p png16m
出力デバイス名など、GS の出力デバイスについては、以下を参照してください。
Details of Ghostscript output devices
http://www.ghostscript.com/doc/current/Devices.htm
Ghostscript Devices
http://www.gnu.org/software/ghostscript/devices.html
ファイルの形式
オプションファイルは、UTF-8 で書いてください。
英語だけなら ASCII で書くことが可能です。
行頭に#があるとコメント行です。
GS_FILE_NUMBERING_FORMAT で始まる行は、出力ファイル名の番号付けの書式を指定します。
%以降の書式指定の詳細は、
http://www.ghostscript.com/doc/current/Use.htm#One_page_per_file22

第 6 章 技術資料を参照してください。
GS_FILE_NUMBERING_FORMAT 行は、GS_FILE_NUMBERING_FORMAT とパラメータが、空白かタブで区切られています。
GSSBC は、パラメータを、出力ファイル名のファイル拡張子の前に挿入して、GS の出力ファイル名にします。
例:
GS_FILE_NUMBERING_FORMAT -%03d
入力ファイル名 foo.pdf、出力ファイル名が foo.jpeg のとき、"%03d" を 指 定 す る と 、 GS に 指 定 す る 出 力 フ ァ イ ル 名 は 、 foo%03d.jpeg になります。
これは、最終的に、foo-001.jpeg, foo-002.jpeg などとなります。
GS_FILE_NUMBERING_FORMAT 以外の行は、GS のオプションになります。
GSSBC は、複数の行を、空白で連結して、GS のオプションを作ります。
オプションの挙動は、GS の実装に依存します。
サンプルファイルは、bin/gsopt-sample.opt です。
注意
以下のオプションは、使わないでください。これらは、GSSBC が設定します。
-dSAFER-dBATCH-dNOPAUSE-o-sDEVICE-sOutputFile23設定例

例1# 静かなモード-q# サムネイル用に、最初のページだけ出力-dLastPage=1# 32 ピクセル * 32 ピクセルのイメージ-g32
例2# 静かなモード-q# ファイル名のナンバリング形式
GS_FILE_NUMBERING_FORMAT -%03d
例3# 静かなモード-q# ファイル名のナンバリング形式
GS_FILE_NUMBERING_FORMAT -%03d# 640 ピクセル * 480 ピクセルのイメージ-g640x480
例4# 静かなモード-q# ファイル名のナンバリング形式
GS_FILE_NUMBERING_FORMAT -%03d# 300dpi-r300

24

第 6 章 技術資料

# テキストとグラフィックスのアルファビットを設定-dTextAlphaBits=4-dGraphicsAlphaBits=425

改 訂 履 歴2013 年 02 月 26 日
1.0 版 GSSBC 1.0 用の初版。
2013 年 06 月 27 日
1.1 版 構成を大幅に変更。スペースを含むファイル名について、記述を追加。

26

図一覧

第 1 章 概要
図 1.1 GSSBC components（p. 1）

第 3 章 変換の流れ
図 3.1 GSSBC のコンポーネント（p. 7）
図 3.2 MS Office ファイルなどから PDF へ（p. 7）
図 3.3 PDF からイメージへ（p. 8）
図 3.4 MS Office ファイルなどからイメージへ（p. 9）
図 3.5 PDF から Flash(SWF), SVG, INX, XPS へ（p. 9）
図 3.6 MS Office ファイルなどから Flash(SWF), SVG, INX, XPS へ（p. 10）

28

索引
Server Based Converter
Flash(SWF) 出力 20

アルファベット1, 3Flash(SWF) 出力 9Server Based Converter 20
GhostScript 1, 3
オプションファイル 16, 21
実行例 12, 13, 14出力デバイス名 16GS 1
GSSBC 1
概要 1
コマンドラインオプション 16

INX 出力 20
PDF 出力 20
SVG 出力 20
XPS 出力 20
イメージ出力 20
オプションファイル 17, 20
実行例 12, 13, 14
プリンタ名 16
SVG 出力 9Server Based Converter 20

実行 11
実行例 12
準備 3
必要なソフト 3
変換の流れ 7GSSBC_HOME
環境変数 5
GS_PROG_PATH
環境変数 5
INX 出力 9Server Based ConverterJava 3

XPS 出力 9Server Based Converter

JAVA_HOME
環境変数 4MS Office 1
実行例 12, 13
PATH
環境変数 11
PDF 1
PDF 出力 7
Server Based Converter
実行例 12, 13
SBC 120

あイメージ出力821
Server Based Converter 20
実行例 12, 13, 14
オプションファイル
GhostScript 16, 21
20

Server Based Converter

17, 20

か20

概要GSSBC 1
環境変数 4GSSBC_HOME 5
GS_PROG_PATH 5
JAVA_HOME 4
PATH 11
コマンドラインオプション
GSSBC 1630

索引
さ実行
GSSBC 11
実行可能パーミッション 11
実行例
GhostScript 12, 13, 14
GSSBC 12MS Office 12, 13
PDF 出力 12, 13Server Based Converter 12, 13, 14
イメージ出力 12, 13, 14出力形式 16
出力デバイス名GhostScript 16
準備
GSSBC 3
ソースパスワード
パスワード 17, 19

たターゲットパスワード
パスワード 19はパスワードソースパスワード 17, 19
ターゲットパスワード 19
必要なソフトGSSBC 3
ファイル形式 2
プリンタ名
Server Based Converter
変換先ファイル形式 2
変換の流れ
GSSBC 7
変換元ファイル形式 21631

GSSBC マニュアル
2013/02/26
2013/06/27

1.0
1.1

1.0 版 GSSBC 1.0 用の初版。
1.1 版 構成を大幅に変更。スペースを含むファイル名について、記述を追加。

アンテナハウス株式会社
Copyright (C) 2013 Antenna House, Inc. All rights reserved.