Repository navigation
docs(architecture): add the framework and rendering sections - #10
Merged
Merged
Conversation
Add the rules of the framework: the application model and the eight passes of a round, the control tree, effects, the execution port and the result slot, the single-threaded event loop with its clock and timers, polling of job reports, dispatch and hit testing, focus checks, command tables and key bindings, the nine traits of the platform interface, the headless and display server backends with event scripts, and the accessibility hook. Add the rules of rendering, text and determinism: the renderer interface, vello_cpu as the raster library, glyph coverage and offset steps, the parley text stack, the two bundled fonts, pixel formats and buffer descriptions, the 26.6 fixed-point representation, the source of transcendental functions, the remaining determinism rules and the external dependencies with their exact versions and features.
Name what the framework runtime, layout, accessibility, rendering, text, platform interface, backends, test support and shared types rows cover, following the framework and rendering sections. Crates, roles and levels are unchanged.
The framework's event loop takes job reports by polling once per round, so a report is taken in the round after it arrives, within the bound that the job reports section states. The headless frontend is the script runner of the test support with the headless backend: the runner reads the scripts and drives the backend, which receives only injected events, and only its driver advances its virtual clock. The key lines of scripts run through both the framework and the display server are presses and releases only, and the framework section defines the other lines of a script. Link the event record and the platform boundary to the sections that now hold the framework clock and the determinism rules.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the design rules of the framework and of rendering, text and determinism to
docs/architecture.md. No code changes.cargo xtask checkpasses locally, and each commit passes on its own.