Libraries \ Matrix

Reference for Wiring version 1.0 Build 0100+ If you have a previous version, use the reference included with your software. If see any errors or have any comments, let us know.

Class

Matrix

Name

write()

Examples
#include "Binary.h"
#include "Sprite.h"
#include "Matrix.h"

Matrix myMatrix = Matrix(0, 2, 1);

void setup()
{

}

void loop()
{
  myMatrix.clear(); // clear display

  delay(1000);

  // turn some pixels on
  myMatrix.write(1, 5, HIGH);
  myMatrix.write(2, 2, HIGH);
  myMatrix.write(2, 6, HIGH);
  myMatrix.write(3, 6, HIGH);
  myMatrix.write(4, 6, HIGH);
  myMatrix.write(5, 2, HIGH);
  myMatrix.write(5, 6, HIGH);
  myMatrix.write(6, 5, HIGH);

  delay(1000);
}

#include "Binary.h"
#include "Sprite.h"
#include "Matrix.h"

Matrix myMatrix = Matrix(0, 2, 1);

/* create a new Sprite instance
   8 pixels wide, 4 pixels tall
*/
Sprite wave = Sprite(
  8, 4,
  B00011000,
  B00100100,
  B01000010,
  B10000001
);

void setup()
{ 

}

int x = 0;

void loop()
{
  myMatrix.write(x, 2, wave);     // place sprite on screen
  myMatrix.write(x - 8, 2, wave); // place sprite again, elsewhere on screen
  delay(75);                      // wait a little bit
  myMatrix.clear();               // clear the screen for next animation frame
  if (x == 8)                      // if reached end of animation sequence
  {
    x = 0;                        // start from beginning
  }
  x++;                            // advance x coordinate to the right
}
Description The write(x, y, value) method is used to set individual pixels on or off. Pixel locations are specified in x, y coordinates and the state of a pixel can be HIGH or LOW. The write(x, y, sprite) method is used to write the pixel data tored on sprite, this is very useful when creating animations.
Syntax
matrix.write(x, y, value)
matrix.write(x, y, sprite)
Parameters
x The x position
y The y position
value The value for the selected pixel, it can be either HIGH or LOW
sprite An Sprite object storing pixel data on it
matrix The Matrix object
Returns None
Usage Application
Updated on July 07, 2011 11:10:43pm PDT

Creative Commons License