Initial Clock Format

rpi-rgb-led-matrix-master/bindings/c#/RGBLedCanvas.cs

@@ -0,0 +1,100 @@
+namespace RPiRgbLEDMatrix;
+
+/// <summary>
+/// Represents a canvas whose pixels can be manipulated.
+/// </summary>
+public class RGBLedCanvas
+{
+    // This is a wrapper for canvas no need to implement IDisposable here 
+    // because RGBLedMatrix has ownership and takes care of disposing canvases
+    internal IntPtr _canvas;
+
+    // this is not called directly by the consumer code,
+    // consumer uses factory methods in RGBLedMatrix
+    internal RGBLedCanvas(IntPtr canvas)
+    {
+        _canvas = canvas;
+        led_canvas_get_size(_canvas, out var width, out var height);
+        Width = width;
+        Height = height;
+    }
+
+    /// <summary>
+    /// The width of the canvas in pixels.
+    /// </summary>
+    public int Width { get; private set; }
+
+    /// <summary>
+    /// The height of the canvas in pixels.
+    /// </summary>
+    public int Height { get; private set; }
+
+    /// <summary>
+    /// Sets the color of a specific pixel.
+    /// </summary>
+    /// <param name="x">The X coordinate of the pixel.</param>
+    /// <param name="y">The Y coordinate of the pixel.</param>
+    /// <param name="color">New pixel color.</param>
+    public void SetPixel(int x, int y, Color color) => led_canvas_set_pixel(_canvas, x, y, color.R, color.G, color.B);
+
+    /// <summary>
+    /// Copies the colors from the specified buffer to a rectangle on the canvas.
+    /// </summary>
+    /// <param name="x">The X coordinate of the top-left pixel of the rectangle.</param>
+    /// <param name="y">The Y coordinate of the top-left pixel of the rectangle.</param>
+    /// <param name="width">Width of the rectangle.</param>
+    /// <param name="height">Height of the rectangle.</param>
+    /// <param name="colors">Buffer containing the colors to copy.</param>
+    public void SetPixels(int x, int y, int width, int height, Span<Color> colors)
+    {
+        if (colors.Length < width * height)
+            throw new ArgumentOutOfRangeException(nameof(colors));
+        led_canvas_set_pixels(_canvas, x, y, width, height, ref colors[0]);
+    }
+
+    /// <summary>
+    /// Sets the color of the entire canvas.
+    /// </summary>
+    /// <param name="color">New canvas color.</param>
+    public void Fill(Color color) => led_canvas_fill(_canvas, color.R, color.G, color.B);
+
+    /// <summary>
+    /// Cleans the entire canvas.
+    /// </summary>
+    public void Clear() => led_canvas_clear(_canvas);
+
+    /// <summary>
+    /// Draws a circle of the specified color.
+    /// </summary>
+    /// <param name="x">The X coordinate of the center.</param>
+    /// <param name="y">The Y coordinate of the center.</param>
+    /// <param name="radius">The radius of the circle, in pixels.</param>
+    /// <param name="color">The color of the circle.</param>
+    public void DrawCircle(int x, int y, int radius, Color color) =>
+        draw_circle(_canvas, x, y, radius, color.R, color.G, color.B);
+
+    /// <summary>
+    /// Draws a line of the specified color.
+    /// </summary>
+    /// <param name="x0">The X coordinate of the first point.</param>
+    /// <param name="y0">The Y coordinate of the first point.</param>
+    /// <param name="x1">The X coordinate of the second point.</param>
+    /// <param name="y1">The Y coordinate of the second point.</param>
+    /// <param name="color">The color of the line.</param>
+    public void DrawLine(int x0, int y0, int x1, int y1, Color color) =>
+        draw_line(_canvas, x0, y0, x1, y1, color.R, color.G, color.B);
+
+    /// <summary>
+    /// Draws the text with the specified color.
+    /// </summary>
+    /// <param name="font">Font to draw text with.</param>
+    /// <param name="x">The X coordinate of the starting point.</param>
+    /// <param name="y">The Y coordinate of the starting point.</param>
+    /// <param name="color">The color of the text.</param>
+    /// <param name="text">Text to draw.</param>
+    /// <param name="spacing">Additional spacing between characters.</param>
+    /// <param name="vertical">Whether to draw the text vertically.</param>
+    /// <returns>How many pixels was advanced on the screen.</returns>
+    public int DrawText(RGBLedFont font, int x, int y, Color color, string text, int spacing = 0, bool vertical = false) =>
+        font.DrawText(_canvas, x, y, color, text, spacing, vertical);
+}