forked from Blendman974/faceclaw
178 lines
8.6 KiB
TypeScript
178 lines
8.6 KiB
TypeScript
/**
|
|
* Schematic diagrams of the shell's layouts for the onboarding's Layout
|
|
* page: to scale in real-display pixels, simplified, and drawn brighter
|
|
* than the real chrome, which they shrink to a few pixels.
|
|
*/
|
|
import { G2_LENS_WIDTH, type GrayImage } from "../../graphics/image";
|
|
import { statusBarPositionSetting, type AppSwitcherPosition } from "../../ui/dashboard-settings";
|
|
import { SIDEBAR_WIDTH, SWITCHER_ROW_HEIGHT, MIN_WINDOW_HEIGHT, TOP_BAR_HEIGHT } from "../../ui/shell/geometry";
|
|
|
|
export const AREA_OUTLINE = 30;
|
|
const CHROME_LINE = 100;
|
|
const WINDOW_FRAME = 140;
|
|
const ICON = 160;
|
|
const SELECTED_ICON = 230;
|
|
const STATUS = 140;
|
|
const CONTENT = 110;
|
|
const CONTENT_TITLE = 170;
|
|
/** Window content under a popup switcher, which dims it. */
|
|
const DIM = 0.5;
|
|
|
|
/** Draws in real-display pixels, scaled into an image at (x, y). */
|
|
export class Diagram {
|
|
constructor(
|
|
private readonly image: GrayImage,
|
|
private readonly x: number,
|
|
private readonly y: number,
|
|
private readonly scale: number,
|
|
) {}
|
|
|
|
private box(x: number, y: number, width: number, height: number) {
|
|
const left = this.x + Math.round(x * this.scale), top = this.y + Math.round(y * this.scale);
|
|
return {
|
|
x: left,
|
|
y: top,
|
|
width: Math.max(1, this.x + Math.round((x + width) * this.scale) - left),
|
|
height: Math.max(1, this.y + Math.round((y + height) * this.scale) - top),
|
|
};
|
|
}
|
|
|
|
fill(x: number, y: number, width: number, height: number, value: number, radius = 0): void {
|
|
const box = this.box(x, y, width, height);
|
|
if (radius) this.image.fillRoundedRect(box.x, box.y, box.width, box.height, value, Math.max(1, Math.round(radius * this.scale)));
|
|
else this.image.fillRect(box.x, box.y, box.width, box.height, value);
|
|
}
|
|
|
|
outline(x: number, y: number, width: number, height: number, value: number, radius = 0): void {
|
|
const box = this.box(x, y, width, height);
|
|
this.image.drawRoundedRect(box.x, box.y, box.width, box.height, value, Math.max(0, Math.round(radius * this.scale)));
|
|
}
|
|
|
|
/** A one-pixel line along a real-pixel row (horizontal) or column. */
|
|
hline(x: number, y: number, width: number, value: number): void {
|
|
const box = this.box(x, y, width, 1);
|
|
this.image.fillRect(box.x, box.y, box.width, 1, value);
|
|
}
|
|
|
|
vline(x: number, y: number, height: number, value: number): void {
|
|
const box = this.box(x, y, 1, height);
|
|
this.image.fillRect(box.x, box.y, 1, box.height, value);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The foreground window's band, in real-display rows: its top and height
|
|
* (header and content; a bottom switcher row hangs under it), and whether
|
|
* it spans the panel's whole width (Full Screen; never beside a side strip).
|
|
*/
|
|
export type DiagramBand = { top: number; height: number; fullWidth: boolean };
|
|
|
|
/**
|
|
* A layout as the real chrome lays it out (geometry.ts, chrome-layer.ts):
|
|
* the window band with its status bar and frame, and the switcher with a
|
|
* few icons, the first selected. A popup switcher shows only with
|
|
* `popupOpen`, dimming the window as it does. Status bar placement follows
|
|
* the current setting.
|
|
*/
|
|
export function drawLayout(d: Diagram, position: AppSwitcherPosition, band: DiagramBand, popupOpen: boolean): void {
|
|
const statusAtBottom = statusBarPositionSetting.get() === "bottom";
|
|
const { top, height } = band;
|
|
switch (position) {
|
|
case "left":
|
|
case "right": {
|
|
const stripLeft = position === "left" ? 0 : G2_LENS_WIDTH - SIDEBAR_WIDTH;
|
|
const contentLeft = position === "left" ? SIDEBAR_WIDTH : 0;
|
|
const windowWidth = G2_LENS_WIDTH - SIDEBAR_WIDTH;
|
|
drawStatusBar(d, contentLeft, top, windowWidth, TOP_BAR_HEIGHT - 1);
|
|
drawContent(d, contentLeft, top + TOP_BAR_HEIGHT, windowWidth, height - TOP_BAR_HEIGHT, 1);
|
|
// The strip keeps to the 288px band's height, even beside taller windows.
|
|
const separator = position === "left" ? SIDEBAR_WIDTH - 1 : stripLeft;
|
|
d.vline(separator, top + TOP_BAR_HEIGHT, MIN_WINDOW_HEIGHT - TOP_BAR_HEIGHT, CHROME_LINE);
|
|
// One column of icons against the separator.
|
|
const column = position === "left" ? SIDEBAR_WIDTH - 36 : stripLeft;
|
|
for (let slot = 0; slot < 4; slot++) drawIcon(d, column + 2, top + TOP_BAR_HEIGHT + 10 + slot * 40, slot === 0);
|
|
return;
|
|
}
|
|
case "bottom": {
|
|
const { left, width, framed } = windowSpan(band);
|
|
// With the status bar in the row, the window's header is just the frame's top.
|
|
const header = !statusAtBottom ? TOP_BAR_HEIGHT : framed ? 1 : 0;
|
|
if (!statusAtBottom) drawStatusBar(d, left, top, width, framed ? null : TOP_BAR_HEIGHT - 1);
|
|
drawContent(d, left, top + header, width, height - header, 1);
|
|
if (framed) d.outline(left - 1, top + header - 1, width + 2, height - header + 2, WINDOW_FRAME, 8);
|
|
else d.hline(left, top + height, width, CHROME_LINE);
|
|
// The first cell starts at the frame's side, or inset like a scrolled row's (chrome-layer switcherLayout).
|
|
const cellsLeft = framed ? left - 1 : left + 8;
|
|
for (let slot = 0; slot < 4; slot++) drawIcon(d, cellsLeft + 2 + slot * 40, top + height + 2, slot === 0);
|
|
if (statusAtBottom) drawStatusItems(d, left + width, top + height + 4);
|
|
return;
|
|
}
|
|
case "popup": {
|
|
const { left, width, framed } = windowSpan(band);
|
|
const edge = framed ? 1 : 0;
|
|
const statusTop = statusAtBottom ? top + height - TOP_BAR_HEIGHT : top;
|
|
const contentTop = statusAtBottom ? top + edge : top + TOP_BAR_HEIGHT;
|
|
const contentHeight = height - TOP_BAR_HEIGHT - edge;
|
|
drawStatusBar(d, left, statusTop, width, framed ? null : statusAtBottom ? 0 : TOP_BAR_HEIGHT - 1);
|
|
drawContent(d, left, contentTop, width, contentHeight, popupOpen ? DIM : 1);
|
|
if (framed) d.outline(left - 1, contentTop - 1, width + 2, contentHeight + 2, WINDOW_FRAME, 8);
|
|
if (!popupOpen) return;
|
|
// The popup: a row of icons over the selected window's title, centred on the content.
|
|
const box = { width: 272, height: 98 };
|
|
const boxLeft = left + (width - box.width) / 2;
|
|
const boxTop = contentTop + (contentHeight - box.height) / 2;
|
|
d.fill(boxLeft, boxTop, box.width, box.height, 0);
|
|
d.outline(boxLeft, boxTop, box.width, box.height, WINDOW_FRAME);
|
|
const iconsLeft = boxLeft + (box.width - (3 * 48 - 4)) / 2;
|
|
for (let slot = 0; slot < 3; slot++) drawIcon(d, iconsLeft + slot * 48 + 6, boxTop + 18, slot === 0);
|
|
d.fill(boxLeft + box.width / 2 - 50, boxTop + 70, 100, 12, STATUS, 6);
|
|
return;
|
|
}
|
|
}
|
|
}
|
|
|
|
/** A bottom row or popup layout's window: centred at 576 wide and framed, or the panel's width without a frame. */
|
|
function windowSpan(band: DiagramBand): { left: number; width: number; framed: boolean } {
|
|
return band.fullWidth
|
|
? { left: 0, width: G2_LENS_WIDTH, framed: false }
|
|
: { left: SIDEBAR_WIDTH / 2, width: G2_LENS_WIDTH - SIDEBAR_WIDTH, framed: true };
|
|
}
|
|
|
|
/**
|
|
* A status bar's 28 rows from `y`; `divider` is the row (within them) of its
|
|
* line toward the window, if it draws one rather than meeting a frame.
|
|
*/
|
|
function drawStatusBar(d: Diagram, x: number, y: number, width: number, divider: number | null): void {
|
|
if (divider !== null) d.hline(x, y + divider, width, CHROME_LINE);
|
|
drawStatusItems(d, x + width, y);
|
|
}
|
|
|
|
/** Notification icons, a battery and the clock, ending at `right`, in a status bar's 28 rows from `top`. */
|
|
function drawStatusItems(d: Diagram, right: number, top: number): void {
|
|
d.fill(right - 64, top + 7, 56, 14, STATUS, 4);
|
|
d.outline(right - 108, top + 8, 32, 12, STATUS, 2);
|
|
d.outline(right - 148, top + 4, 20, 20, CHROME_LINE, 4);
|
|
d.outline(right - 176, top + 4, 20, 20, CHROME_LINE, 4);
|
|
}
|
|
|
|
/** A switcher icon (32px); the selected one filled, as the switcher's selection tab is. */
|
|
function drawIcon(d: Diagram, x: number, y: number, selected: boolean): void {
|
|
if (selected) d.fill(x, y, 32, 32, SELECTED_ICON, 6);
|
|
else d.outline(x, y, 32, 32, ICON, 6);
|
|
}
|
|
|
|
/** Stand-in window content: a title and as many list rows as fit, the first selected. */
|
|
function drawContent(d: Diagram, x: number, y: number, width: number, height: number, brightness: number): void {
|
|
const rowWidths = [width - 60, 300, 360, 240];
|
|
d.fill(x + 18, y + 14, 150, 18, Math.round(CONTENT_TITLE * brightness), 6);
|
|
d.outline(x + 8, y + 44, width - 16, 34, Math.round(CONTENT * brightness), 8);
|
|
for (let row = 0; ; row++) {
|
|
const rowTop = y + 52 + row * 44;
|
|
if (rowTop + 18 > y + height - 8) break;
|
|
d.fill(x + 18, rowTop, Math.min(rowWidths[row % rowWidths.length]!, width - 36), 18, Math.round(CONTENT * brightness), 6);
|
|
}
|
|
}
|
|
|
|
/** Real-display rows the Layout page's diagrams cover: a 288px band and a bottom switcher row under it. */
|
|
export const LAYOUT_AREA_HEIGHT = MIN_WINDOW_HEIGHT + SWITCHER_ROW_HEIGHT;
|