PixiJS Lights

 

A plugin that adds deferred lighting to PixiJS.

Note: This modules requires v6.0.4+ of pixi.js and v1.0.0 of @pixi/layers.

For pixi-v4 see v4.x branch.

* Demo

Usage

You have to create three layers: one for sprites, one for their normals and one for lights. Sprites and normals are rendered to temporary RenderTexture, and lights have those two textures as an input.

``js
// Get class references
import {Application, Sprite, Container, lights} from 'pixi.js';
import {Layer, Stage} from '@pixi/layers';
import {diffuseGroup, normalGroup, lightGroup, PointLight} from 'pixi-lights';

// Create new application
const app = new Application({
backgroundColor: 0x000000, // Black is required!
width: 800,
height: 600
});
document.body.appendChild(app.view);

// Use the pixi-layers Stage instead of default Container
app.stage = new Stage();

// Add the background diffuse color
const diffuse = Sprite.fromImage('images/BGTextureTest.jpg');
diffuse.parentGroup = diffuseGroup;

// Add the background normal map
const normals = Sprite.fromImage('images/BGTextureNORM.jpg');
normals.parentGroup = normalGroup;

// Create the point light
const light = new PointLight(0xffffff, 1);
light.x = app.screen.width / 2;
light.y = app.screen.height / 2;

// Create a background container
const background = new Container();
background.addChild(
normals,
diffuse,
light
);

app.stage.addChild(
// put all layers for deferred rendering of normals
new Layer(diffuseGroup),
new Layer(normalGroup),
new Layer(lightGroup),
// Add the lights and images
background
);
`

$3

If you want to use light shaders inside a filter, make sure its full-screen:

`js
app.stage.filters = [new BlurFilter()];
app.stage.filterArea = app.screen;
`

Vanilla JS, UMD build

All pixiJS v6 plugins has special umd build suited for vanilla.
Navigate pixi-lights npm package, take dist/pixi-lights.umd.js file.

`html


`

all classes can be accessed through PIXI.lights package.

Building

You normally don't need to build this module, you can just download a release from the releases page.

However, if you are developing on the project or want a bleeding edge build then you
will need to have [node][node] setup on your machine.

Then you can install dependencies and build:

`js
npm i && npm run build
`

That will output the built distributables to ./lib and ./dist`.

[node]: http://nodejs.org/

Roadmap

1. More lighting types, left are:
- Spot lights
- Hemisphere lights
- Area lights
2. Add dynamic shadows
3. Write tests!