Optional ReadonlypreferPick editable geometry by zIndex, then frame order, rather than area. Rects accompanying masks or paths are bounds, not independent box targets; mask fills stay below vector geometry unless maskOrder is "detection". Defaults to false.
Optional ReadonlymaskInclude masks in detection order when preferTopmost is enabled.
Optional ReadonlypaddingOptional ReadonlypolylineOptional ReadonlykeypointOptional ReadonlyedgeOptional ReadonlymaskMedia dimensions used to map media-space points into mask raster space.
Optional ReadonlyincludeOptional ReadonlyincludeOptional ReadonlyfilterOptional ReadonlymodeOptional ReadonlyonRuns before default selection, editing, or marquee handling, including empty presses and repeated hits. Return "handled" to skip those defaults and the press's subsequent tap, or "continue" to keep them. Hosts own any ongoing gesture and should let its release or cancellation reach the renderer. The browser may report coordinates outside media; there, "continue" permits only selected-handle editing with an editing engine. Returning "continue" must leave selection and editing state unchanged: defaults use the snapshot resolved before this callback. Return "handled" when the host changes that state.
Optional ReadonlyonOptional ReadonlyonReports selection identity changes. A stable, frame-unique detection id may keep rendering as selected across later frames without re-emitting this callback. The pick is the immutable frame snapshot where the selection event occurred; use the detection id with the active frame when current geometry is required.
Optional ReadonlymultiOptional ReadonlymarqueeSelect intersecting bounds by default, or require full containment.
Optional ReadonlyonReports selection membership changes, not per-frame geometry updates for stable detection ids. Each pick is the snapshot that produced that membership event.
Optional Readonlyon
The renderer supplies
viewportScalefrom its own viewport.