pub struct SubImage<I> {
inner: SubImageInner<I>,
}
Expand description
A View into another image
Instances of this struct can be created using:
GenericImage::sub_image
to create a mutable view,GenericImageView::view
to create an immutable view,SubImage::new
to instantiate the struct directly.
Note that this does not implement GenericImage
, but it dereferences to one which allows you
to use it as if it did. See Design Considerations below for details.
§Design Considerations
For reasons relating to coherence, this is not itself a GenericImage
or a GenericImageView
.
In short, we want to reserve the ability of adding traits implemented for all generic images
but in a different manner for SubImage
. This may be required to ensure that stacking
sub-images comes at no double indirect cost.
If, ultimately, this is not needed then a directly implementation of GenericImage
can and
will get added. This inconvenience may alternatively get resolved if Rust allows some forms of
specialization, which might make this trick unnecessary and thus also allows for a direct
implementation.
Fields§
§inner: SubImageInner<I>
Implementations§
source§impl<I> SubImage<I>
impl<I> SubImage<I>
sourcepub fn new(image: I, x: u32, y: u32, width: u32, height: u32) -> SubImage<I>
pub fn new(image: I, x: u32, y: u32, width: u32, height: u32) -> SubImage<I>
Construct a new subimage The coordinates set the position of the top left corner of the SubImage.
sourcepub fn change_bounds(&mut self, x: u32, y: u32, width: u32, height: u32)
pub fn change_bounds(&mut self, x: u32, y: u32, width: u32, height: u32)
Change the coordinates of this subimage.
sourcepub fn offsets(&self) -> (u32, u32)
pub fn offsets(&self) -> (u32, u32)
The offsets of this subimage relative to the underlying image.
sourcepub fn to_image(
&self,
) -> ImageBuffer<<<I as Deref>::Target as GenericImageView>::Pixel, Vec<<<<I as Deref>::Target as GenericImageView>::Pixel as Pixel>::Subpixel>>
pub fn to_image( &self, ) -> ImageBuffer<<<I as Deref>::Target as GenericImageView>::Pixel, Vec<<<<I as Deref>::Target as GenericImageView>::Pixel as Pixel>::Subpixel>>
Convert this subimage to an ImageBuffer
source§impl<I> SubImage<I>
impl<I> SubImage<I>
Methods for readable images.
sourcepub fn view(
&self,
x: u32,
y: u32,
width: u32,
height: u32,
) -> SubImage<&I::Target>
pub fn view( &self, x: u32, y: u32, width: u32, height: u32, ) -> SubImage<&I::Target>
Create a sub-view of the image.
The coordinates given are relative to the current view on the underlying image.
Note that this method is preferred to the one from GenericImageView
. This is accessible
with the explicit method call syntax but it should rarely be needed due to causing an
extra level of indirection.
use image::{GenericImageView, RgbImage, SubImage};
let buffer = RgbImage::new(10, 10);
let subimage: SubImage<&RgbImage> = buffer.view(0, 0, 10, 10);
let subview: SubImage<&RgbImage> = subimage.view(0, 0, 10, 10);
// Less efficient and NOT &RgbImage
let _: SubImage<&_> = GenericImageView::view(&*subimage, 0, 0, 10, 10);
Trait Implementations§
impl<I: Copy> Copy for SubImage<I>
Auto Trait Implementations§
impl<I> Freeze for SubImage<I>where
I: Freeze,
impl<I> RefUnwindSafe for SubImage<I>where
I: RefUnwindSafe,
impl<I> Send for SubImage<I>where
I: Send,
impl<I> Sync for SubImage<I>where
I: Sync,
impl<I> Unpin for SubImage<I>where
I: Unpin,
impl<I> UnwindSafe for SubImage<I>where
I: UnwindSafe,
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§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)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