sungmg/mutter-performance-source
1
0
Fork 0
Code Activity
mutter-performance-source/doc/code-overview.md

28 lines
1.3 KiB
Markdown
Raw Normal View History

docs: Move the gitlab wiki and other docs to the docs/ directory Let's try to consolidate our documentation in doc/ in the repo. This includes some documentation from README.md, the HACKING.md coding style and the gitlab wiki. The README.md file now links to all top-level topics (i.e. not reachable via other topics). This also includes a few small changes to make things more consistent. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3465>
2023-12-18 16:30:53 +00:00
# Code Overview
Mutter consists of four relatively distinguished and isolated parts.
## Cogl
Hardware acceleration pipeline abstraction layer. Handles things like allocating framebuffer, allocating, importing and drawing textures, internally using OpenGL. Originally a fork of [the Cogl project](https://gitlab.gnome.org/GNOME/cogl).
## Clutter
Compositing toolkit, containing an actor and render node based scene graph, and has features such as input event routing, transformation and animation. Handles compositing, both Wayland surfaces, X11 windows, and is the basis of the UI toolkit implemented by [GNOME Shell](https://gitlab.gnome.org/GNOME/gnome-shell). Originally a fork of [the Clutter project](https://gitlab.gnome.org/GNOME/clutter).
docs: Prefix code documentation files with the subsystem they belong to. This makes it easier to see which files belong where. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3485>
2024-01-03 21:30:16 +00:00
* [Frame Scheduling](clutter-frame-scheduling.md)
docs: Import `Clutter Rendering Model` wiki page This one was overlooked when we migrated the wiki to the repo, so let's add it before we delete the wiki. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3485>
2024-01-03 21:34:30 +00:00
* [Rendering Model](clutter-rendering-model.md)
docs: Move the gitlab wiki and other docs to the docs/ directory Let's try to consolidate our documentation in doc/ in the repo. This includes some documentation from README.md, the HACKING.md coding style and the gitlab wiki. The README.md file now links to all top-level topics (i.e. not reachable via other topics). This also includes a few small changes to make things more consistent. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3465>
2023-12-18 16:30:53 +00:00
## Mtk
The Meta Toolkit containing utilities shared by other parts of mutter.
## Mutter
The display server and window manager library. Contains a X11 window manager and compositing manager implementation, as well as a Wayland display server implementation.
* [Compositor stage and hardware relationships](mutter-relationships.md)
docs: Move kms abstractions documentation out of references Eventually we want to have all the high-level code documentation in the component API reference documentation. However, gi-docgen is currently missing support for mermaid so we just keep the files in `doc/` and link to them from `code-overview.md`. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3505>
2024-01-09 16:32:47 +00:00
* [KMS abstraction](mutter-kms-abstractions.md)
docs: Prefix code documentation files with the subsystem they belong to. This makes it easier to see which files belong where. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3485>
2024-01-03 21:30:16 +00:00
* [Window constraints](mutter-constraints.txt)
* [How to get focus right](mutter-focus.txt)
Copy permalink