Struct slint_interpreter::Image
pub struct Image(/* private fields */);
Expand description
An image type that can be displayed by the Image element. You can construct
Image objects from a path to an image file on disk, using Self::load_from_path
.
Another typical use-case is to render the image content with Rust code. For this it’s most efficient to create a new SharedPixelBuffer with the known dimensions and pass the mutable slice to your rendering function. Afterwards you can create an Image.
The following example creates a 320x200 RGB pixel buffer and calls an external
low_level_render() function to draw a shape into it. Finally the result is
stored in an Image with Self::from_rgb8()
:
fn low_level_render(width: u32, height: u32, buffer: &mut [u8]) {
// render beautiful circle or other shapes here
}
let mut pixel_buffer = SharedPixelBuffer::<Rgb8Pixel>::new(320, 200);
low_level_render(pixel_buffer.width(), pixel_buffer.height(),
pixel_buffer.make_mut_bytes());
let image = Image::from_rgb8(pixel_buffer);
Another use-case is to import existing image data into Slint, by creating a new Image through cloning of another image type.
The following example uses the popular image crate to
load a .png
file from disk, apply brightening filter on it and then import
it into an Image
:
let mut cat_image = image::open("cat.png").expect("Error loading cat image").into_rgba8();
image::imageops::colorops::brighten_in_place(&mut cat_image, 20);
let buffer = SharedPixelBuffer::<Rgba8Pixel>::clone_from_slice(
cat_image.as_raw(),
cat_image.width(),
cat_image.height(),
);
let image = Image::from_rgba8(buffer);
A popular software (CPU) rendering library in Rust is tiny-skia. The following example shows
how to use tiny-skia to render into a SharedPixelBuffer
:
let mut pixel_buffer = SharedPixelBuffer::<Rgba8Pixel>::new(640, 480);
let width = pixel_buffer.width();
let height = pixel_buffer.height();
let mut pixmap = tiny_skia::PixmapMut::from_bytes(
pixel_buffer.make_mut_bytes(), width, height
).unwrap();
pixmap.fill(tiny_skia::Color::TRANSPARENT);
let circle = tiny_skia::PathBuilder::from_circle(320., 240., 150.).unwrap();
let mut paint = tiny_skia::Paint::default();
paint.shader = tiny_skia::LinearGradient::new(
tiny_skia::Point::from_xy(100.0, 100.0),
tiny_skia::Point::from_xy(400.0, 400.0),
vec![
tiny_skia::GradientStop::new(0.0, tiny_skia::Color::from_rgba8(50, 127, 150, 200)),
tiny_skia::GradientStop::new(1.0, tiny_skia::Color::from_rgba8(220, 140, 75, 180)),
],
tiny_skia::SpreadMode::Pad,
tiny_skia::Transform::identity(),
).unwrap();
pixmap.fill_path(&circle, &paint, tiny_skia::FillRule::Winding, Default::default(), None);
let image = Image::from_rgba8_premultiplied(pixel_buffer);
§Sending Image to a thread
Image
is not Send
, because it uses internal cache that are local to the Slint thread.
If you want to create image data in a thread and send that to slint, construct the
SharedPixelBuffer
in a thread, and send that to Slint’s UI thread.
std::thread::spawn(move || {
let mut pixel_buffer = SharedPixelBuffer::<Rgba8Pixel>::new(640, 480);
// ... fill the pixel_buffer with data as shown in the previous example ...
slint::invoke_from_event_loop(move || {
// this will run in the Slint's UI thread
let image = Image::from_rgba8_premultiplied(pixel_buffer);
// ... use the image, eg:
// my_ui_handle.upgrade().unwrap().set_image(image);
});
});
Implementations§
§impl Image
impl Image
pub fn load_from_path(path: &Path) -> Result<Image, LoadImageError>
pub fn load_from_path(path: &Path) -> Result<Image, LoadImageError>
Load an Image from a path to a file containing an image
pub fn from_rgb8(buffer: SharedPixelBuffer<Rgb<u8>>) -> Image
pub fn from_rgb8(buffer: SharedPixelBuffer<Rgb<u8>>) -> Image
Creates a new Image from the specified shared pixel buffer, where each pixel has three color channels (red, green and blue) encoded as u8.
pub fn from_rgba8(buffer: SharedPixelBuffer<Rgba<u8>>) -> Image
pub fn from_rgba8(buffer: SharedPixelBuffer<Rgba<u8>>) -> Image
Creates a new Image from the specified shared pixel buffer, where each pixel has four color channels (red, green, blue and alpha) encoded as u8.
pub fn from_rgba8_premultiplied(buffer: SharedPixelBuffer<Rgba<u8>>) -> Image
pub fn from_rgba8_premultiplied(buffer: SharedPixelBuffer<Rgba<u8>>) -> Image
Creates a new Image from the specified shared pixel buffer, where each pixel has four color
channels (red, green, blue and alpha) encoded as u8 and, in contrast to Self::from_rgba8
,
the alpha channel is also assumed to be multiplied to the red, green and blue channels.
Only construct an Image with this function if you know that your pixels are encoded this way.
pub fn to_rgb8(&self) -> Option<SharedPixelBuffer<Rgb<u8>>>
pub fn to_rgb8(&self) -> Option<SharedPixelBuffer<Rgb<u8>>>
Returns the pixel buffer for the Image if available in RGB format without alpha. Returns None if the pixels cannot be obtained, for example when the image was created from borrowed OpenGL textures.
pub fn to_rgba8(&self) -> Option<SharedPixelBuffer<Rgba<u8>>>
pub fn to_rgba8(&self) -> Option<SharedPixelBuffer<Rgba<u8>>>
Returns the pixel buffer for the Image if available in RGBA format. Returns None if the pixels cannot be obtained, for example when the image was created from borrowed OpenGL textures.
pub fn to_rgba8_premultiplied(&self) -> Option<SharedPixelBuffer<Rgba<u8>>>
pub fn to_rgba8_premultiplied(&self) -> Option<SharedPixelBuffer<Rgba<u8>>>
Returns the pixel buffer for the Image if available in RGBA format, with the alpha channel pre-multiplied to the red, green, and blue channels. Returns None if the pixels cannot be obtained, for example when the image was created from borrowed OpenGL textures.
pub unsafe fn from_borrowed_gl_2d_rgba_texture(
texture_id: NonZero<u32>,
size: Size2D<u32, UnknownUnit>,
) -> Image
👎Deprecated since 1.2.0: Use BorrowedOpenGLTextureBuilder
pub unsafe fn from_borrowed_gl_2d_rgba_texture( texture_id: NonZero<u32>, size: Size2D<u32, UnknownUnit>, ) -> Image
Creates a new Image from an existing OpenGL texture. The texture remains borrowed by Slint
for the duration of being used for rendering, such as when assigned as source property to
an Image
element. It’s the application’s responsibility to delete the texture when it is
not used anymore.
The texture must be bindable against the GL_TEXTURE_2D
target, have GL_RGBA
as format
for the pixel data.
When Slint renders the texture, it assumes that the origin of the texture is at the top-left. This is different from the default OpenGL coordinate system.
§Safety
This function is unsafe because invalid texture ids may lead to undefined behavior in OpenGL
drivers. A valid texture id is one that was created by the same OpenGL context that is
current during any of the invocations of the callback set on Window::set_rendering_notifier()
.
OpenGL contexts between instances of slint::Window
are not sharing resources. Consequently
slint::Image
objects created from borrowed OpenGL textures cannot be shared between
different windows.
pub fn load_from_svg_data(buffer: &[u8]) -> Result<Image, LoadImageError>
pub fn load_from_svg_data(buffer: &[u8]) -> Result<Image, LoadImageError>
Creates a new Image from the specified buffer, which contains SVG raw data.
pub fn set_nine_slice_edges(
&mut self,
top: u16,
right: u16,
bottom: u16,
left: u16,
)
pub fn set_nine_slice_edges( &mut self, top: u16, right: u16, bottom: u16, left: u16, )
Sets the nine-slice edges of the image.
Nine-slice scaling is a method for scaling images in such a way that the corners are not distorted. The arguments define the pixel sizes of the edges that cut the image into 9 slices.
pub fn path(&self) -> Option<&Path>
pub fn path(&self) -> Option<&Path>
Returns the path of the image on disk, if it was constructed via Self::load_from_path
.
For example:
let path_buf = Path::new(env!("CARGO_MANIFEST_DIR"))
.join("../../examples/printerdemo/ui/images/cat.jpg");
let image = Image::load_from_path(&path_buf).unwrap();
assert_eq!(image.path(), Some(path_buf.as_path()));
Trait Implementations§
impl StructuralPartialEq for Image
Auto Trait Implementations§
impl Freeze for Image
impl !RefUnwindSafe for Image
impl !Send for Image
impl !Sync for Image
impl Unpin for Image
impl !UnwindSafe for Image
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
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 moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
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§impl<T> NoneValue for Twhere
T: Default,
impl<T> NoneValue for Twhere
T: Default,
type NoneType = T
§fn null_value() -> T
fn null_value() -> T
§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<R, P> ReadPrimitive<R> for P
impl<R, P> ReadPrimitive<R> for P
source§fn read_from_little_endian(read: &mut R) -> Result<Self, Error>
fn read_from_little_endian(read: &mut R) -> Result<Self, Error>
ReadEndian::read_from_little_endian()
.