Struct Node

Source

pub struct Node { /* private fields */ }

Expand description

A cheaply cloned snapshot of authored grouping and compositing choices.

Drawable values convert directly into leaves with content bounds. Grouping and modifiers retain geometry and explicit drawing policy.

use motion_core::prelude::*;
use motion_core::{
    DisplayList, RasterLimits, ResourceStore, ValidatedDisplayList, MAX_PATH_VERBS,
    MAX_STROKE_VERBS, MAX_SVG_PATH_BYTES, sample_offsets,
};
let artwork = Rect::new(0.0, 0.0, 32.0, 24.0).fill(Color::rgb(20, 150, 125));
let node = Node::group([Node::from(artwork).z_index(2)])
    .opacity(0.5)
    .named("overlay");
node.compile(
    Size::new(32.0, 24.0),
    PixelSize::new(32, 24),
    ValidationLimits::default(),
)?;

Implementations§

Source §

impl Node

Source

pub fn inspect_with_context( &self, design_size: Size, output_size: PixelSize, limits: ValidationLimits, drawing: &DrawContext, ) -> Result<Vec<NodeInspection>, ValidationError>

Plans a bounded editor snapshot using the same layout, resources and z order as compilation. Drawables may resolve/record; no pixels or devices are used. Errors remain separate from normal rendering when used by an editor.

Source §

impl Node

Source

pub fn compile( &self, design_size: Size, output_size: PixelSize, limits: ValidationLimits, ) -> Result<ValidatedDisplayList, ValidationError>

Compiles content to flat device-space commands without rendering.

Logical design space is contained and centered in the output dimensions. bounds/draw callbacks receive the resulting device scale once per occurrence. Layout and stable sibling z order precede matrix composition. Nonunit opacity isolates its whole subtree without f32 narrowing.

All input branches and emitted work validate, including empty, transparent and offscreen content. There is no culling yet. Source and output have independent instances of the supplied limits. This does not prepare coverage/pixels.

use motion_core::prelude::*;
use motion_core::{
    DisplayList, RasterLimits, ResourceStore, ValidatedDisplayList, MAX_PATH_VERBS,
    MAX_STROKE_VERBS, MAX_SVG_PATH_BYTES, sample_offsets,
};
use motion_core::authoring::Scene as _;
let cache = SceneCache::new(0);
let context = SceneContext::new(
    Time::ZERO,
    fps!(30),
    Size::new(100.0, 50.0),
    &cache,
);
let scene = |context: &SceneContext<'_>| {
    let path = Path2D::from_rect(Rect::new(0.0, 0.0, 10.0, 10.0)).unwrap();
    Row::new()
        .gap(4.0)
        .children([
            Node::from(Rect::new(0.0, 0.0, 10.0, 20.0).fill(Color::WHITE)),
            Node::from(path.fill(Color::from_hex(0x24a49b))),
        ])
        .at(context.center())
        .opacity(0.5)
};
let list = scene.render(&context).compile(
    context.size(),
    PixelSize::new(200, 200),
    ValidationLimits::default(),
)?;
assert_eq!(list.commands.len(), 4);
assert!(matches!(
    list.commands[0],
    DrawCommand::PushLayer { opacity: 0.5, .. }
));
assert!(matches!(
    list.commands[2],
    DrawCommand::Fill {
        rule: FillRule::NonZero,
        ..
    }
));
list.preflight(ValidationLimits::default())?;

Source

pub fn compile_with_fonts( &self, design_size: Size, output_size: PixelSize, limits: ValidationLimits, fonts: impl Into<FontEnvironment>, ) -> Result<ValidatedDisplayList, ValidationError>

Compiles with one immutable font environment shared by paragraph callbacks.

Source

pub fn compile_with_context( &self, design_size: Size, output_size: PixelSize, limits: ValidationLimits, drawing: &DrawContext, ) -> Result<ValidatedDisplayList, ValidationError>

Compiles with explicit resources and a reusable session layout cache.

Source §

impl Node

Source

pub fn with_scene_time(self, time: Time) -> Self

Associates scene-local time with deferred content in this subtree.

Source

pub fn empty() -> Self

Creates a node with no artwork.

Source

pub fn next_to(self, reference: &Node, side: Side, gap: f64) -> Self

Positions a snapshot relative to compile-time measured reference bounds.

Source

pub fn align_to(self, reference: &Node, edge: Side) -> Self

Aligns an edge with a compile-time measured reference snapshot.

Source

pub fn accumulate( samples: impl IntoIterator<Item = Node>, ) -> Result<Self, ValidationError>

Averages 1..=64 independently rendered samples in linear premultiplied RGBA. Empty samples retain their weight; sibling z order cannot reorder samples.

Source

pub fn weighted_sum( samples: impl IntoIterator<Item = (Node, f64)>, ) -> Result<Self, ValidationError>

Composites 1..=64 isolated samples with explicit linear-light weights. Each weight must be finite in 0..=1; weights are not normalized.

Source

pub fn with_text_metrics(self, baseline: f64, bounds: Rect) -> Self

Attaches measured paragraph metrics for horizontal baseline layout. Content implementations must provide conservative local bounds and a real baseline.

Source

pub fn transformed(self, transform: Transform) -> Self

Applies a full local affine matrix in a new group, before subsequent placement modifiers.

Source

pub fn group<Kind>(children: impl IntoNodeGroup<Kind>) -> Self

Groups snapshots; sibling z indices are stably sorted during conversion.

Source

pub fn push(&mut self, child: impl Into<Node>)

Appends a drawable snapshot; nongroup nodes retain their original subtree.

Source

pub fn measure(&self, limits: ValidationLimits) -> Result<Rect, ValidationError>

Measures content or declared layout geometry in parent coordinates.

Uses f64 throughout, includes zero-area declared bounds and ignores empty nodes. Structure and parameters validate without pixel narrowing. Opacity does not change layout bounds. leaves call Drawable::bounds, not draw. Uses default drawing inputs at device scale one.

Source

pub fn preflight_with( &self, context: &DrawContext, limits: ValidationLimits, ) -> Result<SceneStats, ValidationError>

Validates structure and measured geometry without recording draw commands. Fonts, when required by content, must be supplied through the drawing context.

Source

pub fn measure_with( &self, context: &DrawContext, limits: ValidationLimits, ) -> Result<Rect, ValidationError>

Measures with explicit, time-independent drawing inputs.

Device scale is metadata for content; this adapter does not apply the future scene-to-device root transform or infer resource environments.

Source §

impl Node

Source

pub fn deferred(content: impl DeferredContent + 'static) -> Self

Wraps content that expands into ordinary nodes at compile time.

Trait Implementations§

Source §

impl Clone for Node

Source §

fn clone(&self) -> Self

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Source §

impl Debug for Node

Source §

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Source §

impl Default for Node

Source §

fn default() -> Self

Returns the “default value” for a type. Read more

Source §