//! Attach an icon to the window of your application. pub use crate::core::window::icon::*; use crate::core::window::icon; use std::io; #[cfg(feature = "image")] use std::path::Path; /// Creates an icon from an image file. /// /// This will return an error in case the file is missing at run-time. You may prefer [`from_file_data`] instead. #[cfg(feature = "image")] pub fn from_file>(icon_path: P) -> Result { let icon = image::io::Reader::open(icon_path)?.decode()?.to_rgba8(); Ok(icon::from_rgba(icon.to_vec(), icon.width(), icon.height())?) } /// Creates an icon from the content of an image file. /// /// This content can be included in your application at compile-time, e.g. using the `include_bytes!` macro. /// You can pass an explicit file format. Otherwise, the file format will be guessed at runtime. #[cfg(feature = "image")] pub fn from_file_data( data: &[u8], explicit_format: Option, ) -> Result { let mut icon = image::io::Reader::new(std::io::Cursor::new(data)); let icon_with_format = match explicit_format { Some(format) => { icon.set_format(format); icon } None => icon.with_guessed_format()?, }; let pixels = icon_with_format.decode()?.to_rgba8(); Ok(icon::from_rgba( pixels.to_vec(), pixels.width(), pixels.height(), )?) } /// An error produced when creating an [`Icon`]. #[derive(Debug, thiserror::Error)] pub enum Error { /// The [`Icon`] is not valid. #[error("The icon is invalid: {0}")] InvalidError(#[from] icon::Error), /// The underlying OS failed to create the icon. #[error("The underlying OS failted to create the window icon: {0}")] OsError(#[from] io::Error), /// The `image` crate reported an error. #[cfg(feature = "image")] #[error("Unable to create icon from a file: {0}")] ImageError(#[from] image::error::ImageError), }