Enum image::DynamicImage[][src]

pub enum DynamicImage {
    ImageLuma8(GrayImage),
    ImageLumaA8(GrayAlphaImage),
    ImageRgb8(RgbImage),
    ImageRgba8(RgbaImage),
    ImageBgr8(ImageBuffer<Bgr<u8>, Vec<u8>>),
    ImageBgra8(ImageBuffer<Bgra<u8>, Vec<u8>>),
    ImageLuma16(ImageBuffer<Luma<u16>, Vec<u16>>),
    ImageLumaA16(ImageBuffer<LumaA<u16>, Vec<u16>>),
    ImageRgb16(ImageBuffer<Rgb<u16>, Vec<u16>>),
    ImageRgba16(ImageBuffer<Rgba<u16>, Vec<u16>>),
}

A Dynamic Image

Variants

ImageLuma8(GrayImage)

Each pixel in this image is 8-bit Luma

ImageLumaA8(GrayAlphaImage)

Each pixel in this image is 8-bit Luma with alpha

ImageRgb8(RgbImage)

Each pixel in this image is 8-bit Rgb

ImageRgba8(RgbaImage)

Each pixel in this image is 8-bit Rgb with alpha

ImageBgr8(ImageBuffer<Bgr<u8>, Vec<u8>>)

Each pixel in this image is 8-bit Bgr

ImageBgra8(ImageBuffer<Bgra<u8>, Vec<u8>>)

Each pixel in this image is 8-bit Bgr with alpha

ImageLuma16(ImageBuffer<Luma<u16>, Vec<u16>>)

Each pixel in this image is 16-bit Luma

ImageLumaA16(ImageBuffer<LumaA<u16>, Vec<u16>>)

Each pixel in this image is 16-bit Luma with alpha

ImageRgb16(ImageBuffer<Rgb<u16>, Vec<u16>>)

Each pixel in this image is 16-bit Rgb

ImageRgba16(ImageBuffer<Rgba<u16>, Vec<u16>>)

Each pixel in this image is 16-bit Rgb with alpha

Implementations

impl DynamicImage[src]

pub fn new_luma8(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of grey pixels.

pub fn new_luma_a8(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of grey pixels with transparency.

pub fn new_rgb8(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of RGB pixels.

pub fn new_rgba8(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of RGBA pixels.

pub fn new_bgra8(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of BGRA pixels.

pub fn new_bgr8(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of BGR pixels.

pub fn new_luma16(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of grey pixels.

pub fn new_luma_a16(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of grey pixels with transparency.

pub fn new_rgb16(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of RGB pixels.

pub fn new_rgba16(w: u32, h: u32) -> DynamicImage[src]

Creates a dynamic image backed by a buffer of RGBA pixels.

pub fn from_decoder<'a>(decoder: impl ImageDecoder<'a>) -> ImageResult<Self>[src]

Decodes an encoded image into a dynamic image.

pub fn to_rgb(&self) -> RgbImage[src]

👎 Deprecated:

replaced by to_rgb8

Returns a copy of this image as an RGB image.

pub fn to_rgb8(&self) -> RgbImage[src]

Returns a copy of this image as an RGB image.

pub fn to_rgb16(&self) -> ImageBuffer<Rgb<u16>, Vec<u16>>[src]

Returns a copy of this image as an RGB image.

pub fn to_rgba(&self) -> RgbaImage[src]

👎 Deprecated:

replaced by to_rgba8

Returns a copy of this image as an RGBA image.

pub fn to_rgba8(&self) -> RgbaImage[src]

Returns a copy of this image as an RGBA image.

pub fn to_rgba16(&self) -> ImageBuffer<Rgba<u16>, Vec<u16>>[src]

Returns a copy of this image as an RGBA image.

pub fn to_bgr(&self) -> ImageBuffer<Bgr<u8>, Vec<u8>>[src]

👎 Deprecated:

replaced by to_bgr8

Returns a copy of this image as an BGR image.

pub fn to_bgr8(&self) -> ImageBuffer<Bgr<u8>, Vec<u8>>[src]

Returns a copy of this image as an BGR image.

pub fn to_bgra(&self) -> ImageBuffer<Bgra<u8>, Vec<u8>>[src]

👎 Deprecated:

replaced by to_bgra8

Returns a copy of this image as an BGRA image.

pub fn to_bgra8(&self) -> ImageBuffer<Bgra<u8>, Vec<u8>>[src]

Returns a copy of this image as an BGRA image.

pub fn to_luma(&self) -> GrayImage[src]

👎 Deprecated:

replaced by to_luma8

Returns a copy of this image as a Luma image.

pub fn to_luma8(&self) -> GrayImage[src]

Returns a copy of this image as a Luma image.

pub fn to_luma16(&self) -> ImageBuffer<Luma<u16>, Vec<u16>>[src]

Returns a copy of this image as a Luma image.

pub fn to_luma_alpha(&self) -> GrayAlphaImage[src]

👎 Deprecated:

replaced by to_luma_alpha8

Returns a copy of this image as a LumaA image.

pub fn to_luma_alpha8(&self) -> GrayAlphaImage[src]

Returns a copy of this image as a LumaA image.

pub fn to_luma_alpha16(&self) -> ImageBuffer<LumaA<u16>, Vec<u16>>[src]

Returns a copy of this image as a LumaA image.

pub fn into_rgb(self) -> RgbImage[src]

👎 Deprecated:

replaced by into_rgb8

Consume the image and returns a RGB image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_rgb8(self) -> RgbImage[src]

Consume the image and returns a RGB image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_rgb16(self) -> ImageBuffer<Rgb<u16>, Vec<u16>>[src]

Consume the image and returns a RGB image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_rgba(self) -> RgbaImage[src]

👎 Deprecated:

replaced by into_rgba8

Consume the image and returns a RGBA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_rgba8(self) -> RgbaImage[src]

Consume the image and returns a RGBA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_rgba16(self) -> ImageBuffer<Rgba<u16>, Vec<u16>>[src]

Consume the image and returns a RGBA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_bgr(self) -> ImageBuffer<Bgr<u8>, Vec<u8>>[src]

👎 Deprecated:

replaced by into_bgra8

Consume the image and returns a BGR image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_bgr8(self) -> ImageBuffer<Bgr<u8>, Vec<u8>>[src]

Consume the image and returns a BGR image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_bgra(self) -> ImageBuffer<Bgra<u8>, Vec<u8>>[src]

👎 Deprecated:

replaced by into_bgra8

Consume the image and returns a BGRA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_bgra8(self) -> ImageBuffer<Bgra<u8>, Vec<u8>>[src]

Consume the image and returns a BGRA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_luma(self) -> GrayImage[src]

👎 Deprecated:

replaced by into_luma8

Consume the image and returns a Luma image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_luma8(self) -> GrayImage[src]

Consume the image and returns a Luma image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_luma16(self) -> ImageBuffer<Luma<u16>, Vec<u16>>[src]

Consume the image and returns a Luma image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_luma_alpha(self) -> GrayAlphaImage[src]

👎 Deprecated:

replaced by into_luma_alpha8

Consume the image and returns a LumaA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_luma_alpha8(self) -> GrayAlphaImage[src]

Consume the image and returns a LumaA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn into_luma_alpha16(self) -> ImageBuffer<LumaA<u16>, Vec<u16>>[src]

Consume the image and returns a LumaA image.

If the image was already the correct format, it is returned as is. Otherwise, a copy is created.

pub fn crop(&mut self, x: u32, y: u32, width: u32, height: u32) -> DynamicImage[src]

Return a cut-out of this image delimited by the bounding rectangle.

Note: this method does not modify the object, and its signature will be replaced with crop_imm()’s in the 0.24 release

pub fn crop_imm(&self, x: u32, y: u32, width: u32, height: u32) -> DynamicImage[src]

Return a cut-out of this image delimited by the bounding rectangle.

pub fn as_rgb8(&self) -> Option<&RgbImage>[src]

Return a reference to an 8bit RGB image

pub fn as_mut_rgb8(&mut self) -> Option<&mut RgbImage>[src]

Return a mutable reference to an 8bit RGB image

pub fn as_bgr8(&self) -> Option<&ImageBuffer<Bgr<u8>, Vec<u8>>>[src]

Return a reference to an 8bit BGR image

pub fn as_mut_bgr8(&mut self) -> Option<&mut ImageBuffer<Bgr<u8>, Vec<u8>>>[src]

Return a mutable reference to an 8bit BGR image

pub fn as_rgba8(&self) -> Option<&RgbaImage>[src]

Return a reference to an 8bit RGBA image

pub fn as_mut_rgba8(&mut self) -> Option<&mut RgbaImage>[src]

Return a mutable reference to an 8bit RGBA image

pub fn as_bgra8(&self) -> Option<&ImageBuffer<Bgra<u8>, Vec<u8>>>[src]

Return a reference to an 8bit BGRA image

pub fn as_mut_bgra8(&mut self) -> Option<&mut ImageBuffer<Bgra<u8>, Vec<u8>>>[src]

Return a mutable reference to an 8bit RGBA image

pub fn as_luma8(&self) -> Option<&GrayImage>[src]

Return a reference to an 8bit Grayscale image

pub fn as_mut_luma8(&mut self) -> Option<&mut GrayImage>[src]

Return a mutable reference to an 8bit Grayscale image

pub fn as_luma_alpha8(&self) -> Option<&GrayAlphaImage>[src]

Return a reference to an 8bit Grayscale image with an alpha channel

pub fn as_mut_luma_alpha8(&mut self) -> Option<&mut GrayAlphaImage>[src]

Return a mutable reference to an 8bit Grayscale image with an alpha channel

pub fn as_rgb16(&self) -> Option<&ImageBuffer<Rgb<u16>, Vec<u16>>>[src]

Return a reference to an 16bit RGB image

pub fn as_mut_rgb16(&mut self) -> Option<&mut ImageBuffer<Rgb<u16>, Vec<u16>>>[src]

Return a mutable reference to an 16bit RGB image

pub fn as_rgba16(&self) -> Option<&ImageBuffer<Rgba<u16>, Vec<u16>>>[src]

Return a reference to an 16bit RGBA image

pub fn as_mut_rgba16(&mut self) -> Option<&mut ImageBuffer<Rgba<u16>, Vec<u16>>>[src]

Return a mutable reference to an 16bit RGBA image

pub fn as_luma16(&self) -> Option<&ImageBuffer<Luma<u16>, Vec<u16>>>[src]

Return a reference to an 16bit Grayscale image

pub fn as_mut_luma16(&mut self) -> Option<&mut ImageBuffer<Luma<u16>, Vec<u16>>>[src]

Return a mutable reference to an 16bit Grayscale image

pub fn as_luma_alpha16(&self) -> Option<&ImageBuffer<LumaA<u16>, Vec<u16>>>[src]

Return a reference to an 16bit Grayscale image with an alpha channel

pub fn as_mut_luma_alpha16(
    &mut self
) -> Option<&mut ImageBuffer<LumaA<u16>, Vec<u16>>>
[src]

Return a mutable reference to an 16bit Grayscale image with an alpha channel

pub fn as_flat_samples_u8(&self) -> Option<FlatSamples<&[u8]>>[src]

Return a view on the raw sample buffer for 8 bit per channel images.

pub fn as_flat_samples_u16(&self) -> Option<FlatSamples<&[u16]>>[src]

Return a view on the raw sample buffer for 16 bit per channel images.

pub fn as_bytes(&self) -> &[u8][src]

Return this image’s pixels as a native endian byte slice.

pub fn into_bytes(self) -> Vec<u8>[src]

Return this image’s pixels as a byte vector. If the ImageBuffer container is Vec<u8>, this operation is free. Otherwise, a copy is returned.

pub fn to_bytes(&self) -> Vec<u8>[src]

Return a copy of this image’s pixels as a byte vector.

pub fn color(&self) -> ColorType[src]

Return this image’s color type.

pub fn grayscale(&self) -> DynamicImage[src]

Return a grayscale version of this image.

pub fn invert(&mut self)[src]

Invert the colors of this image. This method operates inplace.

pub fn resize(
    &self,
    nwidth: u32,
    nheight: u32,
    filter: FilterType
) -> DynamicImage
[src]

Resize this image using the specified filter algorithm. Returns a new image. The image’s aspect ratio is preserved. The image is scaled to the maximum possible size that fits within the bounds specified by nwidth and nheight.

pub fn resize_exact(
    &self,
    nwidth: u32,
    nheight: u32,
    filter: FilterType
) -> DynamicImage
[src]

Resize this image using the specified filter algorithm. Returns a new image. Does not preserve aspect ratio. nwidth and nheight are the new image’s dimensions

pub fn thumbnail(&self, nwidth: u32, nheight: u32) -> DynamicImage[src]

Scale this image down to fit within a specific size. Returns a new image. The image’s aspect ratio is preserved. The image is scaled to the maximum possible size that fits within the bounds specified by nwidth and nheight.

This method uses a fast integer algorithm where each source pixel contributes to exactly one target pixel. May give aliasing artifacts if new size is close to old size.

pub fn thumbnail_exact(&self, nwidth: u32, nheight: u32) -> DynamicImage[src]

Scale this image down to a specific size. Returns a new image. Does not preserve aspect ratio. nwidth and nheight are the new image’s dimensions. This method uses a fast integer algorithm where each source pixel contributes to exactly one target pixel. May give aliasing artifacts if new size is close to old size.

pub fn resize_to_fill(
    &self,
    nwidth: u32,
    nheight: u32,
    filter: FilterType
) -> DynamicImage
[src]

Resize this image using the specified filter algorithm. Returns a new image. The image’s aspect ratio is preserved. The image is scaled to the maximum possible size that fits within the larger (relative to aspect ratio) of the bounds specified by nwidth and nheight, then cropped to fit within the other bound.

pub fn blur(&self, sigma: f32) -> DynamicImage[src]

Performs a Gaussian blur on this image. sigma is a measure of how much to blur by.

pub fn unsharpen(&self, sigma: f32, threshold: i32) -> DynamicImage[src]

Performs an unsharpen mask on this image. sigma is the amount to blur the image by. threshold is a control of how much to sharpen.

See https://en.wikipedia.org/wiki/Unsharp_masking#Digital_unsharp_masking

pub fn filter3x3(&self, kernel: &[f32]) -> DynamicImage[src]

Filters this image with the specified 3x3 kernel.

pub fn adjust_contrast(&self, c: f32) -> DynamicImage[src]

Adjust the contrast of this image. contrast is the amount to adjust the contrast by. Negative values decrease the contrast and positive values increase the contrast.

pub fn brighten(&self, value: i32) -> DynamicImage[src]

Brighten the pixels of this image. value is the amount to brighten each pixel by. Negative values decrease the brightness and positive values increase it.

pub fn huerotate(&self, value: i32) -> DynamicImage[src]

Hue rotate the supplied image. value is the degrees to rotate each pixel by. 0 and 360 do nothing, the rest rotates by the given degree value. just like the css webkit filter hue-rotate(180)

pub fn flipv(&self) -> DynamicImage[src]

Flip this image vertically

pub fn fliph(&self) -> DynamicImage[src]

Flip this image horizontally

pub fn rotate90(&self) -> DynamicImage[src]

Rotate this image 90 degrees clockwise.

pub fn rotate180(&self) -> DynamicImage[src]

Rotate this image 180 degrees clockwise.

pub fn rotate270(&self) -> DynamicImage[src]

Rotate this image 270 degrees clockwise.

pub fn write_to<W: Write, F: Into<ImageOutputFormat>>(
    &self,
    w: &mut W,
    format: F
) -> ImageResult<()>
[src]

Encode this image and write it to w

pub fn save<Q>(&self, path: Q) -> ImageResult<()> where
    Q: AsRef<Path>, 
[src]

Saves the buffer to a file at the path specified.

The image format is derived from the file extension.

pub fn save_with_format<Q>(
    &self,
    path: Q,
    format: ImageFormat
) -> ImageResult<()> where
    Q: AsRef<Path>, 
[src]

Saves the buffer to a file at the specified path in the specified format.

See save_buffer_with_format for supported types.

Trait Implementations

impl Clone for DynamicImage[src]

impl GenericImage for DynamicImage[src]

type InnerImage = DynamicImage

Underlying image type. This is mainly used by SubImages in order to always have a reference to the original image. This allows for less indirections and it eases the use of nested SubImages. Read more

fn blend_pixel(&mut self, x: u32, y: u32, pixel: Rgba<u8>)[src]

DEPRECATED: Use iterator pixels_mut to blend the pixels directly.

fn get_pixel_mut(&mut self, _: u32, _: u32) -> &mut Rgba<u8>[src]

DEPRECATED: Do not use is function: It is unimplemented!

impl GenericImageView for DynamicImage[src]

type Pixel = Rgba<u8>

The type of pixel.

type InnerImageView = Self

Underlying image type. This is mainly used by SubImages in order to always have a reference to the original image. This allows for less indirections and it eases the use of nested SubImages. Read more

Auto Trait Implementations

impl RefUnwindSafe for DynamicImage

impl Send for DynamicImage

impl Sync for DynamicImage

impl Unpin for DynamicImage

impl UnwindSafe for DynamicImage

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

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

The type returned in the event of a conversion error.