Enum zng::image::ImageSource

pub enum ImageSource {
    Read(PathBuf),
    Download(Uri, Option<Txt>),
    Static(ImageHash, &'static [u8], ImageDataFormat),
    Data(ImageHash, Arc<Vec<u8>>, ImageDataFormat),
    Render(Arc<Box<dyn Fn(&ImageRenderArgs) -> Box<dyn ImageRenderWindowRoot> + Sync + Send>>, Option<ImageRenderArgs>),
    Image(ReadOnlyVar<Img, ArcVar<Img>>),
}

The different sources of an image resource.

Variants

Read(PathBuf)

A path to an image file in the file system.

Image equality is defined by the path, a copy of the image in another path is a different image.

Download(Uri, Option<Txt>)

A uri to an image resource downloaded using HTTP GET with an optional HTTP ACCEPT string.

If the ACCEPT line is not given, all image formats supported by the view-process backend are accepted.

Image equality is defined by the URI and ACCEPT string.

Static(ImageHash, &'static [u8], ImageDataFormat)

Static bytes for an encoded or decoded image.

Image equality is defined by the hash, it is usually the hash of the bytes but it does not need to be.

Data(ImageHash, Arc<Vec<u8>>, ImageDataFormat)

Shared reference to bytes for an encoded or decoded image.

Image equality is defined by the hash, it is usually the hash of the bytes but it does not need to be.

Inside IMAGES the reference to the bytes is held only until the image finishes decoding.

Render(Arc<Box<dyn Fn(&ImageRenderArgs) -> Box<dyn ImageRenderWindowRoot> + Sync + Send>>, Option<ImageRenderArgs>)

A boxed closure that instantiates a WindowRoot that draws the image.

Use the render or render_node functions to construct this variant.

The closure is set by the image widget user, the args is set by the image widget.

Image(ReadOnlyVar<Img, ArcVar<Img>>)

Already resolved (loaded or loading) image.

The image is passed-through, not cached.

Implementations

impl ImageSource

pub fn flood( size: impl Into<Size2D<Px, Px>>, color: impl Into<Rgba>, ppi: Option<ImagePpi>, ) -> ImageSource

New image data from solid color.

pub fn from_data(data: Arc<Vec<u8>>, format: ImageDataFormat) -> ImageSource

New source from data.

pub fn from_static(data: &'static [u8], format: ImageDataFormat) -> ImageSource

New source from static data.

pub fn hash128( &self, downscale: Option<ImageDownscale>, mask: Option<ImageMaskMode>, ) -> Option<ImageHash>

Returns the image hash, unless the source is Img.

pub fn hash128_data( data_hash: ImageHash, downscale: Option<ImageDownscale>, mask: Option<ImageMaskMode>, ) -> ImageHash

Compute hash for a borrowed Static or Data image.

pub fn hash128_read( path: &Path, downscale: Option<ImageDownscale>, mask: Option<ImageMaskMode>, ) -> ImageHash

Compute hash for a borrowed Read path.

pub fn hash128_download( uri: &Uri, accept: &Option<Txt>, downscale: Option<ImageDownscale>, mask: Option<ImageMaskMode>, ) -> ImageHash

Compute hash for a borrowed Download URI and HTTP-ACCEPT.

pub fn hash128_render( rfn: &Arc<Box<dyn Fn(&ImageRenderArgs) -> Box<dyn ImageRenderWindowRoot> + Sync + Send>>, args: &Option<ImageRenderArgs>, downscale: Option<ImageDownscale>, mask: Option<ImageMaskMode>, ) -> ImageHash

Compute hash for a borrowed Render source.

Pointer equality is used to identify the node closure.

impl ImageSource

pub fn render<F, R>(new_img: F) -> ImageSource

where F: Fn(&ImageRenderArgs) -> R + Send + Sync + 'static, R: ImageRenderWindowRoot,

New image from a function that generates a headless window.

The function is called every time the image source is resolved and it is not found in the cache.

Examples

    |args| Window! {
        size = (500, 400);
        parent = args.parent;
        background_color = colors::GREEN;
        child = Text!("Rendered!");
    }
)

pub fn render_node<U, N>(render_mode: RenderMode, render: N) -> ImageSource

where U: UiNode, N: Fn(&ImageRenderArgs) -> U + Send + Sync + 'static,

New image from a function that generates a new UiNode.

The function is called every time the image source is resolved and it is not found in the cache.

Note that the generated UiNode is not a child of the widget that renders the image, it is the root widget of a headless surface, not a part of the context where it is rendered. See IMAGES.render for more information.

Examples

ImageSource::render_node(
    RenderMode::Software,
    |_args| Container! {
        size = (500, 400);
        background_color = colors::GREEN;
        child = Text!("Rendered!");
    }
)

Trait Implementations

impl Clone for ImageSource

fn clone(&self) -> ImageSource

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ImageSource

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

Formats the value using the given formatter.

impl From<&'static [u8]> for ImageSource

fn from(data: &'static [u8]) -> ImageSource

From encoded data of Unknown format.

impl<const N: usize> From<&'static [u8; N]> for ImageSource

fn from(data: &'static [u8; N]) -> ImageSource

From encoded data of Unknown format.

impl From<&Path> for ImageSource

fn from(path: &Path) -> ImageSource

Converts to this type from the input type.

impl From<&str> for ImageSource

fn from(s: &str) -> ImageSource

Converts http:// and https:// to Download, file:// to Read the path component, and the rest to Read the string as a path.

impl<F> From<(&'static [u8], F)> for ImageSource

where F: Into<ImageDataFormat>,

fn from(_: (&'static [u8], F)) -> ImageSource

From encoded data of known format.

impl<F, const N: usize> From<(&'static [u8; N], F)> for ImageSource

where F: Into<ImageDataFormat>,

fn from(_: (&'static [u8; N], F)) -> ImageSource

From encoded data of known format.

impl<F> From<(Arc<Vec<u8>>, F)> for ImageSource

where F: Into<ImageDataFormat>,

fn from(_: (Arc<Vec<u8>>, F)) -> ImageSource

From encoded data of known format.

impl From<(Uri, &'static str)> for ImageSource

fn from(_: (Uri, &'static str)) -> ImageSource

From (URI, HTTP-ACCEPT).

impl<F> From<(Vec<u8>, F)> for ImageSource

where F: Into<ImageDataFormat>,

fn from(_: (Vec<u8>, F)) -> ImageSource

From encoded data of known format.

impl From<Arc<Vec<u8>>> for ImageSource

fn from(data: Arc<Vec<u8>>) -> ImageSource

From encoded data of Unknown format.

impl From<ImageSource> for WindowIcon

fn from(source: ImageSource) -> WindowIcon

Converts to this type from the input type.

impl From<PathBuf> for ImageSource

fn from(path: PathBuf) -> ImageSource

Converts to this type from the input type.

impl From<ReadOnlyVar<Img, ArcVar<Img>>> for ImageSource

fn from(image: ReadOnlyVar<Img, ArcVar<Img>>) -> ImageSource

Converts to this type from the input type.

impl From<String> for ImageSource

fn from(s: String) -> ImageSource

Same as conversion from &str.

impl From<Txt> for ImageSource

fn from(s: Txt) -> ImageSource

Same as conversion from &str.

impl From<Uri> for ImageSource

fn from(uri: Uri) -> ImageSource

Converts to this type from the input type.

impl From<Vec<u8>> for ImageSource

fn from(data: Vec<u8>) -> ImageSource

From encoded data of Unknown format.

impl IntoVar<ImageSource> for &'static [u8]

fn into_var(self) -> <&'static [u8] as IntoVar<ImageSource>>::Var

From encoded data of Unknown format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl<const N: usize> IntoVar<ImageSource> for &'static [u8; N]

fn into_var(self) -> <&'static [u8; N] as IntoVar<ImageSource>>::Var

From encoded data of Unknown format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for &Path

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_var(self) -> <&Path as IntoVar<ImageSource>>::Var

Converts the source value into a var.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for &str

fn into_var(self) -> <&str as IntoVar<ImageSource>>::Var

Converts http:// and https:// to Download, file:// to Read the path component, and the rest to Read the string as a path.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl<F> IntoVar<ImageSource> for (&'static [u8], F)

where F: Into<ImageDataFormat>,

fn into_var(self) -> <(&'static [u8], F) as IntoVar<ImageSource>>::Var

From encoded data of known format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl<F, const N: usize> IntoVar<ImageSource> for (&'static [u8; N], F)

where F: Into<ImageDataFormat>,

fn into_var(self) -> <(&'static [u8; N], F) as IntoVar<ImageSource>>::Var

From encoded data of known format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl<F> IntoVar<ImageSource> for (Arc<Vec<u8>>, F)

where F: Into<ImageDataFormat>,

fn into_var(self) -> <(Arc<Vec<u8>>, F) as IntoVar<ImageSource>>::Var

From encoded data of known format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for (Uri, &'static str)

fn into_var(self) -> <(Uri, &'static str) as IntoVar<ImageSource>>::Var

From (URI, HTTP-ACCEPT).

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl<F> IntoVar<ImageSource> for (Vec<u8>, F)

where F: Into<ImageDataFormat>,

fn into_var(self) -> <(Vec<u8>, F) as IntoVar<ImageSource>>::Var

From encoded data of known format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for Arc<Vec<u8>>

fn into_var(self) -> <Arc<Vec<u8>> as IntoVar<ImageSource>>::Var

From encoded data of Unknown format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for PathBuf

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_var(self) -> <PathBuf as IntoVar<ImageSource>>::Var

Converts the source value into a var.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for ReadOnlyVar<Img, ArcVar<Img>>

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_var( self, ) -> <ReadOnlyVar<Img, ArcVar<Img>> as IntoVar<ImageSource>>::Var

Converts the source value into a var.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for String

fn into_var(self) -> <String as IntoVar<ImageSource>>::Var

Same as conversion from &str.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for Txt

fn into_var(self) -> <Txt as IntoVar<ImageSource>>::Var

Same as conversion from &str.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for Uri

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_var(self) -> <Uri as IntoVar<ImageSource>>::Var

Converts the source value into a var.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<ImageSource> for Vec<u8>

fn into_var(self) -> <Vec<u8> as IntoVar<ImageSource>>::Var

From encoded data of Unknown format.

type Var = LocalVar<ImageSource>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<WindowIcon> for ImageSource

type Var = LocalVar<WindowIcon>

Variable type that will wrap the T value.

fn into_var(self) -> <ImageSource as IntoVar<WindowIcon>>::Var

Converts the source value into a var.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl PartialEq for ImageSource

fn eq(&self, other: &ImageSource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl IntoValue<ImageSource> for &'static [u8]

impl<const N: usize> IntoValue<ImageSource> for &'static [u8; N]

impl IntoValue<ImageSource> for &Path

impl IntoValue<ImageSource> for &str

impl<F> IntoValue<ImageSource> for (&'static [u8], F)

where F: Into<ImageDataFormat>,

impl<F, const N: usize> IntoValue<ImageSource> for (&'static [u8; N], F)

where F: Into<ImageDataFormat>,

impl<F> IntoValue<ImageSource> for (Arc<Vec<u8>>, F)

where F: Into<ImageDataFormat>,

impl IntoValue<ImageSource> for (Uri, &'static str)

impl<F> IntoValue<ImageSource> for (Vec<u8>, F)

where F: Into<ImageDataFormat>,

impl IntoValue<ImageSource> for Arc<Vec<u8>>

impl IntoValue<ImageSource> for PathBuf

impl IntoValue<ImageSource> for ReadOnlyVar<Img, ArcVar<Img>>

impl IntoValue<ImageSource> for String

impl IntoValue<ImageSource> for Txt

impl IntoValue<ImageSource> for Uri

impl IntoValue<ImageSource> for Vec<u8>

impl IntoValue<WindowIcon> for ImageSource