Struct SwVideoLayerHandle 

pub struct SwVideoLayerHandle { /* private fields */ }

Thread-safe runtime placement control for one compositor input. Retaining it does not keep the input or compositor alive.

Implementations

impl SwVideoLayerHandle

pub fn id(&self) -> VideoInputId

Returns the stable identity of this particular input registration.

pub fn name(&self) -> Arc<str>

Returns the registration name, which may be reused by a newer input.

pub fn layer(&self) -> Option<VideoLayer>

Returns the current layer settings, or None after this registration is removed.

pub fn set_layer(&self, layer: VideoLayer) -> Result<(), SwVideoCompositorError>

Atomically replaces every layer setting.

Returns SwVideoCompositorError::SourceRemoved if this handle is stale.

pub fn set_rect(&self, rect: VideoRect) -> Result<(), SwVideoCompositorError>

Replaces the destination rectangle while retaining the other layer settings.

pub fn set_opacity(&self, opacity: f32) -> Result<(), SwVideoCompositorError>

Replaces the layer opacity after validating the 0.0..=1.0 range.

pub fn set_z_index(&self, z_index: i32) -> Result<(), SwVideoCompositorError>

Changes the stacking order; larger values are drawn later.

pub fn set_visible(&self, visible: bool) -> Result<(), SwVideoCompositorError>

Shows or hides the input without removing its registration.

pub fn set_fit(&self, fit: VideoFit) -> Result<(), SwVideoCompositorError>

Changes how the input aspect ratio maps into its rectangle.

pub fn set_source( &self, source: Option<VideoSourceRect>, ) -> Result<(), SwVideoCompositorError>

Draws only part of the input, or all of it again with None.

Not checked against the frame, which may not have arrived yet and may change size later — see VideoSourceRect. Only an empty region is refused here.

Trait Implementations

impl Clone for SwVideoLayerHandle

fn clone(&self) -> SwVideoLayerHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.