FRP.Netwire.Input

This module contains definitions for typeclasses and wires to be used in FRP programs that use netwire. In order to use this module, an implementation that provides an instance of one of the underlying typeclasses MonadMouse or MonadKeyboard must be used. In order to not require the GLFW or SDL libraries as dependencies, these instances are provided in separate libraries.

Mouse input

class MouseButton a

Mouse button typeclass. This is used to constrain the type of Monad used | to provide mouse input.

data CursorMode

The mouse cursor mode. This mode is usually dependent on whether or not the mouse is in the bounds of the application window.

Constructors

CursorMode'Disabled

The mouse cursor is disabled

CursorMode'Reset

Reset the cursor to zero between computations

CursorMode'Hidden

The mouse cursor is hidden when over the application

CursorMode'Enabled

The mouse cursor is enabed and visible over the application

Instances

Enum CursorMode

Eq CursorMode

Ord CursorMode

Read CursorMode

Show CursorMode

Mouse input

class (MouseButton mb, Monad m) => MonadMouse mb m | m -> mb where

This monad describes computations that involve mouse input.

Methods

setCursorMode :: CursorMode -> m ()

Sets the cursor mode for all subsequent computations. Note, that many | implementations require some sort of "poll" to read the IO

mbIsPressed :: mb -> m Bool

Returns true if the given mouse button is pressed

releaseButton :: mb -> m ()

Resets the pressed state of the mouse button

cursor :: m (Float, Float)

Get the current cursor location

scroll :: m (Double, Double)

Get the amount of scrolling done in the x and y directions

Mouse input wires

mouseCursor :: MonadMouse mb m => Wire s e m a (Float, Float)

Ignores its input and returns the current normalized mouse coordinates. Regardless of window size, each of the returned coordinates will be in the range [-1, 1].

• Depends: now
• Inhibits: never

mouseDelta :: (MonadFix m, MonadMouse mb m) => Wire s e m a (Float, Float)

Returns the change in mouse coordinates between subsequent time instants

• Depends: before now
• Inhibits: never

mouseMickies :: MonadMouse mb m => Wire s e m a (Float, Float)

The mouse mickies are the offset from zero at each time instant. If this wire is being used, then it is assuming that the cursor mode is set to CursorMode'Reset

• Depends: now
• Inhibits: never

mousePressed :: (Monoid e, MonadMouse mb m) => mb -> Wire s e m a a

Behaves like the identity wire when the mouse button is pressed and inhibits otherwise

• Inhibits: when the mouse button is not pressed

mouseDebounced :: (Monoid e, MonadMouse mb m) => mb -> Wire s e m a a

Behaves like the identity wire for a signle instant when the mouse button is pressed and otherwise inhibits

• Depends: the instant at which the mouse button is pressed
• Inhibits: when the mouse button is not pressed or after it has been pressed

cursorMode :: (MonadMouse mb m, Monoid e) => CursorMode -> Wire s e m a a

Behaves like the identity wire, and inhibits immediately after setting the cursor mode. Common uses of this wire are to switch it to the identity wire: cursorMode CursorMode'Disabled --> mkId

• Inhibits: after now

Keyboard input

class Key a

Key typeclass. This is used to constrain the type of Monad used | to provide keyboard input.

class (Key k, Monad m) => MonadKeyboard k m | m -> k where

This monad describes computations that involve keyboard input.

Methods

keyIsPressed :: k -> m Bool

Returns true if the given key is currently pressed

releaseKey :: k -> m ()

Resets the pressed state of the given key.

Keyboard input wires

keyPressed :: (Monoid e, MonadKeyboard k m) => k -> Wire s e m a a

Behaves like the identity wire when the key is pressed and inhibits otherwise

• Inhibits: when the key is not pressed

keyNotPressed :: (Monoid e, MonadKeyboard k m) => k -> Wire s e m a a

Behaves like the identity wire when the key is not pressed and inhibits otherwise

• Inhibits: when the key is pressed

keyDebounced :: (Monoid e, MonadKeyboard k m) => k -> Wire s e m a a

Behaves like the identity wire for a signle instant when the key is pressed and otherwise inhibits

• Inhibits: when the key is not pressed or after it has been pressed