Repository Public
1// SP Lecture Studio2// File: Apps/LectureStudio/macOS/MacCanvasView.swift3// Description: macOS stage: PDF page with mouse / trackpad / tablet vector ink, shape tools, stroke eraser, laser pointer, zoom and pan.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import SwiftUI8import AppKit9import LectureCore10import LecturePDF1112struct StageCanvas: NSViewRepresentable {13 let session: ProjectSession14 /// Presentation windows show the stage without accepting input.15 var interactive = true1617 func makeNSView(context: Context) -> InkCanvasNSView {18 let v = InkCanvasNSView(session: session)19 v.interactive = interactive20 return v21 }2223 func updateNSView(_ v: InkCanvasNSView, context: Context) {24 // Reading these registers the dependencies: the view redraws when any of them changes.25 _ = session.inkRevision; _ = session.page; _ = session.viewport; _ = session.pointer; _ = session.tool26 _ = session.currentStrokes.count27 v.interactive = interactive28 v.sync()29 }30}3132final class InkCanvasNSView: NSView {33 let session: ProjectSession34 var interactive = true35 private var pageImage: (page: Int, pixels: Int, image: CGImage)?36 private var rendering: (page: Int, pixels: Int)?37 private var draft: Stroke?38 private var draftStart: TimeInterval = 039 private var erasing: Set<UUID> = []40 private var panStart: (point: CGPoint, viewport: Viewport)?41 private var tracking: NSTrackingArea?4243 init(session: ProjectSession) {44 self.session = session45 super.init(frame: .zero)46 wantsLayer = true47 setAccessibilityElement(true)48 setAccessibilityRole(.image)49 setAccessibilityLabel(String(localized: "Diapositive"))50 setAccessibilityIdentifier("stage.canvas")51 }52 required init?(coder: NSCoder) { fatalError() }5354 override var isFlipped: Bool { true }55 override var isOpaque: Bool { true }56 /// A drag on the stage draws ink; it must never be taken as a window drag.57 override var mouseDownCanMoveWindow: Bool { false }58 override var acceptsFirstResponder: Bool { interactive }59 override func acceptsFirstMouse(for event: NSEvent?) -> Bool { true }6061 func sync() {62 setAccessibilityValue(String(localized: "Page \(session.page + 1) sur \(session.pageCount)") + " · " + String(localized: "\(session.currentStrokes.count) annotation(s)"))63 needsDisplay = true64 window?.invalidateCursorRects(for: self)65 }6667 override func updateTrackingAreas() {68 super.updateTrackingAreas()69 if let tracking { removeTrackingArea(tracking) }70 let t = NSTrackingArea(rect: bounds, options: [.mouseMoved, .mouseEnteredAndExited, .activeInKeyWindow, .inVisibleRect], owner: self)71 addTrackingArea(t); tracking = t72 }7374 override func resetCursorRects() {75 guard interactive else { return }76 let cursor: NSCursor = switch session.tool.kind {77 case .pan: .openHand78 case .eraser: .disappearingItem79 case .laser: .pointingHand80 default: .crosshair81 }82 addCursorRect(pageRect().intersection(bounds), cursor: cursor)83 }8485 // MARK: Geometry8687 /// Rect of the whole page in view coordinates for the current viewport.88 func pageRect() -> CGRect {89 let inset = bounds.insetBy(dx: 12, dy: 12)90 let fit = aspectFit(aspect: session.document.aspectRatio(session.page), in: inset)91 let v = session.viewport92 guard !v.isFit else { return fit }93 let w = fit.width * v.zoom, h = fit.height * v.zoom94 func clamp(_ c: Double, _ len: CGFloat, _ avail: CGFloat) -> CGFloat { let half = min(0.5, avail / len / 2); return CGFloat(min(1 - Double(half), max(Double(half), c))) }95 let cx = clamp(v.cx, w, bounds.width), cy = clamp(v.cy, h, bounds.height)96 return CGRect(x: bounds.midX - cx * w, y: bounds.midY - cy * h, width: w, height: h)97 }9899 private func mapping() -> PageMapping { PageMapping(rect: pageRect(), flipped: true) }100101 private func normalized(_ event: NSEvent) -> (x: Double, y: Double, inside: Bool) {102 let p = convert(event.locationInWindow, from: nil)103 let n = mapping().normalized(p)104 return (min(1, max(0, n.x)), min(1, max(0, n.y)), n.x >= 0 && n.x <= 1 && n.y >= 0 && n.y <= 1)105 }106107 // MARK: Drawing108109 override func draw(_ dirtyRect: NSRect) {110 guard let ctx = NSGraphicsContext.current?.cgContext else { return }111 ctx.setFillColor(NSColor(DS.stage).cgColor); ctx.fill(bounds)112 let rect = pageRect()113 let scale = window?.backingScaleFactor ?? 2114 let pixels = min(4096, Int((max(rect.width, rect.height) * scale / 64).rounded(.up)) * 64)115 if let img = pageImage, img.page == session.page {116 ctx.saveGState()117 ctx.setShadow(offset: .zero, blur: 14, color: NSColor.black.withAlphaComponent(0.5).cgColor)118 ctx.translateBy(x: 0, y: rect.minY + rect.maxY); ctx.scaleBy(x: 1, y: -1)119 ctx.interpolationQuality = .high120 ctx.draw(img.image, in: rect)121 ctx.restoreGState()122 } else {123 ctx.setFillColor(NSColor.white.cgColor); ctx.fill(rect)124 }125 if pageImage?.page != session.page || pageImage?.pixels != pixels { renderPage(session.page, pixels: pixels) }126127 ctx.saveGState()128 ctx.clip(to: rect)129 let map = PageMapping(rect: rect, flipped: true)130 for s in session.currentStrokes where !erasing.contains(s.id) { StrokeRenderer.draw(s, in: ctx, mapping: map) }131 if !erasing.isEmpty {132 ctx.saveGState(); ctx.setAlpha(0.25)133 for s in session.currentStrokes where erasing.contains(s.id) { StrokeRenderer.draw(s, in: ctx, mapping: map) }134 ctx.restoreGState()135 }136 if let draft { StrokeRenderer.draw(draft, in: ctx, mapping: map) }137 if let p = session.pointer { StrokeRenderer.drawPointer(x: p.x, y: p.y, in: ctx, mapping: map) }138 ctx.restoreGState()139 }140141 private func renderPage(_ page: Int, pixels: Int) {142 if let r = rendering, r.page == page, r.pixels == pixels { return }143 rendering = (page, pixels)144 let doc = session.document145 DispatchQueue.global(qos: .userInitiated).async { [weak self] in146 let img = doc.thumbnail(page: page, maxDimension: CGFloat(pixels))147 DispatchQueue.main.async {148 guard let self else { return }149 self.rendering = nil150 if let img, page == self.session.page { self.pageImage = (page, pixels, img); self.needsDisplay = true }151 }152 }153 }154155 // MARK: Mouse156157 private func pressureWidth(_ event: NSEvent) -> Double {158 // Tablets and Force Touch trackpads report pressure; a plain mouse reports 0 or 1.159 let p = Double(event.pressure)160 if event.subtype == .tabletPoint || (p > 0.02 && p < 0.98) { return 0.45 + p * 1.1 }161 return 1162 }163164 private func dt() -> Int64 { session.isTimelineRunning ? Int64((ProcessInfo.processInfo.systemUptime - draftStart) * 1e9) : 0 }165166 override func mouseDown(with event: NSEvent) {167 guard interactive else { return }168 window?.makeFirstResponder(self)169 let n = normalized(event)170 switch session.tool.kind {171 case .pan:172 panStart = (convert(event.locationInWindow, from: nil), session.viewport); NSCursor.closedHand.set()173 case .laser:174 if n.inside { session.movePointer(x: n.x, y: n.y) }175 case .eraser:176 erasing = []; erase(at: n)177 default:178 guard n.inside, let ink = session.tool.kind.inkTool else { return }179 draftStart = ProcessInfo.processInfo.systemUptime180 draft = Stroke(page: session.page, tool: ink, color: session.tool.strokeColor, width: session.tool.width, begin: session.strokeBeginTime(),181 points: [StrokePoint(x: n.x, y: n.y, dt: 0, w: ink.isShape ? 1 : pressureWidth(event))])182 }183 needsDisplay = true184 }185186 override func mouseDragged(with event: NSEvent) {187 guard interactive else { return }188 let n = normalized(event)189 switch session.tool.kind {190 case .pan:191 guard let start = panStart else { return }192 let p = convert(event.locationInWindow, from: nil), r = pageRect()193 session.applyViewport(Viewport(zoom: start.viewport.zoom, cx: start.viewport.cx - Double((p.x - start.point.x) / r.width), cy: start.viewport.cy - Double((p.y - start.point.y) / r.height)))194 case .laser:195 session.movePointer(x: n.x, y: n.y)196 case .eraser:197 erase(at: n)198 default:199 guard var d = draft else { return }200 if d.tool.isShape {201 // Keep the anchor and the latest corners (one sample per 30 ms is plenty to replay the drag).202 if let last = d.points.last, d.points.count > 1, dt() - last.dt < 30_000_000 { d.points.removeLast() }203 d.points.append(StrokePoint(x: n.x, y: n.y, dt: dt(), w: 1))204 } else if let last = d.points.last, hypot(last.x - n.x, (last.y - n.y)) > 0.0008 {205 d.points.append(StrokePoint(x: n.x, y: n.y, dt: dt(), w: pressureWidth(event)))206 }207 draft = d208 }209 needsDisplay = true210 }211212 override func mouseUp(with event: NSEvent) {213 guard interactive else { return }214 switch session.tool.kind {215 case .pan: panStart = nil; session.commitViewport(); NSCursor.openHand.set()216 case .laser: break217 case .eraser:218 if !erasing.isEmpty { session.remove(ids: Array(erasing)) }219 erasing = []220 default:221 if var d = draft {222 if d.tool.isShape, d.points.count == 1 { draft = nil; break } // a click without drag draws no shape223 if session.isTimelineRunning, let last = d.points.last { d.points[d.points.count - 1].dt = max(last.dt, dt()) }224 session.add(d)225 }226 draft = nil227 }228 needsDisplay = true229 }230231 private func erase(at n: (x: Double, y: Double, inside: Bool)) {232 let aspect = Double(session.document.aspectRatio(session.page))233 for s in session.currentStrokes where !erasing.contains(s.id) && StrokeRenderer.hit(s, x: n.x, y: n.y, radius: 0.012 / session.viewport.zoom, aspect: aspect) { erasing.insert(s.id) }234 }235236 override func mouseMoved(with event: NSEvent) {237 guard interactive, session.tool.kind == .laser else { return }238 let n = normalized(event)239 if n.inside { session.movePointer(x: n.x, y: n.y) } else { session.hidePointer() }240 }241 override func mouseExited(with event: NSEvent) { if session.tool.kind == .laser { session.hidePointer() } }242243 // MARK: Zoom, pan, keyboard244245 override func magnify(with event: NSEvent) {246 guard interactive else { return }247 let v = session.viewport248 let n = normalized(event)249 let newZoom = min(8, max(1, v.zoom * (1 + Double(event.magnification))))250 // Keep the point under the cursor fixed while zooming.251 let k = v.zoom / newZoom252 session.applyViewport(Viewport(zoom: newZoom, cx: n.x + (v.cx - n.x) * k, cy: n.y + (v.cy - n.y) * k))253 if event.phase == .ended || event.phase == .cancelled { session.commitViewport() }254 }255256 override func smartMagnify(with event: NSEvent) {257 guard interactive else { return }258 let n = normalized(event)259 session.applyViewport(session.viewport.isFit ? Viewport(zoom: 2.5, cx: n.x, cy: n.y) : .fit, force: true)260 }261262 override func scrollWheel(with event: NSEvent) {263 guard interactive, !session.viewport.isFit else { super.scrollWheel(with: event); return }264 let r = pageRect(), v = session.viewport265 session.applyViewport(Viewport(zoom: v.zoom, cx: v.cx - Double(event.scrollingDeltaX / r.width), cy: v.cy - Double(event.scrollingDeltaY / r.height)))266 if event.phase == .ended || event.momentumPhase == .ended { session.commitViewport() }267 }268269 override func keyDown(with event: NSEvent) {270 guard interactive else { super.keyDown(with: event); return }271 switch event.keyCode {272 case 124, 125, 121, 49: session.nextPage() // → ↓ PageDown Space273 case 123, 126, 116: session.previousPage() // ← ↑ PageUp274 case 115: session.go(to: 0) // Home275 case 119: session.go(to: session.pageCount - 1) // End276 case 53: if !session.viewport.isFit { session.applyViewport(.fit, force: true) } else { super.keyDown(with: event) }277 default: super.keyDown(with: event)278 }279 }280}281