Skip to main content

QuarterScan

Struct QuarterScan 

Source
pub struct QuarterScan<const PANEL_ROWS: usize, const PANEL_COLS: usize, V: Variant = SectionsSwapped> { /* private fields */ }
Expand description

Pixel remapper for “quarter-scan” panels (1/16-scan on 64×64 panels)

Some LED panels — particularly 64×64 modules — use fewer row-address steps than the row count would suggest. A 1/16-scan 64×64 panel has only 16 row addresses (A–D) instead of the 32 a 1/32-scan panel would use, and lights four rows at a time: rows n, n+16, n+32 and n+48 for address n. To make this work with the two HUB75 data channels, the panel internally wires each channel’s shift register as two side-by-side 64-column sections, so the physical framebuffer is 2× wider and 2× shorter than the logical display (32×128 for a 64×64 panel).

The mapping splits the panel into four groups of PANEL_ROWS / 4 consecutive rows and places them side by side. How the four groups are wired to the four (channel, section) slots varies by driver chip and manufacturer (FM6126, ICN2037, MBI5153, etc.); the V type parameter selects the wiring — see the quarter_scan module for the built-in variants. The default quarter_scan::SectionsSwapped (verified on hardware) maps:

virtual rowschannelsection (framebuffer columns)
0..161 (top)1 (64..128)
16..321 (top)0 (0..64)
32..482 (bottom)1 (64..128)
48..642 (bottom)0 (0..64)

§Type Parameters

  • PANEL_ROWS — Logical row count of the panel (e.g. 64)
  • PANEL_COLS — Logical column count of the panel (e.g. 64)
  • V — Group → slot wiring variant (see quarter_scan); defaults to quarter_scan::SectionsSwapped

§Framebuffer geometry

The underlying framebuffer must be allocated with:

  • rows = PANEL_ROWS / 2 (e.g. 32 for a 64-row panel — 16 addresses × 2 channels)
  • cols = PANEL_COLS * 2 (e.g. 128 for a 64-column panel — 2 sections per channel)

For the bitplane framebuffers this means DmaFrameBuffer<{ PANEL_ROWS / 4 }, { PANEL_COLS * 2 }, PLANES> because their NROWS parameter counts row-address steps (row pairs).

Trait Implementations§

Source§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V: Debug + Variant> Debug for QuarterScan<PANEL_ROWS, PANEL_COLS, V>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V: Variant> PixelRemapper for QuarterScan<PANEL_ROWS, PANEL_COLS, V>

Source§

const VIRT_ROWS: usize = PANEL_ROWS

Number of rows in the virtual panel
Source§

const VIRT_COLS: usize = PANEL_COLS

Number of columns in the virtual panel
Source§

const FB_ROWS: usize

Number of rows in the actual framebuffer
Source§

const FB_COLS: usize

Number of columns in the actual framebuffer
Source§

fn remap_xy(x: usize, y: usize) -> (usize, usize)

Remap an x,y coordinate to a framebuffer pixel
Source§

fn remap<C: PixelColor>(pixel: Pixel<C>) -> Pixel<C>

Remap a virtual pixel to a framebuffer pixel
Source§

fn remap_point(point: Point) -> Point

Remap a virtual point to a framebuffer point
Source§

fn virtual_size() -> (usize, usize)

Size of the virtual panel
Source§

fn fb_size() -> (usize, usize)

Size of the framebuffer that this remaps to

Auto Trait Implementations§

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> Freeze for QuarterScan<PANEL_ROWS, PANEL_COLS, V>
where PhantomData<V>: Freeze,

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> RefUnwindSafe for QuarterScan<PANEL_ROWS, PANEL_COLS, V>

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> Send for QuarterScan<PANEL_ROWS, PANEL_COLS, V>
where PhantomData<V>: Send,

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> Sync for QuarterScan<PANEL_ROWS, PANEL_COLS, V>
where PhantomData<V>: Sync,

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> Unpin for QuarterScan<PANEL_ROWS, PANEL_COLS, V>
where PhantomData<V>: Unpin,

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> UnsafeUnpin for QuarterScan<PANEL_ROWS, PANEL_COLS, V>

§

impl<const PANEL_ROWS: usize, const PANEL_COLS: usize, V> UnwindSafe for QuarterScan<PANEL_ROWS, PANEL_COLS, V>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Az for T

Source§

fn az<Dst>(self) -> Dst
where T: Cast<Dst>,

Casts the value.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<Src, Dst> CastFrom<Src> for Dst
where Src: Cast<Dst>,

Source§

fn cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> CheckedAs for T

Source§

fn checked_as<Dst>(self) -> Option<Dst>
where T: CheckedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> CheckedCastFrom<Src> for Dst
where Src: CheckedCast<Dst>,

Source§

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> OverflowingAs for T

Source§

fn overflowing_as<Dst>(self) -> (Dst, bool)
where T: OverflowingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> OverflowingCastFrom<Src> for Dst
where Src: OverflowingCast<Dst>,

Source§

fn overflowing_cast_from(src: Src) -> (Dst, bool)

Casts the value.
Source§

impl<T> SaturatingAs for T

Source§

fn saturating_as<Dst>(self) -> Dst
where T: SaturatingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> SaturatingCastFrom<Src> for Dst
where Src: SaturatingCast<Dst>,

Source§

fn saturating_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

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

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> UnwrappedAs for T

Source§

fn unwrapped_as<Dst>(self) -> Dst
where T: UnwrappedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst
where Src: UnwrappedCast<Dst>,

Source§

fn unwrapped_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> WrappingAs for T

Source§

fn wrapping_as<Dst>(self) -> Dst
where T: WrappingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> WrappingCastFrom<Src> for Dst
where Src: WrappingCast<Dst>,

Source§

fn wrapping_cast_from(src: Src) -> Dst

Casts the value.