amenui
en·中 github ↗ v0.0.1
01文档 02组件 03实验室 04作品
en·中github ↗
×

文档 / 概念 / 设计 / 1.31 检查 文档 / 概念 / 设计 /

1.31 检查

03.47

本页只有英文。

One command says what is wrong with a page as drawn: render --page <name> --audit prints a list of findings, most serious first, and with --strict a P0 or P1 is an error. amenui::audit::audit(ui, px, ground) takes a deterministic frame's pixels, the same frame drawn with every glyph hidden (the ground under the text, before the finishing pass) and the runtime that drew them, and returns Vec<Finding> (level, key, kind, measured, limit, fix); drive::audit(spec, faces, o) renders a page and audits it, drive::audit_with for an application's own pages (Driven::audit). The view's structural problems (Ui::problems()) are on the same list as P1 Structure. Everything is measured; each fix is one sentence to act on, naming the element and the number.

kindwhat is measuredlevel
Clippedtext to read whose ink (Instance boxes after poses and turns) is cut by a clip, the window or a reveal; or a word drawn in parta whole glyph or more, or a word in part: P0; less than a glyph: P1
Contrastper line of text, the strongest ink pixel against what is drawn under it (WCAG 2)text to read below 3:1 P0, below 4.5:1 P1; a lone mark (no letter or digit, such as › or −) below 3:1 P1; text not to read below 3:1 P3
Overlapthe share of a glyph's ink covered by another drawn glyph, in one element or between two to readtext to read over 10 %: P1; posed text over its overlap + 0.05: P2
Smallthe drawn height of text to read (size × scale × the pose's vertical scale)under 9 device px: P1
Erodedat looseness 0, the ink pixels (differing from the ground by at least 24 and by at least half the line's contrast) inside each text-to-read ink box, against the same page drawn in plainunder 85 % of plain's: P1
Restlessafter the last input, the clock run on at 60 Hz: still asking for frame after frame 2 s later with nothing visible marked El::ongoing() (a timed wake now and then, such as a caret's blink, is not restless)P1

Posed text dimmed by depth on purpose is read by its nearer half; the smallest size of posed text is its 10th percentile among the glyphs drawn at half opacity or more. A clipped finding says which side is cut, how far the ink reaches past it (px) and what cuts it (the clipping element's key, or the window), and suggests reveal_by(Reveal::Word) when a reveal cuts a word. The eroded check guards materials with a look of their own at rest (near, charr, and materials added from source); one whose rest is plain passes by construction.

The annotation layer shows what the audit measures: gaze::INK draws the true ink's bounding box of an element (after transforms and poses) dashed, with a leader dashed 4 px on, 4 px off from a corner of that box to the nearest point of the drawn outline (of a shape's true outline too), never outside the box: of the corners 12 px clear of text to read, the one farthest from the outline, the line kept round text to read (strand::clear_path). A leader shorter than 16 px (two dashes) is not drawn, so a box that hugs its ink, as text's does, has none. Then an INK w×h label (hit::ink_of, Ui::leaders), from the same measure the clipping and overlap checks use. The annotation colour (Gaze::colour) is used as given where it stands 4.5:1 from the page's ground; on a ground where it does not (the light theme) it is the same hue darkened until it does (Gaze::colour_on), for the boxes, leaders, labels and guides alike. Tags and INK readouts never cover text to read or each other: each tries outside the ink box above at the left, then below, then to the right (gaze::place_tag), takes the first place that meets no text-to-read ink box and no other label, and when none is free only the box is drawn.

What the audit found on the recipes, and what changed for it: Paint::DIM was 0.5 of the way from ground to ink, under 4.5:1 on the light theme (3.2:1); it is 0.66 (5.2:1 light, 6.9:1 dark). The light theme's accent was under 4.5:1 against its ground, both as text and under a solid button's label (3.4:1); it is darker, (0.64, 0.20, 0.035) at 5.6:1, and the selection tint is 12 % instead of 14 %. A selected list row's note is TEXT. The near material drew text as outline and 25 % fill, too faint at text sizes, and lost the outline entirely on a filled panel (the panel's nearness is max-blended over the glyph's); text keeps its own ink whole there, and text set in the ground's colour (a label on a solid button) takes the ink's colour, since near draws the panel open. The loading recipe's tick asked for a new view every frame forever; it asks only when a row changes.

Acceptance: tests/audit.rs (five pages broken on purpose, each reporting its finding at its level: text past the window Clipped P0, grey on grey Contrast P0, two lines over each other Overlap P1, 6 px text Small P1, an element that never stops moving Restless P1, and not when it is marked ongoing; text a material wears away at rest Eroded P1; a calm page has no findings; the seventeen recipes in every material, dark and light, have no P0 or P1); render --page recipe-form --audit --strict exits 0.

Ui::line_inks(key) reads each line of a text element as drawn: its text range, line box and ink box (LineInk), for tests and for an application that places things by the text's real ink.