API reference

aster_blueprint::material_effects

Pre-1.0: signatures are not frozen. Generated from rustdoc JSON of the compiled crate; rustdoc JSON format version 60. Only public items are listed.

Real content for the material layer roles.

LayerRole itself is still only a paint-order slot (see material_layers). These constructors fill the slots with the effect drawings of [crate::effects] so that Outline carries an actual stroke and Outside an actual shadow or glow. They return an ordinary [LayerSpec]; nothing in LayeredPart changes.

Clipping semantics (pinned by tests/effects.rs):

  • the drawing is laid out in the layer's local space, origin at the layer's top-left; the layer bounds are placement and the shape size, not a clip;
  • with the part root Clip::None an outside shadow/glow/stroke paints beyond the root bounds (that is the point);
  • with the part root Clip::Bounds everything is trimmed to the root bounds and a per-layer clip cannot escape it. An outside effect needs a non-clipping root.

The recording kinds still need renderer admission: vector strokes need Renderer::enable_vectors, effect drawings need the matching output scale. Use the *_for_renderer commit variants so a refusal is honest.

Functions

fnaster_blueprint::material_effects::glow_layer

pub fn glow_layer(key: model::Symbol, bounds: aster_ui::LogicalRect, glow: effects::Glow) -> Result<material_layers::LayerSpec, aster_ui::Error>

An Outside layer holding a real glow around a bounds-sized shape.

fnaster_blueprint::material_effects::outline_layer

pub fn outline_layer(key: model::Symbol, bounds: aster_ui::LogicalRect, radius: f64, stroke_width: f64, alignment: aster_ui::VectorStrokeAlignment, color: aster_ui::Srgb8, dash: effects::Dash) -> Result<material_layers::LayerSpec, aster_ui::Error>

An Outline layer holding a real stroked rounded-rect outline of bounds.

fnaster_blueprint::material_effects::shadow_layer

pub fn shadow_layer(key: model::Symbol, bounds: aster_ui::LogicalRect, shadow: effects::DropShadow) -> Result<material_layers::LayerSpec, aster_ui::Error>

An Outside layer holding a real drop shadow of a bounds-sized shape. shadow.width/height are taken from bounds.