diff --git a/reference/note.adoc b/reference/note.adoc index e69de29..cc54542 100644 --- 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 ファイルのデータで置き換える + +---- + + + + Label + + +---- + +という 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 を維持）。 diff --git a/ruby/README.md b/ruby/README.md index bd2ab7d..0354cbe 100644 --- 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。 ## インストール（開発時） @@ -37,7 +35,7 @@ C の `ptouch-print` と同様の流れで、**PNG/SVG 入力**（`-w`/`-H` や 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` にフォールバックします。 @@ -104,4 +102,5 @@ ctx.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` / `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` を使ってください。 + diff --git a/samples/aBw70.png b/samples/aBw70.png new file mode 100644 index 0000000..9190dd4 Binary files /dev/null and b/samples/aBw70.png differ