From 416803b03b750984a7a038f6f1ea2d2dde98e522 Mon Sep 17 00:00:00 2001 From: Sam Lantinga Date: Sat, 10 Feb 2024 07:08:28 -0800 Subject: [PATCH] Clarify the lifetime of the shape surface in SDL_SetWindowShape() --- include/SDL3/SDL_video.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/include/SDL3/SDL_video.h b/include/SDL3/SDL_video.h index 57cf51d476..37cfb1a735 100644 --- a/include/SDL3/SDL_video.h +++ b/include/SDL3/SDL_video.h @@ -2131,6 +2131,8 @@ extern DECLSPEC int SDLCALL SDL_SetWindowHitTest(SDL_Window *window, SDL_HitTest * something besides the SDL render API, then you are responsible for setting * the alpha channel of the window yourself. * + * The shape is copied inside this function, so you can free it afterwards. If your shape surface changes, you should call SDL_SetWindowShape() again to update the window. + * * The window must have been created with the SDL_WINDOW_TRANSPARENT flag. * * \param window the window