Struct raylib::core::texture::Image

#[repr(transparent)]
pub struct Image(_);

Implementations

impl Image

pub unsafe fn unwrap(self) -> Image

Take the raw ffi type. Must manually free memory by calling the proper unload function

impl Image

pub fn to_raw(self) -> Image

returns the unwrapped raylib-sys object

pub unsafe fn from_raw(raw: Image) -> Self

converts raylib-sys object to a “safe” version. Make sure to call this function from the thread the resource was created.

impl Image

pub fn width(&self) -> i32

pub fn height(&self) -> i32

pub fn mipmaps(&self) -> i32

pub unsafe fn data(&self) -> *mut c_void

pub fn format(&self) -> PixelFormat

pub fn from_image(&self, rec: impl Into<Rectangle>) -> Image

pub fn export_image(&self, filename: &str)

Exports image as a PNG file.

pub fn export_image_as_code(&self, filename: &str)

Exports image as a PNG file.

pub fn get_pixel_data_size(&self) -> usize

Get pixel data size in bytes (image or texture)

pub fn get_image_data(&self) -> ImageColors

Gets pixel data from image as a Vec of Color structs.

pub fn extract_palette(&self, max_palette_size: u32) -> ImagePalette

Extract color palette from image to maximum size

pub fn to_pot(&mut self, fill_color: impl Into<Color>)

Converts image to POT (power-of-two).

pub fn set_format(&mut self, new_format: PixelFormat)

Converts image data to desired pixel format.

pub fn alpha_mask(&mut self, alpha_mask: &Image)

Applies alpha mask to image. Alpha mask must be same size as the image. If alpha mask is not greyscale Ensure the colors are white (255, 255, 255, 255) or black (0, 0, 0, 0)

pub fn alpha_clear(&mut self, color: impl Into<Color>, threshold: f32)

Clears alpha channel on image to desired color.

pub fn alpha_crop(&mut self, threshold: f32)

Crops image depending on alpha value.

pub fn alpha_premultiply(&mut self)

Premultiplies alpha channel on image.

pub fn crop(&mut self, crop: impl Into<Rectangle>)

Crops image to a defined rectangle.

pub fn resize(&mut self, new_width: i32, new_height: i32)

Resizes image (bilinear filtering).

pub fn resize_nn(&mut self, new_width: i32, new_height: i32)

Resizes image (nearest-neighbor scaling).

pub fn resize_canvas(
    &mut self,
    new_width: i32,
    new_height: i32,
    offset_x: i32,
    offset_y: i32,
    color: impl Into<Color>
)

Resizes image canvas and fills with color.

pub fn gen_mipmaps(&mut self)

Generates all mipmap levels for a provided image.

pub fn dither(&mut self, r_bpp: i32, g_bpp: i32, b_bpp: i32, a_bpp: i32)

Dithers image data to 16bpp or lower (Floyd-Steinberg dithering).

pub fn get_image_alpha_border(&self, threshold: f32) -> Rectangle

Get image alpha border rectangle

pub fn clear_background(&mut self, color: impl Into<Color>)

Clear image background with given color

pub fn draw(
    &mut self,
    src: &Image,
    src_rec: Rectangle,
    dst_rec: Rectangle,
    tint: impl Into<Color>
)

Draws a source image within a destination image.

pub fn draw_pixel(&mut self, pos_x: i32, pos_y: i32, color: impl Into<Color>)

Draw pixel within an image

pub fn draw_pixel_v(
    &mut self,
    position: impl Into<Vector2>,
    color: impl Into<Color>
)

Draw pixel within an image (Vector version)

pub fn draw_line(
    &mut self,
    start_pos_x: i32,
    start_pos_y: i32,
    end_pos_x: i32,
    end_pos_y: i32,
    color: impl Into<Color>
)

Draw line within an image

pub fn draw_line_v(
    &mut self,
    start: impl Into<Vector2>,
    end: impl Into<Vector2>,
    color: impl Into<Color>
)

Draw line within an image (Vector version)

pub fn draw_circle(
    &mut self,
    center_x: i32,
    center_y: i32,
    radius: i32,
    color: impl Into<Color>
)

Draw circle within an image

pub fn draw_circle_v(
    &mut self,
    center: impl Into<Vector2>,
    radius: i32,
    color: impl Into<Color>
)

Draw circle within an image (Vector version)

pub fn draw_rectangle(
    &mut self,
    pos_x: i32,
    pos_y: i32,
    width: i32,
    height: i32,
    color: impl Into<Color>
)

Draws a rectangle within an image.

pub fn draw_rectangle_lines(
    &mut self,
    rec: Rectangle,
    thickness: i32,
    color: impl Into<Color>
)

Draws a rectangle within an image.

pub fn draw_text(
    &mut self,
    text: &str,
    pos_x: i32,
    pos_y: i32,
    font_size: i32,
    color: impl Into<Color>
)

Draws text (default font) within an image (destination).

pub fn draw_text_ex(
    &mut self,
    font: impl AsRef<Font>,
    text: &str,
    position: impl Into<Vector2>,
    font_size: f32,
    spacing: f32,
    color: impl Into<Color>
)

Draws text (default font) within an image (destination).

pub fn flip_vertical(&mut self)

Flips image vertically.

pub fn flip_horizontal(&mut self)

Flips image horizontally.

pub fn rotate_cw(&mut self)

Rotates image clockwise by 90 degrees (PI/2 radians).

pub fn rotate_ccw(&mut self)

Rotates image counterclockwise by 90 degrees (PI/2 radians).

pub fn color_tint(&mut self, color: impl Into<Color>)

Tints colors in image using specified color.

pub fn color_invert(&mut self)

Inverts the colors in image.

pub fn color_grayscale(&mut self)

Converts `image color to grayscale.

pub fn color_contrast(&mut self, contrast: f32)

Adjusts the contrast of image.

pub fn color_brightness(&mut self, brightness: i32)

Adjusts the brightness of image.

pub fn color_replace(
    &mut self,
    color: impl Into<Color>,
    replace: impl Into<Color>
)

Searches image for all occurences of color and replaces them with replace color.

pub fn gen_image_color(
    width: i32,
    height: i32,
    color: impl Into<Color>
) -> Image

Generates a plain color Image.

pub fn gen_image_gradient_v(
    width: i32,
    height: i32,
    top: impl Into<Color>,
    bottom: impl Into<Color>
) -> Image

Generates an Image containing a vertical gradient.

pub fn gen_image_gradient_h(
    width: i32,
    height: i32,
    left: impl Into<Color>,
    right: impl Into<Color>
) -> Image

Generates an Image containing a horizonal gradient.

pub fn gen_image_gradient_radial(
    width: i32,
    height: i32,
    density: f32,
    inner: impl Into<Color>,
    outer: impl Into<Color>
) -> Image

Generates an Image containing a radial gradient.

pub fn gen_image_checked(
    width: i32,
    height: i32,
    checks_x: i32,
    checks_y: i32,
    col1: impl Into<Color>,
    col2: impl Into<Color>
) -> Image

Generates an Image containing a checkerboard pattern.

pub fn gen_image_white_noise(width: i32, height: i32, factor: f32) -> Image

Generates an Image containing white noise.

pub fn gen_image_perlin_noise(
    width: i32,
    height: i32,
    offset_x: i32,
    offset_y: i32,
    scale: f32
) -> Image

Generates an Image containing perlin noise.

pub fn gen_image_cellular(width: i32, height: i32, tile_size: i32) -> Image

Generates an Image using a cellular algorithm. Bigger tile_size means bigger cells.

pub fn load_image(filename: &str) -> Result<Image, String>

Loads image from file into CPU memory (RAM).

pub fn load_image_from_mem(
    filetype: &str,
    bytes: &Vec<u8>,
    size: i32
) -> Result<Image, String>

Loads image from a given memory buffer as a vector of arrays

pub fn load_image_raw(
    filename: &str,
    width: i32,
    height: i32,
    format: i32,
    header_size: i32
) -> Result<Image, String>

Loads image from RAW file data.

pub fn image_text(text: &str, font_size: i32, color: impl Into<Color>) -> Image

Creates an image from text (custom font).

pub fn image_text_ex(
    font: impl AsRef<Font>,
    text: &str,
    font_size: f32,
    spacing: f32,
    tint: impl Into<Color>
) -> Image

Creates an image from text (custom font).

Trait Implementations

impl AsMut<Image> for Image

fn as_mut(&mut self) -> &mut Image

Performs the conversion.

impl AsRef<Image> for Image

fn as_ref(&self) -> &Image

Performs the conversion.

impl Clone for Image

fn clone(&self) -> Image

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Image

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

Formats the value using the given formatter.

impl Deref for Image

type Target = Image

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Image

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for Image

fn drop(&mut self)

Executes the destructor for this type.