commit

Author: trevorwslee

README.md

@@ -2,9 +2,10 @@
 
 DumbDisplay for Micro-Python is a port of the Arduino DumbDisplay library -- https://github.com/trevorwslee/Arduino-DumbDisplay
 
-Although the porting is not complete, nevertheless, a large portion of DumbDisplay functionalities have been ported. Hopefully, this should already be helpful for friends that develop programs for micro-controller boards in MicroPython.
+Although the porting is not complete, nevertheless, a large portion of DumbDisplay functionalities have been ported. Hopefully, this should already be helpful for friends that develop programs for micro-controller boards in Micro-Python.
 
-Note that even though it is targeted for MicroPython, it is still usable with regular Python 3, like in Raspberry Pi environment.
+Note that even though it is targeted for Micro-Python, it is still usable with regular Python 3, like in Raspberry Pi environment,
+or even desktop/laptop.
 
 
 The basic script setup is:

dumbdisplay/_dumbdisplay.py

@@ -77,6 +77,7 @@ def writeComment(self, comment: str):
     '''write out a comment to DD'''
     self._connect()
     self._sendCommand(None, '// ' + comment)
+    print("# " + comment)
   def recordLayerCommands(self):
     '''
     start recording layer commands (of any layers)

run_sample_graphical.py

@@ -0,0 +1,2 @@
+if __name__ == "__main__":
+    import samples.graphical.main

samples/doodle/main.py

@@ -5,9 +5,11 @@
 from dumbdisplay.layer_graphical import *
 
 
+# initialize some global variables
 _last_x = -1
 _color = "red"
 
+# feedback handler
 def feedback_handler(layer, type, x, y):
     global _last_x, _last_y, _color
     if layer == l:
@@ -25,21 +27,39 @@ def feedback_handler(layer, type, x, y):
         _last_x = -1   
 
 
+# create DumbDisplay connected using Inet (Python Internet connection)
 dd = DumbDisplay(io4Inet())
+
+# create 3 LCD layer as 3 tabs for changing color
 l_r = LayerLcd(dd)
 l_g = LayerLcd(dd)
 l_b = LayerLcd(dd)
-l = LayerGraphical(dd, 150, 100)
+
+# set the background color of the 3 tabs
 l_r.backgroundColor("red")
 l_g.backgroundColor("green")
 l_b.backgroundColor("blue")
+
+
+# create the main graphical [LCD] layer
+l = LayerGraphical(dd, 150, 100)
+
+# set the background color as well as border for the graphical layer
 l.backgroundColor("white")
 l.border(3, "black")
+
+# enable feedback for the 3 tabs
 l_r.enableFeedback("f", feedback_handler)
 l_g.enableFeedback("f", feedback_handler)
 l_b.enableFeedback("f", feedback_handler)
+
+#enable feedback for the core graphical layer, note that it is set to "auto repeat" every 50 milli-seconds
 l.enableFeedback("fs:rpt50", feedback_handler)
+
+# "auto pin" the different layers
 AutoPin('V', AutoPin('H', l_r, l_g, l_b), l).pin(dd)
+
+# the main loop does nothing, but uses DumbDisplay's delay, so that DumbDisplay has a chnace to do it's work
 while True:
     dd.delay(1)
 

samples/graphical/main.py

@@ -0,0 +1,89 @@
+
+from dumbdisplay.core import *
+from dumbdisplay.io_inet import *
+from dumbdisplay.layer_graphical import LayerGraphical
+
+# create DumbDisplay connected using Inet (Python Internet connection)
+dd = DumbDisplay(io4Inet())
+
+# create 4 graphical [LCD] layers
+l1 = LayerGraphical(dd, 150, 101)
+l2 = LayerGraphical(dd, 150, 101)
+l3 = LayerGraphical(dd, 150, 101)
+l4 = LayerGraphical(dd, 150, 101)
+
+# "auto pin" the 4 layers -- 2 by 2
+AutoPin('H', AutoPin('V', l1, l2), AutoPin('V', l3, l4)).pin(dd)
+
+
+while True:
+    dd.writeComment("start")
+
+    # set fill screen with color
+    l1.fillScreen("azure")
+    l2.fillScreen("azure")
+    l3.fillScreen("azure")
+    l4.fillScreen("azure")
+
+    # draw triangles
+    left = 0
+    right = 150
+    top = 0
+    bottom = 100
+    mid = 50
+    for i in range(0, 15):
+        left += 3
+        top += 3
+        right -= 3
+        bottom -= 3
+        x1 = left
+        y1 = mid
+        x2 = right
+        y2 = top
+        x3 = right
+        y3 = bottom
+        r = 25 * i
+        g = 255 - (10 * i)
+        b = 2 * i
+        l1.drawTriangle(x1, y1, x2, y2, x3, y3, RGB_COLOR(r, g, b))
+
+    # draw lines
+    i = 0
+    while True:
+        delta = 5 * i
+        x1 = 150
+        y1 = 0
+        x2 = -150 + delta
+        y2 = delta
+        l2.drawLine(x1, y1, x2, y2, "blue")
+        if x2 > 150:
+            break
+        i += 1
+
+    # draw rectangles
+    for i in range(0, 15):
+        delta = 3 * i
+        x = delta
+        y = delta
+        w = 150 - 2 * x
+        h = 100 - 2 * y
+        l3.drawRect(x, y, w, h, "plum")
+
+    # draw circles
+    radius = 10
+    for i in range(0, 8):
+        x = 2 * radius * i
+        for j in range(0, 6):
+            y = 2 * radius * j
+            r = radius
+            l4.drawCircle(x, y, r, "teal")
+            l4.drawCircle(x + r, y + r, r, "gold", True)
+
+    dd.writeComment("done ... will repeat in 5 second")
+    dd.delay(5)
+    l1.clear()
+    l2.clear()
+    l3.clear()
+    l4.clear()
+
+

setup.py

@@ -5,10 +5,10 @@
 
 setuptools.setup(
   name='uDumbDisplayLib',
-  version='0.1.0',
+  version='0.2.0',
   author='Trevor Lee',
   author_email='trev_lee@hotmail.com',
-  description='DumbDisplay Micro-Python Library',
+  description='Micro-Python DumbDisplay Library',
   long_description=long_description,
   long_description_content_type="text/markdown",
   url='https://github.com/trevorwslee/MicroPython-DumbDisplay',