Convert bad buffering demo into a blitting demo

Author: runer112

examples/gfx_buffering/autotester.json renamed to examples/gfx_blitting/autotester.json

@@ -9,26 +9,38 @@
   },
   "sequence": [
     "action|launch",
-    "delay|300",
-    "hash|1",
+    "hashWait|1",
     "key|enter",
+    "hashWait|2",
     "key|enter",
-    "delay|300",
-    "hashWait|2"
+    "hashWait|3",
+    "key|enter",
+    "hashWait|4"
   ],
   "hashes": {
     "1": {
-      "description": "The background will be blank",
+      "description": "Nothing blitted yet, white screen",
       "start": "vram_start",
       "size": "vram_8_size",
       "expected_CRCs": [ "3132DE74" ]
     },
     "2": {
+      "description": "Parts of buffer blitted to screen",
+      "start": "vram_start",
+      "size": "vram_8_size",
+      "expected_CRCs": [ "830291D3" ]
+    },
+    "3": {
+      "description": "Full buffer blitted to screen",
+      "start": "vram_start",
+      "size": "vram_8_size",
+      "expected_CRCs": [ "EA181DC1" ]
+    },
+    "4": {
       "description": "Back to the home screen (exit check)",
       "start": "vram_start",
       "size": "vram_16_size",
       "expected_CRCs": [ "FFAF89BA", "101734A5", "9DA19F44" ]
     }
   }
 }
-

examples/gfx_buffering/makefile renamed to examples/gfx_blitting/makefile

@@ -0,0 +1,7 @@
+### GraphX Blitting Demo
+
+This example demonstrates blitting to manually copy data from the drawing buffer to the screen buffer
+
+---
+
+This demo is a part of the C SDK Toolchain for use on the CE.

examples/gfx_blitting/readme.md

@@ -0,0 +1,47 @@
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <tice.h>
+
+#include <math.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <graphx.h>
+
+/* This tutorial is meant to be played around with to get a feeling for how blitting works */
+void main(void) {
+    uint8_t c;
+
+    /* Initialize the 8bpp graphics, screen cleared to white */
+    gfx_Begin();
+
+    /* Draw to buffer instead of directly to screen */
+    gfx_SetDrawBuffer(); // This is the same as gfx_SetDraw(gfx_buffer)
+
+    /* Draw a gradient (to the buffer) */
+    for (c = 0; c < 8; c++) {
+        gfx_SetColor(c);
+        gfx_FillRectangle_NoClip(c * (LCD_WIDTH / 8), 0, LCD_WIDTH / 8, LCD_HEIGHT);
+    }
+
+    /* Wait for a key */
+    while (!os_GetCSC());
+
+    /* Copy parts of the buffer to the screen */
+    gfx_BlitLines(gfx_buffer, LCD_HEIGHT - 32, 32);
+    gfx_BlitRectangle(gfx_buffer, LCD_WIDTH / 4, LCD_HEIGHT / 4, LCD_WIDTH / 2, LCD_HEIGHT / 2);
+
+    /* Wait for a key */
+    while (!os_GetCSC());
+
+    /* Copy the full buffer to the screen */
+    gfx_BlitBuffer(); // This is the same as gfx_Blit(gfx_buffer)
+
+    /* Wait for a key */
+    while (!os_GetCSC());
+
+    /* Close the graphics */
+    gfx_End();
+}