plucky (3) SDL_RenderReadPixels.3.gz

Provided by: libsdl3-doc_3.2.4+ds-2_all bug

NAME

       SDL_RenderReadPixels - Read pixels from the current rendering target.

HEADER FILE

       Defined in SDL3/SDL_render.h

SYNOPSIS

       #include "SDL3/SDL.h"

       SDL_Surface * SDL_RenderReadPixels(SDL_Renderer *renderer, const SDL_Rect *rect);

DESCRIPTION

       The returned surface should be freed with

       SDL_DestroySurface  ()  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  called  after  rendering  and  before
       SDL_RenderPresent ().

FUNCTION PARAMETERS

       renderer
              the rendering context.

       rect   an SDL_Rect
               structure  representing  the  area in pixels relative to the to current viewport, or NULL for the
              entire viewport.

RETURN VALUE

       ( SDL_Surface
        *) Returns a new SDL_Surface
        on success or NULL on failure; call SDL_GetError () for more information.

THREAD SAFETY

       This function should only be called on the main thread.

AVAILABILITY

       This function is available since SDL 3.2.0.