---
name: "joystick_getnumaxes"
section: "3"
platform: "linux"
package: "libsvga1-dev"
version: "1:1.4.3-33"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/joystick_getnumaxes"
---

# joystick\_getnumaxes(3)

query the capabilities of a joystick

## NAME

joystick\_getnumaxes, joystick\_getnumbuttons - query the capabilities of a joystick

## SYNOPSIS

**#include \<vgajoystick.h\>**

**char joystick\_getnumaxes(int** *joydev***);**\
 **char joystick\_getnumbuttons(int** *joydev***);**

## DESCRIPTION

queries the number of axes (number of continuous ranges which the joystick allows to choose from) and buttons. The old version 0.\* joystick protocol reports 2 axes (x and y) and 4 buttons although the actual joystick will usually have less (often two) buttons.

svgalib supports up to 127 axes and buttons, provided the underlying device driver does it.

## CAVEATS

This function is only available in ELF versions of svgalib. Due to backwards compatibility issues it cannot be used with shared a.out libs.

## SEE ALSO

[**svgalib**(7)](/svgalib/7.md), [**vgagl**(7)](/vgagl/7.md), [**libvga.config**(5)](/libvga.config/5.md), **joytest**(6), **mjoytest**(6), [**joystick\_init**(3)](/joystick_init/3.md), [**joystick\_close**(3)](/joystick_close/3.md), [**joystick\_update**(3)](/joystick_update/3.md), [**joystick\_sethandler**(3)](/joystick_sethandler/3.md), [**joystick\_setdefaulthandler**(3)](/joystick_setdefaulthandler/3.md), [**joystick\_getaxis**(3)](/joystick_getaxis/3.md), [**joystick\_getbutton**(3)](/joystick_getbutton/3.md), [**joystick\_button1**(3)](/joystick_button1/3.md), [**joystick\_getb1**(3)](/joystick_getb1/3.md), [**joystick\_x**(3)](/joystick_x/3.md), [**joystick\_getx**(3)](/joystick_getx/3.md).

## AUTHOR

The svgalib joystick handler was mostly done by Daniel Engstr\\"om \<daniel.engstrom@riksnett.no\>. Multiple joystick, VC switching support and code to glue it into svgalib by Michael Weller \<eowmob@exp-math.uni-essen.de\>. Part of the code is based on code from C. Smith and Vojtech Pavlik.
