Brother PT-P750W, PT-P710BT software developer manual [ja]

ソフトウェア開発者マニュアル
ラスターコマンドリファレンス
PT-P750W/P710BT
Version 1.01
brother のロゴはブラザー工業株式会社の登録商標です。 ブラザーは、ブラザー工業株式会社の登録商標です。
© 2014-2018 Brother Industries, Ltd. All rights reserved.
MicrosoftWindowsは、米国 Microsoft Corporation の米国およびその他の国における登録商標です。
本ガイドに製品名が記載されている各ソフトウェアの開発会社は、著作プログラムに特定したソフトウェアライセンス 契約を有します。
ブラザー製品および関連資料等に記載されている社名及び商品名はそれぞれ各社の商標または登録商標です。
本書について
ご注意
本資料は、お客様が直接 PT-P750W/PT-P710BT プリンターを制御される場合に必要な情報を提供するものです。 お客様が以下の内容にご同意いただいた場合のみ、本資料のご利用が可能です。 もしご同意いただけない場合は、お客様は本資料をご利用いただけません。
ご利用条件
お客様は、お客様ご自身で PT-P750W/PT-P710BT プリンターをご利用いただくため(以下「本目的」といいます)に 必要な範囲においてのみ、本資料を使用し、複製することができるものとします。 なお、お客様は次のことを行ってはならないものとします。
(i) 本目的以外の目的で本資料を複製すること (ii) 本資料を改変し、翻案・翻訳し、または第三者に再頒布すること (iii) 本資料を第三者に貸与・提供すること (iv) 本資料に含まれるブラザーの権利に関する表示を削除・改変すること
無保証
a. 対応モデルおよび本資料のバージョンアップや修正等はブラザーが任意で行うものとし、お客様からの本資料の
内容に関するお問い合わせまたはご要望に対しては一切応じかねます。
b. ブラザーは本資料に関し、明示または黙示であるかを問わず、瑕疵がないこと、特定の目的に適合することを含
め、その他いかなる保証も行いません。
c. ブラザーは本資料および本資料に基づきお客様が作成したプログラムに起因して発生した直接的または間接的
損害について、お客様に対し、いかなる責任も負わないものとします。
プリンターラスターマニュアル
- i -
目次
本書について ···································································································· 3
ご注意 ····················································································································· 3 ご利用条件 ··············································································································· 3 無保証 ····················································································································· 3
はじめに ··········································································································· 1 プリンターラスターデータとは? ············································································· 2
1. ラスターデータの印刷手順 ··············································································· 3
2. 印刷データ ··································································································· 5
2.1 印刷データ概要 ··································································································· 5
2.2 サンプル (テストページの印刷データ解析) ······························································· 8
2.2.1 事前の準備 ............................................................................................................ 8
2.2.2 印刷データを確認する手順 ..................................................................................... 8
2.2.3 テストページの印刷データの解説 .......................................................................... 11
2.3 ページデータ詳細 ······························································································· 13
2.3.1 解像度 .................................................................................................................. 13
2.3.2 用紙サイズ ........................................................................................................... 14
2.3.3 フィード量.............................................................................................................. 17
2.3.4 最大・最小長......................................................................................................... 18
2.3.5 ラスターライン ....................................................................................................... 19
3. 印刷コマンド一覧 ························································································· 22
4. 印刷コマンド詳細 ························································································· 23
NULL 無効指令 ................................................................................................ ...... 23
ESC @ 初期化.......................................................................................................... 23
ESC i S ステータス情報リクエスト ............................................................................... 23
ESC i a 動的コマンドモード切替 ................................................................................. 30
ESC i ! ステータス自動通知モード切替 ..................................................................... 30
ESC i z 印刷情報指令 ............................................................................................... 31
ESC i M 各種モード設定............................................................................................. 32
ESC i K 拡張モード設定............................................................................................. 32
ESC i d 余白量(フィード量)指定 ................................................................................ 33
ESC i A オートカット枚数指定 ..................................................................................... 33
M 圧縮モード選択............................................................................................. 34
G ラスターグラフィックス転送 ............................................................................ 36
Z ゼロラスターグラフィックス ............................................................................. 36
FF 印字指令 ................................................................................................ ...... 36
Control-Z 排出動作を伴う印字指令 .............................................................................. 37
5.本体フロー ··································································································· 38
5.1 USB 接続逐次印刷通常フロー ·············································································· 39
5.2 USB 接続逐次印刷エラーフロー(ページ終了フィード時のエラー) ································· 40
5.3 USB 接続逐次印刷エラーフロー(テープエンドなど、逐次印刷中のエラー) ····················· 41
5.4 USB 接続バッファリング印刷通常フロー ·································································· 42
5.5 USB 接続バッファリング印刷エラーフロー ································································ 43
5.6 ネットワーク(標準 TCP/IP ポート)接続通常フロー ···················································· 44
付録 A: USB仕様 ·························································································· 45 付録 B: 開発者ツールサイト(Brother Developer Center)のご紹介 ························ 46
プリンターラスターマニュアル
- 1 -
はじめに
はじめに
本資料は、弊社が提供するプリンタードライバーを使用しないで PT-P750W/PT-P710BT で印刷したいお客様に、必 要な情報を提供するものです。 お使いの OS と開発環境での USB の基本的な制御について、お客様が熟知されている前提で本書は説明していま す。 また、USB IF に付きましては、本資料では言及いたしません。 USB IF をご使用される場合には、「付録 A: USB 仕様」を参照して、お客様にて IF 部分を用意していただく必要が あります。
本資料の画面に登場するモデル名は、お使いのプリンターのモデルに置き換えてお読みください。
プリンターラスターマニュアル
- 2 -
プリンターラスターデータとは?
プリンターラスターデータとは?
弊社のプリンタードライバーを使用しないで PT-P750W/PT-P710BT を用いた印刷ができます。 そのため、以下のような場合に便利です。 Windows 以外の OS から印刷したい場合
(例: Linux PC、モバイル端末等から印刷する場合) 既存のシステムに印刷機能を追加したい場合 また、詳細な設定の印刷ができます。
本資料における「ラスター」は、2 値化されたビットマップデータ(ドットの集合)を示します。
本資料を参照し、ラスターデータに初期化コマンドや制御コードを付与してプリンター本体(以降、「本体」)に送ると、 印刷が実現されます。 本書では、このコードを付与し、データを送信する方法について説明をします。
プリンターラスターマニュアル
- 3 -
1. ラスターデータの印刷手順
1. ラスターデータの印刷手順
以下に印刷手順を説明します。 詳細なフローは「5.本体フロー」を参照してください。 個々のコマンドの詳細は、「4.印刷コマンド詳細」を参照してください。
(2) ステータスを受信する (プリンターの状況を確認する)
(1) ポートをオープンする
(5) ステータスを受信する (印刷完了を確認する)
(6) ポートをクローズする
ポート
(4) 印刷する
At your side
(3) 印刷データを送付する
お使いのプリンター
PC、端末等
プリンターラスターマニュアル
- 4 -
1. ラスターデータの印刷手順
(1) USB/ネットワークポートをオープンする
ご利用の環境で USB/ネットワークポートをオープンします。 ポートのオープン方法は本資料では言及しません。
(2) プリンターから送付されたステータスを確認する
「ステータス情報リクエスト」コマンドをプリンターに送信し、プリンターから返されるステータスを解析して、本体の 状況を把握します。 「ステータス情報リクエスト」コマンドと「ステータス」の定義については、「4. 印刷コマンド詳細」の「ステータス情報 リクエスト」を参照してください。
(3) 印刷データを送信する
ステータスの解析により、本体に印字データに対応した用紙が装着され、かつ、エラーが発生していないことを確 認したら、印刷データを送信します。 印刷データの構造は「2. 印刷データ」で説明します。 注意: 印刷データを送信した後、印字終了を確認するまで、本体にいかなるコマンドも送信することはできません。 「ステータス情報リクエスト」コマンドも印刷中に送信できません。
(4) 印刷する
(5) 印字終了状況を確認する
印刷が終了すると、本体からステータスを受け取ります。このステータスを解析して印刷終了ならば、1ページ分 の印刷が終了したことになります。 ジョブが複数ページからなる場合には(2)~(4)を繰り返してください。
(6) USB/ネットワークポートをクローズする
すべての印刷が終了したら、ポートをクローズします。
注意: USB ポート使用時に非圧縮でラスターデータを送信する場合は、高速印刷を実現するため、印刷データを受信 し始めると、印字指令を待たずに印刷(逐次印刷)を開始します。 エラー制御などを行うための処理の流れは、「5.本体フロー」を参照してください。
プリンターラスターマニュアル
- 5 -
2. 印刷データ
2. 印刷データ
2.1 印刷データ概要
印刷データは大きく分けて、(1) 初期化コマンド、(2) 制御コード、(3) ラスターデータ、(4) 印字指令から構成されま す。 ジョブが複数ページからなる場合には、(2)~(4)を繰り返します。
(1) 初期化コマンド
ジョブの先頭で1度だけ指定します。
順序
コマンド名称
説明/例
1
無効指令
100 バイト分の無効指令を送り、プリンターのコマンド受信状態をリ セットします。
2
初期化
印刷のための初期化をします。
1Bh, 40h (固定値)
(2) 制御コード
各ページの先頭に付けて毎ページ送ります。
順序
コマンド名称
説明/例
1
動的コマンドモード切替
本体のモードをラスターモードへ切替えます。
1Bh, 69h, 61h, 01h
2
ステータス自動通知モード切替
PT-P710BT のみで使用します。
動的に、印刷中にステータスを自動的に通知するか、通知しな いかを切り替えます。 ステータスを自動で通知する場合:
1Bh, 69h, 21h, 00h
3
印字情報指令
印字情報をセットします。
24 mm 幅のテープで 100mm 印刷の場合: 1Bh, 69h, 7Ah, 84h, 00h, 18h, 00h, AAh, 02h, 00h, 00h, 00h, 00h
4
各種モード設定
オートカットが ON の場合:
1Bh, 69h, 4Dh, 40h
5
オートカット枚数指定
PT-P750W のみで使用します。
オートカット枚数を指定します オートカット枚数が 1 の場合:
1Bh, 69h, 41h, 01h
6
拡張モード設定
つなげて印刷 OFF の場合
1Bh,69h,4Bh,08h
プリンターラスターマニュアル
- 6 -
2. 印刷データ
7
余白量指定
余白量を指定します。 余白量が 2mm の場合:
1Bh, 69h, 64h, 0Eh, 00h
8
圧縮モード選択
ラスターグラフィックスの圧縮モードを選択します。
TIFF 圧縮されたデータを送信する場合: 4Dh, 02h
プリンターラスターマニュアル
- 7 -
2. 印刷データ
(3) ラスターデータ
ジョブに含まれるページ分繰り返します。
順序
コマンド名称
説明/例
ラスターグラフィックス転送
画像データをコマンド化して送信します。
ゼロラスターグラフィックス
1ライン白の画像データを圧縮コマンドとして送ります。(圧縮モード に TIFF を選択時のみ有効)
5Ah (固定値)
(4) 印字指令
ページの末尾に指定されます。
順序
コマンド名称
説明/例
印字指令
最後でないページの末尾に指定します。 0Ch(固定値)
排出を伴う印字指令
最後のページの末尾に指定します。 1Ah(固定値)
プリンターラスターマニュアル
- 8 -
2. 印刷データ
2.2 サンプル (テストページの印刷データ解析)
ここでは、プリンタードライバーが作成した印刷データをもとに、前章で紹介したコマンドについて具体的に解説しま す。 プリンタープロパティで [テストページ]を印刷した場合を例にして印刷データを確認します。
印刷データはプリンターの印刷設定によって異なりますので、様々な印刷設定で試し、印刷データを作成する際の参 考にしてください。 なお、説明は Windows® 7 環境で行います。ご利用の環境が異なる場合は、同等の手順で行ってください。
テストページ
プリンタープロパティ
2.2.1 事前の準備
以下の2つをあらかじめインストールをしてください。 ・ 弊社 PT-P750W/PT-P710BT プリンタードライバー
・ バイナリエディター サンプルで確認していただくデータは2進化されたファイル(バイナリファイル)です。
そのため、バイナリファイルの内容は、バイナリエディターを使って表示/確認してください。
2.2.2 印刷データを確認する手順
印刷データを確認する手順は、以下のとおりです。
ステップ1: 対象プリンターのポートを「FILE:」に変更します。 ステップ2: お好きな印刷物 (ここでは「テストページ」)を印刷し、ファイル名を指定します。 ステップ3: 作成したファイルをバイナリエディターで開き、確認します。
プリンターラスターマニュアル
- 9 -
2. 印刷データ
ステップ1: 対象プリンターのポートを「FILE:」に変更します。
[デバイスとプリンター]フォルダーを開き、対象プリンターを右クリックして、プロパティ画面を表示します。 プロパティ画面の[ポート]タブを選択し、[FILE:]をクリックして[適用]ボタンをクリックします。
プリンタープロパティの[ポート]タブ
ステップ2: 印刷物(テストページ)を印刷し、ファイル名を指定します。
印刷設定で、用紙サイズ[24mm x 2]を選択した状態でテストページを印刷してください。(下図は PT-P750W)
プリンターラスターマニュアル
- 10 -
2. 印刷データ
テストページを対象プリンターで印刷すると、ファイル名入力用ダイアログが表示されます。(下図参照) 任意のファイル名を入力して[OK]をクリックすると、プリンタードライバーが印刷データを作成し、入力したファ イル名で保存します。
ファイル名入力用ダイアログ
ステップ3: 印刷データをバイナリエディターで開きます。
保存したファイルをバイナリエディターで開きます。 表示される数字の羅列が印刷データです。(下図参照) 印刷データは「2.1 印刷データ概要」で説明した (1) 初期化コマンド、(2) 制御コード、(3) ラスターデータ、 (4) 印字指令から構成されています。 印刷データの詳細は、「2.2.3 テストページの印刷データの解説」を参照してください。
印刷データ
プリンターラスターマニュアル
- 11 -
2. 印刷データ
2.2.3 テストページの印刷データの解説
前項で出力したテストページの印刷データについて解説していきます。 以下の図は、「2.2.1 事前の準備」で作成した印刷データをバイナリエディターで表示したものです。
印刷データ(左:PT-P750W 右:PT-P710BT)
プリンターラスターマニュアル
- 12 -
2. 印刷データ
上記の印刷データの各番号に対応する説明を下記の表にまとめました。 各コマンドの詳細については「4.印刷コマンド詳細」を参照してください。
番号
コマンド名称
説明
1
無効指令
100 バイト分の無効指令を送っていることが分かります。
2
初期化
初期化コマンドを送っています。
3
動的コマンドモード 切替
プリンターをラスターモードに切替えます。 プリンターにラスターデータを送信する前に、このコマンドを送ってくださ い。
4
ジョブ ID 指定コマンド
内部仕様コマンドです。 製品版ドライバーでは出力するコマンドですが、お客様の方で特に送る必 要はありません。
5
印字情報指令
印刷データの用紙サイズ情報を送ります。 ここでは、「24mm」のテープであることを意味しています。
6
各種モード設定
各種モードを指定できるコマンドです。 ここでは、オートカットするを有効にしています。
7
オートカット枚数指定
オートカットの枚数を指定します。
8
拡張モード設定
拡張モードを指定できるコマンドです。
9
余白設定
余白量を指定します。 ここでは、「14dots」であることを意味しています。
10
圧縮モード選択
TIFF モードを指定しています。
11
ラスターデータ
ラスターデータが続きます。
12
印字指令
最終ページではないため、ページの最後に印字指令を送ります。
13
排出を伴う印字指令
最後のページなので、ページの最後には排出を伴う印字指令を送りま す。
14
ステータス自動通知モ ード切替
動的に、印刷中にステータスを自動的に通知するか切り替えます。
Loading...
+ 35 hidden pages