Reactor.Types
- Package
- purescript-grid-reactors
- Repository
- Eugleo/purescript-grid-reactors
This module introduces the Reactor as a datatype.
As the Pyret documentation puts it,
a reactor is a value enabling the creation of time-based animations, simulations, and interactive programs.
During the creation of a reactor, the user supplies a function for handling clock ticks,
and functions for handling mouse and keyboard input events.
The reactor calls these event handlers whenever the respective event occurs.
From within the event handlers, the reactor's state — or, the world, as we call it —
can be updated. After each world update, the reactor renders the new world with the supplied drawing function.
#Reactor Source
type Reactor world = { draw :: world -> Drawing, handleEvent :: Event -> Reaction world, initial :: world, isPaused :: world -> Boolean }The reactor is a simple record. Reactors are parametrized over the type of the world which is saved in the reactor.
The fields in the record are the following:
initialis the initial state of the reactor's worldisPausedis a function used by the reactor to find out whether its internal clock should be paused or not. The clock is paused whenisPausedreturnstrue.drawis a function used to render the world anytime it is changedhandleEventis a function for handling the three types of events that can occur during your game or simulation: keypress events, mouse events, and tick events. The events are handled by running theReactionreturned byhandleEvent.- Tick events are fired on every tick of the reactor's clock, around 60 times a second, provided the reactor is not paused.
- Keypress events are fired when a key on a keyboard is pressed.
- Mouse events are fired whenever a mouse is moved above the canvas (the drawing area of the reactor), when the canvas is clicked, or when the user drags something (i.e. clicks and then moves the mouse).
#Configuration Source
type Configuration = { height :: Int, title :: String, widgets :: Array (String /\ Widget), width :: Int }Configuration for the Halogen component that renders the reactor. The component creates everything on the webpage you see when you run the reactor. Although a reactor is a general structure, this library focuses on reactors with grid-based rendering. The component thus needs a little more info than just what is in already the reactor, namely:
title, the title of the webpage where the reactor is renderedwidth, the width of the grid, in tilesheightthe height of the grid, in tileswidgetsis an array of widgets that are present in the Reactor from the start, ordered from top-most to bottom-most Notably, the size of the rendered tiles isn't customizable and is set to 30pts.