introduction to the pico display pack library

libraries/pico_display/README.md

@@ -0,0 +1,55 @@
+# Pico Display Pack
+
+Our Pico Display Pack offers a vibrant 1.14" (240x135) IPS LCD screen for your Raspberry Pi Pico it also includes four switches and and an RGB LED!
+
+Working with it is very straightforward, we've included helper functions to handle every aspect of drawing to the screen and interfacing with the other hardware.
+
+A very basic example program can be as simple as:
+
+```c++
+    #include "pico_display.hpp"
+
+    using namespace pimoroni;
+
+    uint16_t buffer[PicoDisplay::WIDTH * PicoDisplay::HEIGHT];
+    PicoDisplay pico_display(buffer);
+
+    int main() {
+        pico_display.init();
+
+        // set the backlight to a value between 0 and 255
+        // the backlight is driven via PWM and is gamma corrected by our
+        // library to give a gorgeous linear brightness range.
+        pico_display.set_backlight(100);
+
+        while(true) {
+            // detect if the A button is pressed (could be A, B, X, or Y)
+            if(pico_display.is_pressed(pico_display.A)) {
+                // make the led glow green
+                // parameters are red, green, blue all between 0 and 255
+                // these are also gamma corrected
+                pico_display.set_led(0, 255, 0);
+            }
+
+            // set the colour of the pen
+            // parameters are red, green, blue all between 0 and 255
+            pico_display.set_pen(30, 40, 50);
+
+            // fill the screen with the current pen colour
+            pico_display.clear();
+
+            // draw a box to put some text in
+            pico_display.set_pen(10, 20, 30);
+            rect text_rect(10, 10, 150, 150);
+            pico_display.rectangle(text_rect);
+
+            // write some text inside the box with 10 pixels of margin
+            // automatically word wrapping
+            text_rect.deflate(10);
+            pico_display.text("This is a message", point(text_rect.x, text_rect.y), text_rect.w);
+        }
+
+        // now we've done our drawing let's update the screen
+        pico_display.update();
+    }
+```