###### (This is the documentation for SDL3, which is under heavy development and the API is changing! [SDL2](https://wiki.libsdl.org/SDL2/) is the current stable version!)
# SDL_SetWindowShape

Set the shape and parameters of a shaped window.

## Syntax

```c
int SDL_SetWindowShape(SDL_Window *window,SDL_Surface *shape,SDL_WindowShapeMode *shape_mode);

```

## Function Parameters

|                    |                                                      |
| ------------------ | ---------------------------------------------------- |
| **window**         | The shaped window whose parameters should be set.    |
| **shape**          | A surface encoding the desired shape for the window. |
| **shape_mode**     | The parameters to set for the shaped window.         |

## Return Value

Returns 0 on success,
[SDL_INVALID_SHAPE_ARGUMENT](SDL_INVALID_SHAPE_ARGUMENT) on an invalid
shape argument, or [SDL_NONSHAPEABLE_WINDOW](SDL_NONSHAPEABLE_WINDOW) if
the [SDL_Window](SDL_Window) given does not reference a valid shaped
window.

## Version

This function is available since SDL 3.0.0.

## Related Functions

* [SDL_WindowShapeMode](SDL_WindowShapeMode)
* [SDL_GetShapedWindowMode](SDL_GetShapedWindowMode)

----
[CategoryAPI](CategoryAPI)