//! Manages the affine image transformations. use crate::Image; impl Image, CHANNELS> { /// Flip a image horizontally. pub fn flip_h(&mut self) { self.as_mut().flip_h(); } /// Flip a image vertically. pub fn flip_v(&mut self) { self.as_mut().flip_v(); } } impl Image<&mut [u8], CHANNELS> { /// Flip a image vertically. pub fn flip_v(&mut self) { for y in 0..self.height() / 2 { for x in 0..self.width() { let y2 = self.height() - y - 1; #[allow(clippy::multiple_unsafe_ops_per_block)] // SAFETY: within bounds unsafe { let p2 = self.pixel(x, y2); let p = self.pixel(x, y); self.set_pixel(x, y2, p); self.set_pixel(x, y, p2); } } } } /// Flip a image horizontally. pub fn flip_h(&mut self) { for y in 0..self.height() { for x in 0..self.width() / 2 { let x2 = self.width() - x - 1; #[allow(clippy::multiple_unsafe_ops_per_block)] // SAFETY: bounded unsafe { let p2 = self.pixel(x2, y); let p = self.pixel(x, y); self.set_pixel(x2, y, p); self.set_pixel(x, y, p2); } } } } } impl Image, CHANNELS> { /// Rotate a image 180 degrees clockwise. pub fn rot_180(&mut self) { self.as_mut().rot_180(); } /// Rotate a image 90 degrees clockwise. /// # Safety /// /// UB if the image is not square pub unsafe fn rot_90(&mut self) { // SAFETY: make sure to keep the safety docs linked unsafe { self.as_mut().rot_90() } } /// Rotate a image 270 degrees clockwise, or 90 degrees anti clockwise. /// # Safety /// /// UB if the image is not square pub unsafe fn rot_270(&mut self) { // SAFETY: idk this is just a convenience impl unsafe { self.as_mut().rot_270() } } } impl Image<&mut [u8], CHANNELS> { /// Rotate a image 180 degrees clockwise. pub fn rot_180(&mut self) { for y in 0..self.height() / 2 { for x in 0..self.width() { // SAFETY: x, y come from the loop, must be ok let p = unsafe { self.pixel(x, y) }; let x2 = self.width() - x - 1; let y2 = self.height() - y - 1; // SAFETY: values are good let p2 = unsafe { self.pixel(x2, y2) }; // SAFETY: swapping would be cool, alas. unsafe { self.set_pixel(x, y, p2) }; // SAFETY: although maybe i can cast it to a `[[u8; CHANNELS]]` and swap that 🤔 unsafe { self.set_pixel(x2, y2, p) }; } } if self.height() % 2 != 0 { let middle = self.height() / 2; for x in 0..self.width() / 2 { let x2 = self.width() - x - 1; #[allow(clippy::multiple_unsafe_ops_per_block)] // SAFETY: its just doing the swappy unsafe { let p = self.pixel(x, middle); let p2 = self.pixel(x2, middle); self.set_pixel(x, middle, p2); self.set_pixel(x2, middle, p); } } } } /// Rotate a image 90 degrees clockwise. /// # Safety /// /// UB if the image is not square #[inline] pub unsafe fn rot_90(&mut self) { // This is done by first flipping self.flip_v(); // Then transposing the image, as to not allocate. // SAFETY: caller ensures square unsafe { transpose(self) }; } /// Rotate a image 270 degrees clockwise, or 90 degrees anti clockwise. /// # Safety /// /// UB if the image is not square #[inline] pub unsafe fn rot_270(&mut self) { self.flip_h(); // SAFETY: caller ensures squareness unsafe { transpose(self) }; } } /// Transpose a square image /// # Safety /// /// UB if supplied image rectangular unsafe fn transpose(img: &mut Image<&mut [u8], CHANNELS>) { debug_assert_eq!(img.width(), img.height()); let size = img.width() as usize; // SAFETY: no half pixels let b = unsafe { img.buffer.as_chunks_unchecked_mut::() }; for i in 0..size { for j in i..size { // SAFETY: caller ensures squarity unsafe { b.swap_unchecked(i * size + j, j * size + i); }; } } } #[cfg(test)] mod tests { use super::*; use crate::img; #[test] fn rotate_90() { let mut from = img![ [00, 01] [02, 10] ]; unsafe { from.rot_90() }; assert_eq!( from, img![ [02, 00] [10, 01] ] ); } #[test] fn rotate_180() { let mut from = img![ [00, 01] [02, 10] ]; from.rot_180(); assert_eq!( from, img![ [10, 02] [01, 00] ] ); } #[test] fn rotate_270() { let mut from = img![ [00, 01] [20, 10] ]; unsafe { from.rot_270() }; assert_eq!( from, img![ [01, 10] [00, 20] ] ); } #[test] fn flip_vertical() { let mut from = img![ [90, 01] [21, 42] ]; from.flip_v(); assert_eq!( from, img![ [21, 42] [90, 01] ] ); } #[test] fn flip_horizontal() { let mut from = img![ [90, 01] [21, 42] ]; from.flip_h(); assert_eq!( from, img![ [01, 90] [42, 21] ] ); } }