ptouch_label/reference/note.adoc

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 を維持）。