Merge pull request #739 from pimoroni/helgibbons-patch-1

PicoGraphics: document `dither=False`

Author: Gadgetoid

micropython/examples/galactic_unicorn/README.md

@@ -1,5 +1,5 @@
 # Galactic Unicorn MicroPython Examples <!-- omit in toc -->
- 
+
 - [About Galactic Unicorn](#about-galactic-unicorn)
 - [Galactic Unicorn and PicoGraphics](#galactic-unicorn-and-picographics)
 - [Examples](#examples)
@@ -150,4 +150,5 @@ Here are some cool Galactic Unicorn community projects and resources that you mi
 - :link: [Galactic Unicorn Graphical Workout](https://www.instructables.com/Galactic-Unicorn-Graphical-Workout/)
 - :link: [Galactic Unicorn Bounce - Simple GFX Demo](https://www.instructables.com/Galactic-Unicorn-Bounce-Simple-GFX-Demo/)
 - :link: [Cheerlights + Galactic Unicorn + MicroPython (beginner-friendly tutorial)](https://cheerlights.com/cheerlights-raspberry-pi-pico-w-micropython/)
-- :link: [CheerClock (plus laser-cut templates for a fancy case/diffuser)](https://github.com/seanosteen/CheerClock)
+- :link: [CheerClock (plus laser-cut templates for a fancy case/diffuser)](https://github.com/seanosteen/CheerClock)
+- :link: [Make a giant Pomodoro timer using Galactic Unicorn](https://www.raspberrypi.com/news/make-a-giant-pomodoro-timer-using-galactic-unicorn/)

micropython/modules/picographics/README.md

@@ -562,7 +562,7 @@ j = jpegdec.JPEG(display)
 j.open_file("filename.jpeg")
 
 # Decode the JPEG
-j.decode(0, 0, jpegdec.JPEG_SCALE_FULL)
+j.decode(0, 0, jpegdec.JPEG_SCALE_FULL, dither=True)
 
 # Display the result
 display.update()
@@ -579,3 +579,4 @@ The arguments for `decode` are as follows:
 1. Decode X - where to place the decoded JPEG on screen
 2. Decode Y
 3. Flags - one of `JPEG_SCALE_FULL`, `JPEG_SCALE_HALF`, `JPEG_SCALE_QUARTER` or `JPEG_SCALE_EIGHTH`
+4. If you want to turn off dither altogether, try `dither=False`. This is useful if you want to [pre-dither your images](https://ditherit.com/) or for artsy posterization effects.