SPB Git

Repository Public

MacCanvasView.swift 12.5 KB 281 lines swift

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
Files main
Menu

Theme