add support for non-square pixels

Author: Kezii

CHANGELOG.md

@@ -6,6 +6,10 @@
 
 ## [Unreleased] - ReleaseDate
 
+### Added
+
+- Added support for non-square pixels
+
 ## [0.8.0] - 2025-10-10
 
 ### Added

src/display.rs

@@ -102,8 +102,15 @@ impl<C: PixelColor> SimulatorDisplay<C> {
     /// [`pixel_spacing`](OutputSettings::pixel_spacing) settings to determine
     /// the size of this display in output pixels.
     pub fn output_size(&self, output_settings: &OutputSettings) -> Size {
-        self.size * output_settings.scale
-            + self.size.saturating_sub(Size::new_equal(1)) * output_settings.pixel_spacing
+        let width = self.size.width.saturating_mul(output_settings.scale.width)
+            + self.size.width.saturating_sub(1) * output_settings.pixel_spacing;
+        let height = self
+            .size
+            .height
+            .saturating_mul(output_settings.scale.height)
+            + self.size.height.saturating_sub(1) * output_settings.pixel_spacing;
+
+        Size::new(width, height)
     }
 }
 

src/output_image.rs

@@ -64,7 +64,7 @@ where
         )
         .unwrap();
 
-        if output_settings.scale == 1 {
+        if output_settings.scale == Size::new(1, 1) && output_settings.pixel_spacing == 0 {
             display
                 .bounding_box()
                 .points()
@@ -78,16 +78,19 @@ where
                 .draw(self)
                 .unwrap();
         } else {
-            let pixel_pitch = (output_settings.scale + output_settings.pixel_spacing) as i32;
-            let pixel_size = Size::new(output_settings.scale, output_settings.scale);
+            let pitch_x = (output_settings.scale.width + output_settings.pixel_spacing) as i32;
+            let pitch_y = (output_settings.scale.height + output_settings.pixel_spacing) as i32;
 
             for p in display.bounding_box().points() {
                 let raw_color = display.get_pixel(p).into();
                 let themed_color = output_settings.theme.convert(raw_color);
                 let output_color = C::from(themed_color);
 
                 self.fill_solid(
-                    &Rectangle::new(p * pixel_pitch + position, pixel_size),
+                    &Rectangle::new(
+                        Point::new(p.x * pitch_x, p.y * pitch_y) + position,
+                        output_settings.scale,
+                    ),
                     output_color,
                 )
                 .unwrap();

src/output_settings.rs

@@ -4,8 +4,8 @@ use embedded_graphics::prelude::*;
 /// Output settings.
 #[derive(Debug, PartialEq, Eq, Clone, Copy)]
 pub struct OutputSettings {
-    /// Pixel scale.
-    pub scale: u32,
+    /// Pixel scale, allowing for non-square pixels.
+    pub scale: Size,
     /// Spacing between pixels.
     pub pixel_spacing: u32,
     /// Binary color theme.
@@ -16,12 +16,15 @@ pub struct OutputSettings {
 impl OutputSettings {
     /// Translates a output coordinate to the corresponding display coordinate.
     pub(crate) const fn output_to_display(&self, output_point: Point) -> Point {
-        let pitch = self.pixel_pitch() as i32;
-        Point::new(output_point.x / pitch, output_point.y / pitch)
+        let pitch = self.pixel_pitch();
+        Point::new(output_point.x / pitch.x, output_point.y / pitch.y)
     }
 
-    pub(crate) const fn pixel_pitch(&self) -> u32 {
-        self.scale + self.pixel_spacing
+    pub(crate) const fn pixel_pitch(&self) -> Point {
+        Point::new(
+            (self.scale.width + self.pixel_spacing) as i32,
+            (self.scale.height + self.pixel_spacing) as i32,
+        )
     }
 }
 
@@ -34,7 +37,7 @@ impl Default for OutputSettings {
 /// Output settings builder.
 #[derive(Default)]
 pub struct OutputSettingsBuilder {
-    scale: Option<u32>,
+    scale: Option<Size>,
     pixel_spacing: Option<u32>,
     theme: BinaryColorTheme,
 }
@@ -55,7 +58,7 @@ impl OutputSettingsBuilder {
     pub fn scale(mut self, scale: u32) -> Self {
         assert!(scale > 0, "scale must be > 0");
 
-        self.scale = Some(scale);
+        self.scale = Some(Size::new(scale, scale));
 
         self
     }
@@ -77,7 +80,7 @@ impl OutputSettingsBuilder {
     pub fn theme(mut self, theme: BinaryColorTheme) -> Self {
         self.theme = theme;
 
-        self.scale.get_or_insert(3);
+        self.scale.get_or_insert(Size::new(3, 3));
         self.pixel_spacing.get_or_insert(1);
 
         self
@@ -94,10 +97,25 @@ impl OutputSettingsBuilder {
         self
     }
 
+    /// Sets the pixel scale to a non-square value. This is useful for displaying
+    /// non-square pixels.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `width` or `height` is `0`.
+    pub fn scale_non_square(mut self, width: u32, height: u32) -> Self {
+        assert!(width > 0, "width must be > 0");
+        assert!(height > 0, "height must be > 0");
+
+        self.scale = Some(Size::new(width, height));
+
+        self
+    }
+
     /// Builds the output settings.
     pub fn build(self) -> OutputSettings {
         OutputSettings {
-            scale: self.scale.unwrap_or(1),
+            scale: self.scale.unwrap_or(Size::new(1, 1)),
             pixel_spacing: self.pixel_spacing.unwrap_or(0),
             theme: self.theme,
         }