11

lib/image/card_image.dart

@@ -3,6 +3,13 @@ import 'dart:typed_data';
 
 import 'package:image/image.dart';
 
+/// 纵向卡面 → 横向位图的预旋转方向（Windows Pavo 直打校准常量）。
+///
+/// 实测（2026-09-23 Windows CS-200e）：纵向缓冲 + byOrientation=1 会被 SDK 旋转 90°
+/// 且锚定错位（内容横向贴左、顺时针转卡才可读）。修复=统一预旋转成 1014×642 横向
+/// 位图 + byOrientation=2 打印。此常量定旋转方向：打测试卡若差 90°（顺/逆）就取反。
+const bool pavoPortraitRotateClockwise = true;
+
 /// PNG data URL 解析与像素层转换（Windows PavoApi 直打用）。
 ///
 /// 卡面为 CR-80 @300dpi：横向 1014×642 / 纵向 642×1014，按源图纵横比自动选择；
@@ -20,6 +27,14 @@ class CardImage {
   /// 宽 ≥ 高 = 横向卡面
   bool get isLandscape => width >= height;
 
+  /// 纵向卡面预旋转为横向位图（Windows Pavo 直打用，见 [pavoPortraitRotateClockwise]）。
+  /// 已是横向的原样返回。返回新实例，原实例不变（正/背面各自转换）。
+  CardImage toLandscape() {
+    if (isLandscape) return this;
+    final rotated = copyRotate(_canvas, angle: pavoPortraitRotateClockwise ? 90 : -90);
+    return CardImage._(rotated, rotated.width, rotated.height);
+  }
+
   /// 解析 data:image/png;base64,…（或其他 data URL 形式），缩放到卡面画布并铺白底。
   static CardImage fromDataUrl(String dataUrl) {
     if (dataUrl.trim().isEmpty) {