OverlayRenderer.h File Reference

OverlayRenderer draws editor chrome (currently selection path outlines) directly into the renderer's existing framebuffer using the canvas primitives RendererInterface already exposes. It is not a separate compositing layer and not a fabricated SVG subtree — chrome and document share one render target so there is no subpixel drift between them. More...

#include <array>
#include <optional>
#include <span>
#include <vector>
#include "donner/base/Box.h"
#include "donner/base/Path.h"
#include "donner/base/Transform.h"
#include "donner/svg/SVGElement.h"

Include dependency graph for OverlayRenderer.h:

This graph shows which files directly or indirectly include this file:

Classes
struct	donner::editor::SelectionChromeBoundsPreview
	Active transform bounds chrome. Used while rotating to draw the gesture-start selection box transformed into the current document space. More...
struct	donner::editor::SelectionChromeSnapshot
	Frozen view of everything OverlayRenderer::drawChromeWithTransform would normally read off the live registry: per-element path splines transformed into document space, per-element AABBs in document space, and the optional marquee rect. More...
struct	donner::editor::SelectionChromeSnapshot::OrientedBox
	Four document-space corners of an oriented selection box. More...
struct	donner::editor::SelectionChromeSnapshot::PathItem
	One entry per renderable geometry leaf in the selection (groups are expanded into their geometry descendants, same as the live path). Empty when nothing's selected. More...
class	donner::editor::OverlayRenderer

Namespaces
namespace	donner
	Top-level Donner namespace, which is split into different sub-namespaces such as donner::svg and donner::css.
namespace	donner::svg
	Donner SVG library, which can load, manipulate and render SVG files.

Enumerations
enum class	donner::editor::SelectionChromeDetail {   Full ,   CombinedBoundsOnly }
	Detail level used when capturing selection chrome. More...

Detailed Description

OverlayRenderer draws editor chrome (currently selection path outlines) directly into the renderer's existing framebuffer using the canvas primitives RendererInterface already exposes. It is not a separate compositing layer and not a fabricated SVG subtree — chrome and document share one render target so there is no subpixel drift between them.

See docs/design_docs/editor.md "OverlayRenderer uses direct canvas- style Renderer calls" for the architectural rationale and the primitive policy.

Usage:

renderer.draw(editor.document().document());
donner::editor::OverlayRenderer::drawChrome(renderer, editor);
const auto bitmap = renderer.takeSnapshot();  // contains chrome

Must be called after Renderer::draw(document) (which has its own internal beginFrame / endFrame cycle) and before Renderer::takeSnapshot(). The renderer's frame pixmap survives across endFrame so additional canvas commands compose onto it directly.

---

Class Documentation

donner::editor::SelectionChromeSnapshot::OrientedBox

struct donner::editor::SelectionChromeSnapshot::OrientedBox

Four document-space corners of an oriented selection box.

Collaboration diagram for donner::editor::SelectionChromeSnapshot::OrientedBox:

Class Members
array< Vector2d, 4 >	cornersDoc

donner::editor::SelectionChromeSnapshot::PathItem

struct donner::editor::SelectionChromeSnapshot::PathItem

One entry per renderable geometry leaf in the selection (groups are expanded into their geometry descendants, same as the live path). Empty when nothing's selected.

Collaboration diagram for donner::editor::SelectionChromeSnapshot::PathItem:

Class Members
bool	displayNone = false	True when the selected element is hidden by display:none. The path outline still renders as an editable placeholder, but uses a dimmer stroke than visible selections.
Path	pathDoc	Document-space path data sampled at capture time. Keeping the path in document space lets chrome stroke width depend only on viewport scale, not on the selected element's own scale/rotation transform.

Enumeration Type Documentation

SelectionChromeDetail

enum class donner::editor::SelectionChromeDetail

strong

Detail level used when capturing selection chrome.

Enumerator
Full	Capture visible path outlines plus selection bounds.
CombinedBoundsOnly	Capture only the combined selection bounds, skipping path extraction.