added a new bit layout mode for the RGB matrix

Author: michaelkamprath

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Added
 - Added support for the Arduino Zero and Due boards (and related)
 - Added method to LEDImage for drawing circles
+- Added a Red-Blue-Green bit layout mode for the RGB matrix object
 
 ## [1.0.1] - 2017-12-24
 ### Changed

README.md

@@ -71,8 +71,9 @@ A `TimerAction` object allows you to manage a variably timed action in a manner
 The basic pattern of usage is:
 
 1. Create a `LEDMatrix` or `RGBLEDMatrix` matrix object passing the appropriate arguments
-1. In the global `setup()` method, call the `setup()` method of the matrix object to initialize all fields. This call `startScanning()` on the matrix object to cause but to be transmitted to the shift registers in the matrix. 
-1. Draw to the `image()` object on the matrix object, but do call the `startDrawing()` matrix object method prior to any drawing, and balance the call with a call to `stopDrawing()` on the matrix object. These method prevent the image display on the matrix from being altered while you are drawing to it.
+1. In the global `setup()` method, call the `setup()` method of the matrix object to initialize all fields. Then call `startScanning()` on the matrix object to cause bits to be transmitted to the shift registers in the matrix. 
+1. Draw to the `image()` object on the matrix object, but do call the `startDrawing()` matrix object method prior to any drawing, and balance the call with a call to `stopDrawing()` on the matrix object. These method prevent the image display on the matrix's LEDs from being altered while you are drawing to to the image buffer.
+1. Call the matrix object's `loop()` method in the global `loop()` function.
 
 
 # Notes
@@ -124,6 +125,8 @@ This driver can support either 6-bit or 12-bit color. By default, this library u
 * Arduino Mega 2560
 * Wemos D1 mini Lite
 * NodeMCU
+* Arduino Zero
+* Arduino Due
 
 ### Bit Layouts
 This driver can support two different bit layouts for RGB LED matrices. The default bit layout assumes each RGB LED is a single unit and each column is wired up with the RGB bits consecutively.  That is, for a 4x4 matrix, the bit layout would look like this:

keywords.txt

@@ -68,3 +68,4 @@ YELLOW_COLOR		LITERAL1
 
 INDIVIDUAL_LEDS		LITERAL1
 RGB_GROUPS			LITERAL1
+RBG_GROUPS			LITERAL1

src/RGBLEDMatrix.cpp

@@ -207,6 +207,11 @@ void RGBLEDMatrix::setRowBitsForFrame(
 			greenBitOffset = this->columns();
 			blueBitOffset = 2*this->columns();
 			columnBitIdxIncrement = 1;
+		} else if (_bitLayout == RBG_GROUPS) {
+			redBitOffset = 0;
+			greenBitOffset = 2*this->columns();
+			blueBitOffset = this->columns();
+			columnBitIdxIncrement = 1;
 		}
 		for (unsigned int col = 0; col < this->columns(); col++) {
 			RGBColorType rgbValue = image.pixel(row, col);

src/RGBLEDMatrix.h

@@ -29,9 +29,15 @@ class RGBLEDMatrix : public BaseLEDMatrix {
 		INDIVIDUAL_LEDS,	
 
 		// All elements of the same color are consecutive in column order. The color
-		// are order Red, Green Blue
+		// are order Red, Green, Blue
 		// For a 4-column matrix, each row is ordered: RRRR-GGGG-BBBB
-		RGB_GROUPS
+		RGB_GROUPS,
+		
+		// All elements of the same color are consecutive in column order. The color
+		// are order Red, Blue, Green
+		// For a 4-column matrix, each row is ordered: RRRR-BBBB-GGGG
+		RBG_GROUPS
+			
 	} RGBLEDBitLayout;
 
 private: