ViewBuffer

Struct ViewBuffer 

Source
pub struct ViewBuffer<'a> { /* private fields */ }
Expand description

Render to the temp buffer.

  • It maps your widget area from layout coordinates to screen coordinates before rendering.
  • It helps with cleanup of the widget state if your widget is currently invisible.

Implementations§

Source§

impl<'a> ViewBuffer<'a>

Source

pub fn render_widget<W>(&mut self, widget: W, area: Rect) -> bool
where W: Widget,

Render a widget to the temp buffer.

Source

pub fn render<W, S>(&mut self, widget: W, area: Rect, state: &mut S) -> bool
where W: StatefulWidget<State = S>, S: RelocatableState,

Render a widget to the temp buffer. This expects that the state is a RelocatableState.

Source

pub fn render_popup<W, S>( &mut self, widget: W, area: Rect, state: &mut S, ) -> bool
where W: StatefulWidget<State = S>, S: RelocatableState,

Render an additional popup widget for the given main widget.

Doesn’t call relocate().

Source

pub fn layout(&self) -> Rect

Return the buffer layout.

Source

pub fn is_visible_area(&self, area: Rect) -> bool

Is this area inside the buffer area.

Source

pub fn shift(&self) -> (i16, i16)

👎Deprecated since 2.0.0: should not be public. use relocate2() instead.

Calculate the necessary shift from view to screen.

Source

pub fn locate_area(&self, area: Rect) -> Rect

👎Deprecated since 2.0.0: wrong api, use is_visible_area() or locate_area2()

Does nothing for view. Only exists to match Clipper.

Source

pub fn locate_area2(&self, area: Rect) -> Option<Rect>

Validates that this area is inside the buffer area.

Source

pub fn relocate<S>(&self, state: &mut S)

👎Deprecated since 2.0.0: wrong api, use relocate2() instead

After rendering the widget to the buffer it may have stored areas in its state. These will be in buffer coordinates instead of screen coordinates.

Call this function to correct this after rendering.

Source

pub fn relocate2<S>(&self, area: Rect, state: &mut S)

After rendering the widget to the buffer it may have stored areas in its state. These will be in buffer coordinates instead of screen coordinates.

Call this function to correct this after rendering.

Source

pub fn hidden<S>(&self, state: &mut S)

👎Deprecated since 2.0.0: bad api, use relocate2() instead

If a widget is not rendered because it is out of the buffer area, it may still have left over areas in its state.

This uses relocate_hidden to zero them out.

Source

pub fn buffer(&mut self) -> &mut Buffer

Access the temporary buffer.

Note Use of render_widget is preferred.

Source

pub fn into_widget(self) -> ViewWidget<'a>

👎Deprecated since 2.3.0: use finish() instead

Rendering the content is finished.

Convert to the output widget that can be rendered in the target area.

Source

pub fn finish(self, tgt_buf: &mut Buffer, state: &mut ViewState)

Render the buffer.

Trait Implementations§

Source§

impl<'a> Debug for ViewBuffer<'a>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'a> Drop for ViewBuffer<'a>

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

§

impl<'a> Freeze for ViewBuffer<'a>

§

impl<'a> RefUnwindSafe for ViewBuffer<'a>

§

impl<'a> Send for ViewBuffer<'a>

§

impl<'a> Sync for ViewBuffer<'a>

§

impl<'a> Unpin for ViewBuffer<'a>

§

impl<'a> UnwindSafe for ViewBuffer<'a>

Blanket Implementations§

Source§

impl<S, D, Swp, Dwp, T> AdaptInto<D, Swp, Dwp, T> for S
where T: Real + Zero + Arithmetics + Clone, Swp: WhitePoint<T>, Dwp: WhitePoint<T>, D: AdaptFrom<S, Swp, Dwp, T>,

Source§

fn adapt_into_using<M>(self, method: M) -> D
where M: TransformMatrix<T>,

Convert the source color to the destination color using the specified method.
Source§

fn adapt_into(self) -> D

Convert the source color to the destination color using the bradford method by default.
Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T, C> ArraysFrom<C> for T
where C: IntoArrays<T>,

Source§

fn arrays_from(colors: C) -> T

Cast a collection of colors into a collection of arrays.
Source§

impl<T, C> ArraysInto<C> for T
where C: FromArrays<T>,

Source§

fn arrays_into(self) -> C

Cast this collection of arrays into a collection of colors.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<WpParam, T, U> Cam16IntoUnclamped<WpParam, T> for U
where T: FromCam16Unclamped<WpParam, U>,

Source§

type Scalar = <T as FromCam16Unclamped<WpParam, U>>::Scalar

The number type that’s used in parameters when converting.
Source§

fn cam16_into_unclamped( self, parameters: BakedParameters<WpParam, <U as Cam16IntoUnclamped<WpParam, T>>::Scalar>, ) -> T

Converts self into C, using the provided parameters.
Source§

impl<T, C> ComponentsFrom<C> for T
where C: IntoComponents<T>,

Source§

fn components_from(colors: C) -> T

Cast a collection of colors into a collection of color components.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FromAngle<T> for T

Source§

fn from_angle(angle: T) -> T

Performs a conversion from angle.
Source§

impl<T, U> FromStimulus<U> for T
where U: IntoStimulus<T>,

Source§

fn from_stimulus(other: U) -> T

Converts other into Self, while performing the appropriate scaling, rounding and clamping.
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> IntoAngle<U> for T
where U: FromAngle<T>,

Source§

fn into_angle(self) -> U

Performs a conversion into T.
Source§

impl<WpParam, T, U> IntoCam16Unclamped<WpParam, T> for U
where T: Cam16FromUnclamped<WpParam, U>,

Source§

type Scalar = <T as Cam16FromUnclamped<WpParam, U>>::Scalar

The number type that’s used in parameters when converting.
Source§

fn into_cam16_unclamped( self, parameters: BakedParameters<WpParam, <U as IntoCam16Unclamped<WpParam, T>>::Scalar>, ) -> T

Converts self into C, using the provided parameters.
Source§

impl<T, U> IntoColor<U> for T
where U: FromColor<T>,

Source§

fn into_color(self) -> U

Convert into T with values clamped to the color defined bounds Read more
Source§

impl<T, U> IntoColorUnclamped<U> for T
where U: FromColorUnclamped<T>,

Source§

fn into_color_unclamped(self) -> U

Convert into T. The resulting color might be invalid in its color space Read more
Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> IntoStimulus<T> for T

Source§

fn into_stimulus(self) -> T

Converts self into T, while performing the appropriate scaling, rounding and clamping.
Source§

impl<T, C> TryComponentsInto<C> for T
where C: TryFromComponents<T>,

Source§

type Error = <C as TryFromComponents<T>>::Error

The error for when try_into_colors fails to cast.
Source§

fn try_components_into(self) -> Result<C, <T as TryComponentsInto<C>>::Error>

Try to cast this collection of color components into a collection of colors. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T, U> TryIntoColor<U> for T
where U: TryFromColor<T>,

Source§

fn try_into_color(self) -> Result<U, OutOfBounds<U>>

Convert into T, returning ok if the color is inside of its defined range, otherwise an OutOfBounds error is returned which contains the unclamped color. Read more
Source§

impl<C, U> UintsFrom<C> for U
where C: IntoUints<U>,

Source§

fn uints_from(colors: C) -> U

Cast a collection of colors into a collection of unsigned integers.
Source§

impl<C, U> UintsInto<C> for U
where C: FromUints<U>,

Source§

fn uints_into(self) -> C

Cast this collection of unsigned integers into a collection of colors.