Struct ServerCompositionVisual 

pub struct ServerCompositionVisual { /* private fields */ }

Server-side CompositionVisual counterpart. Is responsible for computing the transformation matrix, for applying various visual properties before calling visual-specific drawing code and for notifying the ServerCompositionTarget for new dirty rects.

Implementations

impl ServerCompositionVisual

pub fn ancestor_transform_subscriber_count(&self) -> usize

The number of subscribers to the transforms of the ancestor chain of the visual: the adorners of the visual, and its children that have subscribers of their own (a diagnostics member, used by tests to verify that subscriptions are released).

impl ServerCompositionVisual

pub fn adorner_helper_enqueue_for_adorner_update(&self)

pub fn update_adorner(&self)

impl ServerCompositionVisual

pub fn own_transform(&self) -> Option<Matrix>

pub fn sub_tree_bounds(&self) -> Option<LtrbRect>

pub fn transformed_sub_tree_bounds(&self) -> Option<LtrbRect>

pub fn compute_own_content_bounds(&self) -> Option<LtrbRect>

pub fn combined_transform_matrix(&self) -> Matrix

pub fn recompute_own_properties(&self)

impl ServerCompositionVisual

pub fn get_readback(&self, reader_revision: u64) -> Option<ReadbackData>

pub fn update_readback(&self, writer_revision: u64, reader_revision: u64)

impl ServerCompositionVisual

pub fn render( self: &Rc<Self>, canvas: &mut dyn IDrawingContextImpl, clip: LtrbRect, dirty_rects: Option<Rc<dyn IDirtyRectTracker>>, render_children: bool, skip_root_visual_transform: bool, rendering_to_bitmap_cache: bool, ) -> (i32, i32)

Renders the visual and, with render_children, its subtree onto canvas. Returns the numbers of visited and rendered visuals.

impl ServerCompositionVisual

pub fn update_root( self: &Rc<Self>, tracker: Rc<dyn IDirtyRectCollector>, transform: Matrix, clip: LtrbRect, )

impl ServerCompositionVisual

pub fn new( compositor: &Rc<ServerCompositor>, children: Option<Rc<ServerCompositionVisualCollection>>, readback: Arc<VisualReadback>, content: Box<dyn IServerVisualContent>, ) -> Rc<ServerCompositionVisual>

Creates a server visual. children is the server side of the children collection (created before the visual by the UI thread), readback the readback slots shared with the UI-thread visual, and content the concrete class.

pub fn weak(&self) -> Weak<ServerCompositionVisual>

A weak handle of the visual.

pub fn compositor(&self) -> Option<Rc<ServerCompositor>>

The compositor of the visual, while it is alive.

pub fn object(&self) -> &ServerObject

The ServerObject part: activation and animations.

pub fn activate(&self)

pub fn deactivate(&self)

pub fn content(&self) -> &dyn IServerVisualContent

The concrete class of the visual.

pub fn content_as<T: IServerVisualContent>(&self) -> Option<&T>

The concrete class of the visual as T.

pub fn children(&self) -> Option<&Rc<ServerCompositionVisualCollection>>

pub fn cache(&self) -> Option<Rc<ServerCompositionVisualCache>>

pub fn visual_props(&self) -> &ServerCompositionVisualProps

The generated properties of the visual class.

pub fn root(&self) -> Option<Rc<ServerCompositionTarget>>

pub fn parent(&self) -> Option<Rc<ServerCompositionVisual>>

pub fn adorned_visual(&self) -> Option<Rc<ServerCompositionVisual>>

pub fn cache_mode(&self) -> Option<Rc<ServerCompositionBitmapCache>>

pub fn visible(&self) -> bool

pub fn opacity(&self) -> f32

pub fn clip(&self) -> Option<Arc<dyn IGeometryImpl>>

pub fn clip_to_bounds(&self) -> bool

pub fn offset(&self) -> Vector3D

pub fn translation(&self) -> Vector3D

pub fn size(&self) -> Vector

pub fn anchor_point(&self) -> Vector

pub fn center_point(&self) -> Vector3D

pub fn rotation_angle(&self) -> f32

pub fn orientation(&self) -> Quaternion

pub fn scale(&self) -> Vector3D

pub fn transform_matrix(&self) -> Matrix

pub fn adorner_is_clipped(&self) -> bool

pub fn opacity_mask_brush(&self) -> Option<Rc<dyn IBrush>>

pub fn effect(&self) -> Option<Arc<dyn IImmutableEffect>>

pub fn render_options(&self) -> RenderOptions

pub fn text_options(&self) -> TextOptions

pub fn on_cache_mode_state_changed(&self)

pub fn base_deserialize_changes_core( &self, reader: &mut BatchStreamReader<'_>, committed_at: Duration, )

DeserializeChangesCore of the container visual class: what the concrete classes call as their base.

Trait Implementations

impl IAnimatedServerObject for ServerCompositionVisual

fn server_object(&self) -> &ServerObject

The embedded ServerObject part.

fn get_composition_property( &self, field_name: &str, ) -> Option<&'static CompositionProperty>

The composition property with the given name, if the class has one.

fn as_server_object_dyn(&self) -> &dyn IServerObject

The object as the base contract (an explicit upcast).

impl IExpressionObject for ServerCompositionVisual

fn get_property(&self, name: &str) -> ExpressionVariant

Gets the value of the property with the given name; Invalid when there is no such property.

fn key(&self) -> ExpressionObjectKey

The identity of the object, used to track the objects an expression depends on (see ExpressionTrackedObjects). The default is the address of the object, which is its reference identity for as long as the object is alive and not moved; an implementation that has a stable identifier should return that instead.

impl IServerAnimatedPropertyHost for ServerCompositionVisual

fn set_animated_value( &self, property: &'static CompositionProperty, current_value: ExpressionVariant, committed_at: Duration, animation: Rc<dyn IAnimationInstance>, )

SetAnimatedValue(prop, ref field, committedAt, animation): starts animation on the property. current_value is the value of the field as a variant; the animation writes the field through CompositionProperty::set_variant.

fn remove_animation_for_property(&self, property: &'static CompositionProperty)

The tail of SetAnimatedValue(prop, out field, value): the field has been assigned directly, so the animation of the property, if any, is removed.

fn notify_animated_value_changed(&self, property: &'static CompositionProperty)

An animation wrote a new value into the field of property.

impl IServerObject for ServerCompositionVisual

fn dispose(&self)

Releases what the visual holds. Upstream the garbage collector reclaims a server visual once nothing refers to it; here the UI thread disposes it by id, and the references that would keep a cycle alive are dropped without notifications.

fn deserialize_changes_core( &self, reader: &mut BatchStreamReader<'_>, committed_at: Duration, )

Reads the changes of the object from a batch.

fn get_props(&self, type_id: TypeId) -> Option<&dyn Any>

The generated property block of the given type embedded in the object, if it has one. A class that embeds generated properties forwards to their find_props; composition properties locate their fields through it.

fn as_animated(self: Rc<Self>) -> Option<Rc<dyn IAnimatedServerObject>>

The object as an animatable object, if it is one.

fn as_any(&self) -> &dyn Any

fn into_any_rc(self: Rc<Self>) -> Rc<dyn Any>

fn values_invalidated(&self)

Called after a group of values of the object changed.

fn deserialize_changes( &self, reader: &mut BatchStreamReader<'_>, committed_at: Duration, )

Applies the changes of the object from a batch.

fn as_render_resource(self: Rc<Self>) -> Option<Rc<dyn IServerRenderResource>>

The object as a render resource, if it is one.

fn as_brush(self: Rc<Self>) -> Option<Rc<dyn IBrush>>

The object as a brush, if it is a server-side brush.

fn as_pen(self: Rc<Self>) -> Option<Rc<dyn IPen>>

The object as a pen, if it is a server-side pen.

fn as_render_data_geometry( self: Rc<Self>, ) -> Option<Rc<dyn IRenderDataGeometry>>

The object as a geometry usable by render data, if it is a server-side geometry.

fn as_transform(self: Rc<Self>) -> Option<Rc<dyn ITransform>>

The object as a transform, if it is a server-side transform.

fn as_gradient_stop(self: Rc<Self>) -> Option<Rc<dyn IGradientStop>>

The object as a gradient stop, if it is a server-side gradient stop.

fn as_surface(self: Rc<Self>) -> Option<Rc<dyn IServerCompositionSurface>>

The object as a composition surface, if it is one.

impl IServerPropertyHost for ServerCompositionVisual

fn server_compositor(&self) -> Option<Rc<ServerCompositor>>

The compositor of the object, while it is alive. Used to resolve the server objects a batch refers to.

fn set_value( &self, property: &'static CompositionProperty, change: ServerValueChange<'_>, )

SetValue(prop, ref field, value) as the class of the object defines it. A plain server object assigns; an animated object also invalidates the subscriptions of the property; a render resource goes through super::ServerRenderResourceCore::set_value.

impl IServerRenderResourceObserver for ServerCompositionVisual

fn dependency_queued_invalidate(&self, _sender: &dyn IServerRenderResource)

impl ServerCompositionContainerVisualHooks for ServerCompositionVisual

impl ServerCompositionExperimentalAcrylicVisualHooks for ServerCompositionVisual

fn base_deserialize_changes_core( &self, reader: &mut BatchStreamReader<'_>, committed_at: Duration, )

base.DeserializeChangesCore(reader, committedAt): reads the changes of the hand-written base class ServerCompositionDrawListVisual.

fn deserialize_changes_extra(&self, _reader: &mut BatchStreamReader<'_>)

fn on_fields_deserialized( &self, _changed: CompositionExperimentalAcrylicVisualChangedFields, )

fn on_material_changed(&self)

fn on_material_changing(&self)

fn on_corner_radius_changed(&self)

fn on_corner_radius_changing(&self)

impl ServerCompositionSolidColorVisualHooks for ServerCompositionVisual

fn base_deserialize_changes_core( &self, reader: &mut BatchStreamReader<'_>, committed_at: Duration, )

base.DeserializeChangesCore(reader, committedAt): reads the changes of the hand-written base class ServerSizeDependantVisual.

fn deserialize_changes_extra(&self, _reader: &mut BatchStreamReader<'_>)

fn on_fields_deserialized( &self, _changed: CompositionSolidColorVisualChangedFields, )

impl ServerCompositionSurfaceVisualHooks for ServerCompositionVisual

fn base_deserialize_changes_core( &self, reader: &mut BatchStreamReader<'_>, committed_at: Duration, )

base.DeserializeChangesCore(reader, committedAt): reads the changes of the hand-written base class ServerSizeDependantVisual.

fn on_surface_changed(&self)

fn on_surface_changing(&self)

fn deserialize_changes_extra(&self, _reader: &mut BatchStreamReader<'_>)

fn on_fields_deserialized( &self, _changed: CompositionSurfaceVisualChangedFields, )

impl ServerCompositionVisualHooks for ServerCompositionVisual

fn on_fields_deserialized(&self, changed: CompositionVisualChangedFields)

fn on_root_changing(&self)

fn on_root_changed(&self)

fn on_parent_changing(&self)

fn on_parent_changed(&self)

fn on_adorned_visual_changing(&self)

fn on_adorned_visual_changed(&self)

fn on_cache_mode_changing(&self)

fn on_cache_mode_changed(&self)

fn deserialize_changes_extra(&self, _reader: &mut BatchStreamReader<'_>)

fn on_clip_changed(&self)

fn on_clip_changing(&self)

fn on_adorner_is_clipped_changed(&self)

fn on_adorner_is_clipped_changing(&self)

fn on_opacity_mask_brush_changed(&self)

fn on_opacity_mask_brush_changing(&self)

fn on_effect_changed(&self)

fn on_effect_changing(&self)

fn on_render_options_changed(&self)

fn on_render_options_changing(&self)

fn on_text_options_changed(&self)

fn on_text_options_changing(&self)