Updated gallery table in README.md for better readability
This commit is contained in:
183
README.md
183
README.md
@@ -21,142 +21,79 @@ It is now production-ready (tested on 2x16 displays only at the moment.) ToDo: M
|
|||||||
|
|
||||||
## Gallery
|
## Gallery
|
||||||
|
|
||||||
Here are some of examples of how a lcdMenu will look, and to get those, simply append the `Code` column's contents to the following (considering you have the library "installed" as explained before. All the examples below use a 2x16 display.
|
Here are some of examples of how a lcdMenu will look, showcasing the amount of options you have with lcdMenu. Currently, as the library is only tested with 2x16 displays, these are the only ones showing up below - but on 4x20, it should look the same except it's bigger!
|
||||||
|
|
||||||
```python
|
|
||||||
from lcdMenu import lcdMenu
|
|
||||||
from machine import Pin, I2C
|
|
||||||
from PCF8574T import I2C_LCD
|
|
||||||
|
|
||||||
prev_btn = Pin(13, Pin.IN, Pin.PULL_DOWN) # input of the first btn
|
|
||||||
next_btn = Pin(14, Pin.IN, Pin.PULL_DOWN) # input of the second btn
|
|
||||||
ok_btn = Pin(15, Pin.IN, Pin.PULL_DOWN) # input of switch
|
|
||||||
|
|
||||||
LCD = I2C_LCD(I2C(0, sda=Pin(8), scl=Pin(9), freq=400000),0x27,2, 16)
|
|
||||||
|
|
||||||
def first():
|
|
||||||
print("first() called! 1")
|
|
||||||
def second():
|
|
||||||
print("second() called! 2")
|
|
||||||
def third():
|
|
||||||
print("third() called! 3")
|
|
||||||
return True
|
|
||||||
|
|
||||||
|
|
||||||
menuItems = [("first item", first),
|
|
||||||
("second item", second),
|
|
||||||
("third item", third)]
|
|
||||||
button_mappings = {"prev_btn":prev_btn, "next_btn": next_btn, "ok_btn": ok_btn}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
<table>
|
<table>
|
||||||
<tr>
|
<tr>
|
||||||
|
<th>Scroll direction</th>
|
||||||
<th>Cycling</th>
|
<th>Cycling</th>
|
||||||
<th>Title shown</th>
|
<th>Title shown</th>
|
||||||
<th>Scroll direction</th>
|
|
||||||
<th>Initial selection</th>
|
<th>Initial selection</th>
|
||||||
<th>Result</th>
|
<th>Result</th>
|
||||||
<th>Code</th>
|
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>yes</td>
|
|
||||||
<td>no</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>first</td>
|
|
||||||
<td><img src="images/2x16-title-vertical-up-down-cycling.jpg" alt="No title, first item & cycling on -> up & down, vertical scrolling"/></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=True, hide_menu_name=True)
|
|
||||||
menu.setup(menuItems)
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>no</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>first</td>
|
|
||||||
<td><img src="images/2x16-no-title-vertical-only-down.jpg" alt="No title, first item & no cycling -> only down, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=<b><i>False</i></b>, hide_menu_name=True) # <- change of cycle to False!
|
|
||||||
menu.setup(menuItems)
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>no</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>middle</td>
|
|
||||||
<td><img src="images/2x16-no-title-vertical-up-down.jpg" alt="No title, middle item -> up & down, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=False, hide_menu_name=True
|
|
||||||
menu.setup(menuItems, <b><i>start_selection=1</i></b>) # <- change of the initial selection
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>no</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>last</td>
|
|
||||||
<td><img src="images/2x16-no-title-vertical-only-up.jpg" alt="No title, last item & no cycling -> only up, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=False, hide_menu_name=True)
|
|
||||||
menu.setup(menuItems, start_selection<b><i>=2</i></b>) # <- set initial selection to the last element
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>yes</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>no options (first and last)</td>
|
|
||||||
<td><img src="images/2x16-title-vertical-no-options.jpg" alt="With title, only one option, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=False, hide_menu_name=<b><i>False, name="No options!"</i></b>) # now with a title
|
|
||||||
menu.setup(<b><i>[("Only option", lambda: print("Only option chosen!"))]</i></b>) # now with only one option (ignoring menuItems!)
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>yes</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>first</td>
|
|
||||||
<td><img src="images/2x16-title-vertical-only-down.jpg" alt="With title, first item & no cycling -> only down, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=False, hide_menu_name=False, name="No options!")
|
|
||||||
menu.setup(<b><i>menuItems</i></b>) # now with menuItems again
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>yes</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>middle</td>
|
|
||||||
<td><img src="images/2x16-title-vertical-up-down.jpg" alt="With title, middle item -> up & down, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=False, hide_menu_name=False, name="lcdMenu!")
|
|
||||||
menu.setup(menuItems<b><i>, start_selection=1</i></b>) # now with an index again
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>no</td>
|
|
||||||
<td>yes</td>
|
|
||||||
<td>vertical</td>
|
|
||||||
<td>last</td>
|
|
||||||
<td><img src="images/2x16-title-vertical-only-up.jpg" alt="With title, last item & no cycling -> only up, vertical scrolling"></td>
|
|
||||||
<td><pre>
|
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=False, cycle=False, hide_menu_name=False, name="lcdMenu!")
|
|
||||||
menu.setup(menuItems, start_selection<b><i>=2</i></b>) # <- set initial selection to the last element
|
|
||||||
menu.run()</pre></td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>yes</td>
|
|
||||||
<td>yes</td>
|
|
||||||
<td>horizontal</td>
|
<td>horizontal</td>
|
||||||
|
<td>yes</td>
|
||||||
|
<td>yes</td>
|
||||||
<td>first</td>
|
<td>first</td>
|
||||||
<td><img src="images/2x16-title-horizontal.jpg" alt="With title, middle item -> forward and backward, horizontal scrolling"></td>
|
<td><img src="images/2x16-title-horizontal.jpg" alt="With title, middle item -> forward and backward, horizontal scrolling"></td>
|
||||||
<td><pre>
|
</tr>
|
||||||
menu = lcdMenu(LCD, button_mappings, scroll_direction=<b><i>True</i></b>, cycle=<b><i>True</i></b>, hide_menu_name=False, name="lcdMenu!")
|
<tr>
|
||||||
menu.setup(menuItems)
|
<td>vertical</td>
|
||||||
menu.run()</pre></td>
|
<td>yes</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>first</td>
|
||||||
|
<td><img src="images/2x16-title-vertical-up-down-cycling.jpg" alt="No title, first item & cycling on -> up & down, vertical scrolling"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>first</td>
|
||||||
|
<td><img src="images/2x16-no-title-vertical-only-down.jpg" alt="No title, first item & no cycling -> only down, vertical scrolling"></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>middle</td>
|
||||||
|
<td><img src="images/2x16-no-title-vertical-up-down.jpg" alt="No title, middle item -> up & down, vertical scrolling"></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>last</td>
|
||||||
|
<td><img src="images/2x16-no-title-vertical-only-up.jpg" alt="No title, last item & no cycling -> only up, vertical scrolling"></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>yes</td>
|
||||||
|
<td>no options (first and last)</td>
|
||||||
|
<td><img src="images/2x16-title-vertical-no-options.jpg" alt="With title, only one option, vertical scrolling"></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>yes</td>
|
||||||
|
<td>first</td>
|
||||||
|
<td><img src="images/2x16-title-vertical-only-down.jpg" alt="With title, first item & no cycling -> only down, vertical scrolling"></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>yes</td>
|
||||||
|
<td>middle</td>
|
||||||
|
<td><img src="images/2x16-title-vertical-up-down.jpg" alt="With title, middle item -> up & down, vertical scrolling"></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>vertical</td>
|
||||||
|
<td>no</td>
|
||||||
|
<td>yes</td>
|
||||||
|
<td>last</td>
|
||||||
|
<td><img src="images/2x16-title-vertical-only-up.jpg" alt="With title, last item & no cycling -> only up, vertical scrolling"></td>
|
||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user