kopia lustrzana https://github.com/pimoroni/pimoroni-pico
update picoscroll docs
rodzic
b4451c3bdc
commit
a60c856ea8
|
@ -13,13 +13,13 @@ We've included helper functions to handle every aspect of drawing to the matrix
|
|||
- [show\_text](#show_text)
|
||||
- [scroll\_text](#scroll_text)
|
||||
- [show\_bitmap\_1d](#show_bitmap_1d)
|
||||
- [update](#update)
|
||||
- [show](#show)
|
||||
- [clear](#clear)
|
||||
- [is\_pressed](#is_pressed)
|
||||
|
||||
## Example Program
|
||||
|
||||
The following example sets up the matrix, sets each pixel to an increasing brightnesses level, and then clears the matrix only after button A is pressed.
|
||||
The following example sets up the matrix, sets each pixel to an increasing brightness level, and then clears the matrix only after button A is pressed.
|
||||
|
||||
```python
|
||||
from picoscroll import PicoScroll
|
||||
|
@ -37,7 +37,7 @@ for y in range (0, picoscroll.get_height()):
|
|||
brightness += 2
|
||||
|
||||
# Push the data to the matrix
|
||||
picoscroll.update()
|
||||
picoscroll.show()
|
||||
|
||||
# Wait until the A button is pressed
|
||||
while picoscroll.is_pressed(picoscroll.BUTTON_A) == False:
|
||||
|
@ -45,9 +45,14 @@ while picoscroll.is_pressed(picoscroll.BUTTON_A) == False:
|
|||
|
||||
# Set the brightness of all pixels to 0
|
||||
picoscroll.clear()
|
||||
picoscroll.update()
|
||||
picoscroll.show()
|
||||
```
|
||||
|
||||
You can now also use Scroll Pack with our tiny PicoGraphics library which has a ton of useful functions for drawing text and shapes:
|
||||
|
||||
- [PicoGraphics example for Scroll Pack](/micropython/examples/pico_scroll/picographics_scroll_text.py)
|
||||
- [PicoGraphics function reference](/micropython/modules/picographics/README.md)
|
||||
|
||||
## Function reference
|
||||
|
||||
### get_width
|
||||
|
@ -62,7 +67,7 @@ height_in_pixels = picoscroll.get_height()
|
|||
|
||||
### set_pixel
|
||||
|
||||
This function sets a pixel at the `x` and `y` coordinates to a brightness level specified by the `l` parameter. The value of `l` must be 0-255. Changes will not be visible until `update()` is called.
|
||||
This function sets a pixel at the `x` and `y` coordinates to a brightness level specified by the `l` parameter. The value of `l` must be 0-255. Changes will not be visible until `show()` is called.
|
||||
|
||||
```python
|
||||
picoscroll.set_pixel(x, y, l)
|
||||
|
@ -72,7 +77,7 @@ picoscroll.set_pixel(x, y, l)
|
|||
|
||||
This function sets all pixel at once from a `bytearray` image indexed
|
||||
as `y * picoscroll.get_width() + x`, containing brightness levels
|
||||
between 0 and 255. Changes will not be visible until `update()` is called.
|
||||
between 0 and 255. Changes will not be visible until `show()` is called.
|
||||
|
||||
```python
|
||||
image = bytearray(0 for j in range(width * height))
|
||||
|
@ -92,7 +97,7 @@ word = "Hello, world!"
|
|||
l = len(word) * 6
|
||||
for j in range(-17, l):
|
||||
picoscroll.show_text(word, 8, j)
|
||||
picoscroll.update()
|
||||
picoscroll.show()
|
||||
time.sleep(0.1)
|
||||
```
|
||||
|
||||
|
@ -102,7 +107,7 @@ The full 256 characters can be displayed with:
|
|||
b = bytearray(range(256))
|
||||
for j in range(256*6):
|
||||
picoscroll.show_text(b, 8, j)
|
||||
picoscroll.update()
|
||||
picoscroll.show()
|
||||
time.sleep(0.1)
|
||||
```
|
||||
|
||||
|
@ -129,29 +134,29 @@ Show a view of a bitmap stored as the 7 least significant bits of
|
|||
bytes in a `bytearray`, top-down. Individual pixels are set to
|
||||
`brightness` based on individual bit values, with the view defined by
|
||||
the offset and the width of the scroll (i.e. 17 columns). Changes will
|
||||
not be visible until `update()` is called.
|
||||
not be visible until `show()` is called.
|
||||
|
||||
```python
|
||||
bitmap = bytearray(j for j in range 127)
|
||||
for offset in range(-17, 127):
|
||||
picoscroll.show_bitmap_1d(bitmap, 16, offset)
|
||||
picoscroll.update()
|
||||
picoscroll.show()
|
||||
```
|
||||
|
||||
will scroll a binary counter across the display (i.e. show `0x00` to
|
||||
`0x7f` in binary).
|
||||
|
||||
### update
|
||||
### show
|
||||
|
||||
Pushes pixel data from the Pico to the Scroll Pack. Until this function is called any `set_pixel` or `clear` calls won't have any visible effect.
|
||||
|
||||
```python
|
||||
picoscroll.update()
|
||||
picoscroll.show()
|
||||
```
|
||||
|
||||
### clear
|
||||
|
||||
Sets the brightness of all pixels to `0`. Will not visibly take effect until `update` is called.
|
||||
Sets the brightness of all pixels to `0`. Will not visibly take effect until `show` is called.
|
||||
|
||||
```python
|
||||
picoscroll.clear()
|
||||
|
|
Ładowanie…
Reference in New Issue