Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add SDFGeometryGenerator addon. #26837

Merged
merged 22 commits into from
Oct 11, 2023
Merged

Add SDFGeometryGenerator addon. #26837

Show file tree
Hide file tree
Changes from 7 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
bba0390
add SDFGeometry ammend
santi-grau Sep 25, 2023
fc88bda
remove comment
santi-grau Sep 25, 2023
845472e
Update webgl_geometry_sdf.jpg
santi-grau Sep 25, 2023
ac48910
pass that check....
santi-grau Sep 25, 2023
771dd24
PR fixes
santi-grau Sep 26, 2023
5885c98
📺🔫
santi-grau Sep 26, 2023
1ea1b90
Update SDFGeometryGenerator.js
santi-grau Sep 27, 2023
2a54b51
semi missing
santi-grau Sep 27, 2023
f659c57
move surface nets to jsm/libs
santi-grau Sep 28, 2023
f9fa448
Update SDFGeometryGenerator.js
Mugen87 Sep 29, 2023
743b983
Update SDFGeometryGenerator.js
Mugen87 Sep 29, 2023
314d4a6
Update SDFGeometryGenerator.html
Mugen87 Sep 29, 2023
8ea8570
Update webgl_geometry_sdf.html
Mugen87 Sep 29, 2023
154318e
Update to example
santi-grau Oct 5, 2023
4977b63
Update SDFGeometryGenerator.js
Mugen87 Oct 9, 2023
24761a5
Update webgl_geometry_sdf.html
Mugen87 Oct 10, 2023
0fa16c6
Update webgl_geometry_sdf.html
Mugen87 Oct 10, 2023
b56d3f5
Update webgl_geometry_sdf.html
Mugen87 Oct 10, 2023
42b2372
Update webgl_geometry_sdf.html
Mugen87 Oct 10, 2023
1d1a5ba
Update SDFGeometryGenerator.js
Mugen87 Oct 10, 2023
30e8a76
Update SDFGeometryGenerator.js
Mugen87 Oct 10, 2023
aa902d5
Remove w from position buffer
santi-grau Oct 10, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
71 changes: 71 additions & 0 deletions docs/examples/en/geometries/SDFGeometryGenerator.html
View file
Open in desktop
@@ -0,0 +1,71 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<base href="../../../" />
<script src="page.js"></script>
<link type="text/css" rel="stylesheet" href="page.css" />
</head>
<body>
[page:BufferGeometry] &rarr;

<h1>[name]</h1>

<p class="desc">
[name] returns a THREE.BufferGeometry from a Signed Distance Function</br>
Uses <a href="https://www.npmjs.com/package/isosurface" target="_blank" > Mikola Lysenko's Isosurface</a>
</p>

<h2>Import</h2>

<p>
[name] is an add-on, and must be imported explicitly.
See [link:#manual/introduction/Installation Installation / Addons].
</p>

<code>
import { SDFGeometryGenerator } from 'three/addons/geometries/SDFGeometryGenerator.js';
</code>

<h2>Code Example</h2>

<code>
const generator = new SDFGeometryGenerator( renderer );
const sdf = 'float dist( vec3 p ){ return length(p) - 0.5; }' // glsl
const geometry = generator.generate( 64, sdf, 1 ); // ~> THREE.BufferGeometry
</code>

<h2>Examples</h2>

<p>[example:webgl_geometry_sdf geometry / sdf ]</p>

<h2>Constructor</h2>

<h3>[name]( [param:WebGLRenderer renderer] )</h3>

<p>
[page:WebGLRenderer renderer] -- The renderer used to render the scene. <br />
</p>

<h2>Methods</h2>

<h3>[method:undefined generate]( [param:Int resolution], [param:String distanceField], [param:Int bounds] )</h3>

<p>
<b>resolution</b> - Int [ mandatory ] Amount of 'voxels' used for triangulation. Must be power of 2. <br/>Gets heavy after 256, most machines won't be able to process over 512. Defaults to 64.
</p>
<p>
<b>distanceField</b> - String [ mandatory ] String with glsl distance function. Name of function must be 'dist', with a vec3 argument. ( see code above ). Defaults to a sphere distance.
</p>
<p>
<b>bounds</b> - Int [ optional ] Bounds in which signed distance field will be evaluated. Defaults to 1.
</p>


<h2>Source</h2>

<p>
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/geometries/SDFGeometry.js examples/jsm/geometries/SDFGeometryGenerator.js]
</p>
</body>
</html>
3 changes: 2 additions & 1 deletion docs/list.json
View file
Open in desktop
Expand Up @@ -346,7 +346,8 @@
"ConvexGeometry": "examples/en/geometries/ConvexGeometry",
"DecalGeometry": "examples/en/geometries/DecalGeometry",
"ParametricGeometry": "examples/en/geometries/ParametricGeometry",
"TextGeometry": "examples/en/geometries/TextGeometry"
"TextGeometry": "examples/en/geometries/TextGeometry",
"SDFGeometryGenerator": "examples/en/geometries/SDFGeometryGenerator"
},

"Helpers": {
Expand Down
1 change: 1 addition & 0 deletions examples/files.json
View file
Open in desktop
Expand Up @@ -34,6 +34,7 @@
"webgl_geometry_extrude_splines",
"webgl_geometry_minecraft",
"webgl_geometry_nurbs",
"webgl_geometry_sdf",
"webgl_geometry_shapes",
"webgl_geometry_spline_editor",
"webgl_geometry_teapot",
Expand Down