@dailies-studio/tsl-textures 3.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Pavel Boytchev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# tsl-textures
+
+> This is a vendored fork of tsl-textures@3.0.4 (Pavel Boytchev, MIT) carrying the perlin-noise/static-noise clamp fix until it lands upstream: upstream calls `clamp(0, 1, k)`, but three's `clamp` signature is `(value, min, max)`, so the fix replaces it with `k.min(1)` in `perlinNoiseRaw` and `staticNoiseRaw`.
+
+A collection of Three.js Shading Language (TSL) textures –
+these are online real-time procedural generators of 3D textures.
+
+Pick a texture from the [Project home page](https://boytchev.github.io/tsl-textures/).
+
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/planet/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/planet/index.html)
+[<img src="https://boytchev.github.io/tsl-textures/examples/normal-map/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/normal-map/index.html)
+[<img src="https://boytchev.github.io/tsl-textures/examples/wooden-toys/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/wooden-toys/index.html)
+[<img src="https://boytchev.github.io/tsl-textures/examples/protozoa/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/protozoa/index.html)
+[<img src="https://boytchev.github.io/tsl-textures/examples/neck-massage/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/neck-massage/index.html)
+[<img src="https://boytchev.github.io/tsl-textures/examples/watermelon/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/watermelon/index.html)
+[<img src="https://boytchev.github.io/tsl-textures/examples/texture-in-motion/screenshot.jpg" width="200">](https://boytchev.github.io/tsl-textures/examples/texture-in-motion/index.html)
+
+<!--
+#### Example "Planet"
+
+Uses [planet.js](https://boytchev.github.io/tsl-textures/docs/planet.html)
+for both the planet and its moon; and [stars.js](https://boytchev.github.io/tsl-textures/docs/stars.html)
+for the stars. Click on the image for a live demo.
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-planet.jpg">](https://boytchev.github.io/tsl-textures/examples/example-planet.html)
+
+
+#### Example "Normal map"
+
+Uses tsl-utils.js to generate two normal maps and the transition between them.
+The normal are created directly without using any of the TSL texture generators.
+Click on the image for a live demo.
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-normal-map.jpg">](https://boytchev.github.io/tsl-textures/examples/example-normal-map.html)
+
+
+#### Example "Wooden toys"
+
+Uses [wood.js](https://boytchev.github.io/tsl-textures/docs/wood.html) texture
+to convert flat-color 3D models (an ambulance, a race car and a luxury SUV from
+Car Kit (1.4) by Kenney [www.kenney.nl](https://www.kenney.nl/)) into wooden toys.
+All the wood textures are procedurally generated in real-time. Click on the image
+for a live demo. (Note: non-WebGPU browsers might need 30+ seconds to start up.)
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-wooden-toys.jpg">](https://boytchev.github.io/tsl-textures/examples/example-wooden-toys.html)
+
+
+#### Example "Protozoa"
+
+Uses [protozoa.js](https://boytchev.github.io/tsl-textures/docs/protozoa.html)
+texture to create a dynamic blob with microorganisms floating innside. A space
+station is constructed arounnd the blob. The surface of the station is made of
+a Dyson sphere texture from [dyson-texture.js](https://boytchev.github.io/tsl-textures/docs/dyson-sphere.html).
+Click on the image for a live demo.
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-protozoa.jpg">](https://boytchev.github.io/tsl-textures/examples/example-protozoa.html)
+
+
+#### Example "Neck massage"
+
+Uses [rotator.js](https://boytchev.github.io/tsl-textures/docs/rotator.html)
+texture that applies soft matrices on model vertices. This allows to make
+gradual rotation that looks like stretching skin and flexing muscles. The
+animation does not use skinning or morphing, the model is not preprocessed
+in any way, and no additional vertex data is added. Click on the image
+for a live demo. 
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-neck-massage.jpg">](https://boytchev.github.io/tsl-textures/examples/example-neck-massage.html)
+
+
+#### Example "Watermelon supersphere"
+
+Uses [supersphere.js](https://boytchev.github.io/tsl-textures/docs/supersphere.html)
+texture to generate the shape of a [supersphere](https://mathworld.wolfram.com/Supersphere.html)
+and [watermelon.js](https://boytchev.github.io/tsl-textures/docs/watermelon.html)
+texture to color the surface in a watermelon pattern. Both the shape and the pattern
+are continuously changing. Click on the image for a live demo.
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-watermelon-supersphere.jpg">](https://boytchev.github.io/tsl-textures/examples/example-watermelon-supersphere.html)
+
+
+#### Example "Texture in motion"
+
+Uses [dyson-sphere.js](https://boytchev.github.io/tsl-textures/docs/dyson-sphere.html),
+[camouflage.js](https://boytchev.github.io/tsl-textures/docs/camouflage.html),
+[dalmatian-spots.js](https://boytchev.github.io/tsl-textures/docs/dalmatian-spots.html) and
+[planet.js](https://boytchev.github.io/tsl-textures/docs/planet.html) textures
+and applies them on the elements of an animated GLTF model. Textures are blended
+via a TSL function. Click on the image for a live demo. (Note: non-WebGPU browsers
+might need 30+ seconds to start up.)
+
+[<img src="https://boytchev.github.io/tsl-textures/examples/example-texture-in-motion.jpg">](https://boytchev.github.io/tsl-textures/examples/example-texture-in-motion.html)
+-->
+
+## Usage
+
+### Use with NPM
+
+**Install**
+```bat
+npm install three tsl-textures
+```
+
+**Use in a javascript file**
+```js
+// Important: Use `webgpu` version of Three.js
+import * as THREE from 'three/webgpu';
+
+// Import your desired texture
+import { polkaDots } from 'tsl-textures/polka-dots';
+
+// Create the renderer. Important: Use `WebGPURenderer`
+renderer = new THREE.WebGPURenderer({antialias: true});
+
+// ... Create your Three.js scene, camera, lights, etc.
+
+// Create geometry
+const objectGeometry = new THREE.IcosahedronGeometry(1, 12)
+
+// Create material: Important: Use `Node` Material
+objectMaterial = new THREE.MeshStandardNodeMaterial({
+    color: 0xCCCCCC,
+    roughness: 0.5,
+    metalness: 0.0,
+});
+
+// Apply texture to the material's `colorNode` property
+objectMaterial.colorNode = polkaDots ( {
+    count: 2,
+    size: 0.6,
+    blur: 0.22,
+    color: new THREE.Color(0),
+    background: new THREE.Color(16777215)
+} );
+
+// Assign Geometry and Material to a Mesh
+object = new THREE.Mesh(objectGeometry, objectMaterial);
+
+// Render
+renderer.render( scene, camera );
+```