Bump project version metadata to 1.0.1.

Synchronize CMake, README, and Ruby gem version strings with the released v1.0.1 tag to keep build and packaging metadata consistent. Made-with: Cursor
Fix print completion flow for PT-P710BT and PT-P900W.
2026-04-17 05:21:39 +09:00 · 2026-04-17 05:17:22 +09:00 · 2026-04-17 03:53:13 +09:00 · 2026-04-17 03:25:39 +09:00 · 2026-04-17 03:24:00 +09:00 · 2026-04-16 19:09:43 +09:00
28 changed files with 1018 additions and 323 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,19 @@
+# Changelog
+
+## Unreleased
+
+- Fix PT-P710BT/PT-P900W print completion flow and protocol bytes.
+  - Correct `G` raster transfer header length (`n1/n2`) from per-model payload size.
+  - Fix `ESC i z` page index (`n9`) and adjust print-information flags/media kind handling.
+  - Keep `ESC i A` disabled on 128-dot family and split `ESC i K` by head width.
+  - Use `0x0C -> 0x1A` end sequence on 560-dot family to complete feed/cut reliably.
+- Improve status handling around print completion.
+  - Retry status reads with backoff and safer command ordering.
+  - Add verbose post-print short polling until print-end status is observed.
+  - Add small wait before `--status` command retrieval.
+- Add protocol regression safeguards.
+  - Introduce `libptouch_protocol` helpers for shared command-byte generation.
+  - Add `protocol_regression_test` and wire it into CTest.
+- Update documentation.
+  - Add `ctest` step to build instructions.
+  - Link to changelog from README.
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -4,7 +4,7 @@
 # Email: knb@artif.org

 cmake_minimum_required(VERSION 3.16)
-project(ptouch_label VERSION 1.0.0 LANGUAGES C)
+project(ptouch_label VERSION 1.0.1 LANGUAGES C)

 set(CMAKE_C_STANDARD 11)
 set(CMAKE_C_STANDARD_REQUIRED ON)
@@ -25,8 +25,10 @@ configure_file(
 set(LIBPTOUCH_SOURCES
 	src/lib/libptouch_core.c
 	src/lib/libptouch_usb.c
+	src/lib/libptouch_protocol.c
 	src/lib/libptouch_layout.c
 	src/lib/libptouch_media_info.c
+	src/lib/libptouch_trim.c
 	src/lib/libptouch_print.c
 	src/lib/libptouch_status.c
 	src/lib/libptouch_png.c
@@ -73,6 +75,19 @@ if(NOT MSVC)
 	target_compile_options(ptouch-print PRIVATE -Wall -Wextra -Wpedantic)
 endif()

+enable_testing()
+add_executable(ptouch-protocol-regression-test
+	tests/protocol_regression_test.c
+	src/lib/libptouch_protocol.c
+)
+target_include_directories(ptouch-protocol-regression-test PRIVATE
+	"${CMAKE_CURRENT_SOURCE_DIR}/src/lib"
+)
+if(NOT MSVC)
+	target_compile_options(ptouch-protocol-regression-test PRIVATE -Wall -Wextra -Wpedantic)
+endif()
+add_test(NAME protocol_regression_test COMMAND ptouch-protocol-regression-test)
+
 install(TARGETS ptouch ARCHIVE DESTINATION "${CMAKE_INSTALL_LIBDIR}")
 install(TARGETS ptouch_shared LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}"
 	RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}")
--- a/README.md
+++ b/README.md
@@ -1,21 +1,25 @@
 # ptouch_label

-**バージョン 1.0.0**（初回リリース）
+**バージョン 1.0.1**

 Brother P-touch シリーズ向けのラベル印刷用 **C コアライブラリ（libptouch）** と、動作確認用 **CLI（`ptouch-print`）** のリポジトリです。

 対象機種: **PT-P900W**（560 ドットヘッド）、**PT-P750W** / **PT-P710BT**（128 ドットヘッド・USB）。`libptouch_open_usb_vid_pid` に各機種の VID/PID を渡す（P900W 既定は `libptouch_open_usb`）。P750/P710 のラスター仕様は `reference/cv_ptp750w_710bt_jpn_raster_102.pdf`。

+現状は USB only / 将来 Bluetooth 対応予定。
+
 ## レイアウト

-| パス | 内容 |
-|------|------|
-| `include/libptouch.h` | 公開 API |
-| `src/lib/libptouch_*.c` | ライブラリ本体（core / usb / print / status / png / svg） |
-| `src/cli/main.c` | `ptouch-print` エントリ |
-| `samples/` | 試験用サンプル画像の置き場（PNG/SVG 等） |
-| `ruby/` | Ruby FFI gem（`libptouch`）・コマンド `ptouch-print-png`（PNG のみ）— `ruby/README.md` |
-| `reference/` | 仕様・参考資料（例: ラスター PDF） |
+
+| パス                      | 内容                                                                          |
+| ----------------------- | --------------------------------------------------------------------------- |
+| `include/libptouch.h`   | 公開 API                                                                      |
+| `src/lib/libptouch_*.c` | ライブラリ本体（core / usb / print / status / png / svg）                            |
+| `src/cli/main.c`        | `ptouch-print` エントリ                                                         |
+| `samples/`              | 試験用サンプル画像の置き場（PNG/SVG 等）                                                    |
+| `ruby/`                 | Ruby FFI gem（`libptouch`）・コマンド `ptouch-print-png`（PNG のみ）— `ruby/README.md` |
+| `reference/`            | 仕様・参考資料（例: ラスター PDF）                                                        |
+

 ## ビルド

@@ -24,6 +28,7 @@ Brother P-touch シリーズ向けのラベル印刷用 **C コアライブラ
 ```bash
 cmake -S . -B build
 cmake --build build
+ctest --test-dir build --output-on-failure
 ```

 成果物（`build/` 以下）:
@@ -40,6 +45,7 @@ cmake --build build

 **PNG**（拡張子 `.png` または PNG シグネチャ）の場合は幅・高さは画像から取得します。  
 **SVG**（拡張子 `.svg`）の場合は現在装着中テープの印字可能ドット幅に合わせて自動拡大・縮小します（USB 接続が必要）。  
+`--trim-right[=DOTS]` で右側空白列を削減できます（DOTS 省略時は左余白ドット、取得失敗時は 0）。  
 任意で `-t`（0–255）で二値化しきい値を指定できます。

 **1bit packed ラスター**（行優先、行あたり `ceil(width/8)` バイト × 行数）の場合は `-f` に加え `-w` / `-H` が必須です。
@@ -49,6 +55,8 @@ cmake --build build
 ```bash
 # PNG — 検証のみ（USB 不要）
 ./build/ptouch-print -n -f label.png
+./build/ptouch-print -n -f label.png --trim-right
+./build/ptouch-print -n -f label.png --trim-right=20

 # SVG — 幅を現在テープにフィットさせて検証（USB 必要）
 ./build/ptouch-print -n -f label.svg
@@ -93,7 +101,7 @@ cmake --build build

 - 接続は **libusb-1.0** のみ。機種ごとに **VID/PID**（`lsusb` 等）を調べ、`libptouch_open_usb_vid_pid` に渡すか、既定の PT-P900W なら `libptouch_open_usb` を使います。PT-P750W は **04f9:2062**、PT-P710BT は **04f9:20af**（`include/libptouch.h` の定数参照）。
 - PT-P750W / PT-P710BT ではラスター幅方向は **180 dpi**（P900W は 360 dpi）。PNG から印刷する場合は解像度に合わせて画像を用意してください。
- ラスターコマンドの詳細は **`reference/` の PDF** および Brother 公開資料に沿って `src/lib/libptouch_*.c` に実装してください。
+- ラスターコマンドの詳細は `**reference/` の PDF** および Brother 公開資料に沿って `src/lib/libptouch_*.c` に実装してください。

 ### Ubuntu で sudo なしで USB を開く（udev）

@@ -113,3 +121,7 @@ sudo usermod -aG plugdev "$USER"
 ## ライセンス

 [MIT License](LICENSE)（`LICENSE` ファイルを参照）。
+
+## 変更履歴
+
+リリース間の変更点は `CHANGELOG.md` を参照してください。
--- a/include/libptouch.h
+++ b/include/libptouch.h
@@ -100,6 +100,16 @@ libptouch_err_t libptouch_check_raster(libptouch_ctx *ctx,
 libptouch_err_t libptouch_get_current_media_info(libptouch_ctx *ctx,
 						 libptouch_media_info_t *out_info);

+/**
+ * 1bit packed ラスターの右側空白列を削減する（USB 不要）。
+ * 入力全体が白の場合は元サイズを維持して返す。
+ */
+libptouch_err_t libptouch_trim_right_blank_columns(
+	libptouch_ctx *ctx, const uint8_t *data, size_t data_len,
+	const libptouch_raster_params_t *in_params, uint16_t right_padding_dots,
+	uint8_t **out_raster,
+	size_t *out_raster_bytes, libptouch_raster_params_t *out_params);
+
 /**
 * 1 ビット packed ラスターを USB で印刷（各機種のラスター PDF 準拠）。
 * 印字前にステータスでテープ幅を読み、印刷可能ドット内に画像を中央配置する。
--- a/reference/note.adoc
+++ b/reference/note.adoc
@@ -0,0 +1,44 @@
+= pTouch Label ノート
+
+== 差込印刷機能追加（案）
+
+SVG ファイルを template として、JSON/YAML ファイルで受け取った内容を差込印刷する。
+
+SVG template の text element の data-field attribute をキーにして 印字テキストを JSON/YAML ファイルのデータで置き換える
+
+----
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="400" viewBox="0 0 124 124" fill="none">
+<rect width="124" height="124" rx="24" fill="#FFFFFFFF"/>
+  <text fill="#000000" x="5" y="60" data-field="label" font-size="40">
+    Label
+  </text>
+</svg>
+----
+
+という SVG ファイルと
+
+^^^^
+label: "ラベル"
+----
+
+という YAML ファイルを受け取ったら、
+
+SVG の text の中身のテキストを"ラベル" に置き換えるという感じです。
+
+== PNG 自動拡大・縮小（後日実装メモ）
+
+PNG でも、現在テープ幅（printable_dots）に合わせた自動拡大・縮小を可能にしたい。
+既定動作は現状維持（自動拡大・縮小 OFF）とし、オプションで ON/OFF を切り替える。
+
+実装方針（案）:
+
+- lib 側に「現在テープ幅へ raster をフィットする」共通 API を追加する。
+- PNG/SVG とも最終的に raster になるため、fit 処理は共通化する。
+- CLI には `--fit-current-tape`（仮）を追加し、明示時のみ有効化する。
+- まずは `contain` 相当（縦横比維持で収める）を実装する。
+
+検討ポイント:
+
+- 1bit 画像の縮小品質（単純 nearest だと潰れやすい）。
+- 既存の length x width 表示/内部座標との整合。
+- 既存ユーザー互換性（デフォルト OFF を維持）。
--- a/ruby/Gemfile
+++ b/ruby/Gemfile
@@ -5,5 +5,5 @@ source "https://rubygems.org"
 gemspec

 group :development do
-  gem "rubocop", "~> 1.69", require: false
+  gem "rubocop", "~> 1.86", require: false
 end
--- a/ruby/Gemfile.lock
+++ b/ruby/Gemfile.lock
@@ -3,6 +3,7 @@ PATH
  specs:
    libptouch (1.0.0)
      ffi (~> 1.15)
+      rexml

 GEM
  remote: https://rubygems.org/
@@ -30,6 +31,7 @@ GEM
    racc (1.8.1)
    rainbow (3.1.1)
    regexp_parser (2.12.0)
+    rexml (3.4.4)
    rubocop (1.86.1)
      json (~> 2.3)
      language_server-protocol (~> 3.17.0.2)
@@ -64,7 +66,7 @@ PLATFORMS

 DEPENDENCIES
  libptouch!
-  rubocop (~> 1.69)
+  rubocop (~> 1.86)

 CHECKSUMS
  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
@@ -89,6 +91,7 @@ CHECKSUMS
  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
+  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
  rubocop (1.86.1) sha256=44415f3f01d01a21e01132248d2fd0867572475b566ca188a0a42133a08d4531
  rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
--- a/ruby/README.md
+++ b/ruby/README.md
@@ -5,12 +5,10 @@
 ## 前提

 1. リポジトリルートで共有ライブラリをビルドする（`libptouch.so` が `build/` に生成されます）。
-
-   ```bash
+  ```bash
   cmake -S .. -B ../build
   cmake --build ../build
-   ```
-
+  ```
 2. Ruby 3.0 以上と `ffi` gem。

 ## インストール（開発時）
@@ -20,7 +18,7 @@ cd ruby
 bundle install   # または gem install ffi
 bundle exec rubocop   # 任意: スタイルチェック（.rubocop.yml）
 gem build libptouch.gemspec
-gem install ./libptouch-1.0.0.gem
+gem install ./libptouch-1.0.1.gem
 ```

 ビルド済みの `../build/libptouch.so` を自動で読みに行きます。別のパスにある場合は環境変数で指定できます。
@@ -31,21 +29,28 @@ export LIBPTOUCH_LIB=/usr/local/lib/libptouch.so

 （`cmake --install` で共有ライブラリをインストールした場合は、通常は `libptouch` 名でローダが解決します。）

-## コマンド `ptouch-print-png`（PNG/SVG）
+## コマンド `ptouch-label`（PNG/SVG）

-C の `ptouch-print` と同様の流れで、**PNG/SVG 入力**（`-w`/`-H` や 1bit ラスターは扱いません）を扱います。`gem install` 後は PATH に `ptouch-print-png` が入ります。
+C の `ptouch-print` と同様の流れで、**PNG/SVG 入力**（`-w`/`-H` や 1bit ラスターは扱いません）を扱います。`gem install` 後は PATH に `ptouch-label` が入ります。
 SVG は現在装着テープの印字可能幅に合わせて自動拡大・縮小します（USB 接続が必要）。
+後方互換のため `ptouch-print-png` も引き続き使えます。

-オプションは C 側に合わせ、**`-p` / `--pid`** で USB 製品 ID（16 進可）を指定できます。省略時は PT-P900W（`Libptouch::USB_PID_PTP900W` = `0x2085`）。例: PT-P750W `0x2062`、PT-P710BT `0x20af`（`libptouch.h` / `Libptouch` 定数と同じ）。
+オプションは C 側に合わせ、`**-p` / `--pid`** で USB 製品 ID（16 進可）を指定できます。省略時は PT-P900W（`Libptouch::USB_PID_PTP900W` = `0x2085`）。例: PT-P750W `0x2062`、PT-P710BT `0x20af`（`libptouch.h` / `Libptouch` 定数と同じ）。
+また、`--template`（SVG）と `--data`（JSON/YAML）を使うと `data-field` 属性をキーにした差込印刷が可能です。
+`--trim-right[=DOTS]` を付けると、libptouch 側の共通処理でラベル右側の空白ドット列を削減します。`DOTS` 省略時は左余白ドット数を使い、取得失敗時は `0` にフォールバックします。

 開発ツリーからそのまま試す例:

 ```bash
-bundle exec ruby -I lib exe/ptouch-print-png --help
-bundle exec ruby -I lib exe/ptouch-print-png -n -f ../samples/your.png
-bundle exec ruby -I lib exe/ptouch-print-png -n -f ../samples/your.svg
-bundle exec ruby -I lib exe/ptouch-print-png --status -p 0x2062
-bundle exec ruby -I lib exe/ptouch-print-png -f ../samples/your.png -p 0x20af
+bundle exec ruby -I lib exe/ptouch-label --help
+bundle exec ruby -I lib exe/ptouch-label -n -f ../samples/your.png
+bundle exec ruby -I lib exe/ptouch-label -n -f ../samples/your.svg
+bundle exec ruby -I lib exe/ptouch-label -n -f ../samples/your.svg --trim-right
+bundle exec ruby -I lib exe/ptouch-label -n -f ../samples/your.svg --trim-right=20
+bundle exec ruby -I lib exe/ptouch-label -n --template ../samples/your_template.svg --data ../samples/your_data.yml
+bundle exec ruby -I lib exe/ptouch-label --media-info
+bundle exec ruby -I lib exe/ptouch-label --status -p 0x2062
+bundle exec ruby -I lib exe/ptouch-label -f ../samples/your.png -p 0x20af
 ```

 ## 使用例
@@ -92,9 +97,10 @@ ctx.dispose

 ## API の範囲

- 実行ファイル `ptouch-print-png` … PNG/SVG（`-f`, `-t`, `-p`, `-n`, `-S`, `-V`, `-h`）。ステータスは JSON（`status_bytes` を `parse_status` したもの、`raw_bytes` 除く）
+- 実行ファイル `ptouch-label`（互換: `ptouch-print-png`）… PNG/SVG（`-f`, `-t`, `-p`, `-n`, `-M`, `-S`, `-V`, `-h`, `--template`, `--data`, `--trim-right[=DOTS]`）。`-M` は現在テープ情報（幅 mm・DPI 等）を JSON 出力、`-S` はステータス JSON 出力、`--trim-right` は右側空白列を削減
 - `Libptouch::Context` … `open_usb` / `open_usb_vid_pid` / `close` / `dispose`
 - `check_raster` / `print_raster` / `png_file_to_raster` / `svg_file_to_raster_fit_current_tape` / `status_bytes` / `status_hash` / `current_media_info`
- `current_media_info` には `print_dpi` / `feed_dpi` / `tape_width_mm` / `min_feed_mm` などを含む
+- `current_media_info` には `print_dpi` / `feed_dpi` / `tape_width_mm` / `printable_height_dots` / `min_feed_mm` などを含む（テープ幅方向は `printable_height_dots`）
 - `Libptouch.parse_status(raw)` … 32 バイトを Hash に展開（機種・テープ幅・**テープ種類**・色・**状態（status_kind）**・エラービット・`raw_hex` など）
- C の `libptouch_status_fprint`（`FILE *`）は FFI からはバインドしていません。テキスト出力の代わりに `parse_status` / `status_hash` を使ってください。
+- C の `libptouch_status_fprint`（`FILE` *）は FFI からはバインドしていません。テキスト出力の代わりに `parse_status` / `status_hash` を使ってください。
+
--- a/ruby/exe/ptouch-label
+++ b/ruby/exe/ptouch-label
@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "libptouch/cli/label_print"
+
+exit Libptouch::Cli::LabelPrint.run(ARGV)
--- a/ruby/exe/ptouch-print-png
+++ b/ruby/exe/ptouch-print-png
@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true

-require "libptouch/cli/png_print"
+require "libptouch/cli/label_print"

-exit Libptouch::Cli::PngPrint.run(ARGV)
+exit Libptouch::Cli::LabelPrint.run(ARGV)
--- a/ruby/lib/libptouch/binding.rb
+++ b/ruby/lib/libptouch/binding.rb
@@ -59,6 +59,8 @@ module Libptouch
    attach_function :libptouch_close, [:pointer], :void
    attach_function :libptouch_check_raster, %i[pointer pointer size_t pointer], :int
    attach_function :libptouch_get_current_media_info, %i[pointer pointer], :int
+    attach_function :libptouch_trim_right_blank_columns,
+                    %i[pointer pointer size_t pointer uint16 pointer pointer pointer], :int
    attach_function :libptouch_print_raster, %i[pointer pointer size_t pointer], :int
    attach_function :libptouch_png_file_to_raster,
                    %i[pointer string pointer pointer pointer pointer], :int
--- a/ruby/lib/libptouch/cli/label_print.rb
+++ b/ruby/lib/libptouch/cli/label_print.rb
@@ -0,0 +1,409 @@
+# frozen_string_literal: true
+
+require "json"
+require "optparse"
+require "rexml/document"
+require "tempfile"
+require "yaml"
+
+require "libptouch"
+
+module Libptouch
+  module Cli
+    # PNG/SVG を扱う ptouch-print 相当の CLI（1bit ラスター経路なし）。
+    module LabelPrint
+      module_function
+
+      def run(argv)
+        opts = parse(argv)
+        return 2 if opts.nil?
+
+        return run_version if opts[:version]
+        return run_help if opts[:help]
+
+        return run_media_info(opts) if opts[:media_info]
+
+        if opts[:status]
+          warn_unused_file_options(opts)
+          return run_status(opts)
+        end
+
+        if opts[:template] || opts[:data]
+          return usage_error("--template and --data must be used together") if opts[:template].to_s.empty? || opts[:data].to_s.empty?
+          return usage_error("-f and --template/--data cannot be used together") unless opts[:file].to_s.empty?
+          return run_template_print(opts)
+        end
+
+        return usage_error("-f is required (or use --template/--data, or --status)") if opts[:file].to_s.empty?
+
+        path = opts[:file]
+        kind = image_kind(path)
+        return usage_error("not a PNG/SVG file: #{path}") if kind.nil?
+
+        run_print(path, opts, kind)
+      end
+
+      def png_file?(path)
+        return true if path.downcase.end_with?(".png")
+
+        File.open(path, "rb") do |f|
+          sig = f.read(8)
+          sig == "\x89PNG\r\n\x1a\n".b
+        end
+      rescue Errno::ENOENT, Errno::EACCES => e
+        warn "open #{path}: #{e.message}"
+        false
+      end
+
+      def svg_file?(path)
+        path.downcase.end_with?(".svg")
+      end
+
+      def image_kind(path)
+        return :png if png_file?(path)
+        return :svg if svg_file?(path)
+
+        nil
+      end
+
+      def parse(argv)
+        opts_hash = default_cli_opts
+        build_cli_parser(opts_hash).parse!(argv)
+        return nil unless threshold_option_ok?(opts_hash)
+        return nil unless trim_right_option_ok?(opts_hash)
+        return nil unless usb_pid_option_ok?(opts_hash)
+
+        opts_hash.delete(:usb_pid_invalid)
+        opts_hash
+      end
+
+      def default_cli_opts
+        {
+          file: nil,
+          template: nil,
+          data: nil,
+          threshold: nil,
+          usb_pid: nil,
+          usb_pid_invalid: false,
+          dry_run: false,
+          trim_right: nil,
+          media_info: false,
+          status: false,
+          version: false,
+          help: false
+        }
+      end
+
+      def pid_option_description
+        p900 = Libptouch::USB_PID_PTP900W
+        p750 = Libptouch::USB_PID_PTP750W
+        p710 = Libptouch::USB_PID_PTP710BT
+        "USB 製品 ID（16 進可）。既定 P900W 0x#{p900.to_s(16)}; " \
+          "P750W 0x#{p750.to_s(16)}; P710BT 0x#{p710.to_s(16)}"
+      end
+
+      def apply_usb_pid_option(opts_hash, pid_str)
+        opts_hash[:usb_pid] = Integer(pid_str, 0)
+      rescue ArgumentError
+        warn "invalid --pid: #{pid_str.inspect}"
+        opts_hash[:usb_pid_invalid] = true
+      end
+
+      def threshold_option_ok?(opts_hash)
+        return true if opts_hash[:threshold].nil? || (0..255).cover?(opts_hash[:threshold])
+
+        warn "-t must be 0..255"
+        false
+      end
+
+      def trim_right_option_ok?(opts_hash)
+        v = opts_hash[:trim_right]
+        return true if v.nil? || v == :auto
+        return true if v.is_a?(Integer) && v >= 0
+
+        warn "--trim-right must be omitted, or >= 0"
+        false
+      end
+
+      def usb_pid_option_ok?(opts_hash)
+        return false if opts_hash[:usb_pid_invalid]
+        return true if opts_hash[:usb_pid].nil?
+        return true if opts_hash[:usb_pid].between?(1, 0xFFFF)
+
+        warn "-p/--pid must be 1..0xFFFF"
+        false
+      end
+
+      def build_cli_parser(opts_hash)
+        OptionParser.new do |p|
+          p.banner = usage_banner
+          p.separator ""
+          p.on("-f", "--file PATH", "入力 PNG/SVG ファイル") { |v| opts_hash[:file] = v }
+          p.on("--template PATH", "差込用 SVG テンプレート") { |v| opts_hash[:template] = v }
+          p.on("--data PATH", "差込データ JSON/YAML ファイル") { |v| opts_hash[:data] = v }
+          p.on("-t", "--threshold N", Integer,
+               "しきい値 0–255（既定 #{Libptouch::PNG_DEFAULT_THRESHOLD}、PNG/SVG）") do |v|
+            opts_hash[:threshold] = v
+          end
+          p.on("-p", "--pid PID", pid_option_description) do |v|
+            apply_usb_pid_option(opts_hash, v)
+          end
+          p.on("-n", "--dry-run", "読み込みと検証のみ（USB なし）") { opts_hash[:dry_run] = true }
+          p.on("--trim-right[=DOTS]", Integer,
+               "右側空白を削減。DOTS省略時は左余白（失敗時 0）") do |v|
+            opts_hash[:trim_right] = v.nil? ? :auto : v
+          end
+          p.on("-M", "--media-info", "現在テープ情報（幅/DPI/余白）を JSON で表示して終了") do
+            opts_hash[:media_info] = true
+          end
+          p.on("-S", "--status", "ステータスを JSON で表示して終了") do
+            opts_hash[:status] = true
+          end
+          p.on("-V", "--version", "バージョンを表示して終了") { opts_hash[:version] = true }
+          p.on("-h", "--help", "このヘルプ") { opts_hash[:help] = true }
+        end
+      end
+
+      def usage_banner
+        <<~BANNER
+          Usage: ptouch-label [options]
+
+          PNG/SVG 対応。画像サイズを使用します（-w/-H はありません）。
+          --template/--data で SVG 差込印刷ができます。
+          SVG は現在テープ幅に自動フィットします（USB 必須）。
+          --trim-right[=DOTS] で右側空白を削減します（省略時は左余白基準）。
+          --status / --media-info のときは -f は不要です。
+        BANNER
+      end
+
+      def warn_unused_file_options(opts)
+        return unless opts[:file] || opts[:template] || opts[:data] || opts[:dry_run] || !opts[:trim_right].nil? || !opts[:threshold].nil?
+
+        warn "warning: options other than --status are ignored"
+      end
+
+      def run_version
+        puts "ptouch-label #{Libptouch::VERSION}"
+        0
+      end
+
+      def run_help
+        puts usage_banner
+        puts ""
+        puts parser_help_text
+        0
+      end
+
+      def parser_help_text
+        opts_hash = default_cli_opts
+        p = OptionParser.new do |parser|
+          parser.banner = "ptouch-label [options]"
+          parser.on("-f", "--file PATH", "入力 PNG/SVG ファイル") { |v| opts_hash[:file] = v }
+          parser.on("--template PATH", "差込用 SVG テンプレート") { |v| opts_hash[:template] = v }
+          parser.on("--data PATH", "差込データ JSON/YAML ファイル") { |v| opts_hash[:data] = v }
+          parser.on("-t", "--threshold N", Integer,
+                    "しきい値 0–255（既定 #{Libptouch::PNG_DEFAULT_THRESHOLD}、PNG/SVG）") do |v|
+            opts_hash[:threshold] = v
+          end
+          parser.on("-p", "--pid PID", pid_option_description) do |v|
+            apply_usb_pid_option(opts_hash, v)
+          end
+          parser.on("-n", "--dry-run", "読み込みと検証のみ（USB なし）") { opts_hash[:dry_run] = true }
+          parser.on("--trim-right[=DOTS]", Integer,
+                    "右側空白を削減。DOTS省略時は左余白（失敗時 0）") do |v|
+            opts_hash[:trim_right] = v.nil? ? :auto : v
+          end
+          parser.on("-M", "--media-info", "現在テープ情報（幅/DPI/余白）を JSON で表示して終了") do
+            opts_hash[:media_info] = true
+          end
+          parser.on("-S", "--status", "ステータスを JSON で表示して終了") do
+            opts_hash[:status] = true
+          end
+          parser.on("-V", "--version", "バージョンを表示して終了") { opts_hash[:version] = true }
+          parser.on("-h", "--help", "このヘルプ") { opts_hash[:help] = true }
+        end
+        p.help
+      end
+
+      def open_usb_for_opts(ctx, opts)
+        if opts[:usb_pid]
+          ctx.open_usb_vid_pid(Libptouch::USB_VID_BROTHER, opts[:usb_pid])
+        else
+          ctx.open_usb
+        end
+      end
+
+      def run_template_print(opts)
+        svg_text = render_svg_template(opts[:template], load_merge_data(opts[:data]))
+        Tempfile.create(["ptouch-merge-", ".svg"]) do |tmp|
+          tmp.binmode
+          tmp.write(svg_text)
+          tmp.flush
+          run_print(tmp.path, opts, :svg)
+        end
+      rescue REXML::ParseException => e
+        warn "template parse error: #{e.message}"
+        1
+      rescue Errno::ENOENT, Errno::EACCES => e
+        warn e.message
+        1
+      rescue JSON::ParserError, Psych::SyntaxError => e
+        warn "data parse error: #{e.message}"
+        1
+      rescue ArgumentError => e
+        warn "data error: #{e.message}"
+        1
+      end
+
+      def load_merge_data(path)
+        text = File.read(path, encoding: "UTF-8")
+        ext = File.extname(path).downcase
+        parsed = if ext == ".json"
+                   JSON.parse(text)
+                 else
+                   YAML.safe_load(text, permitted_classes: [], aliases: false)
+                 end
+        unless parsed.is_a?(Hash)
+          raise ArgumentError, "data must be a key-value object/hash"
+        end
+
+        parsed.transform_keys(&:to_s)
+      end
+
+      def render_svg_template(path, data)
+        xml = File.read(path, encoding: "UTF-8")
+        doc = REXML::Document.new(xml)
+        doc.elements.each("//text[@data-field]") do |el|
+          # If descendants also have data-field (e.g. tspan placeholders),
+          # keep node structure and let element-level replacements handle them.
+          next if el.elements[".//*[@data-field]"]
+
+          key = el.attributes["data-field"].to_s
+          next unless data.key?(key)
+
+          replace_text_element_content(el, data[key].to_s)
+        end
+        doc.elements.each("//tspan[@data-field]") do |el|
+          key = el.attributes["data-field"].to_s
+          next unless data.key?(key)
+
+          replace_text_element_content(el, data[key].to_s)
+        end
+        out = +""
+        formatter = REXML::Formatters::Default.new
+        formatter.write(doc, out)
+        out
+      end
+
+      def replace_text_element_content(text_element, value)
+        # Remove all child nodes first so mixed content (<tspan>, text nodes, etc.)
+        # gets replaced consistently by merge data.
+        text_element.children.to_a.each { |child| text_element.delete(child) }
+        text_element.add(REXML::Text.new(value, true))
+      end
+
+      def run_status(opts)
+        ctx = nil
+        begin
+          ctx = Libptouch::Context.new
+          open_usb_for_opts(ctx, opts)
+          h = Libptouch.parse_status(ctx.status_bytes)
+          h.delete(:raw_bytes)
+          puts JSON.pretty_generate(h)
+          0
+        rescue Libptouch::Error => e
+          warn "get_status: #{e.message}"
+          1
+        ensure
+          ctx&.dispose
+        end
+      end
+
+      def run_media_info(opts)
+        warn_unused_file_options(opts)
+        ctx = nil
+        begin
+          ctx = Libptouch::Context.new
+          open_usb_for_opts(ctx, opts)
+          puts JSON.pretty_generate(ctx.current_media_info)
+          0
+        rescue Libptouch::Error => e
+          warn "media_info: #{e.message}"
+          1
+        ensure
+          ctx&.dispose
+        end
+      end
+
+      def run_print(path, opts, kind)
+        ctx = nil
+        begin
+          ctx = Libptouch::Context.new
+          usb_opened = false
+          threshold = opts[:threshold]
+          data, width, height = if kind == :svg
+                                  open_usb_for_opts(ctx, opts)
+                                  usb_opened = true
+                                  if threshold.nil?
+                                    ctx.svg_file_to_raster_fit_current_tape(path)
+                                  else
+                                    ctx.svg_file_to_raster_fit_current_tape(path, threshold: threshold)
+                                  end
+                                elsif threshold.nil?
+                                  ctx.png_file_to_raster(path)
+                                else
+                                  ctx.png_file_to_raster(path, threshold: threshold)
+                                end
+
+          unless opts[:trim_right].nil?
+            trim_pad, usb_opened = resolve_trim_right_pad_dots(ctx, opts, usb_opened)
+            data, width, height = ctx.trim_right_blank_columns(
+              data,
+              width_dots: width,
+              height_dots: height,
+              right_padding_dots: trim_pad
+            )
+          end
+
+          ctx.check_raster(data, width_dots: width, height_dots: height)
+
+          if opts[:dry_run]
+            puts "dry-run OK: #{data.bytesize} bytes, src #{width}x#{height} dots (print lengthxwidth #{width}x#{height})"
+            return 0
+          end
+
+          open_usb_for_opts(ctx, opts) if kind == :png && !usb_opened
+          ctx.print_raster(data, width_dots: width, height_dots: height)
+          0
+        rescue Libptouch::Error => e
+          warn e.message
+          1
+        ensure
+          ctx&.dispose
+        end
+      end
+
+      def resolve_trim_right_pad_dots(ctx, opts, usb_opened)
+        trim = opts[:trim_right]
+        return [trim, usb_opened] if trim.is_a?(Integer)
+
+        begin
+          unless usb_opened
+            open_usb_for_opts(ctx, opts)
+            usb_opened = true
+          end
+          info = ctx.current_media_info
+          [Integer(info[:left_margin_dots] || 0), usb_opened]
+        rescue Libptouch::Error
+          [0, usb_opened]
+        end
+      end
+
+      def usage_error(msg)
+        warn msg
+        warn "(try ptouch-label --help)"
+        2
+      end
+    end
+  end
+end
--- a/ruby/lib/libptouch/cli/png_print.rb
+++ b/ruby/lib/libptouch/cli/png_print.rb
@@ -1,251 +1,8 @@
-# frozen_string_literal: true
-
-require "json"
-require "optparse"
-
-require "libptouch"
+# Backward-compatibility shim.
+require "libptouch/cli/label_print"

 module Libptouch
  module Cli
-    # PNG/SVG を扱う ptouch-print 相当の CLI（1bit ラスター経路なし）。
-    module PngPrint
-      module_function
-
-      def run(argv)
-        opts = parse(argv)
-        return 2 if opts.nil?
-
-        return run_version if opts[:version]
-        return run_help if opts[:help]
-
-        if opts[:status]
-          warn_unused_file_options(opts)
-          return run_status(opts)
-        end
-
-        return usage_error("-f is required (or use --status)") if opts[:file].to_s.empty?
-
-        path = opts[:file]
-        kind = image_kind(path)
-        return usage_error("not a PNG/SVG file: #{path}") if kind.nil?
-
-        run_print(path, opts, kind)
-      end
-
-      def png_file?(path)
-        return true if path.downcase.end_with?(".png")
-
-        File.open(path, "rb") do |f|
-          sig = f.read(8)
-          sig == "\x89PNG\r\n\x1a\n".b
-        end
-      rescue Errno::ENOENT, Errno::EACCES => e
-        warn "open #{path}: #{e.message}"
-        false
-      end
-
-      def svg_file?(path)
-        path.downcase.end_with?(".svg")
-      end
-
-      def image_kind(path)
-        return :png if png_file?(path)
-        return :svg if svg_file?(path)
-
-        nil
-      end
-
-      def parse(argv)
-        opts_hash = default_cli_opts
-        build_cli_parser(opts_hash).parse!(argv)
-        return nil unless threshold_option_ok?(opts_hash)
-        return nil unless usb_pid_option_ok?(opts_hash)
-
-        opts_hash.delete(:usb_pid_invalid)
-        opts_hash
-      end
-
-      def default_cli_opts
-        {
-          file: nil,
-          threshold: nil,
-          usb_pid: nil,
-          usb_pid_invalid: false,
-          dry_run: false,
-          status: false,
-          version: false,
-          help: false
-        }
-      end
-
-      def pid_option_description
-        p900 = Libptouch::USB_PID_PTP900W
-        p750 = Libptouch::USB_PID_PTP750W
-        p710 = Libptouch::USB_PID_PTP710BT
-        "USB 製品 ID（16 進可）。既定 P900W 0x#{p900.to_s(16)}; " \
-          "P750W 0x#{p750.to_s(16)}; P710BT 0x#{p710.to_s(16)}"
-      end
-
-      def apply_usb_pid_option(opts_hash, pid_str)
-        opts_hash[:usb_pid] = Integer(pid_str, 0)
-      rescue ArgumentError
-        warn "invalid --pid: #{pid_str.inspect}"
-        opts_hash[:usb_pid_invalid] = true
-      end
-
-      def threshold_option_ok?(opts_hash)
-        return true if opts_hash[:threshold].nil? || (0..255).cover?(opts_hash[:threshold])
-
-        warn "-t must be 0..255"
-        false
-      end
-
-      def usb_pid_option_ok?(opts_hash)
-        return false if opts_hash[:usb_pid_invalid]
-        return true if opts_hash[:usb_pid].nil?
-        return true if opts_hash[:usb_pid].between?(1, 0xFFFF)
-
-        warn "-p/--pid must be 1..0xFFFF"
-        false
-      end
-
-      def build_cli_parser(opts_hash)
-        OptionParser.new do |p|
-          p.banner = usage_banner
-          p.separator ""
-          p.on("-f", "--file PATH", "入力 PNG/SVG ファイル") { |v| opts_hash[:file] = v }
-          p.on("-t", "--threshold N", Integer,
-               "二値化しきい値 0–255（既定 #{Libptouch::PNG_DEFAULT_THRESHOLD}、PNG/SVG）") do |v|
-            opts_hash[:threshold] = v
-          end
-          p.on("-p", "--pid PID", pid_option_description) do |v|
-            apply_usb_pid_option(opts_hash, v)
-          end
-          p.on("-n", "--dry-run", "読み込みと検証のみ（USB なし）") { opts_hash[:dry_run] = true }
-          p.on("-S", "--status", "USB プリンタのステータスを JSON で表示して終了") do
-            opts_hash[:status] = true
-          end
-          p.on("-V", "--version", "バージョンを表示して終了") { opts_hash[:version] = true }
-          p.on("-h", "--help", "このヘルプ") { opts_hash[:help] = true }
-        end
-      end
-
-      def usage_banner
-        <<~BANNER
-          Usage: ptouch-print-png [options]
-
-          PNG/SVG 対応。幅・高さは画像から取得します（-w/-H はありません）。
-          SVG は現在テープ幅に合わせて自動拡大・縮小します（USB 接続必須）。
-          --status のときは -f は不要です。
-        BANNER
-      end
-
-      def warn_unused_file_options(opts)
-        return unless opts[:file] || opts[:dry_run] || !opts[:threshold].nil?
-
-        warn "warning: options other than --status are ignored"
-      end
-
-      def run_version
-        puts "ptouch-print-png #{Libptouch::VERSION}"
-        0
-      end
-
-      def run_help
-        puts usage_banner
-        puts ""
-        puts parser_help_text
-        0
-      end
-
-      def parser_help_text
-        opts_hash = default_cli_opts
-        p = OptionParser.new do |parser|
-          parser.banner = "ptouch-print-png [options]"
-          parser.on("-f", "--file PATH", "入力 PNG/SVG ファイル") { |v| opts_hash[:file] = v }
-          parser.on("-t", "--threshold N", Integer,
-                    "二値化しきい値 0–255（既定 #{Libptouch::PNG_DEFAULT_THRESHOLD}、PNG/SVG）") do |v|
-            opts_hash[:threshold] = v
-          end
-          parser.on("-p", "--pid PID", pid_option_description) do |v|
-            apply_usb_pid_option(opts_hash, v)
-          end
-          parser.on("-n", "--dry-run", "読み込みと検証のみ（USB なし）") { opts_hash[:dry_run] = true }
-          parser.on("-S", "--status", "USB プリンタのステータスを JSON で表示して終了") do
-            opts_hash[:status] = true
-          end
-          parser.on("-V", "--version", "バージョンを表示して終了") { opts_hash[:version] = true }
-          parser.on("-h", "--help", "このヘルプ") { opts_hash[:help] = true }
-        end
-        p.help
-      end
-
-      def open_usb_for_opts(ctx, opts)
-        if opts[:usb_pid]
-          ctx.open_usb_vid_pid(Libptouch::USB_VID_BROTHER, opts[:usb_pid])
-        else
-          ctx.open_usb
-        end
-      end
-
-      def run_status(opts)
-        ctx = nil
-        begin
-          ctx = Libptouch::Context.new
-          open_usb_for_opts(ctx, opts)
-          h = Libptouch.parse_status(ctx.status_bytes)
-          h.delete(:raw_bytes)
-          puts JSON.pretty_generate(h)
-          0
-        rescue Libptouch::Error => e
-          warn "get_status: #{e.message}"
-          1
-        ensure
-          ctx&.dispose
-        end
-      end
-
-      def run_print(path, opts, kind)
-        ctx = nil
-        begin
-          ctx = Libptouch::Context.new
-          threshold = opts[:threshold]
-          data, width, height = if kind == :svg
-                                  open_usb_for_opts(ctx, opts)
-                                  if threshold.nil?
-                                    ctx.svg_file_to_raster_fit_current_tape(path)
-                                  else
-                                    ctx.svg_file_to_raster_fit_current_tape(path, threshold: threshold)
-                                  end
-                                elsif threshold.nil?
-                                  ctx.png_file_to_raster(path)
-                                else
-                                  ctx.png_file_to_raster(path, threshold: threshold)
-                                end
-
-          ctx.check_raster(data, width_dots: width, height_dots: height)
-
-          if opts[:dry_run]
-            puts "dry-run OK: #{data.bytesize} bytes, src #{width}x#{height} dots (print lengthxwidth #{width}x#{height})"
-            return 0
-          end
-
-          open_usb_for_opts(ctx, opts) if kind == :png
-          ctx.print_raster(data, width_dots: width, height_dots: height)
-          0
-        rescue Libptouch::Error => e
-          warn e.message
-          1
-        ensure
-          ctx&.dispose
-        end
-      end
-
-      def usage_error(msg)
-        warn msg
-        warn "(try ptouch-print-png --help)"
-        2
-      end
-    end
+    PngPrint = LabelPrint
  end
 end
--- a/ruby/lib/libptouch/context.rb
+++ b/ruby/lib/libptouch/context.rb
@@ -115,6 +115,29 @@ module Libptouch
      [bytes, out_params[:width_dots], out_params[:height_dots]]
    end

+    def trim_right_blank_columns(data, width_dots:, height_dots:, margin_mm: 0, right_padding_dots: 0)
+      in_params = Binding::RasterParams.new
+      in_params[:width_dots] = width_dots
+      in_params[:height_dots] = height_dots
+      in_params[:margin_mm] = margin_mm
+      in_buf = FFI::MemoryPointer.new(:uint8, data.bytesize)
+      in_buf.put_bytes(0, data)
+      out_pp = FFI::MemoryPointer.new(:pointer)
+      out_len = FFI::MemoryPointer.new(:size_t)
+      out_params = Binding::RasterParams.new
+      raise_on_error(Binding.libptouch_trim_right_blank_columns(
+                       @native, in_buf, data.bytesize, in_params.pointer,
+                       right_padding_dots, out_pp, out_len, out_params.pointer
+                     ))
+      raw = out_pp.read_pointer
+      raise Libptouch::Error.new(OK, "null raster from trim_right_blank_columns") if raw.null?
+
+      len = out_len.get(:size_t, 0)
+      bytes = raw.read_bytes(len)
+      Binding.libptouch_free_raster(raw)
+      [bytes, out_params[:width_dots], out_params[:height_dots]]
+    end
+
    def status_bytes
      buf = FFI::MemoryPointer.new(:uint8, STATUS_LENGTH)
      raise_on_error(Binding.libptouch_get_status(@native, buf))
@@ -134,7 +157,7 @@ module Libptouch
        print_dpi: info[:print_dpi],
        feed_dpi: info[:feed_dpi],
        tape_width_mm: info[:tape_width_mm],
-        printable_dots: info[:printable_dots],
+        printable_height_dots: info[:printable_dots],
        left_margin_dots: info[:left_margin_dots],
        right_margin_dots: info[:right_margin_dots],
        min_feed_dots: info[:min_feed_dots],
--- a/ruby/lib/libptouch/version.rb
+++ b/ruby/lib/libptouch/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true

 module Libptouch
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end
--- a/ruby/libptouch.gemspec
+++ b/ruby/libptouch.gemspec
@@ -25,8 +25,9 @@ Gem::Specification.new do |spec|

  spec.files = Dir.chdir(__dir__) { Dir["lib/**/*.rb", "exe/*", "README.md"] }
  spec.bindir = "exe"
-  spec.executables = ["ptouch-print-png"]
+  spec.executables = ["ptouch-label", "ptouch-print-png"]
  spec.require_paths = ["lib"]

  spec.add_dependency "ffi", "~> 1.15"
+  spec.add_dependency "rexml"
 end
--- a/samples/README.md
+++ b/samples/README.md
@@ -1,9 +1,16 @@
 # samples

-試験・デモ用のサンプル画像（PNG など）を置くディレクトリです。リポジトリに含める場合はライセンス・著作権に注意してください。
+試験・デモ用のサンプル画像（PNG/SVG）や差込印刷データ（JSON/YAML）を置くディレクトリです。リポジトリに含める場合はライセンス・著作権に注意してください。

 例（ドライラン）:

 ```bash
 ./build/ptouch-print -n -f samples/your.png
 ```
+
+差込印刷の例（Ruby CLI）:
+
+```bash
+ruby -I ruby/lib ruby/exe/ptouch-label -n --template samples/merge_template.svg --data samples/merge_data.yml
+ruby -I ruby/lib ruby/exe/ptouch-label -n --template samples/merge_template.svg --data samples/merge_data.json
+```
--- a/samples/aBw70.png
+++ b/samples/aBw70.png
--- a/samples/merge_data.json
+++ b/samples/merge_data.json
@@ -0,0 +1,5 @@
+{
+  "title": "出荷ラベル",
+  "left": "品番 ABC-123",
+  "right": "数量 24"
+}
--- a/samples/merge_data.yml
+++ b/samples/merge_data.yml
@@ -0,0 +1,3 @@
+title: "出荷ラベル"
+left: "品番 ABC-123"
+right: "数量 24"
--- a/samples/merge_template.svg
+++ b/samples/merge_template.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="720" height="220" viewBox="0 0 720 220">
+  <rect width="720" height="220" fill="#FFFFFF" />
+  <text x="24" y="86" data-field="title" font-size="56" fill="#000000">TITLE</text>
+  <text x="24" y="160" font-size="36" fill="#000000">
+    <tspan data-field="left">LEFT</tspan>
+    <tspan dx="20">/</tspan>
+    <tspan dx="20" data-field="right">RIGHT</tspan>
+  </text>
+</svg>
--- a/src/cli/main.c
+++ b/src/cli/main.c
@@ -13,6 +13,7 @@
 #include <stdlib.h>
 #include <string.h>
 #include <strings.h>
+#include <unistd.h>

 static void usage(const char *argv0)
 {
@@ -21,15 +22,17 @@ static void usage(const char *argv0)
 		"  -f, --file PATH     入力ファイル\n"
 		"  -w, --width DOTS    1bit ラスター時: 幅（ドット）\n"
 		"  -H, --height DOTS   1bit ラスター時: 高さ（ドット）\n"
-		"  -t, --threshold N  二値化しきい値 0–255（既定 %u、PNG/SVG）\n"
+		"  -t, --threshold N  しきい値 0–255（既定 %u、PNG/SVG）\n"
+		"      --trim-right[=DOTS] 右側空白を削減（省略時は左余白、失敗時 0）\n"
 		"  -n, --dry-run       読み込みと check_raster のみ（USB なし）\n"
+		"  -v, --verbose       印刷前情報と印刷後ステータスを標準出力\n"
 		"  -p, --pid HEX       USB 製品 ID（既定: P900W の 0x2085）。例: P750W 0x2062、P710BT 0x20af\n"
-		"  -S, --status        USB 接続プリンタのステータス（テープ種・幅・色等）を表示して終了\n"
+		"  -S, --status        ステータスを表示して終了\n"
 		"  -V, --version       バージョンを表示して終了\n"
 		"  -h, --help          このヘルプ\n"
 		"\n"
-		"PNG は幅・高さを画像から取得（-w/-H 不要）。\n"
-		"SVG は現在テープの印字可能幅に合わせて自動拡大・縮小（USB 必須）。\n"
+		"PNG は画像サイズを使用（-w/-H 不要）。\n"
+		"SVG は現在テープ幅に自動フィット（USB 必須）。\n"
 		"1bit packed ラスター（行優先）の場合は -f -w -H が必須。\n"
 		"--status のときは -f は不要（他オプションは無視されます）。\n",
 		argv0, (unsigned)LIBPTOUCH_PNG_DEFAULT_THRESHOLD);
@@ -100,6 +103,69 @@ static int read_file(const char *path, uint8_t **out, size_t *out_len)
 	return 0;
 }

+static void verbose_print_pre_print_info(libptouch_ctx *ctx,
+					 const libptouch_raster_params_t *params,
+					 size_t data_len)
+{
+	if (!ctx || !params)
+		return;
+
+	printf("=== verbose: pre-print info ===\n");
+	printf("raster bytes: %zu\n", data_len);
+	printf("raster size: %ux%u dots (length x width)\n",
+	       (unsigned)params->width_dots, (unsigned)params->height_dots);
+	printf("margin_mm: %u\n", (unsigned)params->margin_mm);
+
+	libptouch_media_info_t mi;
+	if (libptouch_get_current_media_info(ctx, &mi) == LIBPTOUCH_OK) {
+		printf("media width code: 0x%02X\n", (unsigned)mi.media_width_code);
+		printf("media kind code: 0x%02X\n", (unsigned)mi.media_kind_code);
+		printf("tape width: %.1f mm\n", mi.tape_width_mm);
+		printf("printable dots: %u\n", (unsigned)mi.printable_dots);
+		printf("left/right margins: %u/%u dots\n",
+		       (unsigned)mi.left_margin_dots, (unsigned)mi.right_margin_dots);
+		printf("print/feed dpi: %.1f/%.1f\n", mi.print_dpi, mi.feed_dpi);
+	} else {
+		printf("media info: unavailable (%s)\n", libptouch_strerror(ctx));
+	}
+
+	uint8_t st[LIBPTOUCH_STATUS_LENGTH];
+	if (libptouch_get_status(ctx, st) == LIBPTOUCH_OK) {
+		libptouch_status_fprint(stdout, st);
+	} else {
+		printf("status: unavailable (%s)\n", libptouch_strerror(ctx));
+	}
+}
+
+static void verbose_print_post_print_status(libptouch_ctx *ctx, const char *label)
+{
+	if (!ctx)
+		return;
+	printf("=== verbose: post-print status (%s) ===\n", label);
+	/*
+	 * 印刷直後は phase change (status[18] != 0x00) が続くことがあるため、
+	 * 短時間ポーリングで最終状態まで追跡する。
+	 */
+	const int max_polls = 12; /* ~2.4s */
+	const useconds_t poll_interval_us = 200000;
+	for (int i = 0; i < max_polls; i++) {
+		uint8_t st[LIBPTOUCH_STATUS_LENGTH];
+		if (libptouch_get_status(ctx, st) != LIBPTOUCH_OK) {
+			printf("status poll %d/%d: unavailable (%s)\n", i + 1,
+			       max_polls, libptouch_strerror(ctx));
+		} else {
+			printf("status poll %d/%d:\n", i + 1, max_polls);
+			libptouch_status_fprint(stdout, st);
+			if (st[18] == 0x00u) {
+				printf("post-print polling settled: print end.\n");
+				return;
+			}
+		}
+		usleep(poll_interval_us);
+	}
+	printf("post-print polling timeout: phase did not settle.\n");
+}
+
 int main(int argc, char **argv)
 {
 	const char *file = NULL;
@@ -107,6 +173,10 @@ int main(int argc, char **argv)
 	unsigned threshold = LIBPTOUCH_PNG_DEFAULT_THRESHOLD;
 	unsigned usb_pid_arg = 0;
 	int dry_run = 0;
+	int verbose = 0;
+	int trim_right_enabled = 0;
+	int trim_right_auto = 0;
+	unsigned trim_right_dots = 0;
 	int has_threshold = 0;
 	int want_status = 0;
 	static struct option longopts[] = {
@@ -114,7 +184,9 @@ int main(int argc, char **argv)
 		{ "height", required_argument, NULL, 'H' },
 		{ "file", required_argument, NULL, 'f' },
 		{ "threshold", required_argument, NULL, 't' },
+		{ "trim-right", optional_argument, NULL, 'r' },
 		{ "dry-run", no_argument, NULL, 'n' },
+		{ "verbose", no_argument, NULL, 'v' },
 		{ "pid", required_argument, NULL, 'p' },
 		{ "status", no_argument, NULL, 'S' },
 		{ "version", no_argument, NULL, 'V' },
@@ -123,7 +195,7 @@ int main(int argc, char **argv)
 	};

 	int c;
-	while ((c = getopt_long(argc, argv, "w:H:f:t:p:nhSV", longopts, NULL)) !=
+	while ((c = getopt_long(argc, argv, "w:H:f:t:r::p:nvhSV", longopts, NULL)) !=
 	       -1) {
 		switch (c) {
 		case 'w':
@@ -146,6 +218,23 @@ int main(int argc, char **argv)
 		case 'n':
 			dry_run = 1;
 			break;
+		case 'v':
+			verbose = 1;
+			break;
+		case 'r':
+			trim_right_enabled = 1;
+			if (!optarg) {
+				trim_right_auto = 1;
+				trim_right_dots = 0;
+				break;
+			}
+			trim_right_auto = 0;
+			trim_right_dots = (unsigned)strtoul(optarg, NULL, 10);
+			if (trim_right_dots > 0xFFFFu) {
+				fprintf(stderr, "--trim-right must be 0..65535\n");
+				return 2;
+			}
+			break;
 		case 'p':
 			usb_pid_arg = (unsigned)strtoul(optarg, NULL, 0);
 			if (usb_pid_arg == 0u || usb_pid_arg > 0xFFFFu) {
@@ -189,6 +278,10 @@ int main(int argc, char **argv)
 			libptouch_destroy(sctx);
 			return 1;
 		}
+		/* 印刷直後などは内部処理中で最初のステータス応答が不安定なことがあるため、
+		 * 少し待ってからステータスを取りに行く。 */
+		usleep(300000); /* 300ms */
+
 		uint8_t st[LIBPTOUCH_STATUS_LENGTH];
 		se = libptouch_get_status(sctx, st);
 		if (se != LIBPTOUCH_OK) {
@@ -238,6 +331,7 @@ int main(int argc, char **argv)
 	libptouch_raster_params_t params = { 0, 0, 0 };
 	libptouch_err_t e;
 	int usb_opened = 0;
+	int data_from_lib = 0;

 	if (png) {
 		libptouch_png_options_t opt = { .threshold = (uint8_t)threshold };
@@ -250,6 +344,7 @@ int main(int argc, char **argv)
 			libptouch_destroy(ctx);
 			return 1;
 		}
+		data_from_lib = 1;
 	} else if (svg) {
 		e = usb_pid_arg != 0
 			? libptouch_open_usb_vid_pid(ctx, LIBPTOUCH_USB_VID_BROTHER,
@@ -272,6 +367,7 @@ int main(int argc, char **argv)
 			libptouch_destroy(ctx);
 			return 1;
 		}
+		data_from_lib = 1;
 	} else {
 		if (read_file(file, &data, &data_len) != 0) {
 			libptouch_destroy(ctx);
@@ -282,12 +378,60 @@ int main(int argc, char **argv)
 		params.margin_mm = 0;
 	}

+	if (trim_right_enabled) {
+		uint16_t pad = (uint16_t)trim_right_dots;
+		if (trim_right_auto) {
+			pad = 0u;
+			if (!usb_opened) {
+				e = usb_pid_arg != 0
+					? libptouch_open_usb_vid_pid(
+					      ctx, LIBPTOUCH_USB_VID_BROTHER,
+					      (uint16_t)usb_pid_arg)
+					: libptouch_open_usb(ctx);
+				if (e == LIBPTOUCH_OK)
+					usb_opened = 1;
+			}
+			if (usb_opened) {
+				libptouch_media_info_t mi;
+				if (libptouch_get_current_media_info(ctx, &mi) ==
+				    LIBPTOUCH_OK) {
+					pad = mi.left_margin_dots;
+				}
+			}
+		}
+
+		uint8_t *trimmed = NULL;
+		size_t trimmed_len = 0;
+		libptouch_raster_params_t trimmed_params = { 0, 0, 0 };
+		e = libptouch_trim_right_blank_columns(
+			ctx, data, data_len, &params, pad, &trimmed, &trimmed_len,
+			&trimmed_params);
+		if (e != LIBPTOUCH_OK) {
+			fprintf(stderr, "trim_right_blank_columns: %s\n",
+				libptouch_strerror(ctx));
+			libptouch_destroy(ctx);
+			if (data_from_lib)
+				libptouch_free_raster(data);
+			else
+				free(data);
+			return 1;
+		}
+		if (data_from_lib)
+			libptouch_free_raster(data);
+		else
+			free(data);
+		data = trimmed;
+		data_len = trimmed_len;
+		params = trimmed_params;
+		data_from_lib = 1;
+	}
+
 	e = libptouch_check_raster(ctx, data, data_len, &params);
 	if (e != LIBPTOUCH_OK) {
 		fprintf(stderr, "check_raster: %s\n",
 			libptouch_strerror(ctx));
 		libptouch_destroy(ctx);
-		if (png || svg)
+		if (data_from_lib)
 			libptouch_free_raster(data);
 		else
 			free(data);
@@ -304,7 +448,7 @@ int main(int argc, char **argv)
 		if (usb_opened)
 			libptouch_close(ctx);
 		libptouch_destroy(ctx);
-		if (png || svg)
+		if (data_from_lib)
 			libptouch_free_raster(data);
 		else
 			free(data);
@@ -319,7 +463,7 @@ int main(int argc, char **argv)
 		if (e != LIBPTOUCH_OK) {
 			fprintf(stderr, "open_usb: %s\n", libptouch_strerror(ctx));
 			libptouch_destroy(ctx);
-			if (png || svg)
+			if (data_from_lib)
 				libptouch_free_raster(data);
 			else
 				free(data);
@@ -327,22 +471,30 @@ int main(int argc, char **argv)
 		}
 	}

+	if (verbose)
+		verbose_print_pre_print_info(ctx, &params, data_len);
+
 	e = libptouch_print_raster(ctx, data, data_len, &params);
 	if (e != LIBPTOUCH_OK) {
+		if (verbose)
+			verbose_print_post_print_status(ctx, "print failed");
 		fprintf(stderr, "print_raster: %s\n",
 			libptouch_strerror(ctx));
 		libptouch_close(ctx);
 		libptouch_destroy(ctx);
-		if (png || svg)
+		if (data_from_lib)
 			libptouch_free_raster(data);
 		else
 			free(data);
 		return 1;
 	}

+	if (verbose)
+		verbose_print_post_print_status(ctx, "print success");
+
 	libptouch_close(ctx);
 	libptouch_destroy(ctx);
-	if (png || svg)
+	if (data_from_lib)
 		libptouch_free_raster(data);
 	else
 		free(data);
--- a/src/lib/libptouch_print.c
+++ b/src/lib/libptouch_print.c
@@ -7,6 +7,7 @@

 #include "libptouch_internal.h"
 #include "libptouch_layout.h"
+#include "libptouch_protocol.h"

 #include <libusb.h>
 #include <stdio.h>
@@ -102,7 +103,7 @@ libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
 	(void)right_dots;

 	unsigned head_dots = prof->head_width_dots;
-	size_t line_payload = (size_t)((head_dots + 7u) / 8u);
+	size_t line_payload = ptouch_line_payload_bytes(head_dots);
 	size_t gf_packet = 3u + line_payload;

 	uint32_t wd = params->width_dots;
@@ -139,21 +140,6 @@ libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
 	}

 	uint32_t lines = ht;
-	uint8_t n5 = (uint8_t)(lines & 0xFFu);
-	uint8_t n6 = (uint8_t)((lines >> 8) & 0xFFu);
-	uint8_t n7 = (uint8_t)((lines >> 16) & 0xFFu);
-	uint8_t n8 = (uint8_t)((lines >> 24) & 0xFFu);
-
-	uint8_t n2_paper = 0x09u;
-	if (media_kind == 0x03u)
-		n2_paper = 0x00u;
-	else if (media_kind == 0x11u)
-		n2_paper = 0x11u;
-	else if (media_kind == 0x17u)
-		n2_paper = 0x17u;
-	else if (media_kind == 0x13u)
-		n2_paper = 0x13u;
-
 	uint8_t head[256];
 	size_t pos = 0;
 	memset(head + pos, 0, 200);
@@ -165,18 +151,27 @@ libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
 	memcpy(head + pos, raster_mode, sizeof(raster_mode));
 	pos += sizeof(raster_mode);

-	uint8_t esc_iz[] = { 0x1B, 0x69, 0x7A, 0x0Eu, n2_paper, media_w,
-			     0x00u, n5,    n6,	  n7,	 n8,	0x02u, 0x00u };
+	uint8_t esc_iz[13];
+	ptouch_fill_esc_iz(esc_iz, media_kind, media_w, lines);
 	memcpy(head + pos, esc_iz, sizeof(esc_iz));
 	pos += sizeof(esc_iz);

 	static const uint8_t esc_im[] = { 0x1B, 0x69, 0x4D, 0x40 };
 	memcpy(head + pos, esc_im, sizeof(esc_im));
 	pos += sizeof(esc_im);
-	static const uint8_t esc_ia[] = { 0x1B, 0x69, 0x41, 0x01 };
-	memcpy(head + pos, esc_ia, sizeof(esc_ia));
-	pos += sizeof(esc_ia);
-	static const uint8_t esc_ik[] = { 0x1B, 0x69, 0x4B, 0x0C };
+
+	/*
+	 * ESC i A ("cut each n labels") is not supported on PT-P710BT class
+	 * devices. Sending it can trigger a communication error (red LED blink).
+	 * Keep it only for 560-dot family.
+	 */
+	if (prof->head_width_dots > 128u) {
+		static const uint8_t esc_ia[] = { 0x1B, 0x69, 0x41, 0x01 };
+		memcpy(head + pos, esc_ia, sizeof(esc_ia));
+		pos += sizeof(esc_ia);
+	}
+
+	uint8_t esc_ik[] = { 0x1B, 0x69, 0x4B, ptouch_esc_ik_value(head_dots) };
 	memcpy(head + pos, esc_ik, sizeof(esc_ik));
 	pos += sizeof(esc_ik);

@@ -199,7 +194,6 @@ libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
 	}

 	size_t row_b = ((size_t)wd + 7u) / 8u;
-	static const uint8_t g_hdr[] = { 0x47, 0x46, 0x00 };

 	uint8_t *gbuf = (uint8_t *)malloc(gf_packet);
 	if (!gbuf) {
@@ -213,7 +207,7 @@ libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
 		const uint8_t *row = src + (size_t)y * row_b;
 		pack_line(gbuf + 3, line_payload, head_dots, row, wd, left_dots,
 			  print_dots);
-		memcpy(gbuf, g_hdr, sizeof(g_hdr));
+		ptouch_fill_gf_header(gbuf, line_payload);
 		v = ptouch_bulk_send_job(ctx, gbuf, gf_packet, "raster line");
 		if (v != LIBPTOUCH_OK) {
 			free(gbuf);
@@ -223,6 +217,21 @@ libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
 	}
 	free(gbuf);

+	/*
+	 * Some 560-dot family devices are sensitive to end-of-page sequencing.
+	 * Send FF (0x0C) then Control-Z (0x1A) on that family to explicitly
+	 * terminate page and final feed/cut.
+	 */
+	if (head_dots > 128u) {
+		static const uint8_t page_end[] = { 0x0C };
+		v = ptouch_bulk_send_job(ctx, page_end, sizeof(page_end),
+					 "print page end");
+		if (v != LIBPTOUCH_OK) {
+			free(transposed);
+			return v;
+		}
+	}
+
 	static const uint8_t print_end[] = { 0x1A };
 	v = ptouch_bulk_send_job(ctx, print_end, sizeof(print_end), "print end");
 	if (v != LIBPTOUCH_OK) {
--- a/src/lib/libptouch_protocol.c
+++ b/src/lib/libptouch_protocol.c
@@ -0,0 +1,39 @@
+#include "libptouch_protocol.h"
+
+size_t ptouch_line_payload_bytes(unsigned head_dots)
+{
+	return (size_t)((head_dots + 7u) / 8u);
+}
+
+void ptouch_fill_gf_header(uint8_t out[3], size_t line_payload_bytes)
+{
+	out[0] = 0x47u;
+	out[1] = (uint8_t)(line_payload_bytes & 0xFFu);
+	out[2] = (uint8_t)((line_payload_bytes >> 8) & 0xFFu);
+}
+
+void ptouch_fill_esc_iz(uint8_t out[13], uint8_t media_kind, uint8_t media_width,
+			uint32_t raster_lines)
+{
+	out[0] = 0x1Bu;
+	out[1] = 0x69u;
+	out[2] = 0x7Au;
+	/* PI flags: enable media/width/length with quality bit for broad compatibility. */
+	out[3] = 0x8Eu;
+	/* Use status media-kind byte directly (e.g., 0x01 laminated, 0x03 non-laminate). */
+	out[4] = media_kind;
+	out[5] = media_width;
+	out[6] = 0x00u;
+	out[7] = (uint8_t)(raster_lines & 0xFFu);
+	out[8] = (uint8_t)((raster_lines >> 8) & 0xFFu);
+	out[9] = (uint8_t)((raster_lines >> 16) & 0xFFu);
+	out[10] = (uint8_t)((raster_lines >> 24) & 0xFFu);
+	out[11] = 0x00u; /* first page */
+	out[12] = 0x00u; /* fixed */
+}
+
+uint8_t ptouch_esc_ik_value(unsigned head_dots)
+{
+	/* Preserve legacy 560-dot behaviour (0x0C), 128-dot uses 0x08. */
+	return head_dots > 128u ? 0x0Cu : 0x08u;
+}
--- a/src/lib/libptouch_protocol.h
+++ b/src/lib/libptouch_protocol.h
@@ -0,0 +1,13 @@
+#ifndef LIBPTOUCH_PROTOCOL_H
+#define LIBPTOUCH_PROTOCOL_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+size_t ptouch_line_payload_bytes(unsigned head_dots);
+void ptouch_fill_gf_header(uint8_t out[3], size_t line_payload_bytes);
+void ptouch_fill_esc_iz(uint8_t out[13], uint8_t media_kind, uint8_t media_width,
+			uint32_t raster_lines);
+uint8_t ptouch_esc_ik_value(unsigned head_dots);
+
+#endif /* LIBPTOUCH_PROTOCOL_H */
--- a/src/lib/libptouch_status.c
+++ b/src/lib/libptouch_status.c
@@ -9,6 +9,7 @@

 #include <stdio.h>
 #include <string.h>
+#include <unistd.h>

 libptouch_err_t libptouch_get_status(libptouch_ctx *ctx, uint8_t *status)
 {
@@ -28,18 +29,34 @@ libptouch_err_t libptouch_get_status(libptouch_ctx *ctx, uint8_t *status)
 	static const uint8_t req[] = { 0x1B, 0x69, 0x53 };

 	int r = LIBUSB_ERROR_OTHER;
-	for (int attempt = 0; attempt < 2; attempt++) {
+	for (int attempt = 0; attempt < 5; attempt++) {
+		/* First status read after reconnect can fail on some P-touch units. */
+		(void)libusb_clear_halt(h, ctx->bulk_in_ep);
+		(void)libusb_clear_halt(h, ctx->bulk_out_ep);
 		if (attempt > 0) {
-			(void)libusb_clear_halt(h, ctx->bulk_in_ep);
-			(void)libusb_clear_halt(h, ctx->bulk_out_ep);
+			usleep(120000); /* 120ms backoff */
 		}
-		r = ptouch_bulk_out(h, ctx->bulk_out_ep, init, 2, 5000u);
-		if (r != 0) {
-			ptouch_set_error_usb(ctx, r, "bulk OUT ESC @");
-			return LIBPTOUCH_ERR_USB;
+		/*
+		 * Avoid unconditional ESC @ here:
+		 * some models can be in phase-change right after print end, and
+		 * re-initializing there may disturb cutter/feed completion.
+		 * Try plain ESC i S first, use ESC @ only on retry paths.
+		 */
+		if (attempt > 0) {
+			r = ptouch_bulk_out(h, ctx->bulk_out_ep, init, 2, 5000u);
+			if (r != 0) {
+				if (r == LIBUSB_ERROR_IO || r == LIBUSB_ERROR_PIPE ||
+				    r == LIBUSB_ERROR_TIMEOUT)
+					continue;
+				ptouch_set_error_usb(ctx, r, "bulk OUT ESC @");
+				return LIBPTOUCH_ERR_USB;
+			}
 		}
 		r = ptouch_bulk_out(h, ctx->bulk_out_ep, req, 3, 5000u);
 		if (r != 0) {
+			if (r == LIBUSB_ERROR_IO || r == LIBUSB_ERROR_PIPE ||
+			    r == LIBUSB_ERROR_TIMEOUT)
+				continue;
 			ptouch_set_error_usb(ctx, r, "bulk OUT ESC i S");
 			return LIBPTOUCH_ERR_USB;
 		}
@@ -47,7 +64,8 @@ libptouch_err_t libptouch_get_status(libptouch_ctx *ctx, uint8_t *status)
 				  (int)LIBPTOUCH_STATUS_LENGTH, 5000u);
 		if (r == 0)
 			break;
-		if (r != LIBUSB_ERROR_IO && r != LIBUSB_ERROR_PIPE)
+		if (r != LIBUSB_ERROR_IO && r != LIBUSB_ERROR_PIPE &&
+		    r != LIBUSB_ERROR_TIMEOUT)
 			break;
 	}
 	if (r != 0) {
--- a/src/lib/libptouch_trim.c
+++ b/src/lib/libptouch_trim.c
@@ -0,0 +1,84 @@
+/*
+ * libptouch — raster right blank trim
+ *
+ * Author: knb
+ * Email: knb@artif.org
+ */
+
+#include "libptouch_internal.h"
+
+#include <stdlib.h>
+#include <string.h>
+
+libptouch_err_t libptouch_trim_right_blank_columns(
+	libptouch_ctx *ctx, const uint8_t *data, size_t data_len,
+	const libptouch_raster_params_t *in_params, uint16_t right_padding_dots,
+	uint8_t **out_raster, size_t *out_raster_bytes,
+	libptouch_raster_params_t *out_params)
+{
+	if (!ctx || !data || !in_params || !out_raster || !out_raster_bytes ||
+	    !out_params) {
+		if (ctx)
+			ptouch_set_error(ctx, LIBPTOUCH_ERR_ARG, "null argument");
+		return LIBPTOUCH_ERR_ARG;
+	}
+
+	libptouch_err_t v = libptouch_check_raster(ctx, data, data_len, in_params);
+	if (v != LIBPTOUCH_OK)
+		return v;
+
+	uint32_t width = in_params->width_dots;
+	uint32_t height = in_params->height_dots;
+	size_t row_bytes = ((size_t)width + 7u) / 8u;
+	int32_t rightmost = -1;
+
+	for (uint32_t y = 0; y < height; y++) {
+		const uint8_t *row = data + (size_t)y * row_bytes;
+		for (int32_t x = (int32_t)width - 1; x >= 0; x--) {
+			uint8_t b = row[(size_t)x / 8u];
+			uint8_t bit = (uint8_t)(7u - ((uint32_t)x % 8u));
+			if (((b >> bit) & 1u) == 0)
+				continue;
+			if (x > rightmost)
+				rightmost = x;
+			break;
+		}
+	}
+
+	uint32_t new_width = width;
+	if (rightmost >= 0) {
+		uint32_t trimmed = (uint32_t)(rightmost + 1);
+		uint32_t padded = trimmed + (uint32_t)right_padding_dots;
+		if (padded > width)
+			padded = width;
+		if (padded < width)
+			new_width = padded;
+	}
+
+	size_t new_row_bytes = ((size_t)new_width + 7u) / 8u;
+	size_t total = new_row_bytes * (size_t)height;
+	uint8_t *out = (uint8_t *)calloc(1u, total);
+	if (!out) {
+		ptouch_set_error(ctx, LIBPTOUCH_ERR_NOMEM, "calloc raster failed");
+		return LIBPTOUCH_ERR_NOMEM;
+	}
+
+	uint8_t last_mask = 0xFFu;
+	if ((new_width % 8u) != 0u)
+		last_mask = (uint8_t)((0xFFu << (8u - (new_width % 8u))) & 0xFFu);
+
+	for (uint32_t y = 0; y < height; y++) {
+		const uint8_t *src = data + (size_t)y * row_bytes;
+		uint8_t *dst = out + (size_t)y * new_row_bytes;
+		memcpy(dst, src, new_row_bytes);
+		dst[new_row_bytes - 1u] &= last_mask;
+	}
+
+	*out_raster = out;
+	*out_raster_bytes = total;
+	out_params->width_dots = new_width;
+	out_params->height_dots = height;
+	out_params->margin_mm = in_params->margin_mm;
+	ptouch_set_error(ctx, LIBPTOUCH_OK, "");
+	return LIBPTOUCH_OK;
+}
--- a/tests/protocol_regression_test.c
+++ b/tests/protocol_regression_test.c
@@ -0,0 +1,49 @@
+#include "libptouch_protocol.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+
+static int expect_int(const char *name, int got, int want)
+{
+	if (got == want)
+		return 0;
+	fprintf(stderr, "%s mismatch: got=%d want=%d\n", name, got, want);
+	return 1;
+}
+
+int main(void)
+{
+	int fail = 0;
+
+	fail |= expect_int("line_payload_128", (int)ptouch_line_payload_bytes(128u), 16);
+	fail |= expect_int("line_payload_560", (int)ptouch_line_payload_bytes(560u), 70);
+
+	uint8_t gf[3];
+	ptouch_fill_gf_header(gf, 16u);
+	fail |= expect_int("gf16_cmd", gf[0], 0x47);
+	fail |= expect_int("gf16_n1", gf[1], 0x10);
+	fail |= expect_int("gf16_n2", gf[2], 0x00);
+
+	ptouch_fill_gf_header(gf, 70u);
+	fail |= expect_int("gf70_cmd", gf[0], 0x47);
+	fail |= expect_int("gf70_n1", gf[1], 0x46);
+	fail |= expect_int("gf70_n2", gf[2], 0x00);
+
+	uint8_t iz[13];
+	ptouch_fill_esc_iz(iz, 0x01u, 0x0Cu, 70u);
+	fail |= expect_int("iz_cmd_0", iz[0], 0x1B);
+	fail |= expect_int("iz_cmd_1", iz[1], 0x69);
+	fail |= expect_int("iz_cmd_2", iz[2], 0x7A);
+	fail |= expect_int("iz_n1_flags", iz[3], 0x8E);
+	fail |= expect_int("iz_media_kind_passthrough", iz[4], 0x01);
+	fail |= expect_int("iz_media_width", iz[5], 0x0C);
+	fail |= expect_int("iz_lines_lsb", iz[7], 70);
+	fail |= expect_int("iz_page_index", iz[11], 0x00);
+	fail |= expect_int("iz_last_fixed", iz[12], 0x00);
+
+	/* ESC i K mode byte: 128-dot vs 560-dot families */
+	fail |= expect_int("esc_ik_128", ptouch_esc_ik_value(128u), 0x08);
+	fail |= expect_int("esc_ik_560", ptouch_esc_ik_value(560u), 0x0C);
+
+	return fail ? EXIT_FAILURE : EXIT_SUCCESS;
+}
Author	SHA1	Message	Date
knb	d0e5846012	Bump project version metadata to 1.0.1. Synchronize CMake, README, and Ruby gem version strings with the released v1.0.1 tag to keep build and packaging metadata consistent. Made-with: Cursor	2026-04-17 05:21:39 +09:00
knb	d2fd6cc1f9	Fix print completion flow for PT-P710BT and PT-P900W. Align raster protocol bytes and print-end sequencing by printer family, add safer status polling/retry behavior, and document the changes with regression coverage to prevent protocol regressions. Made-with: Cursor	2026-04-17 05:17:22 +09:00
knb	779a50747d	Bluetooth 対応状況追記	2026-04-17 03:53:13 +09:00
knb	29072dc20c	Update docs and add sample image for label workflows. Capture design notes for merge-print and PNG fit behavior, clean up Ruby README formatting, and include a new sample PNG for print testing. Made-with: Cursor	2026-04-17 03:25:39 +09:00
knb	42a785f086	Fix PT-P710BT raster protocol handling and add regression coverage. Align print command payload generation with model-specific protocol requirements, add verbose CLI diagnostics and robust status retries, and introduce protocol regression tests to prevent future GF/ESC i z regressions. Made-with: Cursor	2026-04-17 03:24:00 +09:00
knb	e92273a747	Merge branch 'cursor/ruby-label-merge-cli'	2026-04-16 19:09:43 +09:00
knb	094f183994	ptouch-label/ptouch-print のオプション整理と trim-right 対応を反映 CLIヘルプ文言を簡潔化しつつ、右余白トリム機能と関連API・ドキュメント更新をまとめて取り込み、PNG/SVG/テンプレート経路での利用体験を揃える。 Made-with: Cursor	2026-04-16 19:09:37 +09:00
knb	32ab12f661	ptouch-label CLIを追加して差込印刷を拡張コマンド名を機能に合わせて整理し、SVGテンプレート+JSON/YAMLの差込印刷とメディア情報取得を使いやすくする。 Made-with: Cursor	2026-04-16 14:49:08 +09:00
knb	33465c7299	Merge branch 'feature/svg-print-fit-tape-width'	2026-04-16 13:55:57 +09:00