From 6ba3e56538fcbd6aa073a048a2a9216ec55f1295 Mon Sep 17 00:00:00 2001
From: rofl0r <[EMAIL REDACTED]>
Date: Sun, 24 Mar 2024 18:02:15 +0000
Subject: [PATCH] SDL_GetWindowSurface: update documentation re:
surface->pixels
---
include/SDL_video.h | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/include/SDL_video.h b/include/SDL_video.h
index fa47d30991df0..b0d7598985f95 100644
--- a/include/SDL_video.h
+++ b/include/SDL_video.h
@@ -1297,6 +1297,10 @@ extern DECLSPEC SDL_bool SDLCALL SDL_HasWindowSurface(SDL_Window *window);
* This surface will be invalidated if the window is resized. After resizing a
* window this function must be called again to return a valid surface.
*
+ * Note that on some platforms the pixels pointer of the surface may be
+ * modified after each call to SDL_UpdateWindowSurface(), so that the platform
+ * code can implement efficient double or triple buffering.
+ *
* You may not combine this with 3D or the rendering API on this window.
*
* This function is affected by `SDL_HINT_FRAMEBUFFER_ACCELERATION`.