|
Size: 1461
Comment: update content (old wiki)
|
Size: 1765
Comment: update content - standard return value
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 19: | Line 19: |
| ||'''joystick'''||a pointer to a structure containing joystick information ???|| | ||'''joystick'''||^a pointer to the joystick to query^|| |
| Line 26: | Line 26: |
<<Color2(green,Suggested alternate text here and in Remarks:)>><<BR>> Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information. See [[#Remarks|Remarks]] for details. |
|
| Line 41: | Line 44: |
| <<Color2(green,Alt text continued:)>><<BR>>This function will return -1 if it is passed invalid parameters. |
DRAFT |
SDL_JoystickGetBall
Use this function to get the ball axis change since the last poll.
Contents
Syntax
int SDL_JoystickGetBall(SDL_Joystick* joystick,
int ball,
int* dx,
int* dy)
Function Parameters
joystick |
a pointer to the joystick to query |
ball |
the ball indices index; starts at index 0 |
dx |
the difference in the x axis since the last poll |
dy |
the difference in the y axis since the last poll |
Return Value
Returns 0 on success, or -1 if you passed it invalid parameters; call SDL_GetError() for more information.
green
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information. See Remarks for details.
Code Examples
int delta_x, delta_y;
SDL_Joystick *joy;
.
.
.
SDL_JoystickUpdate();
if(SDL_JoystickGetBall(joy, 0, &delta_x, &delta_y)==-1)
printf("TrackBall Read Error!\n");
printf("Trackball Delta- X:%d, Y:%d\n", delta_x, delta_y);
Remarks
green
This function will return -1 if it is passed invalid parameters.
*
Trackballs can only return relative motion since the last call to SDL_JoystickGetBall(), these motion deltas are placed into dx and dy.
*
