raea/picking

pick finds the nearest part under the pointer, given the camera and the parts, and pointerRay gives the ray the pointer casts into the scene. Both are pure functions, so a game's step function can use them and still replay exactly.

import { pick, pointerRay } from "raea/picking"

raea/picking exports 2 functions, 3 types. Bevy's counterpart: bevy_picking. Source: sdk/raea/src/picking.ts.

#Functions

#pick

The nearest part under the pointer, or null. size is the frame's (useVideoConfig's width and height), whose pixels the pointer is in.

function pick(pointer: { x: number; y: number; }, camera: PickCamera, parts: readonly Pickable[], size: { width: number; height: number; }): Hit | null

#pointerRay

The pointer's ray: from the camera through the pointer (x, y in the frame's pixels, y down), as the engine draws it (Bevy's looking_at, with +Z for up when the camera looks straight up or down, as rdb does).

function pointerRay(pointer: { x: number; y: number; }, camera: PickCamera, size: { width: number; height: number; }): { origin: Vec3; direction: Vec3; }

#Types

#Hit

#Pickable

Something the pointer can hit: an axis-aligned box or a sphere, in world space.

type Pickable = { name: string; box: { min: Vec3; max: Vec3 } } | { name: string; sphere: { center: Vec3; radius: number } }

#PickCamera

The camera as a scene sets it: a PerspectiveCamera's props (fov in degrees, vertical) or an OrthographicCamera's.