SDL_ConvertPixelsAndColorspace - Copy a block of pixels of one format and colorspace to another format
Contents
Availability
This function is available since SDL 3.2.0.
Function Parameters
width the width of the block to copy, in pixels.
height the height of the block to copy, in pixels.
src_format
an SDL_PixelFormat
value of the src pixels format.
src_colorspace
an SDL_Colorspace
value describing the colorspace of the src pixels.
src_properties
an SDL_PropertiesID
with additional source color properties, or 0.
src a pointer to the source pixels.
src_pitch
the pitch of the source pixels, in bytes.
dst_format
an SDL_PixelFormat
value of the dst pixels format.
dst_colorspace
an SDL_Colorspace
value describing the colorspace of the dst pixels.
dst_properties
an SDL_PropertiesID
with additional destination color properties, or 0.
dst a pointer to be filled in with new pixel data.
dst_pitch
the pitch of the destination pixels, in bytes.
Header File
Defined in SDL3/SDL_surface.h
Name
SDL_ConvertPixelsAndColorspace - Copy a block of pixels of one format and colorspace to another format
and colorspace.
Return Value
Returns true on success or false on failure; call
SDL_GetError () for more information.
See Also
•(3), SDL_ConvertPixels(3) Simple Directmedia Layer SDL 3.2.10 SDL_ConvertPixelsAndColorspace(3)
Synopsis
#include"SDL3/SDL.h"boolSDL_ConvertPixelsAndColorspace(intwidth,intheight,SDL_PixelFormatsrc_format,SDL_Colorspacesrc_colorspace,SDL_PropertiesIDsrc_properties,constvoid*src,intsrc_pitch,SDL_PixelFormatdst_format,SDL_Colorspacedst_colorspace,SDL_PropertiesIDdst_properties,void*dst,intdst_pitch);
Thread Safety
The same destination pixels should not be used from two threads at once. It is safe to use the same
source pixels from multiple threads.
