2026-06-21 22:04:49 +08:00
|
|
|
// lib/editor/canvas/ink_painters.dart
|
|
|
|
|
//
|
|
|
|
|
// CustomPainters for the ink layers. Strokes are stored in normalized page
|
|
|
|
|
// coordinates; both painters receive the on-screen page [Size] and scale
|
|
|
|
|
// points into pixels at paint time. perfect_freehand produces the outline.
|
|
|
|
|
|
2026-06-22 22:02:17 +08:00
|
|
|
import 'package:flutter/foundation.dart';
|
2026-06-21 22:04:49 +08:00
|
|
|
import 'package:flutter/material.dart';
|
|
|
|
|
import 'package:perfect_freehand/perfect_freehand.dart' as pf;
|
|
|
|
|
|
2026-06-22 02:10:05 +08:00
|
|
|
import '../engine/stroke_geometry.dart' show kDefaultPenThinning;
|
2026-06-21 22:04:49 +08:00
|
|
|
import 'pen_stroke.dart';
|
|
|
|
|
|
|
|
|
|
/// Builds a filled outline [Path] for one stroke (already scaled to pixels).
|
|
|
|
|
///
|
|
|
|
|
/// [pageSize] maps normalized coords to pixels. [isComplete] should be false
|
2026-06-22 02:10:05 +08:00
|
|
|
/// for the in-progress live stroke so freehand tapers correctly. [thinning] is
|
|
|
|
|
/// the pressure→width response (shared default [kDefaultPenThinning]); the
|
|
|
|
|
/// SAME value drives the export path so screen and PDF never diverge.
|
|
|
|
|
Path buildStrokePath(
|
|
|
|
|
PenStroke stroke,
|
|
|
|
|
Size pageSize, {
|
|
|
|
|
required bool isComplete,
|
|
|
|
|
double thinning = kDefaultPenThinning,
|
|
|
|
|
}) {
|
2026-06-21 22:04:49 +08:00
|
|
|
final pixelWidth = stroke.width * pageSize.width;
|
|
|
|
|
|
|
|
|
|
final hasRealPressure = stroke.points.any((p) => p.pressure != null);
|
|
|
|
|
final isHighlighter = stroke.kind == PenStrokeKind.highlighter;
|
|
|
|
|
|
|
|
|
|
final pfPoints = stroke.points
|
|
|
|
|
.map(
|
2026-06-22 02:10:05 +08:00
|
|
|
(p) => pf.PointVector(
|
2026-06-21 22:04:49 +08:00
|
|
|
p.x * pageSize.width,
|
|
|
|
|
p.y * pageSize.height,
|
|
|
|
|
p.pressure ?? 0.5,
|
|
|
|
|
),
|
|
|
|
|
)
|
|
|
|
|
.toList();
|
|
|
|
|
|
|
|
|
|
final outline = pf.getStroke(
|
|
|
|
|
pfPoints,
|
2026-06-22 02:10:05 +08:00
|
|
|
options: pf.StrokeOptions(
|
|
|
|
|
size: pixelWidth,
|
|
|
|
|
// Highlighter keeps a constant width (no thinning); pen uses the
|
|
|
|
|
// configurable [thinning] so real Surface-Pen pressure changes width.
|
|
|
|
|
thinning: isHighlighter ? 0.0 : thinning,
|
|
|
|
|
smoothing: 0.5,
|
|
|
|
|
streamline: 0.5,
|
|
|
|
|
// Real stylus pressure → don't simulate; no pressure → let freehand fake
|
|
|
|
|
// it based on velocity. (perfect_freehand 2.x honors REAL pressure when
|
|
|
|
|
// simulatePressure is false — 1.0.4 ignored it, which made width
|
|
|
|
|
// unresponsive to pen force.)
|
|
|
|
|
simulatePressure: !hasRealPressure && !isHighlighter,
|
|
|
|
|
isComplete: isComplete,
|
|
|
|
|
),
|
2026-06-21 22:04:49 +08:00
|
|
|
);
|
|
|
|
|
|
|
|
|
|
final path = Path();
|
|
|
|
|
if (outline.isEmpty) return path;
|
2026-06-22 02:10:05 +08:00
|
|
|
path.moveTo(outline.first.dx, outline.first.dy);
|
2026-06-21 22:04:49 +08:00
|
|
|
for (var i = 1; i < outline.length; i++) {
|
2026-06-22 02:10:05 +08:00
|
|
|
path.lineTo(outline[i].dx, outline[i].dy);
|
2026-06-21 22:04:49 +08:00
|
|
|
}
|
|
|
|
|
path.close();
|
|
|
|
|
return path;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// Paints all committed strokes for the page. Repaints only when the stroke
|
|
|
|
|
/// list identity or page size changes (kept behind a RepaintBoundary).
|
|
|
|
|
class StaticInkPainter extends CustomPainter {
|
2026-06-22 02:10:05 +08:00
|
|
|
StaticInkPainter({
|
|
|
|
|
required this.strokes,
|
|
|
|
|
required this.pageSize,
|
|
|
|
|
this.thinning = kDefaultPenThinning,
|
|
|
|
|
});
|
2026-06-21 22:04:49 +08:00
|
|
|
|
|
|
|
|
final List<PenStroke> strokes;
|
|
|
|
|
final Size pageSize;
|
|
|
|
|
|
2026-06-22 02:10:05 +08:00
|
|
|
/// Pressure→width response shared with the live/export paths.
|
|
|
|
|
final double thinning;
|
|
|
|
|
|
2026-06-21 22:04:49 +08:00
|
|
|
@override
|
|
|
|
|
void paint(Canvas canvas, Size size) {
|
|
|
|
|
for (final stroke in strokes) {
|
2026-06-22 02:10:05 +08:00
|
|
|
final path =
|
|
|
|
|
buildStrokePath(stroke, pageSize, isComplete: true, thinning: thinning);
|
2026-06-21 22:04:49 +08:00
|
|
|
if (path.getBounds().isEmpty) continue;
|
|
|
|
|
canvas.drawPath(
|
|
|
|
|
path,
|
|
|
|
|
Paint()
|
|
|
|
|
..color = Color(stroke.color)
|
|
|
|
|
..style = PaintingStyle.fill
|
|
|
|
|
..isAntiAlias = true,
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
@override
|
|
|
|
|
bool shouldRepaint(StaticInkPainter old) =>
|
|
|
|
|
!identical(old.strokes, strokes) ||
|
|
|
|
|
old.strokes.length != strokes.length ||
|
2026-06-22 02:10:05 +08:00
|
|
|
old.pageSize != pageSize ||
|
|
|
|
|
old.thinning != thinning;
|
2026-06-21 22:04:49 +08:00
|
|
|
}
|
|
|
|
|
|
2026-06-22 20:03:50 +08:00
|
|
|
/// Eraser preview: shows the eraser circle and faintly highlights the committed
|
|
|
|
|
/// strokes the eraser would delete, so the user can see what is about to go.
|
|
|
|
|
/// Mounted only while the eraser is the active mode and the pen is near the
|
|
|
|
|
/// page; kept behind its own RepaintBoundary so it never dirties the ink layers.
|
|
|
|
|
class EraserPreviewPainter extends CustomPainter {
|
|
|
|
|
EraserPreviewPainter({
|
|
|
|
|
required this.strokes,
|
|
|
|
|
required this.cursor,
|
|
|
|
|
required this.radius,
|
|
|
|
|
required this.aspect,
|
|
|
|
|
required this.pageSize,
|
2026-06-22 22:02:17 +08:00
|
|
|
}) : super(repaint: cursor);
|
2026-06-22 20:03:50 +08:00
|
|
|
|
|
|
|
|
final List<PenStroke> strokes;
|
|
|
|
|
|
2026-06-22 22:02:17 +08:00
|
|
|
/// Eraser center in normalized page coords (null = no preview). A listenable
|
|
|
|
|
/// so the painter repaints on cursor moves WITHOUT rebuilding the canvas.
|
|
|
|
|
final ValueListenable<PenPoint?> cursor;
|
2026-06-22 20:03:50 +08:00
|
|
|
|
|
|
|
|
/// Eraser radius as a fraction of page width (matches the live erase test).
|
|
|
|
|
final double radius;
|
|
|
|
|
|
|
|
|
|
/// Page aspect (height / width) so the on-screen circle stays round.
|
|
|
|
|
final double aspect;
|
|
|
|
|
|
|
|
|
|
final Size pageSize;
|
|
|
|
|
|
|
|
|
|
@override
|
|
|
|
|
void paint(Canvas canvas, Size size) {
|
2026-06-22 22:02:17 +08:00
|
|
|
final c = cursor.value;
|
2026-06-22 20:03:50 +08:00
|
|
|
if (c == null) return;
|
|
|
|
|
|
2026-06-22 22:02:17 +08:00
|
|
|
// CHEAP, ACCURATE highlight: trace ONLY the point-runs inside the eraser
|
|
|
|
|
// radius — i.e. exactly what splitStrokeByCircle will remove — as a plain
|
|
|
|
|
// polyline (no perfect_freehand getStroke; that was the eraser lag source).
|
|
|
|
|
// So what turns red is exactly what gets deleted.
|
|
|
|
|
final r2 = radius * radius;
|
2026-06-22 20:03:50 +08:00
|
|
|
final highlight = Paint()
|
2026-06-22 22:02:17 +08:00
|
|
|
..color = const Color(0xFFFF5252).withValues(alpha: 0.85)
|
2026-06-22 20:03:50 +08:00
|
|
|
..style = PaintingStyle.stroke
|
2026-06-22 22:02:17 +08:00
|
|
|
..strokeWidth = 3.0
|
|
|
|
|
..strokeCap = StrokeCap.round
|
|
|
|
|
..strokeJoin = StrokeJoin.round
|
2026-06-22 20:03:50 +08:00
|
|
|
..isAntiAlias = true;
|
|
|
|
|
for (final stroke in strokes) {
|
2026-06-22 22:02:17 +08:00
|
|
|
Path? run;
|
|
|
|
|
void flush() {
|
|
|
|
|
if (run != null) {
|
|
|
|
|
canvas.drawPath(run!, highlight);
|
|
|
|
|
run = null;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
for (final pt in stroke.points) {
|
|
|
|
|
final dx = pt.x - c.x;
|
|
|
|
|
final dy = (pt.y - c.y) * aspect;
|
|
|
|
|
if (dx * dx + dy * dy < r2) {
|
|
|
|
|
final o = Offset(pt.x * pageSize.width, pt.y * pageSize.height);
|
|
|
|
|
(run ??= Path()..moveTo(o.dx, o.dy)).lineTo(o.dx, o.dy);
|
|
|
|
|
} else {
|
|
|
|
|
flush();
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
flush();
|
2026-06-22 20:03:50 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// The eraser circle itself (radius is a page-width fraction → px = r * w).
|
|
|
|
|
final center = Offset(c.x * pageSize.width, c.y * pageSize.height);
|
|
|
|
|
final rPx = radius * pageSize.width;
|
|
|
|
|
canvas.drawCircle(
|
|
|
|
|
center,
|
|
|
|
|
rPx,
|
|
|
|
|
Paint()
|
2026-06-22 22:02:17 +08:00
|
|
|
..color = const Color(0xFF757575).withValues(alpha: 0.7)
|
2026-06-22 20:03:50 +08:00
|
|
|
..style = PaintingStyle.stroke
|
|
|
|
|
..strokeWidth = 1.0
|
|
|
|
|
..isAntiAlias = true,
|
|
|
|
|
);
|
|
|
|
|
canvas.drawCircle(
|
|
|
|
|
center,
|
|
|
|
|
rPx,
|
2026-06-22 22:02:17 +08:00
|
|
|
Paint()..color = const Color(0x14000000),
|
2026-06-22 20:03:50 +08:00
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
@override
|
|
|
|
|
bool shouldRepaint(EraserPreviewPainter old) =>
|
2026-06-22 22:02:17 +08:00
|
|
|
!identical(old.cursor, cursor) ||
|
2026-06-22 20:03:50 +08:00
|
|
|
old.radius != radius ||
|
|
|
|
|
old.aspect != aspect ||
|
|
|
|
|
!identical(old.strokes, strokes) ||
|
|
|
|
|
old.strokes.length != strokes.length ||
|
2026-06-22 22:02:17 +08:00
|
|
|
old.pageSize != pageSize;
|
2026-06-22 20:03:50 +08:00
|
|
|
}
|
|
|
|
|
|
2026-06-21 22:04:49 +08:00
|
|
|
/// Paints just the in-progress stroke (the live layer), kept behind its own
|
|
|
|
|
/// RepaintBoundary so committed strokes don't repaint on every move.
|
|
|
|
|
class LiveInkPainter extends CustomPainter {
|
2026-06-22 02:10:05 +08:00
|
|
|
LiveInkPainter({
|
|
|
|
|
required this.stroke,
|
|
|
|
|
required this.pageSize,
|
|
|
|
|
this.thinning = kDefaultPenThinning,
|
|
|
|
|
});
|
2026-06-21 22:04:49 +08:00
|
|
|
|
|
|
|
|
/// Current in-progress stroke, or null when nothing is being drawn.
|
|
|
|
|
final PenStroke? stroke;
|
|
|
|
|
final Size pageSize;
|
|
|
|
|
|
2026-06-22 02:10:05 +08:00
|
|
|
/// Pressure→width response shared with the static/export paths.
|
|
|
|
|
final double thinning;
|
|
|
|
|
|
2026-06-21 22:04:49 +08:00
|
|
|
@override
|
|
|
|
|
void paint(Canvas canvas, Size size) {
|
|
|
|
|
final s = stroke;
|
|
|
|
|
if (s == null || s.points.isEmpty) return;
|
2026-06-22 02:10:05 +08:00
|
|
|
final path =
|
|
|
|
|
buildStrokePath(s, pageSize, isComplete: false, thinning: thinning);
|
2026-06-21 22:04:49 +08:00
|
|
|
if (path.getBounds().isEmpty) return;
|
|
|
|
|
canvas.drawPath(
|
|
|
|
|
path,
|
|
|
|
|
Paint()
|
|
|
|
|
..color = Color(s.color)
|
|
|
|
|
..style = PaintingStyle.fill
|
|
|
|
|
..isAntiAlias = true,
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
@override
|
|
|
|
|
bool shouldRepaint(LiveInkPainter old) =>
|
2026-06-22 02:10:05 +08:00
|
|
|
!identical(old.stroke, stroke) ||
|
|
|
|
|
old.pageSize != pageSize ||
|
|
|
|
|
old.thinning != thinning;
|
2026-06-21 22:04:49 +08:00
|
|
|
}
|