1.0.1 • Published 7 years ago

aframe-area-light-component v1.0.1

Weekly downloads
27
License
MIT
Repository
github
Last release
7 years ago

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

PropertyDescriptionDefault Value
intensityintensity of the light output1.0
colorcolor of the light output (and helper if enabled)1.0
widthwidth of the light output2.0
heightheight of the light output2.0
showHelperShow the RectAreaLightHelper. Useful for positioning lights in the Inspector, or as a quick panel light (Note that the helper is single sided)true
helperColorGiven showHelper is enabled, set a custom color for it hereundefined

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

  • Combine with A-Frame Effects post-processing effects like Bloom and showHelper:true for a neat glow effect

TODO

  • Add tests :)
  • Performance fixes
  • Enable a simple plane rather than a helper (?)