Struct RenderEnvironment 

pub struct RenderEnvironment { /* private fields */ }

Immutable render services and the policy used to capture one operation context.

Implementations

impl RenderEnvironment

pub fn deterministic() -> Self

Creates a target-independent environment with fixed time, UTC, and a fixed seed.

When the math capability is compiled, the environment also installs its built-in math renderer. Builds without that capability leave the service absent so family admission can return a typed missing-capability error.

pub fn try_native() -> Result<Self, RuntimePolicyError>

Creates an environment backed by native clock, timezone, and randomness adapters.

Timing remains an explicit opt-in because it adds work and observable diagnostics.

pub fn with_text_measurement_policy(self, policy: TextMeasurementPolicy) -> Self

pub const fn with_capability_policy( self, policy: RenderCapabilityPolicy, ) -> Self

Restricts optional renderer capabilities for every operation begun by this environment.

This is primarily useful to artifact owners whose public feature contract can be narrower than Cargo’s resolved dependency feature union.

pub fn with_compiled_math_renderer(self) -> Self

Installs the math renderer compiled into this renderer, if present.

Facades use this to select the canonical compiled capability instead of duplicating Cargo feature checks in each transport layer.

pub fn with_math_renderer( self, renderer: Arc<dyn MathRenderer + Send + Sync>, ) -> Self

pub fn without_math_renderer(self) -> Self

pub fn with_icon_registry(self, registry: IconRegistry) -> Self

pub fn with_runtime_policy(self, policy: RuntimePolicy) -> Self

pub fn runtime_policy(&self) -> &RuntimePolicy

pub const fn with_resource_policy(self, policy: RenderResourcePolicy) -> Self

pub fn begin_session(&self) -> Result<RenderSession, RuntimePolicyError>

Captures time, timezone rules, random seed, and provenance exactly once.

pub fn begin_session_with_control( &self, control: OperationControl, ) -> Result<RenderSession, RuntimePolicyError>

Captures one render session using caller-owned cancellation/deadline state.

The control is cloned into the operation work meter so layout adapters, SVG emission, and postprocessing observe the same operation scope. This method does not create another control or expose a second cancellation state.

pub fn begin_session_in_context( &self, operation_context: OperationContext, control: OperationControl, ) -> RenderSession

Begins one render session from caller-captured operation state.

This entry point deliberately does not call RuntimePolicy::begin_operation. Facades that already own the source-to-output operation use it to keep parsing and rendering on the same runtime context and cancellation/deadline control.

Trait Implementations

impl Clone for RenderEnvironment

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 RenderEnvironment

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

Formats the value using the given formatter.

impl Default for RenderEnvironment

fn default() -> Self

Returns the “default value” for a type.