table of contents
- experimental 3.1.0+ds-1
SDL_SetWindowShape(3) | SDL3 FUNCTIONS | SDL_SetWindowShape(3) |
NAME¶
SDL_SetWindowShape - Set the shape of a transparent window.
SYNOPSIS¶
#include "SDL3/SDL.h"
int SDL_SetWindowShape(SDL_Window *window, SDL_Surface *shape);
DESCRIPTION¶
This sets the alpha channel of a transparent window and any fully transparent areas are also transparent to mouse clicks. If you are using 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.
FUNCTION PARAMETERS¶
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.
SDL 3.1.0 | SDL |