|
Size: 1760
Comment: minor change
|
Size: 1522
Comment: update content - pointers, structs
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 19: | Line 19: |
| ||'''joystick'''||^a pointer to the joystick to query^|| | ||'''joystick'''||^the SDL_Joystick to query^|| |
| Line 21: | Line 21: |
| ||'''dx'''||the difference in the x axis since the last poll|| ||'''dy'''||the difference in the y axis since the last poll|| |
||'''dx'''||the difference in the x axis ^position^ since the last poll|| ||'''dy'''||the difference in the y axis ^position^ since the last poll|| <<Color2(green,Is it possible to use more than one index for '''ball'''?)>> |
| Line 25: | Line 27: |
| Returns 0 on success, or -1 if you passed it invalid parameters; call [[SDL_GetError]]() for more information. <<Color2(green,Suggested alternate text here and in Remarks:)>><<BR>> <<Color2(purple,Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information. See [[#Remarks|Remarks]] for details.)>> |
Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information. |
| Line 44: | Line 43: |
| <<Color2(purple,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 |
the SDL_Joystick to query |
ball |
the ball indices index; starts at index 0 |
dx |
the difference in the x axis position since the last poll |
dy |
the difference in the y axis position since the last poll |
green
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
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
*
Trackballs can only return relative motion since the last call to SDL_JoystickGetBall(), these motion deltas are placed into dx and dy.
*
