feat(pen): pressure-responsive width, configurable thinning, native Windows pen (tilt/buttons)
All checks were successful
CI / Windows build (push) Successful in 11m34s

W1 — Custom pen width + pressure sensitivity (Saber-style):
- Root cause of "压感没用": perfect_freehand 1.0.4 IGNORES real stylus pressure
  (hardcodes radius=size/2 when simulatePressure=false) — width never tracked pen
  force. Upgraded perfect_freehand ^1.0.0 -> ^2.0.0 (honors real pressure); migrated
  all 5 getStroke call sites to the 2.x API (PointVector / StrokeOptions / Offset).
- De-hardcoded `thinning` into `kDefaultPenThinning` (0.85), single source shared by
  the on-screen painter and the PDF export path; exposed as PenConfig.pressureSensitivity
  with a Pressure Sensitivity slider; live-applies via a config listener.

W3 — Native Windows pen plugin (tilt + barrel/eraser buttons):
- windows/runner/pen_channel.{h,cpp}: observe WM_POINTER at the TOP of MessageHandler
  (before HandleTopLevelWindowProc, which Flutter uses to consume pen events), read
  GetPointerPenInfo penFlags + tilt, stream over EventChannel('badnote/pen'); non-consuming.
- PenInputService: single latched hardware state (no Win32-pointerId<->event.pointer
  correlation); graceful no-op off-Windows.
- pen_canvas maps barrel/inverted/eraser through PenConfig.sideButton/eraserEnd
  (eraser/undo/toggleTool/pan) and captures tilt into PenPoint.tilt -> EditorPoint.tilt.

W2 — Zoom flicker: page raster isolated in its own RepaintBoundary (safe interim);
definitive crisp-on-zoom fix gated on the on-device root-cause probe (plan M3).

Plans: ralplan-consensus plan at docs/plans/2026-06-22-badnote-pen-polish.md
(Architect APPROVE-WITH-MUST-FIX M1-M4 + Critic ITERATE->APPROVE).

Tests: 58/58 pass incl. shared-thinning invariant + thinning-affects-outline +
tilt-adapter round-trip. flutter analyze clean; linux debug build OK.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-22 02:10:05 +08:00
parent e4a94d00c0
commit 3295018ee3
22 changed files with 1280 additions and 93 deletions

View File

@@ -296,7 +296,7 @@ class PdfService {
final pfPoints = stroke.points
.map(
(pt) => pf.Point(
(pt) => pf.PointVector(
pt.x * pageSize.width,
pt.y * pageSize.height,
pt.pressure,
@@ -306,21 +306,24 @@ class PdfService {
final outline = pf.getStroke(
pfPoints,
size: pixelWidth,
// Highlighter keeps constant width; pen/marker taper via thinning=0.7.
thinning: isHighlighter ? 0.0 : 0.7,
smoothing: 0.5,
streamline: 0.5,
// Real stylus pressure -> don't simulate; no pressure -> let freehand
// fake it based on velocity. Highlighter never simulates.
simulatePressure: !hasRealPressure && !isHighlighter,
isComplete: true,
options: pf.StrokeOptions(
size: pixelWidth,
// Highlighter keeps constant width; pen/marker taper via thinning=0.7.
thinning: isHighlighter ? 0.0 : 0.7,
smoothing: 0.5,
streamline: 0.5,
// Real stylus pressure -> don't simulate; no pressure -> let freehand
// fake it based on velocity. Highlighter never simulates.
simulatePressure: !hasRealPressure && !isHighlighter,
isComplete: true,
),
);
if (outline.isEmpty) return null;
final path = PdfPath();
path.addPolygon(outline.map((pt) => Offset(pt.x, pt.y)).toList());
// outline is already List<Offset> in perfect_freehand 2.x.
path.addPolygon(outline.toList());
return path;
}
}

View File

@@ -139,7 +139,7 @@ class StrokeRasterizer {
) {
final pfPoints = points
.map(
(p) => pf.Point(
(p) => pf.PointVector(
p.x,
p.y,
_defaultPressureCurve.apply(p.pressure).clamp(0.0, 1.0),
@@ -153,18 +153,20 @@ class StrokeRasterizer {
final outline = pf.getStroke(
pfPoints,
size: strokeWidth,
thinning: thinning,
smoothing: 0.5,
streamline: 0.5,
simulatePressure: tool != PenTool.marker && tool != PenTool.highlighter,
isComplete: true,
options: pf.StrokeOptions(
size: strokeWidth,
thinning: thinning,
smoothing: 0.5,
streamline: 0.5,
simulatePressure: tool != PenTool.marker && tool != PenTool.highlighter,
isComplete: true,
),
);
if (outline.isEmpty) return;
final path = Path()..moveTo(outline[0].x, outline[0].y);
final path = Path()..moveTo(outline[0].dx, outline[0].dy);
for (var i = 1; i < outline.length; i++) {
path.lineTo(outline[i].x, outline[i].y);
path.lineTo(outline[i].dx, outline[i].dy);
}
path.close();