mokargas / aframe-area-light-component

Add Area Lights to an A-Frame entity
https://mokargas.github.io/aframe-area-light-component
MIT License
21 stars 2 forks source link
a-frame aframe area-light component threejs

aframe-area-light-component

Version License

Add Area Lights to an A-Frame entity. Uses THREE.RectAreaLight at the core.

WARNING: Area Lights are highly experimental and performance intensive at the moment. Please use sparingly

Example of Area Light

For A-Frame

Examples

API

Property Description Default Value
intensity intensity of the light output 1.0
color color of the light output (and helper if enabled) 1.0
width width of the light output 2.0
height height of the light output 2.0
showHelper Show the RectAreaLightHelper. Useful for positioning lights in the Inspector, or as a quick panel light (Note that the helper is single sided) true
helperColor Given showHelper is enabled, set a custom color for it here undefined

Installation

Browser

Install and use by directly including the browser files:

<head>
  <title>My A-Frame Scene</title>
  <script src="https://aframe.io/releases/0.6.1/aframe.min.js"></script>
  <script src="https://unpkg.com/aframe-area-light-component/dist/aframe-area-light-component.min.js"></script>
</head>

<body>
  <a-scene>
    <a-entity area-light="intensity:4; width:1; height:1; color: #FFFFFF;"></a-entity>
  </a-scene>
</body>

npm

Install via npm:

npm install aframe-area-light-component

Then require and use.

require('aframe');
require('aframe-area-light-component');

Recommended enhancements

TODO