JS library for displaying 8-bit-styled pixel-images generated by code
Go to file
2021-02-21 19:45:51 +01:00
LICENSE Initial commit 2021-02-21 18:18:04 +01:00
pixelimg.js Update pixelimg.js 2021-02-21 19:02:42 +01:00
README.md Update README.md 2021-02-21 19:45:51 +01:00

Pixelimg.js

GitHub release License Maintaner

Pixelimg.js is a rather small js-library to display code-generated pixel images inside of a html image-element.

Installation

To include Pixelimg.js in your html code you have two options:

  • Either download the pixelimg.js file from the repo and serve it by yourself
  • Or use a CDN

Example using jsdelivr.net:

<script type="text/javascript" src="https://cdn.jsdelivr.net/gh/DrMaxNix/pixelimgjs@1.0/pixelimg.min.js"></script>

Usage

HTML image element

The only two important parts here are:

  1. The element must be an image <img />
  2. The element should have an id-tag (or any other data-tag) which helps specifying the element later when we will be loading data into the image
<img id="img1" />

Create Pixelimg-object

To be able to work with your image you need to create an object for each of them.

const img1 = new Pixelimg(document.getElementById("img1"), {matrix:8, image:512});

Arguments shown above:

  • matrix: The pixel-matrix will have 8 by 8 pixels in size
  • image: The png image which is generated will have a size of 512 by 512 pixels (=resolution)

More arguments for the constructor can be found in the Functions/constructor section.

Functions

constructor

Bla

Examples

1. Do something

2. Do something else