Remarks
LedMatrix8x16Wing | |
---|---|
Status | |
Source code | GitHub |
NuGet package |
Code Example
LedMatrix8x16Wing ledMatrixWing;
MicroGraphics graphics;
public override Task Initialize()
{
Console.WriteLine("Initializing ..");
ledMatrixWing = new LedMatrix8x16Wing(Device.CreateI2cBus());
ledMatrixWing.Clear();
graphics = new MicroGraphics(ledMatrixWing)
{
Rotation = RotationType._90Degrees,
CurrentFont = new Font4x8()
};
return Task.CompletedTask;
}
public override Task Run()
{
graphics.Clear();
graphics.DrawText(0, 0, "M F7");
graphics.Show();
return Task.CompletedTask;
}
Sample project(s) available on GitHub
Characteristic | Locus |
---|---|
Inheritance | System.Object > LedMatrix8x16Wing |
Implements | IGraphicsDisplay |
Namespace | Meadow.Foundation.FeatherWings |
Assembly | LedMatrix8x16Wing.dll |
Syntax
public class LedMatrix8x16Wing : IPixelBuffer, IGraphicsDisplay
Constructors
LedMatrix8x16Wing(II2cBus, Byte)
Creates a LedMatrix8x16Wing driver
Declaration
public LedMatrix8x16Wing(II2cBus i2cBus, byte address = null)
Parameters
Type | Name | Description |
---|---|---|
II2cBus | i2cBus | The I2CBus used by the CharlieWing |
System.Byte | address | The I2C address |
Properties
BitDepth
The bit depth of the display
Declaration
public int BitDepth { get; }
Property Value
Type | Description |
---|---|
System.Int32 |
Buffer
The backing buffer for the pixel buffer (not implemented)
Declaration
public byte[] Buffer { get; }
Property Value
Type | Description |
---|---|
System.Byte[] |
ByteCount
The total bytes used for the display buffer
Declaration
public int ByteCount { get; }
Property Value
Type | Description |
---|---|
System.Int32 |
ColorMode
Returns the color mode
Declaration
public ColorMode ColorMode { get; }
Property Value
Type | Description |
---|---|
ColorMode |
Height
Returns the height of the RGB LED matrix
Declaration
public int Height { get; }
Property Value
Type | Description |
---|---|
System.Int32 |
IgnoreOutOfBoundsPixels
Gets/Sets property to ignore boundaries when drawing outside of the LED matrix
Declaration
public bool IgnoreOutOfBoundsPixels { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
PixelBuffer
The pixel buffer that represents the offscreen buffer Not implemented for this driver
Declaration
public IPixelBuffer PixelBuffer { get; }
Property Value
Type | Description |
---|---|
IPixelBuffer |
SupportedColorModes
Color modes supported by the device
Declaration
public ColorMode SupportedColorModes { get; }
Property Value
Type | Description |
---|---|
ColorMode |
Width
Returns the width of the RGB LED matrix
Declaration
public int Width { get; }
Property Value
Type | Description |
---|---|
System.Int32 |
Methods
Clear()
Clear the RGB LED Matrix offscreen buffer
Declaration
public void Clear()
Clear(Boolean)
Clear the RGB LED Matrix offscreen buffer
Declaration
public void Clear(bool updateDisplay = false)
Parameters
Type | Name | Description |
---|---|---|
System.Boolean | updateDisplay | Force a display update if true, false to clear the buffer |
DrawPixel(Int32, Int32, Color)
Turn on an RGB LED with the specified color on (x,y) coordinates
Declaration
public void DrawPixel(int x, int y, Color color)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels 0 indexed from the left |
System.Int32 | y | The y position in pixels 0 indexed from the top |
Color | color | The color to draw normalized to black/off or white/on |
DrawPixel(Int32, Int32, Boolean)
Turn on a LED on (x,y) coordinates
Declaration
public void DrawPixel(int x, int y, bool colored)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels 0 indexed from the left |
System.Int32 | y | The y position in pixels 0 indexed from the top |
System.Boolean | colored | Led is on if true, off if false |
Fill(Color)
Fill the display with a normalized color to on/off
Declaration
public void Fill(Color color)
Parameters
Type | Name | Description |
---|---|---|
Color | color | The color to fill |
Fill(Color, Boolean)
Fill the display buffer to a normalized color
Declaration
public void Fill(Color fillColor, bool updateDisplay = false)
Parameters
Type | Name | Description |
---|---|---|
Color | fillColor | The clear color which will be normalized to black/off or white/on |
System.Boolean | updateDisplay | Force a display update if true, false to clear the buffer |
Fill(Int32, Int32, Int32, Int32, Color)
Fill the display
Declaration
public void Fill(int x, int y, int width, int height, Color fillColor)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels 0 indexed from the left |
System.Int32 | y | The y position in pixels 0 indexed from the top |
System.Int32 | width | The width to fill in pixels |
System.Int32 | height | The height to fill in pixels |
Color | fillColor | The fillColor color which will be normalized to black/off or white/on |
GetPixel(Int32, Int32)
Get the Color of the pixel at a location (not implemented)
Declaration
public Color GetPixel(int x, int y)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels |
System.Int32 | y | The y position in pixels |
Returns
Type | Description |
---|---|
Color | The pixel color |
InvertPixel(Int32, Int32)
Invert the color of the pixel at the given location
Declaration
public void InvertPixel(int x, int y)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels 0 indexed from the left |
System.Int32 | y | The y position in pixels 0 indexed from the top |
SetPixel(Int32, Int32, Color)
Set a pixel at a specific location
Declaration
public void SetPixel(int x, int y, Color color)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels |
System.Int32 | y | The y position in pixels |
Color | color | The pixel color normalized to on/off |
Show()
Show changes on the display
Declaration
public void Show()
Show(Int32, Int32, Int32, Int32)
Update a region of the display from the offscreen buffer Currently always redraws the entire display
Declaration
public void Show(int left, int top, int right, int bottom)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | left | The left bounding position in pixels |
System.Int32 | top | The top bounding position in pixels |
System.Int32 | right | The right bounding position in pixels |
System.Int32 | bottom | The bottom bounding position in pixels |
WriteBuffer(Int32, Int32, IPixelBuffer)
Draw a buffer to the display
Declaration
public void WriteBuffer(int x, int y, IPixelBuffer displayBuffer)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | x | The x position in pixels 0 indexed from the left |
System.Int32 | y | The y position in pixels 0 indexed from the top |
IPixelBuffer | displayBuffer | The display buffer to draw to the display |