Reference · Cube engine and views
pickDragfunction
The layer a drag across a sticker means, once it can be told: null while
the pointer has not gone far enough, or while the two layers that carry the
sticker are too nearly as likely as each other. Past DRAG_DECIDE_PX the
likelier is picked whatever the odds. A drag that began on a seam
(seamsAt) and goes the way that turns about the seam's axis picks the
layer beside as well (also).
Import it
import { pickDrag } from "@johnmorrisdotca/kyuubu";
Definition
function pickDrag(slot: StickerSlot, n: number, view: Mat3, dx: number, dy: number, seams?: readonly Seam[]): DragPick | null
Parameters
| Name | Type | Description |
|---|---|---|
slot | StickerSlot | The sticker’s centre and outward normal. |
n | number | The cube’s side length. |
view | Mat3 | The view matrix, or mounted CubeView for a guide. |
dx | number | The horizontal pointer displacement in pixels. |
dy | number | The vertical pointer displacement in pixels. |
seams (optional) | readonly Seam[] | The nearby seams selected at the start of the drag. |
Returns
DragPick | null
The layer a drag across a sticker means, once it can be told: null while the pointer has not gone far enough, or while the two layers that carry the sticker are too nearly as likely as each other. Past DRAG_DECIDE_PX the likelier is picked whatever the odds. A drag that began on a seam (seamsAt) and goes the way that turns about the seam's axis picks the layer beside as well (also).
Examples
import { cubeSlots, pickDrag, viewMatrix } from "@johnmorrisdotca/kyuubu";
const view = viewMatrix(-30, -20);
const slot = cubeSlots(3).slots[0]!;
console.log(pickDrag(slot, 3, view, 40, 0));{
axis: 2,
layer: 0,
along: [ -0.7356226275534367, 0.6773915779158889 ]
}What it prints (run when this page was built)