table of contents
other versions
- experimental 3.1.0+ds-1
SDL_ConvertPixels(3) | SDL3 FUNCTIONS | SDL_ConvertPixels(3) |
NAME¶
SDL_ConvertPixels - Copy a block of pixels of one format to another format.
SYNOPSIS¶
#include "SDL3/SDL.h"
int SDL_ConvertPixels(int width, int height, SDL_PixelFormatEnum src_format, const void *src, int src_pitch, SDL_PixelFormatEnum dst_format, void *dst, int dst_pitch);
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_PixelFormatEnum
value of the src pixels format - src
- a pointer to the source pixels
- src_pitch
- the pitch of the source pixels, in bytes
- dst_format
- an SDL_PixelFormatEnum
value of the dst pixels format - dst
- a pointer to be filled in with new pixel data
- dst_pitch
- the pitch of the destination pixels, in bytes
RETURN VALUE¶
Returns 0 on success or a negative error code on failure; call
SDL_GetError () for more information.
AVAILABILITY¶
This function is available since SDL 3.0.0.
SEE ALSO¶
SDL 3.1.0 | SDL |