|
Size: 2150
Comment: update content - w/ Sam (in progress)
|
Size: 1825
Comment: update content - w/ Sam (in progress)
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| ||<tablewidth="100%" style="color: #FF0000;" :> DRAFT|| | |
| Line 37: | Line 36: |
| '''xrel''' and '''yrel''' are relative to the last SDL_MOUSEMOTIONEVENT. If the cursor is hidden ([[SDL_ShowCursor]](0)) and the input is grabbed (SDL_WM_!GrabInput(SDL_GRAB_ON)), then the mouse will give relative motion events even when the cursor reaches the edge of the screen. This is currently only implemented on Windows and Linux/Unix-alikes. <<Color2(green,There are currently no pages for SDL_!WarpMouse or SDL_WM_!GrabInput. Do they still exist in 1.3? Is [[SDL_WarpMouseInWindow]] the appropriate replacement for SDL_!WarpMouse? If it is should it be listed in RFs also?)>> |
Relative motion is stored in '''xrel''' and '''yrel''' and is relative to the last motion event. If relative mouse mode is enabled with [[SDL_SetRelativeMouseMode]](), then the mouse will give relative motion events even when the cursor reaches the edge of the screen. |
| Line 51: | Line 46: |
| .[[SDL_GetMouseState]] .[[SDL_SetRelativeMouseMode]] |
SDL_MouseMotionEvent
A structure that contains mouse motion event information.
Contents
Data Fields
Uint32 |
type |
SDL_MOUSEMOTION |
Uint32 |
windowID |
the window with mouse focus, if any |
Uint8 |
state |
the current button state; see Remarks for details |
int |
x |
X coordinate, relative to window |
int |
y |
Y coordinate, relative to window |
int |
xrel |
relative motion in the X direction |
int |
yrel |
relative motion in the Y direction |
Code Examples
You can add your code example here
Remarks
SDL_MouseMotionEvent is a member of the SDL_Event structure and is used when an event of type SDL_MOUSEMOTION is reported.
An SDL_MOUSEMOTION event occurs whenever a user moves the mouse within the application window or when SDL_WarpMouseInWindow() is called.
state is an 8-bit button bitmask of the current button state and is the same as that returned by SDL_GetMouseState(). You can test different buttons by using the following masks:
SDL_BUTTON_LMASK |
SDL_BUTTON_MMASK |
SDL_BUTTON_RMASK |
SDL_BUTTON_X1MASK |
SDL_BUTTON_X2MASK |
Relative motion is stored in xrel and yrel and is relative to the last motion event. If relative mouse mode is enabled with SDL_SetRelativeMouseMode(), then the mouse will give relative motion events even when the cursor reaches the edge of the screen.
Related Enumerations
Related Structures
