MaxMatrix
Drive chained 8x8 LED dot matrix modules with MAX7219.
Loading...
Searching...
No Matches
Panel.h File Reference

The matrix as the viewer sees it. More...

#include "Arduino.h"
#include "MaxMatrixAttributes.h"
#include "MaxMatrixConfig.h"
#include "MaxMatrixError.h"
#include "Utility/Byte.h"
#include "Utility/span.h"
#include "Wired.h"

Go to the source code of this file.

Classes

class  max_matrix::internal::Panel
 The matrix as the viewer sees it: columns, rows and dots in the viewer's coordinates. More...

Enumerations

enum class  max_matrix::MatrixOrientation : uint8_t { k0 , k180 }
 How the whole matrix is turned: by 180 degrees for a board mounted upside down. More...
enum class  max_matrix::ModuleType : uint8_t {
  kDr0Cr0Rr0 = 0 , kDr0Cr0Rr1 = 1 , kDr0Cr1Rr0 = 2 , kDr0Cr1Rr1 = 3 ,
  kDr1Cr0Rr0 = 4 , kDr1Cr0Rr1 = 5 , kDr1Cr1Rr0 = 6 , kDr1Cr1Rr1 = 7 ,
  kGeneric = kDr0Cr1Rr0 , kFc16 , kParola = kDr1Cr1Rr0 , kIcstation = kDr1Cr1Rr1
}
 How the LEDs of a module are wired to its MAX7219, named as MD_MAX72XX names its hardware types. More...
enum class  max_matrix::ShiftFill : uint8_t { kZero , kRotate , kKeep }
 What comes in at the edge a shift leaves empty. More...

Variables

constexpr uint8_t max_matrix::internal::kModuleTypeDigitsAsRows {0x04}
constexpr uint8_t max_matrix::internal::kModuleTypeReversedColumns {0x02}
constexpr uint8_t max_matrix::internal::kModuleTypeReversedRows {0x01}

Detailed Description

The matrix as the viewer sees it.

Columns, rows and dots in the viewer's coordinates, on top of the matrix as it is wired. Drawing only changes the buffer; Matrix decides when it is sent.

Enumeration Type Documentation

◆ MatrixOrientation

enum class max_matrix::MatrixOrientation : uint8_t
strong

How the whole matrix is turned: by 180 degrees for a board mounted upside down.

Enumerator
k0 

The board as it is meant to be mounted.

k180 

The board upside down: the module at the input on the left.

◆ ModuleType

enum class max_matrix::ModuleType : uint8_t
strong

How the LEDs of a module are wired to its MAX7219, named as MD_MAX72XX names its hardware types.

Three properties tell the eight wirings apart, seen with the module's input on the right, its columns counted from the right and its rows from the top: DR1 if a digit register drives a row of LEDs and its bits the columns, DR0 if a digit drives a column; CR1 if the bits run the other way, bit 7 - n for n; RR1 if the digits do, digit 7 - n for n. Four of the eight have a name of their own. Four are mirror images of the others, Parola among them. The value holds the three properties as bits: DR in bit 2, CR in bit 1, RR in bit 0.

Enumerator
kDr0Cr0Rr0 

Digits as columns.

kDr0Cr0Rr1 

Digits as columns, in reverse; the buffer is the picture as the viewer sees it.

kDr0Cr1Rr0 

Digits as columns, their bits in reverse.

kDr0Cr1Rr1 

Digits as columns, both in reverse.

kDr1Cr0Rr0 

Digits as rows.

kDr1Cr0Rr1 

Digits as rows, in reverse.

kDr1Cr1Rr0 

Digits as rows, their bits in reverse.

kDr1Cr1Rr1 

Digits as rows, both in reverse.

kGeneric 

The generic modules, often with the MAX7219 in a DIP package (GENERIC_HW).

kFc16 

FC-16, the common boards of four modules (FC16_HW).

kParola 

The Parola modules (PAROLA_HW).

kIcstation 

The ICStation modules (ICSTATION_HW).

◆ ShiftFill

enum class max_matrix::ShiftFill : uint8_t
strong

What comes in at the edge a shift leaves empty.

Enumerator
kZero 

Every LED of the new column or row off.

kRotate 

The column or row that falls out at the other edge.

kKeep 

The column or row keeps what it held.

Variable Documentation

◆ kModuleTypeDigitsAsRows

uint8_t max_matrix::internal::kModuleTypeDigitsAsRows {0x04}
constexpr

DR1 of MD_MAX72XX's names: the digits of the MAX7219 are the rows.

◆ kModuleTypeReversedColumns

uint8_t max_matrix::internal::kModuleTypeReversedColumns {0x02}
constexpr

CR1 of MD_MAX72XX's names: the columns in reverse order.

◆ kModuleTypeReversedRows

uint8_t max_matrix::internal::kModuleTypeReversedRows {0x01}
constexpr

RR1 of MD_MAX72XX's names: the rows in reverse order.