.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL's wiki page for SDL_GetWindowBordersSize:
.\"   https://wiki.libsdl.org/SDL_GetWindowBordersSize
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\"  revision SDL-3.1.0
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20SDL_GetWindowBordersSize
.\" SDL can be found at https://libsdl.org/
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH SDL_GetWindowBordersSize 3 "SDL 3.1.0" "SDL" "SDL3 FUNCTIONS"
.SH NAME
SDL_GetWindowBordersSize \- Get the size of a window's borders (decorations) around the client area\[char46]
.SH SYNOPSIS
.nf
.B #include \(dqSDL3/SDL.h\(dq
.PP
.BI "int SDL_GetWindowBordersSize(SDL_Window *window, int *top, int *left, int *bottom, int *right);
.fi
.SH DESCRIPTION
Note: If this function fails (returns -1), the size values will be
initialized to 0, 0, 0, 0 (if a non-NULL pointer is provided), as if the
window in question was borderless\[char46]

Note: This function may fail on systems where the window has not yet been
decorated by the display server (for example, immediately after calling

.BR SDL_CreateWindow
)\[char46] It is recommended that you wait at
least until the window has been presented and composited, so that the
window system has a chance to decorate the window and provide the border
dimensions to SDL\[char46]

This function also returns -1 if getting the information is not supported\[char46]

.SH FUNCTION PARAMETERS
.TP
.I window
the window to query the size values of the border (decorations) from
.TP
.I top
pointer to variable for storing the size of the top border; NULL is permitted
.TP
.I left
pointer to variable for storing the size of the left border; NULL is permitted
.TP
.I bottom
pointer to variable for storing the size of the bottom border; NULL is permitted
.TP
.I right
pointer to variable for storing the size of the right border; NULL is permitted
.SH RETURN VALUE
Returns 0 on success or a negative error code on failure; call

.BR SDL_GetError
() for more information\[char46]

.SH AVAILABILITY
This function is available since SDL 3\[char46]0\[char46]0\[char46]

.SH SEE ALSO
.BR SDL_GetWindowSize (3)