User Manual

Tiled Matrices

tiled

matrix is comprised of multiple smaller DotStar matrices. This is sometimes easier for assembly or for

distributing power. All of the sub-matrices need to be the same size, and must be ordered in a predictable manner. The

Adafruit_DotStarMatrix() constructor then receives some additional arguments:

The first two arguments are the width and height, in pixels, of each tiled sub-matrix, not the entire display.

The next two arguments are the number of tiles, in the horizontal and vertical direction. The dimensions of the overall

display then will always be a multiple of the sub-matrix dimensions.

The fifth and sixth arguments are the data and clock pin numbers, same as before and as with the DotStar library. The

last argument also follows prior behaviors, and in many cases can be left off.

The second-to-last argument though…this gets complicated…

With a single matrix, there was a starting corner, a major axis (rows or columns) and a line sequence (progressive or

zigzag). This is now doubled — similar information is needed both for the pixel order within the individual tiles, and the

overall arrangement of tiles in the display. As before, we add up a list of symbols to produce a single argument

describing the display format.

The DS_MATRIX_* symbols work the same as in the prior single-matrix case, and now refer to the individual sub-

matrices within the overall display. All tiles must follow the same format. An additional set of symbols work similarly to

then describe the tile order.

Adafruit_DotStarMatrix matrix = Adafruit_DotStarMatrix(

matrixWidth, matrixHeight, tilesX, tilesY,

dataPin, clockPin, matrixType, ledType);