1 files changed, 12 insertions, 0 deletions

diff --git a/contrib/SDL-3.2.8/examples/renderer/17-read-pixels/README.txt b/contrib/SDL-3.2.8/examples/renderer/17-read-pixels/README.txt
new file mode 100644
index 0000000..dd474e6
--- /dev/null
+++ b/contrib/SDL-3.2.8/examples/renderer/17-read-pixels/README.txt
@@ -0,0 +1,12 @@
+This example creates an SDL window and renderer, and draws a
+rotating texture to it, reads back the rendered pixels, converts them to
+black and white, and then draws the converted image to a corner of the
+screen.
+
+This isn't necessarily an efficient thing to do--in real life one might
+want to do this sort of thing with a render target--but it's just a visual
+example of how to use SDL_RenderReadPixels().
+
+A better, but less visual, use of SDL_RenderReadPixels() is to make
+screenshots: you grab the current contents of the screen, and save the pixels
+as a bitmap file or whatever.