karlib

A minimal HTML5 canvas rendering library. Fine tuned for web games development.

API Docs

https://goldenratio.github.io/karlib/

Install

NPM

npm install --save @goldenratio/karlib

https://www.npmjs.com/package/@goldenratio/karlib

Run Examples

npm run example draw_rect

Check examples folder for list of examples to run.

Basic Example

Try this example on CodePen

import { BrowserEnv, Karlib, BrowserTicker } from "https://unpkg.com/@goldenratio/karlib@latest/target/karlib.min.js";

async function main() {
  const canvas = document.getElementById("my_game");
  const { width, height } = canvas;

  const rect_width = 100;
  const rect_height = 100;

  let x = canvas.width / 2 - rect_width / 2;
  let y = canvas.height / 2 - rect_height / 2;

  let vx = Math.random() * 10 - 5;
  let vy = Math.random() * 10 - 5;

  const kl = new Karlib({canvas, env: new BrowserEnv()});

  const ticker = new BrowserTicker();
  ticker.on_tick(({ delta_time }) => {
    // Update position
    x += vx * delta_time;
    y += vy * delta_time;

    // Bounce off horizontal walls
    if (x + rect_width >= width || x <= 0) {
      vx *= -1;
      x = x + rect_width >= width ? width - rect_width : 0;
    }

    // Bounce off vertical walls
    if (y + rect_height >= height || y <= 0) {
      vy *= -1;
      y = y + rect_height >= height ? height - rect_height : 0;
    }

    // draw
    kl.clear_background("#000");
    kl.draw_rectangle({
      x: x,
      y: y,
      width: rect_width,
      height: rect_height,
      fill_style: "#ff0000",
    });
  });

}

main();

Showcase

Games created using karlib:

• Cat-aplut

Inspirations

• Raylib
• Tsoding

Release

NPM

npm version {major | minor | patch}
npm publish

# If you have ignore-scripts enabled
npm version {major | minor | patch}
npm run version
npm run postversion
npm publish