Struct PictureLayer 

pub struct PictureLayer {
    pub canvas_bounds: Rect,
    /* private fields */
}

A composited layer containing a Picture.

Picture layers are always leaves in the layer tree. They are also responsible for disposing of the Picture object they hold. This is typically done when their parent and all RenderObjects that participated in painting the picture have been disposed.

Fields

canvas_bounds: Rect

The bounds that were used for the canvas that drew this layer’s picture.

This is purely advisory. It can help debug why certain drawing commands are being culled.

Implementations

impl PictureLayer

pub fn new(app: &mut App, canvas_bounds: Rect) -> Handle<PictureLayer>

Creates a leaf layer for the layer tree.

pub fn picture(self: Handle<Self>, app: &App) -> Option<&Arc<Picture>>

The picture recorded for this layer.

The picture’s coordinate system matches this layer’s coordinate system.

pub fn set_picture( self: Handle<Self>, app: &mut App, picture: Option<Arc<Picture>>, )

See picture. Dart’s _picture?.dispose() is the drop of the old one.

pub fn is_complex_hint(self: Handle<Self>, app: &App) -> bool

Hints that the painting in this layer is complex and would benefit from caching.

If this hint is not set, the compositor will apply its own heuristics to decide whether the this layer is complex enough to benefit from caching.

pub fn set_is_complex_hint(self: Handle<Self>, app: &mut App, value: bool)

See is_complex_hint.

pub fn will_change_hint(self: Handle<Self>, app: &App) -> bool

Hints that the painting in this layer is likely to change next frame.

This hint tells the compositor not to cache this layer because the cache will not be used in the future. If this hint is not set, the compositor will apply its own heuristics to decide whether this layer is likely to be reused in the future.

pub fn set_will_change_hint(self: Handle<Self>, app: &mut App, value: bool)

See will_change_hint.

Trait Implementations

impl Layer for PictureLayer

fn layer_data(self: Handle<Self>, app: &App) -> &LayerData

Dart’s base-class fields, held under the field layer ([layer_accessors!]).

fn layer_data_mut(self: Handle<Self>, app: &mut App) -> &mut LayerData

See layer_data.

fn dispose(self: Handle<Self>, app: &mut App)

Clears any retained resources that this layer holds.

fn add_to_scene(self: Handle<Self>, app: &mut App, builder: &mut SceneBuilder)

Override this method to upload this layer to the engine.

fn find_annotations( self: Handle<Self>, _app: &App, _result: &mut AnnotationSearch, _local_position: Offset, _only_first: bool, ) -> bool

Search this layer and its subtree for annotations of the searched type at the location described by local_position.

const AS_CONTAINER: Option<fn() -> &'static ContainerLayerVTable> = None

The container table when this type extends ContainerLayer; layer_accessors!(container) sets it. Dart’s layer is ContainerLayer.

fn supports_rasterization(self: Handle<Self>, app: &App) -> bool

Whether or not this layer, or any child layers, can be rasterized with Scene.toImage.

fn describe_clip_bounds(self: Handle<Self>, app: &App) -> Option<Rect>

Describes the clip that would be applied to contents of this layer, if any.

fn always_needs_add_to_scene(self: Handle<Self>, app: &App) -> bool

Subclasses may override this to true to disable retained rendering.

fn attach(self: Handle<Self>, app: &mut App, owner: HandleId)

Mark this layer as attached to the given owner.

fn detach(self: Handle<Self>, app: &mut App)

Mark this layer as detached from its owner.

fn redepth_children(self: Handle<Self>, app: &mut App)

Adjust the depth of this node’s children, if any.

fn fire_composition_callbacks( self: Handle<Self>, app: &mut App, include_children: bool, )

Dart’s _fireCompositionCallbacks; ContainerLayer recurses into its children.