Struct DrawContext 

pub struct DrawContext { /* private fields */ }

Drawing inputs for the frontend.

Device scale and structural limits are drawing-specific; time, quality, assets, fonts, diagnostics and compute caches live in the shared Evaluation. Neither implicitly discovers resources.

Implementations

impl DrawContext

pub fn new(device_scale: f64) -> Result<Self, ValidationError>

Creates drawing inputs with a finite, strictly positive device scale.

pub fn with_evaluation(self, evaluation: Arc<Evaluation>) -> Self

Replaces the shared evaluation environment.

pub fn evaluation(&self) -> &Arc<Evaluation>

Shared time, quality, resources, diagnostics and caches.

pub fn with_quality(self, quality: RenderQuality) -> Self

Selects an explicit approximation policy for deferred content recording.

pub fn render_quality(&self) -> RenderQuality

Production quality is the default for every standalone drawing context.

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

Supplies scene-local signed time to deferred content effects.

pub fn time(&self) -> Time

Scene-local time; direct static recording defaults to zero.

pub fn device_scale(&self) -> f64

Device pixels per logical unit; does not implicitly modify local geometry.

pub fn with_fonts(self, fonts: impl Into<FontEnvironment>) -> Self

Supplies a shared explicit font snapshot to paragraph bounds and drawing.

pub fn fonts(&self) -> Option<&FontEnvironment>

Font environment for paragraph text, optional for geometry-only drawing.

pub fn with_assets(self, assets: &Assets) -> Self

Captures the same lazy/preloaded owner used by the enclosing session.

pub fn assets(&self) -> &Assets

Explicit resource owner; an unconfigured context does not resolve relative files.

pub fn record( &self, drawable: &dyn Drawable, limits: ValidationLimits, ) -> Result<Vec<DrawCommand>, ValidationError>

Records a drawable’s local commands without rendering or color quantization.

Limits charge the drawable at depth one and every command at depth two. Callback errors and ignored canvas errors both fail the recording. This local buffer is not a scene DisplayList; use crate::Node::compile for layout, global transforms and isolated subtree opacity.

use motion_core::prelude::*;
use motion_core::{
    DisplayList, RasterLimits, ResourceStore, ValidatedDisplayList, MAX_PATH_VERBS,
    MAX_STROKE_VERBS, MAX_SVG_PATH_BYTES, sample_offsets,
};
let bounds = Rect::new(0.1, 0.2, 10.3, 20.4);
let color = Color::from_rgb_float(1.25, -0.125, 0.333);
let commands =
    DrawContext::new(2.0)?.record(&bounds.fill(color), ValidationLimits::default())?;
assert_eq!(
    commands,
    vec![DrawCommand::FillRect {
        bounds,
        transform: Transform::IDENTITY,
        paint: Paint::Solid(color)
    }]
);

pub fn with_validation_limits(self, limits: ValidationLimits) -> Self

Supplies the enclosing structural policy to deferred layout callbacks.

pub fn validation_limits(&self) -> ValidationLimits

Structural policy supplied by the enclosing measurement or compilation.

pub fn with_render_cache(self, cache: RenderCache) -> Self

Supplies partitioned compute caches shared by rendering workers.

pub fn render_cache(&self) -> Option<&RenderCache>

Shared cache partitions, absent for standalone uncached drawing.

pub fn cache_layout<Key: Eq + Hash + Send + Sync + 'static, Value: Send + Sync + 'static>( &self, key: Key, build: impl FnOnce() -> Value, cost: impl FnOnce(&Value) -> usize, ) -> Arc<Value>

Caches immutable layout in the paragraph partition by full typed key and declared logical payload; without a render cache the value is rebuilt.

pub fn with_font_usage(self, usage: FontUsage) -> Self

Carries an export-owned font observation sink into every recorded glyph.

pub fn font_usage(&self) -> &FontUsage

Font sources actually painted through this context.

pub fn with_invalid_geometry_marker(self, mark: bool) -> Self

Draws leaves with invalid geometry as a visible error marker instead of failing compilation. Intended for preview; export keeps the strict default.

pub fn marks_invalid_geometry(&self) -> bool

Whether invalid leaf geometry is drawn as an error marker.

pub fn with_diagnostics(self, diagnostics: RequestDiagnostics) -> Self

Carries request diagnostics explicitly through deferred content compilation.

pub fn diagnostics(&self) -> &RequestDiagnostics

Request-owned sink; cloning this drawing context preserves its identity.

Trait Implementations

impl Clone for DrawContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DrawContext

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

Formats the value using the given formatter.

impl Default for DrawContext

fn default() -> Self

Returns the “default value” for a type.