Skip to content

daveknights/cre8bit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cre8bit logo Cre8bitJS

8bit Space Invader, Ufo, Pacman and Ghost

Cre8bitJS is a lightweight Javascript library that adds 8bit style retro video game characters to your web page as svgs. These are created dynamically allowing for customisation.

npm version GitHub GitHub code size in bytes

Setup

Via npm for use with a bundler.

$ npm install cre8bitjs --save
import cre8bit from 'cre8bitjs';

Or

Download and include the unminified or minified* version in your project (or scripts folder) and specify the path.

import cre8bit from "./cre8bit.js"; // "./cre8bit.min.js"; (For the minified version)

And set your own javascript file to type="module".

* At the time of writing, a minifier that could handle private properties & methods could not be found, so a custom node minifying script was created, shaving nearly 40% off the unminified version.

Usage

// The most basic usage of the library
new cre8bit().create('space invader');

Examples

// Create an svg with custom options
new cre8bit().create('pacman', {size: 12, parentClass: 'container'});

// Some helper methods are available if you need to modify the svg after creation
const pacman = new cre8bit().create('pacman');
pacman.setSize(20);
// Methods can be chained
pacman
  .setColour('#f9eb06')
  .setFlip(true);

// Animation option available for certain characters
const ghost = new cre8bit().create('ghost', {animate: true});
// Cancel animation
ghost.stop();

Character names

Pass one as the first argument to the create method.

  • 'space invader'
  • 'ufo'
  • 'pacman'
  • 'ghost'
  • 'poke ball'
  • 'pikachu'
  • 'mario'
  • 'mushroom'
  • 'kirby'

Look out for new characters.

Options

Optional object passed as the second argument to the create method.

(string) colour - Any valid CSS colour name or hex value e.g: red or #c8b. Characters have a default colour.

(number) size - Up to a maximum size of 70. The default is 5.

(boolean) flip - The default is false.

(boolean) animate - Only available currently with space invader, pacman & ghost.

(boolean) reflection - The default is false.

(string) parentClass - Use this to add the svg to an existing DOM element by providing the class name. If none is provided they are added to the document body.

(string) wrapperClass - Use this to wrap the svg in a div with the class name provided.

(boolean) outline - Add an outline to all paths of a character. Useful if there is not enough contrast between the character colour and your page background, or the character (parts of the character) are the same colour as your page.

(array) responsive - Pass an array of exactly 3 numbers for the size you want to display the character on mobile, tablet(768px) and desktop(1000px). E.g: [6, 8, 12]. All 3 values don't need to be different if, for example, you want to use the same size at tablet and desktop but you do still need to pass 3 values. E.g: [6, 12, 12].

Helper methods

setColour(string) - Any valid CSS colour name or hex value e.g: red or #c8b. Characters have a default colour.

setSize(number) - Up to a maximum size of 70. The default is 5.

setFlip(boolean) - The default is false.

stop() - Stop a currently animating character.

In action

See some examples of the library in use.

Try out the library in the Cre8bitJS Playground.

Browser support

Works in latest version of all major desktop browsers and latest version of major Android & IOS browsers.