api: add text and number display to grid

Also, use row + column for setting pixels instead of x, y. Then it is the same indexing as matrices.

pybricks/_common.py

@@ -469,7 +469,7 @@ class LightArray():
     """Control an array of single-color lights."""
 
     def __init__(self, lights):
-        """Initialize the light grid.
+        """Initialize the light array.
 
         Arguments:
             lights (int): Number of lights
@@ -516,12 +516,12 @@ class LightGrid():
         """
         pass
 
-    def pixel(self, x, y, brightness):
+    def pixel(self, row, column, brightness):
         """Turn on a pixel at the specified brightness.
 
         Arguments:
-            x (int): horizontal index, starting at 0 from the left.
-            y (int): vertical index, starting at 0 from the top.
+            row (int): Vertical grid index, starting at 0 from the top.
+            column (int): Horizontal grid index, starting at 0 from the left.
             brightness (:ref:`brightness`): Brightness of the pixel.
         """
         pass
@@ -530,6 +530,36 @@ class LightGrid():
         """Turn off all the pixels."""
         pass
 
+    def number(self, number):
+        """Display a number on the light grid.
+
+        Arguments:
+            number (int): The number to be displayed.
+        """
+        pass
+
+    def char(self, character):
+        """Display a character or symbol on the light grid. This may
+        be any letter (``a``--``z``), capital letter (``A``--``Z``) or one of
+        the following symbols: ``!"#$%&'()*+,-./:;<=>?@[\\]^_`{|}``.
+
+        Arguments:
+            character (str): The character or symbol to be displayed.
+        """
+        pass
+
+    def text(self, text, pause=500):
+        """Display a text string, one charachter at a time, with a pause
+        between each character. After the last charachter is shown, the light
+        grid turns off.
+
+        Arguments:
+            character (str): The character or symbol to be displayed.
+            time (:ref:`time`): How long to show a character before showing
+                                the next one.
+        """
+        pass
+
 
 class Battery():
     """Get the status of a battery."""