.. CTIP 2.0 インターフェースの概要

..1. 接続情報

まず、サーバー側が各接続方式に対応するように設定されていることを確認してください。 ドライバ側では次の形式のURIで接続情報を設定します。

ctip://ホスト名:ポート/

例えば、ローカルマシンの8099版ポートでCopper PDFサーバーが動作している場合は、 ctip://localhost:8099/ というアドレスをドライバに渡します。

TLSによる暗号化通信3.0.0を用いる場合は、 ctips://localhost:8094/ のようにURIを設定してください。

Java用ドライバはHTTP/RESTによる接続にも対応しています。 HTTPを使う場合は "http://127.0.0.1:8097/" 、 SSL(HTTPS)を使う場合は "https://127.0.0.1:8096/" 、 のようにURIを設定してください。

..2. メッセージコード

処理状況や警告・エラーとして、2バイトのメッセージコード、メッセージに付随する値、 人間が読める形式の文字列の3つの値がドライバに渡されます。 メッセージコードは16進数で表記し、以下の通りクラス分けされます。

1XXX

処理情報。文書のタイトル、出力したページの番号等です。

2XXX

警告メッセージ。通常の運用でも発生する可能性のある軽微なエラーを示すもので、処理が続行されます。

3XXX

エラーメッセージ。アプリケーション等の問題によるエラーで、処理が中断されます。

4XXX

深刻なエラー。サーバープログラムのバグやシステムの障害によるもので、処理が中断されます。

全てのメッセージコードの一覧は資料集を参照してください。

..3. サーバー情報

ドライバによりCopper PDFサーバーの環境に関する情報を得ることができます。 情報の種類はURIで指定します。

http://www.cssj.jp/ns/ctip/version

Copper PDFのバージョン情報です。これは以下の形式のXMLです。

<?xml version="1.0" encoding="UTF-8"?>
<version>
<long-version>Copper PDF バージョン番号/ビルド番号</long-version>
<name>Copper PDF</name>
<number>バージョン番号</number>
<build>ビルド番号</build>
<copyrights>著作権表示</copyrights>
<credits>
付属ライブラリの著作権教示
</credits>
</version>

http://www.cssj.jp/ns/ctip/output-types3.0.0

Copper PDFがサポートする出力形式です。これは以下の形式のXMLです。

<?xml version="1.0" encoding="UTF-8"?>
<output-types>
<type name="PDF" mimeType="application/pdf" suffix="pdf"/>
<type name="PNG" mimeType="image/png" suffix="png"/>
<type name="JPEG" mimeType="image/jpeg" suffix="jpg"/>
<type name="WBMP" mimeType="image/vnd.wap.wbmp" suffix="wbmp"/>
<type name="BMP" mimeType="image/bmp" suffix="bmp"/>
<type name="SVG" mimeType="image/svg+xml" suffix="pdf"/>
...
以降
<type name="フォーマット名" mimeType="MIME型" suffix="拡張子"/>
の繰り返し
...
</output-types>

http://www.cssj.jp/ns/ctip/fonts3.0.4

利用可能なフォントの一覧です。これは以下の形式のXMLです。

<fonts>
<font name="Courier-Bold" weight="700" type="core" direction="ltr">
<alias name="Courier"/>
<alias name="Courier-New"/>
</font>
<font name="Courier-BoldOblique" italic="true" weight="700" type="core" direction="ltr">
<alias name="Courier"/>
<alias name="Courier-New"/>
</font>
<font name="Courier-Oblique" italic="true" weight="400" type="core" direction="ltr">
<alias name="Courier"/>
<alias name="Courier-New"/>
</font>
...
以降
<font name="フォント名" (italic="true") weight="太さ" type="タイプ" direction="方向">
<alias name="別名"/>
...
</font>
の繰り返し
...
</fonts>

italic="true" 属性は斜体のフォントだけに付きます。 weightは100～900までの数値です。 typeはcore, cid-keyed, cid-identity, embeddedのいずれかで、それぞれコア14フォント、CID-Keyedフォント、外部フォント、埋め込みフォントに対応します。 directionはltr, tbのいずれかで、それぞれ横書き用フォント、縦書き用フォントに対応します。

..4. CTIP 2.0 プロトコルの仕様

プロトコルの仕様書は、以下のアドレスで公開しています。
https://osdn.net/projects/copper/docs/ctip-v2