Safe Haskell	None
Language	Haskell2010

SDL.Input.Mouse

Contents

Relative Mouse Mode
Mouse and Touch Input
Mouse State
Warping the Mouse
Cursor Visibility
Cursor Shape

Synopsis

Relative Mouse Mode

data LocationMode Source #

Constructors

AbsoluteLocation
RelativeLocation

Instances

Eq LocationMode Source #
Methods (==) :: LocationMode -> LocationMode -> Bool # (/=) :: LocationMode -> LocationMode -> Bool #

setMouseLocationMode :: (Functor m, MonadIO m) => LocationMode -> m LocationMode Source #

Sets the current relative mouse mode.

When relative mouse mode is enabled, cursor is hidden and mouse position will not change. However, you will be delivered relative mouse position change events.

getMouseLocationMode :: MonadIO m => m LocationMode Source #

Check which mouse location mode is currently active.

setRelativeMouseMode :: (Functor m, MonadIO m) => Bool -> m () Source #

Deprecated: Use setMouseLocationMode instead

getRelativeMouseMode :: MonadIO m => m Bool Source #

Deprecated: Use getMouseLocationMode instead

Mouse and Touch Input

data MouseButton Source #

Constructors

ButtonLeft
ButtonMiddle
ButtonRight
ButtonX1
ButtonX2
ButtonExtra !Int	An unknown mouse button.

Instances

Eq MouseButton Source #
Methods (==) :: MouseButton -> MouseButton -> Bool # (/=) :: MouseButton -> MouseButton -> Bool #
Data MouseButton Source #
Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> MouseButton -> c MouseButton # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c MouseButton # toConstr :: MouseButton -> Constr # dataTypeOf :: MouseButton -> DataType # dataCast1 :: Typeable (* -> ) t => (forall d. Data d => c (t d)) -> Maybe (c MouseButton) # dataCast2 :: Typeable ( -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c MouseButton) # gmapT :: (forall b. Data b => b -> b) -> MouseButton -> MouseButton # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> MouseButton -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> MouseButton -> r # gmapQ :: (forall d. Data d => d -> u) -> MouseButton -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> MouseButton -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> MouseButton -> m MouseButton # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> MouseButton -> m MouseButton # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> MouseButton -> m MouseButton #
Ord MouseButton Source #
Methods compare :: MouseButton -> MouseButton -> Ordering # (<) :: MouseButton -> MouseButton -> Bool # (<=) :: MouseButton -> MouseButton -> Bool # (>) :: MouseButton -> MouseButton -> Bool # (>=) :: MouseButton -> MouseButton -> Bool # max :: MouseButton -> MouseButton -> MouseButton # min :: MouseButton -> MouseButton -> MouseButton #
Read MouseButton Source #
Methods readsPrec :: Int -> ReadS MouseButton # readList :: ReadS [MouseButton] # readPrec :: ReadPrec MouseButton # readListPrec :: ReadPrec [MouseButton] #
Show MouseButton Source #
Methods showsPrec :: Int -> MouseButton -> ShowS # show :: MouseButton -> String # showList :: [MouseButton] -> ShowS #
Generic MouseButton Source #
Associated Types type Rep MouseButton :: * -> * # Methods from :: MouseButton -> Rep MouseButton x # to :: Rep MouseButton x -> MouseButton #
type Rep MouseButton Source #
type Rep MouseButton = D1 (MetaData "MouseButton" "SDL.Input.Mouse" "sdl2-2.1.2-4UU7MvzI4nolG4tt1i7Fa" False) ((:+:) ((:+:) (C1 (MetaCons "ButtonLeft" PrefixI False) U1) ((:+:) (C1 (MetaCons "ButtonMiddle" PrefixI False) U1) (C1 (MetaCons "ButtonRight" PrefixI False) U1))) ((:+:) (C1 (MetaCons "ButtonX1" PrefixI False) U1) ((:+:) (C1 (MetaCons "ButtonX2" PrefixI False) U1) (C1 (MetaCons "ButtonExtra" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))))

data MouseDevice Source #

Identifies what kind of mouse-like device this is.

Constructors

Mouse !Int	An actual mouse. The number identifies which mouse.
Touch	Some sort of touch device.

Instances

Eq MouseDevice Source #
Methods (==) :: MouseDevice -> MouseDevice -> Bool # (/=) :: MouseDevice -> MouseDevice -> Bool #
Data MouseDevice Source #
Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> MouseDevice -> c MouseDevice # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c MouseDevice # toConstr :: MouseDevice -> Constr # dataTypeOf :: MouseDevice -> DataType # dataCast1 :: Typeable (* -> ) t => (forall d. Data d => c (t d)) -> Maybe (c MouseDevice) # dataCast2 :: Typeable ( -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c MouseDevice) # gmapT :: (forall b. Data b => b -> b) -> MouseDevice -> MouseDevice # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> MouseDevice -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> MouseDevice -> r # gmapQ :: (forall d. Data d => d -> u) -> MouseDevice -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> MouseDevice -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> MouseDevice -> m MouseDevice # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> MouseDevice -> m MouseDevice # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> MouseDevice -> m MouseDevice #
Ord MouseDevice Source #
Methods compare :: MouseDevice -> MouseDevice -> Ordering # (<) :: MouseDevice -> MouseDevice -> Bool # (<=) :: MouseDevice -> MouseDevice -> Bool # (>) :: MouseDevice -> MouseDevice -> Bool # (>=) :: MouseDevice -> MouseDevice -> Bool # max :: MouseDevice -> MouseDevice -> MouseDevice # min :: MouseDevice -> MouseDevice -> MouseDevice #
Read MouseDevice Source #
Methods readsPrec :: Int -> ReadS MouseDevice # readList :: ReadS [MouseDevice] # readPrec :: ReadPrec MouseDevice # readListPrec :: ReadPrec [MouseDevice] #
Show MouseDevice Source #
Methods showsPrec :: Int -> MouseDevice -> ShowS # show :: MouseDevice -> String # showList :: [MouseDevice] -> ShowS #
Generic MouseDevice Source #
Associated Types type Rep MouseDevice :: * -> * # Methods from :: MouseDevice -> Rep MouseDevice x # to :: Rep MouseDevice x -> MouseDevice #
type Rep MouseDevice Source #
type Rep MouseDevice = D1 (MetaData "MouseDevice" "SDL.Input.Mouse" "sdl2-2.1.2-4UU7MvzI4nolG4tt1i7Fa" False) ((:+:) (C1 (MetaCons "Mouse" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))) (C1 (MetaCons "Touch" PrefixI False) U1))

Mouse State

getModalMouseLocation :: MonadIO m => m (LocationMode, Point V2 CInt) Source #

Return proper mouse location depending on mouse mode

getMouseLocation :: MonadIO m => m (Point V2 CInt) Source #

Deprecated: Use getAbsoluteMouseLocation instead, or getModalMouseLocation to match future behavior.

getAbsoluteMouseLocation :: MonadIO m => m (Point V2 CInt) Source #

Retrieve the current location of the mouse, relative to the currently focused window.

getRelativeMouseLocation :: MonadIO m => m (Point V2 CInt) Source #

Retrieve mouse motion

getMouseButtons :: MonadIO m => m (MouseButton -> Bool) Source #

Retrieve a mapping of which buttons are currently held down.

Warping the Mouse

data WarpMouseOrigin Source #

Instances

Eq WarpMouseOrigin Source #
Methods (==) :: WarpMouseOrigin -> WarpMouseOrigin -> Bool # (/=) :: WarpMouseOrigin -> WarpMouseOrigin -> Bool #
Data WarpMouseOrigin Source #
Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> WarpMouseOrigin -> c WarpMouseOrigin # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c WarpMouseOrigin # toConstr :: WarpMouseOrigin -> Constr # dataTypeOf :: WarpMouseOrigin -> DataType # dataCast1 :: Typeable (* -> ) t => (forall d. Data d => c (t d)) -> Maybe (c WarpMouseOrigin) # dataCast2 :: Typeable ( -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c WarpMouseOrigin) # gmapT :: (forall b. Data b => b -> b) -> WarpMouseOrigin -> WarpMouseOrigin # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> WarpMouseOrigin -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> WarpMouseOrigin -> r # gmapQ :: (forall d. Data d => d -> u) -> WarpMouseOrigin -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> WarpMouseOrigin -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> WarpMouseOrigin -> m WarpMouseOrigin # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> WarpMouseOrigin -> m WarpMouseOrigin # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> WarpMouseOrigin -> m WarpMouseOrigin #
Ord WarpMouseOrigin Source #
Methods compare :: WarpMouseOrigin -> WarpMouseOrigin -> Ordering # (<) :: WarpMouseOrigin -> WarpMouseOrigin -> Bool # (<=) :: WarpMouseOrigin -> WarpMouseOrigin -> Bool # (>) :: WarpMouseOrigin -> WarpMouseOrigin -> Bool # (>=) :: WarpMouseOrigin -> WarpMouseOrigin -> Bool # max :: WarpMouseOrigin -> WarpMouseOrigin -> WarpMouseOrigin # min :: WarpMouseOrigin -> WarpMouseOrigin -> WarpMouseOrigin #
Show WarpMouseOrigin Source #
Methods showsPrec :: Int -> WarpMouseOrigin -> ShowS # show :: WarpMouseOrigin -> String # showList :: [WarpMouseOrigin] -> ShowS #
Generic WarpMouseOrigin Source #
Associated Types type Rep WarpMouseOrigin :: * -> * # Methods from :: WarpMouseOrigin -> Rep WarpMouseOrigin x # to :: Rep WarpMouseOrigin x -> WarpMouseOrigin #
type Rep WarpMouseOrigin Source #
type Rep WarpMouseOrigin = D1 (MetaData "WarpMouseOrigin" "SDL.Input.Mouse" "sdl2-2.1.2-4UU7MvzI4nolG4tt1i7Fa" False) ((:+:) (C1 (MetaCons "WarpInWindow" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Window))) (C1 (MetaCons "WarpCurrentFocus" PrefixI False) U1))

warpMouse :: MonadIO m => WarpMouseOrigin -> Point V2 CInt -> m () Source #

Move the current location of a mouse pointer. The WarpMouseOrigin specifies the origin for the given warp coordinates.

Cursor Visibility

cursorVisible :: StateVar Bool Source #

Get or set whether the cursor is currently visible.

This StateVar can be modified using $= and the current value retrieved with get.

See SDL_ShowCursor and SDL_HideCursor for C documentation.

Cursor Shape

data Cursor Source #

Instances

Eq Cursor Source #
Methods (==) :: Cursor -> Cursor -> Bool # (/=) :: Cursor -> Cursor -> Bool #

activeCursor :: StateVar Cursor Source #

Get or set the currently active cursor. You can create new Cursors with createCursor.

This StateVar can be modified using $= and the current value retrieved with get.

See SDL_SetCursor and SDL_GetCursor for C documentation.

createCursor Source #

Arguments

:: MonadIO m
=> Vector Bool	Whether this part of the cursor is black. Use `False` for white and `True` for black.
-> Vector Bool	Whether or not pixels are visible. Use `True` for visible and `False` for transparent.
-> V2 CInt	The width and height of the cursor.
-> Point V2 CInt	The X- and Y-axis location of the upper left corner of the cursor relative to the actual mouse position
-> m Cursor

Create a cursor using the specified bitmap data and mask (in MSB format).

freeCursor :: MonadIO m => Cursor -> m () Source #

Free a cursor created with createCursor and createColorCusor.

See SDL_FreeCursor for C documentation.

createColorCursor Source #

Arguments

:: MonadIO m
=> Surface
-> Point V2 CInt	The location of the cursor hot spot
-> m Cursor

Create a color cursor.

See SDL_CreateColorCursor for C documentation.