eden-emu/SDL
15
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-05-23 13:09:11 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Sync SDL3 wiki -> header

Browse source 
[ci skip]
This commit is contained in:
SDL Wiki Bot 2025-02-25 18:29:56 +00:00
parent 85a302550d
commit 38a73a1783
1 changed files with 8 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

12
include/SDL3/SDL_render.h
View file

@ -2247,17 +2247,21 @@ extern SDL_DECLSPEC bool SDLCALL SDL_RenderGeometryRaw(SDL_Renderer *renderer,
/** /**
* Read pixels from the current rendering target. * Read pixels from the current rendering target.
* *
* The returned surface contains pixels inside the desired area clipped to the current viewport, and should be freed with SDL_DestroySurface(). * The returned surface contains pixels inside the desired area clipped to the
* current viewport, and should be freed with SDL_DestroySurface().
* *
* Note that this returns the actual pixels on the screen, so if you are using logical presentation you should use SDL_GetRenderLogicalPresentationRect() to get the area containing your content. * Note that this returns the actual pixels on the screen, so if you are using
* logical presentation you should use SDL_GetRenderLogicalPresentationRect()
* to get the area containing your content.
* *
* **WARNING**: This is a very slow operation, and should not be used * **WARNING**: This is a very slow operation, and should not be used
* frequently. If you're using this on the main rendering target, it should be * frequently. If you're using this on the main rendering target, it should be
* called after rendering and before SDL_RenderPresent(). * called after rendering and before SDL_RenderPresent().
* *
* \param renderer the rendering context. * \param renderer the rendering context.
* \param rect an SDL_Rect structure representing the area to read, which will be clipped to the current viewport, * \param rect an SDL_Rect structure representing the area to read, which will
* or NULL for the entire viewport. * be clipped to the current viewport, or NULL for the entire
* viewport.
* \returns a new SDL_Surface on success or NULL on failure; call * \returns a new SDL_Surface on success or NULL on failure; call
* SDL_GetError() for more information. * SDL_GetError() for more information.
* *