thi-ng/umbrella

View on GitHub
packages/imgui/src/components/ring.ts

Summary

Maintainability
A
1 hr
Test Coverage
import type { Fn, FnN2, Maybe } from "@thi.ng/api";
import { pointInRect } from "@thi.ng/geom-isec/point";
import { polygon } from "@thi.ng/geom/polygon";
import type { IGridLayout, LayoutBox } from "@thi.ng/layout";
import { isLayout } from "@thi.ng/layout/checks";
import { HALF_PI, PI, TAU } from "@thi.ng/math/api";
import { fitClamped, norm } from "@thi.ng/math/fit";
import { mix } from "@thi.ng/math/mix";
import { map } from "@thi.ng/transducers/map";
import { normRange } from "@thi.ng/transducers/norm-range";
import type { Vec } from "@thi.ng/vectors";
import { cartesian2 } from "@thi.ng/vectors/cartesian";
import { hash } from "@thi.ng/vectors/hash";
import { dialVal } from "../behaviors/dial.js";
import { handleSlider1Keys } from "../behaviors/slider.js";
import type { IMGUI } from "../gui.js";
import { dialValueLabel } from "./textlabel.js";
import { tooltipRaw } from "./tooltip.js";

const ringHeight: FnN2 = (w, thetaGap) =>
    (w / 2) * (1 + Math.sin(HALF_PI + thetaGap / 2));

const arcVerts = (
    o: Vec,
    r: number,
    start: number,
    end: number,
    thetaRes = 12
): Iterable<Vec> =>
    r > 1
        ? map(
                (t) => cartesian2(null, [r, mix(start, end, t)], o),
                normRange(
                    Math.max(1, Math.abs(end - start) / (PI / thetaRes)) | 0
                )
          )
        : [o];

export const ring = (
    gui: IMGUI,
    layout: IGridLayout<any> | LayoutBox,
    id: string,
    min: number,
    max: number,
    prec: number,
    val: number,
    thetaGap: number,
    rscale: number,
    label?: string,
    fmt?: Fn<number, string>,
    info?: string
) => {
    let h: number;
    let box: LayoutBox;
    if (isLayout(layout)) {
        h = ringHeight(layout.cellW, thetaGap);
        box = layout.next([1, layout.rowsForHeight(h) + 1]);
    } else {
        h = ringHeight(layout.cw, thetaGap);
        box = layout;
    }
    return ringRaw(
        gui,
        id,
        box.x,
        box.y,
        box.w,
        h,
        min,
        max,
        prec,
        val,
        thetaGap,
        rscale,
        0,
        h + box.ch / 2 + gui.theme.baseLine,
        label,
        fmt,
        info
    );
};

export const ringGroup = (
    gui: IMGUI,
    layout: IGridLayout<any>,
    id: string,
    min: number,
    max: number,
    prec: number,
    horizontal: boolean,
    thetaGap: number,
    rscale: number,
    vals: number[],
    label: string[],
    fmt?: Fn<number, string>,
    info: string[] = []
) => {
    const n = vals.length;
    const nested = horizontal
        ? layout.nest(n, [n, 1])
        : layout.nest(1, [
                1,
                (layout.rowsForHeight(ringHeight(layout.cellW, thetaGap)) + 1) *
                    n,
          ]);
    let res: Maybe<number>;
    let idx: number = -1;
    for (let i = 0; i < n; i++) {
        const v = ring(
            gui,
            nested,
            `${id}-${i}`,
            min,
            max,
            prec,
            vals[i],
            thetaGap,
            rscale,
            label[i],
            fmt,
            info[i]
        );
        if (v !== undefined) {
            res = v;
            idx = i;
        }
    }
    return res !== undefined ? [idx, res] : undefined;
};

export const ringRaw = (
    gui: IMGUI,
    id: string,
    x: number,
    y: number,
    w: number,
    h: number,
    min: number,
    max: number,
    prec: number,
    val: number,
    thetaGap: number,
    rscale: number,
    lx: number,
    ly: number,
    label?: string,
    fmt?: Fn<number, string>,
    info?: string
) => {
    const r = w / 2;
    const key = hash([x, y, r]);
    gui.registerID(id, key);
    const pos = [x + r, y + r];
    const startTheta = HALF_PI + thetaGap / 2;
    const endTheta = HALF_PI + TAU - thetaGap / 2;
    const draw = gui.draw;
    const aid = gui.activeID;
    const hover =
        !gui.disabled &&
        (aid === id || (aid === "" && pointInRect(gui.mouse, [x, y], [w, h])));
    let v: Maybe<number> = val;
    let res: Maybe<number>;
    if (hover) {
        gui.setCursor("pointer");
        gui.hotID = id;
        if (gui.isMouseDown()) {
            gui.activeID = id;
            res = dialVal(gui.mouse, pos, startTheta, thetaGap, min, max, prec);
        }
        info && draw && tooltipRaw(gui, info);
    }
    const focused = gui.requestFocus(id);
    if (draw) {
        const valTheta = startTheta + (TAU - thetaGap) * norm(v, min, max);
        const r2 = r * rscale;
        // adaptive arc resolution
        const numV = fitClamped(r, 15, 80, 12, 30);
        const shape = (max: number) => () =>
            polygon(
                [
                    ...arcVerts(pos, r, startTheta, max, numV),
                    ...arcVerts(pos, r2, max, startTheta, numV),
                ],
                {}
            );
        const bgShape = gui.resource(id, key, shape(endTheta));
        const valShape = gui.resource(id, v, shape(valTheta));
        const valLabel = dialValueLabel(
            gui,
            id,
            key,
            v,
            x + lx,
            y + ly,
            label,
            fmt
        );
        bgShape.attribs.fill = gui.bgColor(hover || focused);
        bgShape.attribs.stroke = gui.focusColor(id);
        valShape.attribs.fill = gui.fgColor(hover);
        gui.add(bgShape, valShape, valLabel);
    }
    if (
        focused &&
        (v = handleSlider1Keys(gui, min, max, prec, v)) !== undefined
    ) {
        return v;
    }
    gui.lastID = id;
    return res;
};