mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-19 21:03:09 +00:00
397 lines
14 KiB
TypeScript
397 lines
14 KiB
TypeScript
import { G2_LENS_HEIGHT, G2_LENS_WIDTH, GrayImage, type UiFont } from "../graphics/image";
|
|
import { wrapText } from "../graphics/textwrap";
|
|
import { getDefaultSmallFont } from "../graphics/ui-fonts";
|
|
import { clamp } from "../util/numeric-util";
|
|
import { Layer, LayerContext, PaintBelow } from "./layers";
|
|
import { Menu, MENU_HIGHLIGHT_FILL, MENU_HIGHLIGHT_STROKE } from "./menu-core";
|
|
|
|
import { GESTURE_DOUBLE_CLICK, InputEvent } from "./gestures";
|
|
import { LIST_ROW_TEXT_INSET, centeredTextY, lineStep, listRowHeight, menuTitleHeight } from "./metrics";
|
|
const DEFAULT_MENU_X = 8;
|
|
const DEFAULT_MENU_Y = 8;
|
|
const DEFAULT_MENU_WIDTH = 272;
|
|
// Menus grow with their item count, from half the screen (matching the old
|
|
// fixed quarter-screen-era look) up to the full screen, then scroll.
|
|
const DEFAULT_MENU_MIN_HEIGHT = G2_LENS_HEIGHT / 2 - 2 * DEFAULT_MENU_Y;
|
|
const MENU_BODY_PADDING = 8;
|
|
/** Gap between the last item row and a footer hint line. */
|
|
const MENU_FOOTER_GAP = 8;
|
|
/** Horizontal inset of the row (highlight) boxes from the menu box's edges. */
|
|
const MENU_ROW_INSET = 12;
|
|
/** Horizontal inset of row text from the row box. */
|
|
const MENU_ROW_TEXT_INSET = 10;
|
|
|
|
export type MenuLayout = {
|
|
/** Stereo depth of the menu surface, including the selected row. */
|
|
depth?: number;
|
|
/** Left edge, or "center" to center horizontally on the painted surface. */
|
|
x: number | "center";
|
|
y: number;
|
|
width: number;
|
|
/** Whether to draw the rounded outline around the menu. Default: true. */
|
|
showBorder?: boolean;
|
|
/** Smallest box to draw even when items don't fill it. Default: top half of the screen. */
|
|
minHeight?: number;
|
|
/** Height cap before the menu starts scrolling. Default: the full screen. */
|
|
maxHeight?: number;
|
|
/**
|
|
* Dim hint line pinned to the bottom edge inside the box, below the items
|
|
* (gesture help such as "●— system menu"). Takes a line off the item area.
|
|
*/
|
|
footer?: string;
|
|
/** Brightness factor for everything beneath the menu (see Layer.dimUnderneath). Default: none. */
|
|
dimUnderneath?: number;
|
|
/**
|
|
* Paint as a standalone page: the layers below stay in the stack for back
|
|
* navigation but are not composited underneath. Default: false — the menu
|
|
* renders over whatever is below it (modal/window menus).
|
|
*/
|
|
opaque?: boolean;
|
|
squareCorners?: boolean;
|
|
};
|
|
|
|
export type MenuItemRenderArgs = {
|
|
image: GrayImage;
|
|
x: number;
|
|
y: number;
|
|
width: number;
|
|
height: number;
|
|
selected: boolean;
|
|
disabled: boolean;
|
|
text: string;
|
|
ctx: LayerContext;
|
|
};
|
|
|
|
export type MenuItem = {
|
|
label: string;
|
|
/** Extended description; the Settings panel shows it below the list while the item is selected. */
|
|
description?: string;
|
|
/** Disabled rows stay visible but render dimly and ignore clicks. */
|
|
disabled?: boolean | (() => boolean);
|
|
onSelect: (ctx: LayerContext, menu: MenuLayer) => Promise<void> | void;
|
|
render?: (args: MenuItemRenderArgs) => void;
|
|
};
|
|
|
|
/**
|
|
* Draw a selection highlight for a list row. A focused list fills the row and
|
|
* outlines it; a visible-but-unfocused list draws only the outline, so the
|
|
* selection stays legible without implying it will receive input.
|
|
*/
|
|
export function drawSelectionHighlight(
|
|
image: GrayImage,
|
|
x: number,
|
|
y: number,
|
|
width: number,
|
|
height: number,
|
|
focused: boolean,
|
|
radius = 6,
|
|
): void {
|
|
if (focused) {
|
|
image.fillRoundedRect(x, y, width, height, MENU_HIGHLIGHT_FILL, radius);
|
|
}
|
|
image.drawRoundedRect(x, y, width, height, MENU_HIGHLIGHT_STROKE, radius);
|
|
}
|
|
|
|
/**
|
|
* Move a list's scroll position the minimum distance needed to keep the
|
|
* selected row inside the visible window, clamped to the list bounds.
|
|
* Returns the new scroll row (the index of the first visible item).
|
|
*/
|
|
export function scrollToKeepSelectionVisible(
|
|
scrollRow: number,
|
|
selectedIndex: number,
|
|
visibleRowCount: number,
|
|
itemCount: number,
|
|
): number {
|
|
if (selectedIndex < scrollRow) {
|
|
scrollRow = selectedIndex;
|
|
} else if (selectedIndex >= scrollRow + visibleRowCount) {
|
|
scrollRow = selectedIndex - visibleRowCount + 1;
|
|
}
|
|
return clamp(scrollRow, 0, Math.max(0, itemCount - visibleRowCount));
|
|
}
|
|
|
|
/**
|
|
* Draw a vertical scrollbar beside a row-scrolled list: a dim track with a
|
|
* proportional thumb positioned by scroll fraction. Only call when the list
|
|
* actually overflows (itemCount > visibleRowCount).
|
|
*/
|
|
export function drawListScrollbar(
|
|
image: GrayImage,
|
|
trackX: number,
|
|
trackY: number,
|
|
trackHeight: number,
|
|
scrollRow: number,
|
|
visibleRowCount: number,
|
|
itemCount: number,
|
|
): void {
|
|
image.fillRect(trackX, trackY, 3, trackHeight, 30);
|
|
const thumbHeight = Math.max(8, (trackHeight * visibleRowCount / itemCount) | 0);
|
|
const maxScrollRow = Math.max(1, itemCount - visibleRowCount);
|
|
const thumbY = trackY + (((trackHeight - thumbHeight) * clamp(scrollRow, 0, maxScrollRow) / maxScrollRow) | 0);
|
|
image.fillRect(trackX, thumbY, 3, thumbHeight, 120);
|
|
}
|
|
|
|
/**
|
|
* Draw a ">" submenu indicator inset at the right edge of a row's selection
|
|
* highlight box, vertically centered within it. Pass the same rect as the
|
|
* row's drawSelectionHighlight call (the row need not actually be selected).
|
|
*/
|
|
export function drawSubmenuIndicator(
|
|
image: GrayImage,
|
|
font: UiFont,
|
|
highlightX: number,
|
|
highlightY: number,
|
|
highlightWidth: number,
|
|
highlightHeight: number,
|
|
value: number,
|
|
): void {
|
|
const arrow = ">";
|
|
const x = highlightX + highlightWidth - font.measureText(arrow) - 4;
|
|
const y = centeredTextY(font, highlightY, highlightHeight);
|
|
image.drawText(font, x, y, arrow, value);
|
|
}
|
|
|
|
export function drawToggleMenuItem(
|
|
image: GrayImage,
|
|
font: UiFont,
|
|
x: number,
|
|
y: number,
|
|
width: number,
|
|
label: string,
|
|
enabled: boolean,
|
|
selected: boolean,
|
|
): void {
|
|
const switchWidth = 34;
|
|
const switchHeight = 16;
|
|
const switchX = x + width - switchWidth - 2;
|
|
// Center the switch on the row's line box (legacy y+1 at the 12px default).
|
|
const switchY = y + Math.max(1, Math.round((listRowHeight(font) - 2 - switchHeight) / 2));
|
|
image.drawText(font, x, y + LIST_ROW_TEXT_INSET, label, 200);
|
|
const offFill = selected ? 1 : 18;
|
|
image.fillRoundedRect(switchX, switchY, switchWidth, switchHeight, enabled ? 70 : offFill, 8);
|
|
image.drawRoundedRect(switchX, switchY, switchWidth, switchHeight, enabled ? 130 : 55, 8);
|
|
const knobSize = 12;
|
|
const knobX = enabled ? switchX + switchWidth - knobSize - 2 : switchX + 2;
|
|
image.fillRoundedRect(knobX, switchY + 2, knobSize, knobSize, enabled ? 230 : selected ? 170 : 90, 6);
|
|
}
|
|
|
|
export function drawRightValueMenuItem(
|
|
image: GrayImage,
|
|
font: UiFont,
|
|
x: number,
|
|
y: number,
|
|
width: number,
|
|
label: string,
|
|
value: string,
|
|
): void {
|
|
image.drawText(font, x, y + LIST_ROW_TEXT_INSET, label, 200);
|
|
const valueX = x + width - font.measureText(value) - 2;
|
|
image.drawText(font, valueX, y + LIST_ROW_TEXT_INSET, value, 220);
|
|
}
|
|
|
|
/** How far context menus (window and system) dim the content beneath them. */
|
|
export const CONTEXT_MENU_DIM = 0.25;
|
|
|
|
export class MenuLayer implements Layer {
|
|
private readonly menu: Menu<MenuItem>;
|
|
/** The context of the paint in progress, handed to item render callbacks. */
|
|
private paintCtx: LayerContext | null = null;
|
|
|
|
get depth(): number { return this.layout.depth ?? 0; }
|
|
|
|
get dimUnderneath(): false | number {
|
|
return this.layout.dimUnderneath ?? false;
|
|
}
|
|
|
|
constructor(
|
|
private readonly title: string | null,
|
|
private items: MenuItem[],
|
|
private readonly layout: MenuLayout = {
|
|
x: DEFAULT_MENU_X,
|
|
y: DEFAULT_MENU_Y,
|
|
width: DEFAULT_MENU_WIDTH,
|
|
},
|
|
public readonly paintOverBase = false,
|
|
) {
|
|
this.menu = new Menu<MenuItem>({
|
|
items,
|
|
wrap: true,
|
|
rowGap: 1,
|
|
getHeight: () => listRowHeight(getDefaultSmallFont()),
|
|
draw: ({ image, item, x, y, width, height, selected }) => {
|
|
const font = getDefaultSmallFont();
|
|
const disabled = isMenuItemDisabled(item);
|
|
if (item.render) {
|
|
item.render({
|
|
image,
|
|
x: x + MENU_ROW_TEXT_INSET,
|
|
y,
|
|
width: width - 2 * MENU_ROW_TEXT_INSET,
|
|
height: height - 2,
|
|
selected,
|
|
disabled,
|
|
text: item.label,
|
|
ctx: this.paintCtx!,
|
|
});
|
|
} else {
|
|
image.drawText(font, x + MENU_ROW_TEXT_INSET, y + LIST_ROW_TEXT_INSET, item.label,
|
|
disabled ? 70 : selected ? 255 : 200);
|
|
}
|
|
},
|
|
});
|
|
}
|
|
|
|
/** Start a newly opened picker on its current value. */
|
|
selectItem(index: number): this {
|
|
this.menu.select(index);
|
|
return this;
|
|
}
|
|
|
|
/** The selected row's index, or null when nothing is selectable. */
|
|
get selectedIndex(): number | null {
|
|
return this.menu.selectedIndex;
|
|
}
|
|
|
|
get selectedItem(): MenuItem | null {
|
|
return this.menu.selectedItem;
|
|
}
|
|
|
|
/**
|
|
* Replace the rows in place, keeping scroll and highlight state. The
|
|
* selection follows Menu.setItems: pass the new index of the previously
|
|
* selected row, or leave it out to keep the same index, clamped.
|
|
*/
|
|
setItems(items: MenuItem[], selectedIndex?: number | null): void {
|
|
this.items = items;
|
|
this.menu.setItems(items, selectedIndex);
|
|
}
|
|
|
|
paint(ctx: LayerContext, paintBelow: PaintBelow): GrayImage {
|
|
const font = getDefaultSmallFont();
|
|
const rowHeight = listRowHeight(font);
|
|
const base = ctx.stack.getBaseSize();
|
|
const image = this.layout.opaque ? new GrayImage(base.width, base.height, 0) : paintBelow();
|
|
const { y, width } = this.layout;
|
|
const x = this.layout.x === "center" ? ((image.width - width) / 2) | 0 : this.layout.x;
|
|
const chromeTop = (this.title ? menuTitleHeight(font) : 0) + MENU_BODY_PADDING;
|
|
const minHeight = this.layout.minHeight ?? DEFAULT_MENU_MIN_HEIGHT;
|
|
// Cap to the surface being painted on: a window's stack image may be much
|
|
// shorter than the full screen (min-height windows).
|
|
const maxHeight = Math.min(
|
|
this.layout.maxHeight ?? image.height - y - DEFAULT_MENU_Y,
|
|
image.height - y,
|
|
(this.layout.squareCorners || this.depth !== 0) ? Math.floor(65530 / Math.ceil(width / 2)) : Infinity,
|
|
);
|
|
const footerHeight = this.layout.footer ? MENU_FOOTER_GAP + lineStep(font) : 0;
|
|
const contentHeight = chromeTop + this.items.length * rowHeight + footerHeight + MENU_BODY_PADDING;
|
|
const height = clamp(contentHeight, Math.min(minHeight, maxHeight), maxHeight);
|
|
const visibleRowCount = Math.max(
|
|
1,
|
|
((height - chromeTop - footerHeight - MENU_BODY_PADDING) / rowHeight) | 0,
|
|
);
|
|
|
|
// Fill 1, not 0: identical after 4bpp quantization, but 0 is the
|
|
// transparent color key when a menu paints on the shell surface.
|
|
if (this.layout.squareCorners) image.fillRect(x, y, width, height, 1);
|
|
else image.fillRoundedRect(x, y, width, height, 1);
|
|
if (this.layout.showBorder !== false) {
|
|
if (this.layout.squareCorners) image.drawRect(x, y, width, height, 72);
|
|
else image.drawRoundedRect(x, y, width, height, 72);
|
|
}
|
|
if (this.title) {
|
|
image.drawText(font, x + 12, y + 8, this.title, 220);
|
|
}
|
|
if (this.layout.footer) {
|
|
image.drawText(font, x + 22, y + height - MENU_BODY_PADDING - font.lineHeight, this.layout.footer, 110);
|
|
}
|
|
|
|
const bodyY = y + chromeTop;
|
|
const listHeight = visibleRowCount * rowHeight;
|
|
this.paintCtx = ctx;
|
|
try {
|
|
this.menu.paint(image, { x: x + MENU_ROW_INSET, y: bodyY, width: width - 2 * MENU_ROW_INSET, height: listHeight },
|
|
ctx.stack.isFocused());
|
|
} finally {
|
|
this.paintCtx = null;
|
|
}
|
|
this.menu.drawScrollbar(image, x + width - 7, bodyY, listHeight - 4);
|
|
return image;
|
|
}
|
|
|
|
async handleInput(event: InputEvent, ctx: LayerContext): Promise<void> {
|
|
switch (event.type) {
|
|
case "double-click":
|
|
ctx.stack.pop();
|
|
return;
|
|
case "click": {
|
|
const item = this.menu.selectedItem;
|
|
if (item && !isMenuItemDisabled(item)) {
|
|
await item.onSelect(ctx, this);
|
|
}
|
|
return;
|
|
}
|
|
default:
|
|
await this.menu.handleInput(event);
|
|
return;
|
|
}
|
|
}
|
|
}
|
|
|
|
/** Open a centered, bordered menu over the current layer. */
|
|
export function openModalMenu(
|
|
ctx: LayerContext,
|
|
title: string,
|
|
items: MenuItem[],
|
|
initialSelectedIndex = 0,
|
|
): void {
|
|
const { width, height } = ctx.stack.getBaseSize();
|
|
const font = getDefaultSmallFont();
|
|
const menuWidth = Math.min(320, width - 40);
|
|
const naturalHeight = menuTitleHeight(font) + 2 * MENU_BODY_PADDING + items.length * listRowHeight(font);
|
|
const menuHeight = Math.min(naturalHeight, height - 40);
|
|
const layout: MenuLayout = {
|
|
x: ((width - menuWidth) / 2) | 0,
|
|
y: ((height - menuHeight) / 2) | 0,
|
|
width: menuWidth,
|
|
minHeight: menuHeight,
|
|
maxHeight: menuHeight,
|
|
};
|
|
ctx.stack.push(new MenuLayer(title, items, layout).selectItem(initialSelectedIndex));
|
|
}
|
|
|
|
export function isMenuItemDisabled(item: MenuItem): boolean {
|
|
return typeof item.disabled === "function" ? item.disabled() : item.disabled === true;
|
|
}
|
|
|
|
export class TextPageLayer implements Layer {
|
|
constructor(
|
|
private readonly title: string,
|
|
private readonly body: string,
|
|
) {}
|
|
|
|
paint(_ctx: LayerContext): GrayImage {
|
|
const font = getDefaultSmallFont();
|
|
const image = new GrayImage(G2_LENS_WIDTH, G2_LENS_HEIGHT, 0);
|
|
image.drawText(font, 18, 14, this.title, 220);
|
|
image.drawRect(12, 12, G2_LENS_WIDTH - 24, G2_LENS_HEIGHT - 24, 52);
|
|
|
|
const wrapped = wrapText(font, this.body, G2_LENS_WIDTH - 60);
|
|
const step = lineStep(font);
|
|
const bodyTop = 28 + font.lineHeight;
|
|
const footerY = G2_LENS_HEIGHT - 48;
|
|
const maxBodyLines = Math.max(0, Math.floor((footerY - bodyTop - 8) / step));
|
|
for (let index = 0; index < Math.min(wrapped.length, maxBodyLines); index++) {
|
|
image.drawText(font, 24, bodyTop + index * step, wrapped[index]!, 190);
|
|
}
|
|
image.drawText(font, 24, footerY, `${GESTURE_DOUBLE_CLICK} back`, 110);
|
|
return image;
|
|
}
|
|
|
|
handleInput(event: InputEvent, ctx: LayerContext): void {
|
|
if (event.type === "double-click") {
|
|
ctx.stack.pop();
|
|
}
|
|
}
|
|
}
|