XQueryBestSize(3) XLIB FUNCTIONS XQueryBestSize(3)

# [NAME](#NAME)

XQueryBestSize, XQueryBestTile, XQueryBestStipple - determine efficient sizes

# [SYNTAX](#SYNTAX)

Status XQueryBestSize(Display \**display*, int *class*, Drawable *which\_screen*, unsigned int *width*, unsigned int *height*, unsigned int \**width\_return*, unsigned int \**height\_return*);

Status XQueryBestTile(Display \**display*, Drawable *which\_screen*, unsigned int *width*, unsigned int *height*, unsigned int \**width\_return*, unsigned int \**height\_return*);

Status XQueryBestStipple(Display \**display*, Drawable *which\_screen*, unsigned int *width*, unsigned int *height*, unsigned int \**width\_return*, unsigned int \**height\_return*);

# [ARGUMENTS](#ARGUMENTS)

[*class*](#class)

Specifies the class that you are interested in. You can pass **TileShape**, **CursorShape**, or **StippleShape**.

[*display*](#display)

Specifies the connection to the X server.

[*width*](#width)

[*height*](#height)

Specify the width and height.

[*which\_screen*](#which_screen)

Specifies any drawable on the screen.

[*width\_return*](#width_return)

[*height\_return*](#height_return)

Return the width and height of the object best supported by the display hardware.

# [DESCRIPTION](#DESCRIPTION)

The **XQueryBestSize** function returns the best or closest size to the specified size. For **CursorShape**, this is the largest size that can be fully displayed on the screen specified by which\_screen. For **TileShape**, this is the size that can be tiled fastest. For **StippleShape**, this is the size that can be stippled fastest. For **CursorShape**, the drawable indicates the desired screen. For **TileShape** and **StippleShape**, the drawable indicates the screen and possibly the window class and depth. An **InputOnly** window cannot be used as the drawable for **TileShape** or **StippleShape**, or a **BadMatch** error results.

**XQueryBestSize** can generate **BadDrawable**, **BadMatch**, and **BadValue** errors.

The **XQueryBestTile** function returns the best or closest size, that is, the size that can be tiled fastest on the screen specified by which\_screen. The drawable indicates the screen and possibly the window class and depth. If an **InputOnly** window is used as the drawable, a **BadMatch** error results.

**XQueryBestTile** can generate **BadDrawable** and **BadMatch** errors.

The **XQueryBestStipple** function returns the best or closest size, that is, the size that can be stippled fastest on the screen specified by which\_screen. The drawable indicates the screen and possibly the window class and depth. If an **InputOnly** window is used as the drawable, a **BadMatch** error results.

**XQueryBestStipple** can generate **BadDrawable** and **BadMatch** errors.

# [DIAGNOSTICS](#DIAGNOSTICS)

[**BadMatch**](#BadMatch)

An **InputOnly** window is used as a Drawable.

[**BadDrawable**](#BadDrawable)

A value for a Drawable argument does not name a defined Window or Pixmap.

[**BadMatch**](#BadMatch~2)

The values do not exist for an **InputOnly** window.

[**BadValue**](#BadValue)

Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.

# [SEE ALSO](#SEE_ALSO)

[**XCreateGC**(3)](/man/os/libx11/XCreateGC.3), [**XSetArcMode**(3)](/man/os/libx11/XSetArcMode.3), [**XSetClipOrigin**(3)](/man/os/libx11/XSetClipOrigin.3), [**XSetFillStyle**(3)](/man/os/libx11/XSetFillStyle.3), [**XSetFont**(3)](/man/os/libx11/XSetFont.3), [**XSetLineAttributes**(3)](/man/os/libx11/XSetLineAttributes.3), [**XSetState**(3)](/man/os/libx11/XSetState.3), [**XSetTile**(3)](/man/os/libx11/XSetTile.3)  
*Xlib - C Language X Interface*

libX11 1.8.14 X Version 11

---

Document: XQueryBestSize(3) from libx11 1.8.14-r1 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git