mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-19 21:03:09 +00:00
215 lines
7.5 KiB
TypeScript
215 lines
7.5 KiB
TypeScript
import { G2_LENS_HEIGHT, G2_LENS_WIDTH, GrayImage } from "../graphics/image";
|
|
import { type Plane } from "../graphics/plane";
|
|
import { spanCurrent } from "../native/frame-timings";
|
|
import { type ConfigSettingString } from "./dashboard-settings";
|
|
|
|
export type DashboardInputEvent =
|
|
| { type: "click"; source: "ring" | "left-arm" | "right-arm" }
|
|
| { type: "double-click"; source: "ring" | "left-arm" | "right-arm" }
|
|
| { type: "scroll-up" }
|
|
| { type: "scroll-down" }
|
|
| { type: "long-press"; source: "ring" | "left-arm" | "right-arm" }
|
|
| { type: "long-press-release"; source: "ring" | "left-arm" | "right-arm" }
|
|
/**
|
|
* The stock display lifecycle woke while no EvenHub page was running. This
|
|
* is wake-only, unlike a normal double-click (which turns an on screen off).
|
|
*/
|
|
| { type: "display-wake" }
|
|
/**
|
|
* The on-glasses "Hey Even" wakeword fired. Delivered on sid 0x07 by the
|
|
* stock firmware regardless of CFW; the CFW additionally suppresses the stock
|
|
* Even AI app so this is ours to handle. Its configured action may be applied
|
|
* while the screen is off, unlike ordinary input events.
|
|
*/
|
|
| { type: "wakeword" }
|
|
| { type: "unknown"; kind: string; eventSource: number; eventType: number };
|
|
|
|
export type LayerActions = {
|
|
/** Ask for a dashboard repaint+transmit, e.g. when async data arrives. */
|
|
requestRender: () => void;
|
|
disconnect: () => Promise<void> | void;
|
|
startTextSettingEdit: (setting: ConfigSettingString) => Promise<void> | void;
|
|
/** Open one phone form for multiple related settings (for example email + password). */
|
|
startTextSettingsEdit: (
|
|
settings: readonly ConfigSettingString[],
|
|
title: string,
|
|
onFinish?: () => void,
|
|
) => Promise<void> | void;
|
|
endTextSettingEdit: () => Promise<void> | void;
|
|
/**
|
|
* Start push-to-talk voice capture with the provider chosen in settings.
|
|
* With `endpointing`, the capture also ends itself when the speaker stops
|
|
* (hands-free); otherwise it runs until stopVoiceCapture.
|
|
*/
|
|
startVoiceCapture: (endpointing?: boolean) => Promise<void> | void;
|
|
/** Stop push-to-talk; for a cloud provider this also commits for a final result. */
|
|
stopVoiceCapture: () => Promise<void> | void;
|
|
/** Start continuous capture (Transcribe); shares the mic with push-to-talk. */
|
|
startContinuousVoiceCapture: () => Promise<void> | void;
|
|
stopContinuousVoiceCapture: () => Promise<void> | void;
|
|
/** Play a CFW tone-sequencer payload (see sound-effects.ts). */
|
|
playBuzzerSequence: (payload: Uint8Array) => Promise<void> | void;
|
|
};
|
|
|
|
/** Do-nothing actions, for stacks whose layers never use them (or as a base to spread over). */
|
|
export const noopLayerActions: LayerActions = {
|
|
requestRender: () => {},
|
|
disconnect: () => {},
|
|
startTextSettingEdit: () => {},
|
|
startTextSettingsEdit: () => {},
|
|
endTextSettingEdit: () => {},
|
|
startVoiceCapture: () => {},
|
|
stopVoiceCapture: () => {},
|
|
startContinuousVoiceCapture: () => {},
|
|
stopContinuousVoiceCapture: () => {},
|
|
playBuzzerSequence: () => {},
|
|
};
|
|
|
|
/**
|
|
* Hands a layer its paint canvas: a fresh transparent (0-filled) image the
|
|
* size of the stack. Calling it also declares that the layers below should
|
|
* stay visible beneath this layer — each layer becomes its own plane, so a
|
|
* layer that never calls paintBelow fully replaces what is under it (its
|
|
* plane is submitted alone), while one that does gets composited above the
|
|
* planes below. Repeat calls return the same canvas.
|
|
*
|
|
* Note the plane model's occlusion rule: raster painted onto the canvas
|
|
* covers lower planes entirely (including their text), but glyphs drawn into
|
|
* the *same* image always render above that image's own raster.
|
|
*/
|
|
export type PaintBelow = () => GrayImage;
|
|
|
|
function notifyRemoved(layer: Layer | undefined): void {
|
|
try {
|
|
layer?.onRemoved?.();
|
|
} catch (error) {
|
|
console.warn("layer onRemoved failed", error);
|
|
}
|
|
}
|
|
|
|
export interface LayerContext {
|
|
readonly stack: LayerStack;
|
|
readonly actions: LayerActions;
|
|
}
|
|
|
|
export interface Layer {
|
|
readonly paintOverBase?: boolean;
|
|
paint(ctx: LayerContext, paintBelow: PaintBelow): GrayImage;
|
|
handleInput(event: DashboardInputEvent, ctx: LayerContext): Promise<void> | void;
|
|
/** Called when the layer leaves the stack by any path (pop or clearToBase). */
|
|
onRemoved?(): void;
|
|
}
|
|
|
|
export class LayerStack {
|
|
private readonly layers: Layer[];
|
|
private readonly ctx: LayerContext;
|
|
private baseWidth: number;
|
|
private baseHeight: number;
|
|
private readonly focusedFn: () => boolean;
|
|
|
|
constructor(
|
|
baseLayer: Layer,
|
|
actions: LayerActions,
|
|
baseSize?: { width: number; height: number },
|
|
// Whether this stack is the current input target; drives the strength of
|
|
// selection highlights (a visible-but-unfocused window dims its selection).
|
|
// Defaults to always-focused for shell overlays and standalone stacks.
|
|
isFocused: () => boolean = () => true,
|
|
) {
|
|
this.layers = [baseLayer];
|
|
this.ctx = {
|
|
stack: this,
|
|
actions,
|
|
};
|
|
this.baseWidth = baseSize?.width ?? G2_LENS_WIDTH;
|
|
this.baseHeight = baseSize?.height ?? G2_LENS_HEIGHT;
|
|
this.focusedFn = isFocused;
|
|
}
|
|
|
|
isFocused(): boolean {
|
|
return this.focusedFn();
|
|
}
|
|
|
|
push(layer: Layer): void {
|
|
this.layers.push(layer);
|
|
}
|
|
|
|
pop(): void {
|
|
if (this.layers.length > 1) {
|
|
notifyRemoved(this.layers.pop());
|
|
}
|
|
}
|
|
|
|
/** Whether the top layer matches (without popping it). */
|
|
topMatches(predicate: (layer: Layer) => boolean): boolean {
|
|
return this.layers.length > 1 && predicate(this.layers[this.layers.length - 1]!);
|
|
}
|
|
|
|
/** Pop the top layer only if it matches; returns whether a layer was popped. */
|
|
popIfTop(predicate: (layer: Layer) => boolean): boolean {
|
|
if (this.layers.length > 1 && predicate(this.layers[this.layers.length - 1]!)) {
|
|
notifyRemoved(this.layers.pop());
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
clearToBase(): void {
|
|
for (const layer of this.layers.splice(1)) {
|
|
notifyRemoved(layer);
|
|
}
|
|
}
|
|
|
|
isAtBase(): boolean {
|
|
return this.layers.length === 1;
|
|
}
|
|
|
|
getBaseSize(): { width: number; height: number } {
|
|
return { width: this.baseWidth, height: this.baseHeight };
|
|
}
|
|
|
|
/** Resize the base viewport (e.g. an EvenHub window switching to the tall canvas). */
|
|
setBaseSize(size: { width: number; height: number }): void {
|
|
this.baseWidth = size.width;
|
|
this.baseHeight = size.height;
|
|
}
|
|
|
|
setActions(actions: Partial<LayerActions>): void {
|
|
Object.assign(this.ctx.actions, actions);
|
|
}
|
|
|
|
/**
|
|
* Paint the stack as planes, bottom to top: the top layer's plane last,
|
|
* preceded by the planes of the layers it asked to remain visible (see
|
|
* PaintBelow). All planes share the stack's base size at offset (0, 0).
|
|
*/
|
|
paint(): Plane[] {
|
|
return this.paintLayer(this.layers.length - 1);
|
|
}
|
|
|
|
async handleInput(event: DashboardInputEvent): Promise<void> {
|
|
await this.layers[this.layers.length - 1]!.handleInput(event, this.ctx);
|
|
}
|
|
|
|
private paintLayer(index: number): Plane[] {
|
|
const layer = this.layers[index]!;
|
|
let canvas: GrayImage | null = null;
|
|
let belowRequested = false;
|
|
const image = spanCurrent(`paint[${index}]:${layer.constructor.name}`, () =>
|
|
layer.paint(this.ctx, () => {
|
|
belowRequested = true;
|
|
if (!canvas) {
|
|
canvas = new GrayImage(this.baseWidth, this.baseHeight, 0);
|
|
}
|
|
return canvas;
|
|
}),
|
|
);
|
|
const ownPlane: Plane = { image, x: 0, y: 0 };
|
|
if (index <= 0 || !belowRequested) {
|
|
return [ownPlane];
|
|
}
|
|
const below = layer.paintOverBase ? this.paintLayer(0) : this.paintLayer(index - 1);
|
|
return [...below, ownPlane];
|
|
}
|
|
}
|