rtx-on
v0.17.0
Published
Use proper ray traced shadow instead of the boring box-shadow
Downloads
433
Readme
RTX: ON
Use proper ray traced shadow instead of the boring box-shadow on your web pages.
Quickstart
Simply add to your web page:
<script type="importmap">
{
"imports": {
"webgl-path-tracing": "https://webgl-path-tracing.steren.fr/webgl-path-tracing.js",
"sylvester": "https://webgl-path-tracing.steren.fr/sylvester.src.js",
"rtx-on": "https://rtx-on.steren.fr/rtx-on.js"
}
}
</script>
<script type="module">
import * as rtx from 'rtx-on';
window.onload = function() {
rtx.on();
}
</script>
See the examples folder for more examples.
Local installation
Install the module with npm install rtx-on
API reference
rtx.on({background, raised})
Turn on the ray traced shadow effect on the provided background elements for the provided raised elements. Removes any existing box shadow effect.
background
element to apply the effect to, defaults to the entire body.raised[]
elevated elements, defaults to children of the background element with a box shadow styledisableIfDarkMode
: iftrue
, will not apply the effect if the user has dark mode enabled, which dims the light of rtx-on. Defaults tofalse
.forceLightMode
: iftrue
, the effect will always apply at full light. Defaults tofalse
. Set totrue
if your website does not implement dark mode.moveLightOnClick
: Set totrue
to move the light under the cursor when clicking on the page. Default to false.
rtx.off()
Turn off the ray traced shadow effect. Restores any existing box shadow effect.
rtx.button()
Display an RTX ON/OFF button on the page. For fun.
Acknowledgements
This module uses webgl-path-tracing, a WebGL path tracing library developed in 2010 by Evan Wallace and later updated by the author of this module.