incular-runtime 0.1.1

Application runtime and scheduling foundations for Incular
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

//! Read-only DevTools inspection requests answered from a window's retained
//! tree: runtime counters, semantics, compositor layers and work counts.
//!
//! These additions live apart from the frame pipeline; nothing here marks the
//! tree dirty or triggers layout, paint or composition.

use crate::application::Application;
use incular_devtools_protocol::{
    DevWindowId, ErrorCode, LayerNodeWire, RuntimeDiagnosticsWire, SemanticsNodeWire,
    WorkCountEntry,
};
use incular_platform::WindowId;

/// Evaluates `$read` with `$tree` bound to the window's retained tree.
macro_rules! with_tree {
    ($self:ident, $window:ident, |$tree:ident| $read:expr) => {{
        let id = WindowId::from_parts(
            $window.index().saturating_sub(1) as u32,
            $window.generation() as u32,
        );
        let registry = $self.registry.borrow();
        let record = registry.get(id).ok_or(ErrorCode::StaleId)?;
        let $tree = record.runtime.tree();
        Ok($read)
    }};
}

impl Application {
    /// Cumulative widget, text, semantics and compositor counters for one window.
    pub fn devtools_runtime_diagnostics(
        &self,
        window: DevWindowId,
    ) -> Result<RuntimeDiagnosticsWire, ErrorCode> {
        with_tree!(self, window, |tree| tree.devtools_runtime_counters())
    }

    /// Bounded semantics tree snapshot; the flag reports truncation.
    pub fn devtools_semantics_tree(
        &self,
        window: DevWindowId,
    ) -> Result<(Vec<SemanticsNodeWire>, bool), ErrorCode> {
        with_tree!(self, window, |tree| tree.devtools_semantics_nodes())
    }

    /// Bounded compositor layer snapshot; the flag reports truncation.
    pub fn devtools_layer_tree(
        &self,
        window: DevWindowId,
    ) -> Result<(Vec<LayerNodeWire>, bool), ErrorCode> {
        with_tree!(self, window, |tree| tree.devtools_layer_nodes())
    }

    /// Per-element work counters ranked by build count, at most `limit`
    /// (itself capped at 200).
    pub fn devtools_work_counts(
        &self,
        window: DevWindowId,
        limit: usize,
    ) -> Result<Vec<WorkCountEntry>, ErrorCode> {
        with_tree!(self, window, |tree| tree.devtools_work_counts(limit))
    }
}