@absolutejs/rendering 0.4.0 → 0.5.0

package/README.md

@@ -131,3 +131,15 @@ owned textures separately. Standard lighting, shadows and geometry stay intact.
 With color, normal and roughness present, the shader uses nine texture samples
 instead of three UV samples, with no extra draw or render pass. Hardware cost is
 scene-dependent; the qualification uses software rendering, not a hardware FPS claim.
+
+### Thin foliage
+
+`createThinFoliageMaterial({ leafTransmission: 0.35 })` creates a standard
+material with approximate thin-leaf backlighting. Transmission is a bounded
+fraction (0–1) of direct diffuse; zero retains standard lighting. The shader
+uses Three's shadowed incident light, preserving PBR specular, indirect lighting,
+fog and tone mapping. Area lights retain standard lighting. This is a lightweight
+leaf approximation, not volumetric subsurface scattering or a complete grass
+renderer. Distribution, blade shape, wind and terrain integration remain the
+caller's responsibility. Compose custom shader hooks after the factory hook;
+use `cloneRenderMaterial` to preserve them when cloning.

package/dist/index.d.ts

@@ -14,3 +14,5 @@ export declare function cloneRenderMaterial<T extends Material>(source: T): T;
 export { renderTargetScope, readTargetPixelsScoped, readFloatTargetScoped, } from "./renderTargetScope.js";
 export { createObjectTriplanarMaterial } from "./objectTriplanar.js";
 export type { ObjectTriplanarProjection, ObjectTriplanarMaterialParameters, } from "./objectTriplanar.js";
+export { createThinFoliageMaterial } from './thinFoliage.js';
+export type { ThinFoliageMaterialParameters } from './thinFoliage.js';

package/dist/index.js

@@ -77,3 +77,4 @@ export function cloneRenderMaterial(source) {
 }
 export { renderTargetScope, readTargetPixelsScoped, readFloatTargetScoped, } from "./renderTargetScope.js";
 export { createObjectTriplanarMaterial } from "./objectTriplanar.js";
+export { createThinFoliageMaterial } from './thinFoliage.js';

package/dist/thinFoliage.d.ts

@@ -0,0 +1,11 @@
+import { MeshStandardMaterial, type MeshStandardMaterialParameters } from 'three';
+export type ThinFoliageMaterialParameters = MeshStandardMaterialParameters & {
+    /** Fraction of direct diffuse allocated to approximate leaf transmission, 0..1. */
+    leafTransmission?: number;
+};
+/** Approximate thin-leaf backlighting using Three's already shadowed direct light.
+ * Not volumetric transmission. No extra render pass, texture, or animation loop.
+ * Area-light and environment paths retain standard shading. Use
+ * cloneRenderMaterial to preserve shader hooks when cloning.
+ */
+export declare function createThinFoliageMaterial(options?: ThinFoliageMaterialParameters): MeshStandardMaterial;

package/dist/thinFoliage.js

@@ -0,0 +1,34 @@
+import { DoubleSide, MeshStandardMaterial } from 'three';
+/** Approximate thin-leaf backlighting using Three's already shadowed direct light.
+ * Not volumetric transmission. No extra render pass, texture, or animation loop.
+ * Area-light and environment paths retain standard shading. Use
+ * cloneRenderMaterial to preserve shader hooks when cloning.
+ */
+export function createThinFoliageMaterial(options = {}) {
+    const { leafTransmission = 0.35, ...parameters } = options;
+    if (!Number.isFinite(leafTransmission) || leafTransmission < 0 || leafTransmission > 1)
+        throw Error('Invalid leaf transmission');
+    const material = new MeshStandardMaterial({ side: DoubleSide, roughness: 0.85, ...parameters });
+    material.onBeforeCompile = shader => {
+        const anchor = '#include <lights_physical_pars_fragment>';
+        if (shader.fragmentShader.split(anchor).length !== 2)
+            throw Error('Unsupported thin-foliage shader');
+        shader.uniforms.absLeafTransmission = { value: leafTransmission };
+        shader.fragmentShader = shader.fragmentShader.replace(anchor, `${anchor}
+uniform float absLeafTransmission;
+void absLeafDirect(const in IncidentLight light, const in vec3 p, const in vec3 n,
+ const in vec3 v, const in vec3 coatN, const in PhysicalMaterial m, inout ReflectedLight result) {
+ vec3 previousDiffuse=result.directDiffuse;
+ RE_Direct_Physical(light,p,n,v,coatN,m,result);
+ float through=max(0.,dot(-n,light.direction));
+ float forward=max(0.,dot(v,-light.direction));
+ vec3 transmitted=light.color*BRDF_Lambert(m.diffuseColor)*through*(.5+.5*forward*forward);
+ result.directDiffuse=previousDiffuse+mix(result.directDiffuse-previousDiffuse,transmitted,absLeafTransmission);
+}
+#undef RE_Direct
+#define RE_Direct absLeafDirect
+`);
+    };
+    material.customProgramCacheKey = () => `absolute-thin-foliage-1:${leafTransmission}`;
+    return material;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/rendering",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Three.js material ownership, destination coverage, rigid-object triplanar mapping and isolated React Spring hosts.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,8 @@
     "check:package": "bun run build && bun run test",
     "test:browser": "bun scripts/verify-browser.cjs",
     "test:spring:browser": "bun scripts/verify-spring.cjs",
-    "test:triplanar:browser": "bun scripts/verify-triplanar.cjs"
+    "test:triplanar:browser": "bun scripts/verify-triplanar.cjs",
+    "test:foliage:browser": "bun scripts/verify-foliage.cjs"
   },
   "peerDependencies": {
     "three": ">=0.186.0 <0.187.0",