@opsydyn/effect-three 0.0.0-stage → 0.1.0

package/dist/kernel/contactShadowPasses.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Contact shadows, drawn by the frame loop with the scene's renderer: the passes, shared
+ * by every render kit, which supplies the materials (`ShadowMaterials`).
+ *
+ * Behavioural reference: Drei `src/core/ContactShadows.tsx` at `bf6f4ad`, itself after
+ * three.js's `webgl_shadow_contact` example by mrdoob (both MIT). As there, every drawn
+ * frame:
+ *
+ * 1. renders the scene from below with an orthographic camera into a texture, through a
+ *    depth material that turns nearness to the ground into shadow (alpha `1 − depth`,
+ *    colour `color · depth · 2`), with the background off and the shadow plane hidden;
+ * 2. blurs it horizontally and vertically (`blur / 256`), twice with `smooth` (the second
+ *    at 0.4 of the blur);
+ * 3. shows it on a transparent plane facing up.
+ *
+ * One difference: the blur passes draw a quad with their own camera, so they fill the
+ * texture wherever the shadows are placed. (Drei draws its quad at the world origin with
+ * the shadow camera, which leaves the blur empty when the shadows sit above `y = 0`.)
+ *
+ * @module
+ */
+import { Color, type Material, type Texture } from 'three';
+import type { SceneRenderer } from './renderer.ts';
+import type { ContactShadowPasses, ShadowedScene } from './renderKit.ts';
+/** One blur direction's material, and how to point it at a texture by an amount. */
+export type BlurPass = {
+    readonly material: Material;
+    /** Reads `source`, blurring by `amount` of the texture's width (or height). */
+    readonly set: (source: Texture, amount: number) => void;
+};
+/** What a render kit draws contact shadows with. */
+export type ShadowMaterials = {
+    /**
+     * The material the scene is drawn through from below: colour `color · depth · 2`, alpha
+     * `1 − depth`, no depth test or write.
+     */
+    readonly depth: (color: Color) => Material;
+    readonly blur: (direction: 'horizontal' | 'vertical') => BlurPass;
+    /**
+     * Whether the renderer reads a target's texture with v running the other way from
+     * WebGL's: three's WebGPU renderer does, on either backend.
+     */
+    readonly flippedTargets: boolean;
+};
+/** Creates the contact shadow passes for one scene graph and renderer, with `materials`. */
+export declare const createContactShadowPasses: (graph: ShadowedScene, renderer: SceneRenderer, materials: ShadowMaterials) => ContactShadowPasses;
+//# sourceMappingURL=contactShadowPasses.d.ts.map

package/dist/kernel/contactShadowPasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactShadowPasses.d.ts","sourceRoot":"","sources":["../../src/kernel/contactShadowPasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,KAAK,EACL,KAAK,QAAQ,EAMb,KAAK,OAAO,EAEb,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEzE,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,GAAG,UAAU,KAAK,QAAQ,CAAC;IAClE;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC,CAAC;AAqCF,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,UAC7B,aAAa,YACV,aAAa,aACZ,eAAe,KACzB,mBA2GF,CAAC"}