Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions build/three.cjs
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
*/
'use strict';

const REVISION = '183dev';
const REVISION = '183';

/**
* Represents mouse buttons and interaction types in context of controls.
Expand Down Expand Up @@ -76262,7 +76262,11 @@ class WebGLRenderer {

}

_gl.clear( bits );
if ( bits !== 0 ) {

_gl.clear( bits );

}

};

Expand Down
2 changes: 1 addition & 1 deletion build/three.core.js
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
* Copyright 2010-2026 Three.js Authors
* SPDX-License-Identifier: MIT
*/
const REVISION = '183dev';
const REVISION = '183';

/**
* Represents mouse buttons and interaction types in context of controls.
Expand Down
2 changes: 1 addition & 1 deletion build/three.core.min.js

Large diffs are not rendered by default.

6 changes: 5 additions & 1 deletion build/three.module.js
Original file line number Diff line number Diff line change
Expand Up @@ -16801,7 +16801,11 @@ class WebGLRenderer {

}

_gl.clear( bits );
if ( bits !== 0 ) {

_gl.clear( bits );

}

};

Expand Down
2 changes: 1 addition & 1 deletion build/three.module.min.js

Large diffs are not rendered by default.

71 changes: 48 additions & 23 deletions build/three.webgpu.js

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion build/three.webgpu.min.js

Large diffs are not rendered by default.

71 changes: 48 additions & 23 deletions build/three.webgpu.nodes.js

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion build/three.webgpu.nodes.min.js

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1491,6 +1491,7 @@ <h2>TSL</h2>
<li><a href="TSL.html#viewZToLogarithmicDepth">viewZToLogarithmicDepth</a></li>
<li><a href="TSL.html#viewZToOrthographicDepth">viewZToOrthographicDepth</a></li>
<li><a href="TSL.html#viewZToPerspectiveDepth">viewZToPerspectiveDepth</a></li>
<li><a href="TSL.html#viewZToReversedOrthographicDepth">viewZToReversedOrthographicDepth</a></li>
<li><a href="TSL.html#viewZToReversedPerspectiveDepth">viewZToReversedPerspectiveDepth</a></li>
<li><a href="TSL.html#viewport">viewport</a></li>
<li><a href="TSL.html#viewportCoordinate">viewportCoordinate</a></li>
Expand Down
14 changes: 7 additions & 7 deletions docs/llms-full.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ CORRECT - modern pattern (always use latest version):
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.182.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.182.0/examples/jsm/"
"three": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.183.0/examples/jsm/"
}
}
</script>
Expand Down Expand Up @@ -100,8 +100,8 @@ When using TSL, use node-based materials:
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.182.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.182.0/examples/jsm/"
"three": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.183.0/examples/jsm/"
}
}
</script>
Expand Down Expand Up @@ -175,9 +175,9 @@ renderer.setAnimationLoop( animate );
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.182.0/build/three.webgpu.js",
"three/tsl": "https://cdn.jsdelivr.net/npm/three@0.182.0/build/three.tsl.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.182.0/examples/jsm/"
"three": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.webgpu.js",
"three/tsl": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.tsl.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.183.0/examples/jsm/"
}
}
</script>
Expand Down
4 changes: 2 additions & 2 deletions docs/llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ CORRECT - modern pattern (always use latest version):
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.182.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.182.0/examples/jsm/"
"three": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.183.0/examples/jsm/"
}
}
</script>
Expand Down
30 changes: 27 additions & 3 deletions docs/pages/GLSLNodeBuilder.html
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,7 @@ <h3 class="name name-method" id="generateTexture" translate="no">.<a href="#gene
<dt class="tag-returns"><strong>Returns:</strong> The GLSL snippet.</dt>
</dl>
</div>
<h3 class="name name-method" id="generateTextureBias" translate="no">.<a href="#generateTextureBias">generateTextureBias</a><span class="signature">( texture : <span class="param-type"><a href="Texture.html">Texture</a></span>, textureProperty : <span class="param-type">string</span>, uvSnippet : <span class="param-type">string</span>, biasSnippet : <span class="param-type">string</span>, offsetSnippet : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
<h3 class="name name-method" id="generateTextureBias" translate="no">.<a href="#generateTextureBias">generateTextureBias</a><span class="signature">( texture : <span class="param-type"><a href="Texture.html">Texture</a></span>, textureProperty : <span class="param-type">string</span>, uvSnippet : <span class="param-type">string</span>, biasSnippet : <span class="param-type">string</span>, depthSnippet : <span class="param-type">string</span>, offsetSnippet : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
<div class="method">
<div class="description">
<p>Generates the GLSL snippet when sampling textures with a bias to the mip level.</p>
Expand Down Expand Up @@ -286,6 +286,14 @@ <h3 class="name name-method" id="generateTextureBias" translate="no">.<a href="#
<p>A GLSL snippet that represents the bias to apply to the mip level before sampling.</p>
</td>
</tr>
<tr>
<td class="name">
<strong translate="no">depthSnippet</strong>
</td>
<td class="description last">
<p>A GLSL snippet that represents 0-based texture array index to sample.</p>
</td>
</tr>
<tr>
<td class="name">
<strong translate="no">offsetSnippet</strong>
Expand Down Expand Up @@ -371,7 +379,7 @@ <h3 class="name name-method" id="generateTextureCompare" translate="no">.<a href
<dt class="tag-returns"><strong>Returns:</strong> The GLSL snippet.</dt>
</dl>
</div>
<h3 class="name name-method" id="generateTextureGrad" translate="no">.<a href="#generateTextureGrad">generateTextureGrad</a><span class="signature">( texture : <span class="param-type"><a href="Texture.html">Texture</a></span>, textureProperty : <span class="param-type">string</span>, uvSnippet : <span class="param-type">string</span>, gradSnippet : <span class="param-type">Array.&lt;string></span>, offsetSnippet : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
<h3 class="name name-method" id="generateTextureGrad" translate="no">.<a href="#generateTextureGrad">generateTextureGrad</a><span class="signature">( texture : <span class="param-type"><a href="Texture.html">Texture</a></span>, textureProperty : <span class="param-type">string</span>, uvSnippet : <span class="param-type">string</span>, gradSnippet : <span class="param-type">Array.&lt;string></span>, depthSnippet : <span class="param-type">string</span>, offsetSnippet : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
<div class="method">
<div class="description">
<p>Generates the GLSL snippet for sampling/loading the given texture using explicit gradients.</p>
Expand Down Expand Up @@ -410,6 +418,14 @@ <h3 class="name name-method" id="generateTextureGrad" translate="no">.<a href="#
<p>An array holding both gradient GLSL snippets.</p>
</td>
</tr>
<tr>
<td class="name">
<strong translate="no">depthSnippet</strong>
</td>
<td class="description last">
<p>A GLSL snippet that represents 0-based texture array index to sample.</p>
</td>
</tr>
<tr>
<td class="name">
<strong translate="no">offsetSnippet</strong>
Expand All @@ -424,7 +440,7 @@ <h3 class="name name-method" id="generateTextureGrad" translate="no">.<a href="#
<dt class="tag-returns"><strong>Returns:</strong> The GLSL snippet.</dt>
</dl>
</div>
<h3 class="name name-method" id="generateTextureLevel" translate="no">.<a href="#generateTextureLevel">generateTextureLevel</a><span class="signature">( texture : <span class="param-type"><a href="Texture.html">Texture</a></span>, textureProperty : <span class="param-type">string</span>, uvSnippet : <span class="param-type">string</span>, levelSnippet : <span class="param-type">string</span>, offsetSnippet : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
<h3 class="name name-method" id="generateTextureLevel" translate="no">.<a href="#generateTextureLevel">generateTextureLevel</a><span class="signature">( texture : <span class="param-type"><a href="Texture.html">Texture</a></span>, textureProperty : <span class="param-type">string</span>, uvSnippet : <span class="param-type">string</span>, levelSnippet : <span class="param-type">string</span>, depthSnippet : <span class="param-type">string</span>, offsetSnippet : <span class="param-type">string</span> )</span><span class="type-signature"> : string</span> </h3>
<div class="method">
<div class="description">
<p>Generates the GLSL snippet when sampling textures with explicit mip level.</p>
Expand Down Expand Up @@ -463,6 +479,14 @@ <h3 class="name name-method" id="generateTextureLevel" translate="no">.<a href="
<p>A GLSL snippet that represents the mip level, with level 0 containing a full size version of the texture.</p>
</td>
</tr>
<tr>
<td class="name">
<strong translate="no">depthSnippet</strong>
</td>
<td class="description last">
<p>A GLSL snippet that represents 0-based texture array index to sample.</p>
</td>
</tr>
<tr>
<td class="name">
<strong translate="no">offsetSnippet</strong>
Expand Down
18 changes: 15 additions & 3 deletions docs/pages/GLSLNodeBuilder.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ A GLSL snippet that represents the offset that will be applied to the unnormaliz

**Returns:** The GLSL snippet.

### .generateTextureBias( texture : Texture, textureProperty : string, uvSnippet : string, biasSnippet : string, offsetSnippet : string ) : string
### .generateTextureBias( texture : Texture, textureProperty : string, uvSnippet : string, biasSnippet : string, depthSnippet : string, offsetSnippet : string ) : string

Generates the GLSL snippet when sampling textures with a bias to the mip level.

Expand All @@ -146,6 +146,10 @@ A GLSL snippet that represents texture coordinates used for sampling.

A GLSL snippet that represents the bias to apply to the mip level before sampling.

**depthSnippet**

A GLSL snippet that represents 0-based texture array index to sample.

**offsetSnippet**

A GLSL snippet that represents the offset that will be applied to the unnormalized texture coordinate before sampling the texture.
Expand Down Expand Up @@ -188,7 +192,7 @@ Default is `this.shaderStage`.

**Returns:** The GLSL snippet.

### .generateTextureGrad( texture : Texture, textureProperty : string, uvSnippet : string, gradSnippet : Array.<string>, offsetSnippet : string ) : string
### .generateTextureGrad( texture : Texture, textureProperty : string, uvSnippet : string, gradSnippet : Array.<string>, depthSnippet : string, offsetSnippet : string ) : string

Generates the GLSL snippet for sampling/loading the given texture using explicit gradients.

Expand All @@ -208,13 +212,17 @@ A GLSL snippet that represents texture coordinates used for sampling.

An array holding both gradient GLSL snippets.

**depthSnippet**

A GLSL snippet that represents 0-based texture array index to sample.

**offsetSnippet**

A GLSL snippet that represents the offset that will be applied to the unnormalized texture coordinate before sampling the texture.

**Returns:** The GLSL snippet.

### .generateTextureLevel( texture : Texture, textureProperty : string, uvSnippet : string, levelSnippet : string, offsetSnippet : string ) : string
### .generateTextureLevel( texture : Texture, textureProperty : string, uvSnippet : string, levelSnippet : string, depthSnippet : string, offsetSnippet : string ) : string

Generates the GLSL snippet when sampling textures with explicit mip level.

Expand All @@ -234,6 +242,10 @@ A GLSL snippet that represents texture coordinates used for sampling.

A GLSL snippet that represents the mip level, with level 0 containing a full size version of the texture.

**depthSnippet**

A GLSL snippet that represents 0-based texture array index to sample.

**offsetSnippet**

A GLSL snippet that represents the offset that will be applied to the unnormalized texture coordinate before sampling the texture.
Expand Down
7 changes: 7 additions & 0 deletions docs/pages/GaussianBlurNode.html
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,13 @@ <h3 class="name" id="directionNode" translate="no">.<a href="#directionNode">dir
<p>Defines the direction and radius of the blur.</p>
</div>
</div>
<div class="member">
<h3 class="name" id="isGaussianBlurNode" translate="no">.<a href="#isGaussianBlurNode">isGaussianBlurNode</a><span class="type-signature"> : boolean</span> <span class="type-signature">(readonly) </span></h3>
<div class="description">
<p>This flag can be used for type testing.</p>
<p>Default is <code>true</code>.</p>
</div>
</div>
<div class="member">
<h3 class="name" id="premultipliedAlpha" translate="no">.<a href="#premultipliedAlpha">premultipliedAlpha</a><span class="type-signature"> : boolean</span> </h3>
<div class="description">
Expand Down
6 changes: 6 additions & 0 deletions docs/pages/GaussianBlurNode.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,12 @@ Default is `1`.

Defines the direction and radius of the blur.

### .isGaussianBlurNode : boolean (readonly)

This flag can be used for type testing.

Default is `true`.

### .premultipliedAlpha : boolean

Whether the effect should use premultiplied alpha or not. Set this to `true` if you are going to blur texture input with transparency.
Expand Down
13 changes: 3 additions & 10 deletions docs/pages/NodeBuilder.html
Original file line number Diff line number Diff line change
Expand Up @@ -285,7 +285,9 @@ <h3 class="name" id="scene" translate="no">.<a href="#scene">scene</a><span clas
<div class="member">
<h3 class="name" id="sequentialNodes" translate="no">.<a href="#sequentialNodes">sequentialNodes</a><span class="type-signature"> : Array.&lt;<a href="Node.html">Node</a>></span> </h3>
<div class="description">
<p>A list of all sequential nodes.</p>
<p>A list of all nodes the builder is processing in sequential order.</p>
<p>This is used to determine the update order of nodes, which is important for
NodeUpdateType#UPDATE_BEFORE and NodeUpdateType#UPDATE_AFTER.</p>
</div>
</div>
<div class="member">
Expand Down Expand Up @@ -1392,15 +1394,6 @@ <h3 class="name name-method" id="getBindGroupArray" translate="no">.<a href="#ge
<dt class="tag-returns"><strong>Returns:</strong> The array of node uniform groups.</dt>
</dl>
</div>
<h3 class="name name-method" id="getBindGroupsCache" translate="no">.<a href="#getBindGroupsCache">getBindGroupsCache</a><span class="signature">()</span><span class="type-signature"> : <a href="ChainMap.html">ChainMap</a></span> </h3>
<div class="method">
<div class="description">
<p>Returns the bind groups of the current renderer.</p>
</div>
<dl class="details">
<dt class="tag-returns"><strong>Returns:</strong> The cache.</dt>
</dl>
</div>
<h3 class="name name-method" id="getBindings" translate="no">.<a href="#getBindings">getBindings</a><span class="signature">()</span><span class="type-signature"> : Array.&lt;<a href="BindGroup.html">BindGroup</a>></span> </h3>
<div class="method">
<div class="description">
Expand Down
10 changes: 3 additions & 7 deletions docs/pages/NodeBuilder.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,7 +182,9 @@ Default is `null`.

### .sequentialNodes : Array.<Node>

A list of all sequential nodes.
A list of all nodes the builder is processing in sequential order.

This is used to determine the update order of nodes, which is important for NodeUpdateType#UPDATE\_BEFORE and NodeUpdateType#UPDATE\_AFTER.

### .shaderStage : 'vertex' | 'fragment' | 'compute' | 'any'

Expand Down Expand Up @@ -752,12 +754,6 @@ The shader stage.

**Returns:** The array of node uniform groups.

### .getBindGroupsCache() : ChainMap

Returns the bind groups of the current renderer.

**Returns:** The cache.

### .getBindings() : Array.<BindGroup>

Returns a list bindings of all shader stages separated by groups.
Expand Down
7 changes: 7 additions & 0 deletions docs/pages/PassMultipleTextureNode.html
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,13 @@ <h3 class="name name-method" id="PassMultipleTextureNode" translate="no">new <a
</div>
</div>
<h2 class="subsection-title">Properties</h2>
<div class="member">
<h3 class="name" id="isPassMultipleTextureNode" translate="no">.<a href="#isPassMultipleTextureNode">isPassMultipleTextureNode</a><span class="type-signature"> : boolean</span> <span class="type-signature">(readonly) </span></h3>
<div class="description">
<p>This flag can be used for type testing.</p>
<p>Default is <code>true</code>.</p>
</div>
</div>
<div class="member">
<h3 class="name" id="previousTexture" translate="no">.<a href="#previousTexture">previousTexture</a><span class="type-signature"> : boolean</span> </h3>
<div class="description">
Expand Down
6 changes: 6 additions & 0 deletions docs/pages/PassMultipleTextureNode.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,12 @@ Default is `false`.

## Properties

### .isPassMultipleTextureNode : boolean (readonly)

This flag can be used for type testing.

Default is `true`.

### .previousTexture : boolean

Whether previous frame data should be used or not.
Expand Down
7 changes: 7 additions & 0 deletions docs/pages/PassTextureNode.html
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,13 @@ <h3 class="name name-method" id="PassTextureNode" translate="no">new <a href="#P
</div>
</div>
<h2 class="subsection-title">Properties</h2>
<div class="member">
<h3 class="name" id="isPassTextureNode" translate="no">.<a href="#isPassTextureNode">isPassTextureNode</a><span class="type-signature"> : boolean</span> <span class="type-signature">(readonly) </span></h3>
<div class="description">
<p>This flag can be used for type testing.</p>
<p>Default is <code>true</code>.</p>
</div>
</div>
<div class="member">
<h3 class="name" id="passNode" translate="no">.<a href="#passNode">passNode</a><span class="type-signature"> : <a href="PassNode.html">PassNode</a></span> </h3>
<div class="description">
Expand Down
6 changes: 6 additions & 0 deletions docs/pages/PassTextureNode.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,12 @@ The output texture.

## Properties

### .isPassTextureNode : boolean (readonly)

This flag can be used for type testing.

Default is `true`.

### .passNode : PassNode

A reference to the pass node.
Expand Down
10 changes: 5 additions & 5 deletions docs/pages/PixelationNode.html
Original file line number Diff line number Diff line change
Expand Up @@ -115,14 +115,14 @@ <h3 class="name" id="textureNode" translate="no">.<a href="#textureNode">texture
</div>
</div>
<div class="member">
<h3 class="name" id="updateBeforeType" translate="no">.<a href="#updateBeforeType">updateBeforeType</a><span class="type-signature"> : string</span> </h3>
<h3 class="name" id="updateType" translate="no">.<a href="#updateType">updateType</a><span class="type-signature"> : string</span> </h3>
<div class="description">
<p>The <code>updateBeforeType</code> is set to <code>NodeUpdateType.FRAME</code> since the node updates
<p>The <code>updateType</code> is set to <code>NodeUpdateType.FRAME</code> since the node updates
its internal uniforms once per frame in <code>updateBefore()</code>.</p>
<p>Default is <code>'frame'</code>.</p>
</div>
<dl class="details">
<dt class="tag-overrides"><strong>Overrides:</strong> <a href="TempNode.html#updateBeforeType">TempNode#updateBeforeType</a></dt>
<dt class="tag-overrides"><strong>Overrides:</strong> <a href="TempNode.html#updateType">TempNode#updateType</a></dt>
</dl>
</div>
<h2 class="subsection-title">Methods</h2>
Expand All @@ -147,7 +147,7 @@ <h3 class="name name-method" id="setup" translate="no">.<a href="#setup">setup</
<dt class="tag-overrides"><strong>Overrides:</strong> <a href="TempNode.html#setup">TempNode#setup</a></dt>
</dl>
</div>
<h3 class="name name-method" id="updateBefore" translate="no">.<a href="#updateBefore">updateBefore</a><span class="signature">( frame : <span class="param-type"><a href="NodeFrame.html">NodeFrame</a></span> )</span> </h3>
<h3 class="name name-method" id="update" translate="no">.<a href="#update">update</a><span class="signature">( frame : <span class="param-type"><a href="NodeFrame.html">NodeFrame</a></span> )</span> </h3>
<div class="method">
<div class="description">
<p>This method is used to update uniforms once per frame.</p>
Expand All @@ -165,7 +165,7 @@ <h3 class="name name-method" id="updateBefore" translate="no">.<a href="#updateB
</tbody>
</table>
<dl class="details">
<dt class="tag-overrides"><strong>Overrides:</strong> <a href="TempNode.html#updateBefore">TempNode#updateBefore</a></dt>
<dt class="tag-overrides"><strong>Overrides:</strong> <a href="TempNode.html#update">TempNode#update</a></dt>
</dl>
</div>
<h2 class="subsection-title">Source</h2>
Expand Down
Loading
Loading