diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 39 |
1 files changed, 5 insertions, 34 deletions
@@ -69,41 +69,12 @@ how it is painted. - A tiling window manager will ignore the size hints and give the grid its own tile; the layout handles that, the empty space is the WM's choice. -## colitur-mu — the microui variant +## The microui variant -`colitur-mu` is the same idea with an *editable* surface: year, language, -book-name form and numbering tradition are buttons, and changing any of them -re-runs colitur and reloads. It reimplements no calendar logic — every value -on screen came out of `colitur emit --format csv`, and the exact command is -shown in the status line. - - make colitur-mu && ./colitur-mu - -microui (MIT, rxi) is **vendored** in `vendor/`, 1504 lines. That is the point: -a copied-in dependency cannot rot. `mu_x11.c` is the Xlib/Xft backend, ~150 -lines — microui emits a command list and asks two font-metric questions; this -answers them. - -### One bug worth recording - -microui resets its scissor by emitting an "unclipped" rectangle of -`0x1000000` × `0x1000000`. `XRectangle`'s width and height are **unsigned -short**, so that truncates to **0** — turning "clip nothing" into "clip -everything". The symptom is that a scrolling panel draws its first screenful -and everything after it silently disappears, which looks like a layout or -buffer-overflow bug and is neither. `set_clip()` clamps to the buffer bounds -before converting. - -### Verifying a frame without a screenshot - - MUX_DUMP=/tmp/frame.ppm ./colitur-mu # writes one frame, then exits - convert /tmp/frame.ppm /tmp/frame.png - -This reads back the off-screen PIXMAP, not the window. A window's contents -are not retained while it is obscured or sitting on an unfocused tag, so -`import`/`xwd` against one can return solid black while the program is -drawing perfectly -- which cost real time to work out once. A pixmap is -always there. +An editable front-end -- where year, language, book-name form and numbering +tradition are buttons that re-run colitur -- lives in +[colitur-experiments](../colitur-experiments) rather than here, so this repo +holds one finished program instead of a finished one and a sketch. ### Which to use |