Skip to content

graticule()

Convenience function to create an App instance from a canvas element.

Signature

ts
function graticule(canvas: HTMLCanvasElement, config?: AppConfig): App

Parameters

ParamTypeDescription
canvasHTMLCanvasElementThe canvas element to render to
configAppConfigOptional configuration

AppConfig

Extends ScreenConfig:

PropertyTypeDefaultDescription
fontstring'SF Mono, IBM Plex Mono, monospace'Monospace font family
fontSizenumber14Font size in pixels
fgstring'#c0c0c0'Default foreground color
bgstring'#0a0a0a'Background color
lineHeightnumber1.2Line height multiplier
hoverbooleantrueEnable hover highlighting
hoverColorstring'#ffffff'Hover highlight color

Returns

An App instance.

Example

ts
import { graticule } from 'graticule'

const app = graticule(document.getElementById('screen'), {
  fontSize: 16,
  bg: '#000000',
})

app.render = (cols, rows) => {
  // ...
  return { grid: g }
}

app.start()