GSOOSBC マニュアル

2013/06/27

1.6

目

次

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

第 2 章 準備

1
1
2
3

3
2–1 必要なソフト
2–2 環境変数の設定
4
7
2–3 OpenOffice/LibreOffice のリッスンモードの起動
2–4 OpenOffice/LibreOffice のリッスンモードの終了 10
2–5 OpenOffice/LibreOffice のリッスンモードと GUI の同時実行に関する問題
10

第 3 章 変換の流れ
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 出力ファイル名の決定方法

12
12
13
15
17
17
17
18
23
26
26
27
27

iii

28
6–4 Server Based Converter のオプションファイル
6–5 OpenOffice/LibreOffice の PDF エクスポートオプショ
ンファイル
30
6–6 GhostScript のオプションファイル
38

改訂履歴
図一覧
索引

iv

42
44
46

第1章 概要

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

1

図 1.1 GSOOSBC components

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

新たな変換元ファイル形式
OO/LO のファイル
拡張子が以下のもの。
.odp
プレゼンテーション
.ods
表計算
.odt
ワープロ
新たな変換先ファイル形式
GS がサポートしている出力ファイル形式2

第2章 準備

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

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

第 2 章 準備

set JAVA_HOME=c:\jdk1.7.0
LinuxJava が、/usr/local/java/jdk1.7.0にインストールされているなら、
export JAVA_HOME=/usr/local/java/jdk1.7.0

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

OO_PROG_PATH
OO_PROG_PATH には、OO/LO の実行プログラムのパスを設定してください。
OO/LO のファイルを変換しないのなら、このステップは省略でき
5

ます。
Windows
OO の実行プログラムが、
C:\Program Files\OpenOffice.org 3\program\soffice.exe
なら、
set OO_PROG_PATH="C:\Program Files\OpenOffice.org 3\program\soffice.exe"
LO の実行プログラムが、
C:\Program Files\LibreOffice 3.5\program\soffice.exe
なら、
set OO_PROG_PATH="C:\Program Files\LibreOffice 3.5\program\soffice.exe"
Linux
OO の実行プログラムが、/opt/openoffice.org3/program/soffice
なら、export OO_PROG_PATH=/opt/openoffice.org3/program/soffice
LO の実行プログラムが、
OO_PROG_PATH=/opt/libreoffice3.5/program/soffice
なら、export OO_PROG_PATH=/opt/libreoffice3.5/program/soffice6

第 2 章 準備

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"
Linux
GS の実行プログラムが、/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

2–3 OpenOffice/LibreOffice のリッスンモードの起動
GSOOSBC を実行する前に、OO/LO をリッスンモードで動かす必要があります。
OO/LO をリッスンモードで動かすのには、%GSOOSBC_HOME%\bin\start-oo.bat や $GSOOSBC_HOME/bin/start-oo.sh が使えます。
リースンモードで使うポート番号のデフォルトは、8100 です。
警告: 複数の OO または LO を同時に起動することは、トラブルの元になりますので、行わないでください。

7

Windows(1) コマンドプロンプトを実行します。
(2) start-oo.bat を実行します。
LO の起動には、'libre' パラメータを使います。
cd %GSOOSBC_HOME%\bin
OO の場合、
start-oo.bat
LO の場合、
start-oo.bat libre
OO/LO の動作確認
別のコマンドプロンプトを実行して、netstat -anp tcpを実行してください。
TCP

127.0.0.1:8100

0.0.0.0:0

LISTENINGのような行があれば、OO/LO がポート番号 8100 のリッスンモード
で動作しています。
%GSOOSBC_HOME%\bin\start.bat は、環境変数 OO_PORT によって、リッスンするポート番号を変更できます。
8200 にする場合
set OO_PORT=8200
start-oo.bat
または、
set OO_PORT=8200
start-oo.bat libre8

第 2 章 準備

Linux(1) ターミナルソフトを実行します。
(2) $GSOOSBC_HOME/bin/*.sh には、実行可能パーミッションをつけてください。
cd $GSOOSBC_HOME/binchmod +x *.sh(3) OO/LO を起動します。
LO の起動には、'libre' パラメータを使います。
cd $GSOOSBC_HOME/bin
OO の場合、
start-oo.sh
LO の場合、
start-oo.sh libre
OO/LO の動作確認
別のターミナルソフトを実行して、netstat -anp --tcp | grep 8100を実行。
tcp 0 0 127.0.0.1:8100 0.0.0.0:* LISTEN 19348/soffice.binのような行があれば、OO/LO がポート番号 8100 のリッスンモード
で動作しています。
$GSOOSBC_HOME/bin/start.sh は、環境変数 OO_PORT によって、リッスンするポート番号を変更できます。
8200 にする場合
export OO_PORT=8200./start-oo.sh
9またはexport OO_PORT=8200./start-oo.sh libre

2–4 OpenOffice/LibreOffice のリッスンモードの終了
リッスンモードで動いている OO/LO は、以下の方法で終了できます。
ただし、強制終了になるので、変換途中など何か処理中に終了させると、変換が正常に終了しない可能性があります。
Windows
タスクマネージャを実行して、プロセスタブで、soffice.exe を選択し、プロセスの終了ボタンを押します。
Linux
ps ax | grep soffice
で、OO/LO のプロセス ID(PID) を得て、kill -9 PID
で、終了します。

2–5 OpenOffice/LibreOffice のリッスンモードと GUI の同時実行に関する問題
OO または LO を、リッスンモードと GUI で、同時に実行しないでください。
OO/LO の同時起動について、2012/08/16 時点で判明していることは次の通りです。いずれも Windows で確認した動作です。
OO/LO をリッスンモードで起動しているマシンでは、GUI の OO/LO
を起動することはできません。違う場所にインストールされた２つ
10

第 2 章 準備の OO/LO を使ってもできないようです。
GUI の OO/LO を先に起動してから、リッスンモードの OO/LO を起動することはできますが、GUI を終了するとリッスンモードの OO/LO
も終了します。
以上から、リッスンモードと GUI の OO/LO の同時起動は、できな
いと考えるべきでしょう。
OO/LO をリッスンモードで起動しているマシンでは、同じポート
番号でリッスンモードの OO/LO を起動することはできません。しかし、違うポート番号であれば、同時に起動できます。 つまり、ともにリッスンモード、かつ、違うポート番号であれば、同時起動できます。
とはいえ、リッスンモードでも、同時起動はトラブルの元になりやすいので、やめておいたほうがいいでしょう。

11

第3章 変 換 の 流 れ
GSOOSBC は、次のように、SBC, OO/LO と GS を使って変換を実行します。
OO/LO のファイルについては、GSOOSBC は、OO/LO のリッスンモー
ド1）を使って、OO/LO のファイルを PDF に変換し、必要ならさらにイメージなどに変換します。

図 3.1 GSOOSBC のコンポーネント

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

1） リッスンモードとは、OO/LO を GUI ではなく、サーバとして動かすモードです。

12

第 3 章 変換の流れ

図 3.2 MS Office ファイルなどから PDF へ(1-2) 入力が、OO/LO のファイルの場合

図 3.3 OO/LO ファイルから PDF へ

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

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

図 3.5 MS Office ファイルなどからイメージへ(2-3) 入力が OO/LO のファイルの場合

14

第 3 章 変換の流れ

図 3.6 OO/LO ファイルからイメージへ

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

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

15

図 3.8 MS Office ファイルなどから Flash(SWF), SVG, INX, XPS へ(3-3) 入力が、OO/LO のファイルの場合

図 3.9 OO/LO ファイルから Flash(SWF), SVG, INX, XPS へ

16

第4章 実行

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

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

17

4–3 実 行 例
以下の例にあるコマンドラインオプションの説明は、「コマンドラインオプション」（p. 23） を読んでください。
出力ファイル名が決まるルールの説明は、「出力ファイル名の決定方法」（p. 27） を読んでください。
１つのファイルを変換
gsoosbc test.doc
こ れ は 、 SBC を 使 っ て 、 MS Office フ ァ イ ル 'test.doc' を'test.odt.pdf'に変換します。
１つのファイルを変換 (詳細表示モード、MS Office ファイル)gsoosbc -v test.doc
これは、実行の詳細を表示し、SBC を使って、MS Office ファイ
ル'test.doc'を'test.doc.pdf'に変換します。
１つのファイルを変換 (詳細表示モード、OO/LO ファイル)gsoosbc -v test.odt
これは、ポート番号 8100 に接続して、OO/LO ファイル'test.odt'
を'test.odt.pdf'に変換します。
１つのファイルを変換 (ポート番号指定。詳細表示モード)
gsoosbc -v -port 8200 test.odt
これは、ポート番号 8200 に接続して、OO/LO ファイル'test.odt'
を'test.odt.pdf'に変換します。

18

第 4 章 実行

１つのファイルを変換 (出力ファイル名を指定)
gsoosbc -o my-test.pdf test.doc
これは、SBC を使って、MS Office ファイル'test.doc'を'mytest.pdf'に変換します。
１つのファイルを変換 (出力形式を指定。GS によるイメージ出力)
GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
gsoosbc -p jpeg test.doc
こ れ は 、 MS Office フ ァ イ ル 'test.doc' を 、 GS を 使 っ て 、'test.doc.jpeg'に変換します。
１つのファイルを変換 (出力形式を指定。SBC によるイメージ出力)
SBC によるイメージ出力は、SBC Windows 版では動きますが、Linux
版では動きません。
SBC によるイメージ出力は、-p で、@で始まる SBC のプリンタ名を指定します。
gsoosbc -p @PNG test.odt
これは、ポート番号 8100 に接続して、OO/LO ファイル'test.odt'
を、SBC を使って、'test.odt.png'に変換します。
１つのファイルを変換 (出力形式を指定。出力ファイル名を指定。
GS によるイメージ出力、MS Office ファイル)
GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
19

gsoosbc -p png16m -o my-test.png test.doc
これは、MS Office ファイル'test.doc'を、GS を使って、'mytest.png'に変換します。
１つのファイルを変換 (出力形式を指定。出力ファイル名を指定。
GS によるイメージ出力、OO/LO ファイル)
GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
gsoosbc -p jpeg -o my-test.jpeg test.odt
これは、ポート番号 8100 に接続して、OO/LO ファイル'test.odt'
を、GS を使って、'my-test.jpeg'に変換します。
複数のファイルを変換
gsoosbc test.doc test1.doc
こ れ は 、 SBC を 使 っ て 、 MS Office フ ァ イ ル 'test.doc' を'test.doc.pdf', 'test1.doc'を'test1.doc.pdf'に変換します。
複数のファイルを変換 (出力ディレクトリ指定)
Windows
gsoosbc -d \temp test.odt test1.odt(Windows)

これは、ポート番号 8100 に接続して、OO/LO ファイル'test.odt','test1.odt' を 変 換 し て 、 \temp の 下 に 、 'test.odt.pdf','test1.odt.pdf'を作ります。
Linux
gsoosbc -d /temp test.odt test1.odt(Linux)

これは、ポート番号 8100 に接続して、OO/LO ファイル'test.odt',
20

第 4 章 実行'test1.odt' を 変 換 し て 、 /temp の 下 に 、 'test.odt.pdf','test1.odt.pdf'を作ります。
複数のファイルを変換 (出力ディレクトリ指定、GS によるイメージ
出力)GS によるイメージ出力は、SBC Linux 版でも Windows 版でも動きます。
GS によるイメージ出力は、-p で GS の出力デバイス名を指定します。
Windows
gsoosbc -d \temp -p jpeg test*.pdf
PDF ファイル'test.pdf', 'test1.pdf'がある場合、これは、\tempの下に、GS を使って、test.pdf.jpeg、test1.pdf.jpeg を作ります。
Linux
gsoosbc -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
gsoosbc -d \temp -p @JPEG test*.pdf
PDF ファイル'test.pdf', 'test1.pdf'がある場合、これは、\tempの下に、SBC を使って、test.pdf.jpeg、test1.pdf.jpeg を作ります。

21

Linuxgsoosbc -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 の出力デバイス名を指定します。
gsoosbc -gsopt my-gs.opt -p jpeg test*.odt
OO/LO ファイル'test.odt', 'test1.odt'がある場合、これは、ポート番号 8100 に接続して、GS オプションファイルと GS を使って、'test.odt.jpeg', 'test1.odt.jpeg'を作ります。

22

第 5 章 コマンドラインオプション
GSOOSBC のコマンドラインオプション
gsoosbc [-?][-d output_dir][-gsopt gs_option_file][-ooutput_file][-oopdfopt
oo_pdf_option_file][-ooport
port_number][-p output_format][-password password][-sbcopt
sbc_option_file][-v][-x level] input_files-?
ヘルプメッセージを出します。
-d
出力ディレクトリを指定します。デフォルトは、各入力ファイ
ルと同じディレクトリになります。これは、複数の入力ファイルのときのみ、有効です。入力ファイルが１つだけのときは、無視されます。
-gsoptGS のオプションファイルを指定します。
-o
出力ファイルを指定します。これは、入力ファイルが１つだけのときに有効です。複数ファイルのときは、無視されます。
-oopdfopt
OO/LO の PDF エクスポートに関するオプションファイルを指定します。
-ooportOO/LO のリッスンモードのポート番号を指定します。デフォル
トは、8100 です。
-p
出力形式を指定します。デフォルトは@PDF です。GS によってイメージファイルを作りたいときは、GS の出力デバイス名を指定します。例 jpeg, png16m。あるいは、SBC によってイメージ
ファイルを作りたいときは、SBC のプリンタ名を指定します。
例 @JPEG, @PNG 。 SBC の プ リ ン タ 名 @JPEG, @PNG な ど は 、
23

GSOOSBC が Windows で動いているときに有効です。
Ghostscript のデバイス名について詳しい情報は、以下を参照してください。
http://www.gnu.org/software/ghostscript/devices.html
SBC のプリンタ名について詳しい情報は、以下を参照してください。
日 本 語 :
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
入力ファイルです。
詳細表示メッセージ、エラーメッセージなどは、標準エラー出力に出力されます。
これらのメッセージを、ファイルにリダイレクトするには、
gsoosbc コマンドを次のように使います。
例１ 標準エラー出力のみリダイレクト
gsoosbc input_file 2>error.txt
例２ 標準出力、標準エラー出力の両方をリダイレクト24

第 5 章 コマンドラインオプション

gsoosbc input_file >error.txt 2>&1

25

第6章 技 術 資 料
6–1 スペースを含むファイル名についてスペースを含むファイル名は、トラブルの元です。スペースを含
むファイル名は、使わないほうが賢明です。
bin ディレクトリの下の gsoosbc.sh は、スペースを含むファイル
名を処理できません。スペースを含むファイル名を処理するためには、あなたが、シェルスクリプトを書く必要があります。
サンプルとして、bin ディレクトリの下に、space-gsoosbc.sh があります。必要に応じて、これを変更してください。
最後の方法として、シェルスクリプトを使わずに、Java を直接起動する方法があります。
例
export GSOOSBC_HOME=~/gsoosbc-top/gsoosbc
export GS_PROG_PATH=/usr/bin/gs
export OO_PROG_PATH=/opt/openoffice.org3/program/sofficeexport 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=${GSOOSBC_HOME}/lib/gsoosbc-1.0.7.jar
これらの環境変数を設定して、Java を直接実行。

26

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

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

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

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

6–4 Server Based Converter のオプションファイル
コマンドラインオプションの-sbcopt は、SBC に対するオプションを書いたファイルを指定します。
-sbcopt は、SBC で、PDF, イメージ、Flash(SWF), SVG, INX, XPSを出力するときに使います。
OO/LO の フ ァ イ ル を PDF に す る と き は 、 -sbcopt で は な く 、 oopdfopt を使います。
「変換の流れ」の「PDF 出力」（p. 12）を参照
してください。
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 で書くことが可能です。
行頭に#があるとコメント行です。
28

第 6 章 技術資料

各行に API 名とパラメータを、空白かタブで区切って並べます。
パラメータの形式は、次の通り。
10 進数は、'0'から'9'の数字の列。例 10。
文字列は、" でくくる。例 "MyString"。
ブール値は、true か false。
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%"

29

6–5 OpenOffice/LibreOffice の PDF エクスポートオプションファイル
コマンドラインオプションの-oopdfopt は、OO/LO の PDF エクスポートに対するオプションを書いたファイルを指定します。
-oopdfopt は、OO/LO のファイルを PDF にするときに使います。
「変換の流れ」の「PDF 出力」（p. 12）を参照してください。
SBC で、PDF, イメージ、Flash(SWF), SVG, INX, XPS を出力する
ときは、-oopdfopt ではなく、-sbcopt を使います。
ファイルの形式
オプションファイルは、UTF-8 で書いてください。
英語だけなら ASCII で書くことが可能です。
行頭に#があるとコメント行です。
各行にオプション名とパラメータを、空白かタブで区切って並べます。
パラメータの形式は、次の通り。
10 進数は、0 から 9 の数字の列。例 10。
文字列は、" でくくる。例 "MyString"。
ブール値は、true か false。
オプションの例
EncryptFile
true
DocumentOpenPassword"test"

サンプルファイルは、bin/oopdf-sample.opt です。
注意オプションの指定が、OO/LO の仕様と合ってないと結果は保証されません。
オプションの説明
以下で、たとえば、30

第 6 章 技術資料

Quality

Integer90という行は、オプション名パラメータ型

既定値を意味しています。
より詳細な説明は、以下のリンクを参照してください。
OpenOffice
http://wiki.openoffice.org/wiki/Documentation/
OOo3_User_Guides/Getting_Started/Exporting_to_PDF
LibreOffice
http://help.libreoffice.org/Common/Export_as_PDF
LibreOffice
http://help.libreoffice.org/Common/Export_as_PDF/ja[全般] タブ[範囲]
PageRange
String""
出力範囲を指定する。空文字列は、全部出力する。
ページ範囲をエクスポートする場合は、3-6 の形式で指定する。単独のページを複数箇所エクスポートする場合は、7;9;11 の形式で指定する。ページ範囲と単独ページの指定を 3-6;8;10;12のような形式で組み合わせて使用することもできる。
[イメージ/画像]
UseLosslessCompression
Boolean
ロスレス圧縮を指定する。

false

Quality
Integer90
JPEG 圧縮の品質をパーセントで指定する。
ReduceImageResolution
画像の解像度を下げる。

Booleanfalse

31[一般/全般]
IsAddStream
Boolean
false
OpenDocument ファイルを埋め込む。
SelectPdfVersion
Integer
PDF のバージョンを指定する。
0: PDF 1.4
1: PDF/A-1a0

UseTaggedPDF
Boolean
タグ付き PDF を指定する。

false

ExportFormFields
Boolean
フォームの作成を指定する。

true

FormsType
Integer
0
送信フォーマットを指定する。
0: FDF
1: PDF
2: HTML
3: XML
AllowDuplicateFieldNames
Boolean
フィールド名の重複を許す。
ExportBookmarks
Booleanブックマークをエクスポート。
ExportNotes
Boolean
コメントをエクスポート。

false

true

false

ExportNotesPages
Booleanfalse
コメントページをエクスポート。
プレゼンテーション (Impress) のみ有効。
32

第 6 章 技術資料

IsSkipEmptyPages
Booleantrue
自動的に挿入された空白ページをエクスポートするかスキッ
プするか。
EmbedStandardFonts
Boolean
標準フォントを埋め込む。

false[初期値] タブ
[区画/ナビゲーションパネル]
InitialView
Integer
初期表示を指定する。
0: ページのみ
1: ブックマークとページ
2: サムネイルとページ

0

mnInitialPage
Integer1
リーダーが PDF ファイルをオープンしたとき、表示するページを指定する。
[拡大率]
Magnification
Integer
拡大方法を指定する。
0: 標準
1: ウィンドウに合わせる
2: 幅を合わせる
3: 表示を合わせる
4: ズーム

0

Zoom

Integer
100
ズーム率をパーセントで指定する。

33

[ページレイアウト]
PageLayout
Integer0
ページレイアウトを指定する。
0: 標準
1: 単一ページ
2: 連続
3: 連続見開き[ユーザインターフェース] タブ[ウィンドウオプション]
ResizeWindowToInitialPage
Booleanfalse
最初のページに合わせてウィンドウサイズを変更する。
CenterWindow
Booleanfalse
ウィンドウを画面中央に揃える。
OpenInFullScreenMode
Boolean
全画面表示モードで開く。

false

DisplayPDFDocumentTitle
Booleanドキュメントタイトルを表示する。

false[ユーザインターフェースオプション]
HideViewerMenubar
Boolean
メニューバーを隠す。

false

HideViewerToolbar
Boolean
ツールバーを隠す。

false

HideViewerWindowControls
Booleanウィンドウコントロールを隠す。

34

false

第 6 章 技術資料

[切り替え]
UseTransitionEffects
Boolean
切り替え効果を使用する。

true[ブックマーク]
OpenBookmarkLevels
Integer-1
オープンするブックマークの階層。
-1: すべてのブックマーク
1 以上: 指定したレベルのブックマークをオープン[リンク] タブ
ExportBookmarksToPDFDestination
Booleanブックマークを指定した宛先としてエクスポートする

false

ConvertOOoTargetToPDFTarget
Booleanfalse
参照しているドキュメントも PDF の対象として変換する
ExportLinksRelativeFsys
Booleanfalse
ファイルシステムの相対 URL にエクスポートする[クロスドキュメントリンク]
PDFViewSelection
Integer00: 標準モード
1: PDF リーダーアプリケーションで開く
2: インターネットブラウザで開く[セキュリティ] タブ[パスワードの設定]
EncryptFile
Booleanファイルを暗号化する。

false

35

DocumentOpenPassword
String
オープンパスワードを指定する。

""

RestrictPermissions
許可を制限する。

false

BooleanPermissionPassword
String
制限パスワードを指定する。

""

[印刷]
Printing
Integer
印刷の許可を指定する。
0: 許可しない
1: 低解像度 (150 DPI)
2: 高解像度2[変更]
Changes
Integer4
変更の許可を指定する。
0: 許可しない
1: ページの挿入、削除、回転のみ許可
2: フォームフィールドへの入力のみ許可
3: フォームフィールドへのコメントと入力のみ許可
4: ページの抽出以外のすべての変更を許可
EnableCopyingOfContent
Boolean
内容の抽出を有効にする。

true

EnableTextAccessForAccessibilityTools
Booleantrue
アクセシビリティツールのテキストアクセスを有効にする。

36

第 6 章 技術資料

設

定

例

例1
文書を開くパスワードの設定により、暗号化する。
パスワードは、"test"。
EncryptFile
true
DocumentOpenPassword"test"

例2
権限パスワードの設定により、印刷できないようにする。
パスワードは、"test"。
RestrictPermissions
PermissionPassword
Printing0

true"test"

例3
権限パスワードの設定により、印刷、変更、内容のコピーができないようにする。
パスワードは、test。
RestrictPermissions
true
PermissionPassword"test"
Printing
0
Changes0
EnableCopyingOfContent
false
例4
文書を開くパスワードの設定により、暗号化する。
パスワードは、test。
権限パスワードの設定により、印刷、変更、内容のコピーができないようにする。
パスワードは、foobar。
文書を開くパスワードと権限パスワードが違うことに注意。
37

EncryptFile
true
DocumentOpenPassword"test"
RestrictPermissions
true
PermissionPassword"foobar"Printing
0
Changes0
EnableCopyingOfContent
false

6–6 GhostScript のオプションファイル
コマンドラインオプションの-gsopt は、GS に対するオプションを書いたファイルを指定します。
-gsopt は、GS で、イメージを出力するときに使います。
「変換の流れ」の「イメージ出力」（p. 13）を参照してください。
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 の出力イメージフォーマットは、このファイルではなく、
GSOOSBC のコマンドラインの-p オプションの引数で指定します。
使用できる出力イメージフォーマットは、GS の出力デバイス名です。
例１: JPEG 出力-p jpeg
例２: PNG 出力-p png16m
出力デバイス名など、GS の出力デバイスについては、以下を参照
してください。
38

第 6 章 技術資料

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_file
を参照してください。
GS_FILE_NUMBERING_FORMAT 行は、GS_FILE_NUMBERING_FORMAT とパラメータが、空白かタブで区切られています。
GSOOSBC は、パラメータを、出力ファイル名のファイル拡張子の前に挿入して、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 のオプションになります。
GSOOSBC は、複数の行を、空白で連結して、GS のオプションを作ります。
オプションの挙動は、GS の実装に依存します。
サンプルファイルは、bin/gsopt-sample.opt です。
39

注意
以下のオプションは、使わないでください。これらは、GSOOSBCが設定します。
-dSAFER-dBATCH-dNOPAUSE-o-sDEVICE-sOutputFile
設

定

例

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

第 6 章 技術資料

例4
# 静かなモード-q# ファイル名のナンバリング形式
GS_FILE_NUMBERING_FORMAT -%03d# 300dpi-r300# テキストとグラフィックスのアルファビットを設定-dTextAlphaBits=4-dGraphicsAlphaBits=4

41

改 訂 履 歴2012 年 11 月 15 日
1.0 版 GSOOSBC 1.0 用の初版。
2013 年 01 月 31 日
1.1 版 GPL GhostScript のダウンロード先を改訂。
2013 年 02 月 14 日
1.2 版 スペースを含むファイル名について、記述を追加。
2013 年 02 月 26 日
1.3 版 実行例を改訂。
2013 年 05 月 28 日
1.4 版 「OpenOffice/LibreOffice のリッスンモードの起動と終了」を改訂。
2013 年 06 月 14 日
1.5 版 構成を大幅に変更。
2013 年 06 月 27 日
1.6 版 スペースを含むファイル名について、記述を追加。

42

図

一

覧

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

第 3 章 変換の流れ
図 3.1 GSOOSBC のコンポーネント（p. 12）
図 3.2 MS Office ファイルなどから PDF へ（p. 13）
図 3.3 OO/LO ファイルから PDF へ（p. 13）
図 3.4 PDF からイメージへ（p. 14）
図 3.5 MS Office ファイルなどからイメージへ（p. 14）
図 3.6 OO/LO ファイルからイメージへ（p. 15）
図 3.7 PDF から Flash(SWF), SVG, INX, XPS へ（p. 15）
図 3.8 MS Office ファイルなどから Flash(SWF), SVG, INX, XPS へ（p. 16）
図 3.9 OO/LO ファイルから Flash(SWF), SVG, INX, XPS へ（p. 16）

44

索

引
OO_PROG_PATH
環境変数 5

アルファベット
Flash(SWF) 出力 15Server Based Converter 28
GhostScript 1, 3
オプションファイル 23, 38
実行例 19, 20, 21, 22
出力デバイス名 23
GS 1
GSOOSBC 1
概要 1
コマンドラインオプション 23

OpenOffice 1, 3, 7, 10
PDF 出力 30
オプションファイル 23, 30
実行例 18, 19, 20
PATH
環境変数 17
PDF 1
PDF 出力 12
LibreOffice 30
OpenOffice 30

実行 17
実行例 18
準備 3
必要なソフト 3
変換の流れ 12GSOOSBC_HOME
環境変数 5
GS_PROG_PATH
環境変数 7
INX 出力 15
Server Based ConverterJava 3Server Based Converter 28
実行例 18, 19, 20
SBC 1
Server Based Converter 1, 3
Flash(SWF) 出力
INX 出力 28
PDF 出力SVG 出力28

28
28

XPS 出力 28
イメージ出力28

28

オプションファイル 24, 28
実行例 18, 19, 20, 21

JAVA_HOME
環境変数 4
LibreOffice 1, 3, 7, 10
PDF 出力 30
オプションファイル 23, 30
実行例 18, 19, 20
LO 1
MS Office 1
実行例 18, 19, 20
OO 1
OO/LO 1

プリンタ名 23
SVG 出力 15
Server Based Converter 28
XPS 出力 15
Server Based Converter 28

あイメージ出力 13
38
Server Based Converter
実行例 19, 20, 21, 22

28

46

索引
オプションファイル
GhostScript 23, 38
LibreOffice 23, 30
OpenOffice 23, 30
Server Based Converter

イメージ出力出力形式 23

24, 28か概要
GSOOSBC 1
環境変数 4
GSOOSBC_HOME 5
GS_PROG_PATH 7
JAVA_HOME 4
OO_PROG_PATH 5
PATH 17
コマンドラインオプション
GSOOSBC 23

さ実行
GSOOSBC 17
実行可能パーミッション 17
実行例
GhostScript 19, 20, 21, 22
GSOOSBC 18
LibreOffice 18, 19, 20
MS Office 18, 19, 20
OpenOffice 18, 19, 20
PDF 出力 18, 19, 20
Server Based Converter 18, 19,
20, 21

19, 20, 21, 22

出力デバイス名GhostScript 23
準備
GSOOSBC 3
ソースパスワード
パスワード 24, 27

たターゲットパスワード
パスワード 27

はパスワード
ソースパスワード 24, 27
ターゲットパスワード 27
必要なソフトGSOOSBC 3
ファイル形式 2
プリンタ名
Server Based Converter 23
変換先ファイル形式 2
変換の流れ
GSOOSBC 12
変換元ファイル形式
ポート番号 23

2

らリッスンモード

7, 10, 23

47

GSOOSBC マニュアル
2012/11/15
2013/06/27

1.0
1.6

GSOOSBC 1.0 用の初版。
スペースを含むファイル名について、記述を追加。

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