doc: brick, sound, display, and experiment with samples

source/brick.rst

@@ -0,0 +1,55 @@
+:mod:`brick` -- The EV3 Programmable Brick
+==========================================
+
+
+Buttons
+-------
+
+.. autofunction:: brick.buttons
+
+
+Light
+-----
+
+.. autofunction:: brick.light
+
+
+
+Sound
+-----
+
+.. automethod:: brick.sound.beep
+
+
+.. automethod:: brick.sound.beeps
+
+
+.. automethod:: brick.sound.tune
+
+
+.. automethod:: brick.sound.file
+
+
+.. automethod:: brick.sound.speak
+   
+
+Display
+-------
+::
+     
+                       x
+              -------------->
+     (0, 0)  __________________  
+            |                  |
+        |   |                  |
+     y  |   |      Hello       |
+        |   |      World       |
+        v   |                  |
+            |__________________|
+                                (177, 127)
+
+.. automethod:: brick.display.clear
+
+.. automethod:: brick.display.text
+
+.. automethod:: brick.display.image

source/devices.rst

@@ -0,0 +1,30 @@
+:mod:`devices` -- EV3 Motors and Sensors
+===========================================
+
+Motors
+------
+
+.. autoclass:: devices.Motor
+
+Sensors
+-------
+
+Touch Sensor
+^^^^^^^^^^^^
+.. autoclass:: devices.TouchSensor
+
+Color Sensor
+^^^^^^^^^^^^
+.. autoclass:: devices.ColorSensor
+
+Infrared Sensor and Beacon
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. autoclass:: devices.InfraredSensor
+
+Ultrasonic Sensor
+^^^^^^^^^^^^^^^^^
+.. autoclass:: devices.UltrasonicSensor
+
+Gyroscopic Sensor
+^^^^^^^^^^^^^^^^^
+.. autoclass:: devices.GyroSensor

source/ev3brick.rst

@@ -1,37 +0,0 @@
-:mod:`ev3brick` -- The Programmable Brick
-=========================================
-
-
-Buttons
--------
-
-.. autofunction:: ev3brick.buttons
-
-Light
------
-
-.. autofunction:: ev3brick.light
-
-Sound
------
-
-.. automethod:: ev3brick.sound.beep
-
-.. automethod:: ev3brick.sound.beeps
-
-.. automethod:: ev3brick.sound.tune
-
-.. automethod:: ev3brick.sound.file
-
-.. automethod:: ev3brick.sound.speak
-
-Display
--------
-
-TODO: picture with (0,0), +x +y arrows
-
-.. automethod:: ev3brick.display.clear
-
-.. automethod:: ev3brick.display.text
-
-.. automethod:: ev3brick.display.image

source/ev3devices.rst

@@ -1,30 +0,0 @@
-:mod:`ev3devices` -- Motors and Sensors
-===========================================
-
-Motors
-------
-
-.. autoclass:: ev3devices.Motor
-
-Sensors
--------
-
-Touch Sensor
-^^^^^^^^^^^^
-.. autoclass:: ev3devices.TouchSensor
-
-Color Sensor
-^^^^^^^^^^^^
-.. autoclass:: ev3devices.ColorSensor
-
-Infrared Sensor and Beacon
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. autoclass:: ev3devices.InfraredSensor
-
-Ultrasonic Sensor
-^^^^^^^^^^^^^^^^^
-.. autoclass:: ev3devices.UltrasonicSensor
-
-Gyroscopic Sensor
-^^^^^^^^^^^^^^^^^
-.. autoclass:: ev3devices.GyroSensor

source/index.rst

@@ -18,8 +18,8 @@ Welcome to Pybricks's documentation!
    :maxdepth: 1
    :caption: Modules:
 
-   ev3brick
-   ev3devices
+   brick
+   devices
    parameters
    tools
 

source/parameters.rst

@@ -20,7 +20,6 @@ Intro
     :no-members:
 
 .. autoclass:: parameters.Pattern
-    :no-members:
 
 .. autoclass:: parameters.Align
     :no-members:

source/signaltypes.rst

@@ -61,3 +61,10 @@ TODO definition of physical quantity and units and :py:obj:`float` type
 frequency: Hz
 --------------
 TODO definition of physical quantity and units and :py:obj:`float` type
+
+
+.. _colortuple:
+
+custom color
+--------------
+TODO definition of physical quantity and units and :py:obj:`float` type