From 8d4f6294d75c84431b2e524c4ca8fba3bbcc427f Mon Sep 17 00:00:00 2001
From: Laurens Valk <laurens@pybricks.com>
Date: Wed, 5 Jun 2019 15:39:00 +0200
Subject: [PATCH] api: add LightArray

---
 pybricks/_common.py | 38 ++++++++++++++++++++++++++++++++------
 1 file changed, 32 insertions(+), 6 deletions(-)

diff --git a/pybricks/_common.py b/pybricks/_common.py
index 9867fbd..8318078 100644
--- a/pybricks/_common.py
+++ b/pybricks/_common.py
@@ -432,10 +432,36 @@ class Light():
         pass
 
     def brightness(self, brightness):
-        """Set the perceived brightness of the light.
+        """Set the brightness of the light.
 
         Arguments:
-            brightness (:ref:`percentage`): Perceived brightness of the light.
+            brightness (:ref:`percentage`): Brightness of the light.
+        """
+        pass
+
+
+class LightArray():
+    """Control an array of single color LEDs."""
+
+    def __init__(self, number_of_lights):
+        self.number_of_lights = number_of_lights
+
+    def on(self):
+        """Turn on all the lights at maximum brightness."""
+        pass
+
+    def off(self):
+        """Turn off all the lights."""
+        pass
+
+    def brightness(self, *brightnesses):
+        """brightness(first_light, ..., last_light)
+
+        Set the brightness of each light.
+
+        Arguments:
+            brightnesses (:ref:`percentage`, ..., :ref:`percentage`):
+                Brightness of each light.
         """
         pass
 
@@ -457,12 +483,12 @@ class ColorLight():
         pass
 
     def brightness(self, red, green, blue):
-        """Set the perceived brightness of the red, green, and blue light.
+        """Set the brightness of the red, green, and blue light.
 
         Arguments:
-            red (:ref:`percentage`): Perceived brightness of the red light.
-            green (:ref:`percentage`): Perceived brightness of the green light.
-            blue (:ref:`percentage`): Perceived brightness of the blue light.
+            red (:ref:`percentage`): Brightness of the red light.
+            green (:ref:`percentage`): Brightness of the green light.
+            blue (:ref:`percentage`): Brightness of the blue light.
         """
         pass