|
|
@@ -8,13 +8,11 @@
|
|
|
<link type="text/css" rel="stylesheet" href="page.css" />
|
|
|
</head>
|
|
|
<body>
|
|
|
- [page:Loader] →
|
|
|
-
|
|
|
<h1>[name]</h1>
|
|
|
|
|
|
<p class="desc">Utility class for sampling weighted random points on the surface of a mesh.</p>
|
|
|
|
|
|
- <p>Weighted sampling is useful for effects like heavier foliage growth in certain areas of terrain, or concentrated particle emissions from specific parts of a mesh. Vertex weights may be written programmatically, or painted by hand as vertex colors in Blender.</p>
|
|
|
+ <p>Weighted sampling is useful for effects like heavier foliage growth in certain areas of terrain, or concentrated particle emissions from specific parts of a mesh. Vertex weights may be written programmatically, or painted by hand as vertex colors in 3D tools like Blender.</p>
|
|
|
|
|
|
<h2>Example</h2>
|
|
|
|
|
|
@@ -64,25 +62,25 @@
|
|
|
|
|
|
<h2>Methods</h2>
|
|
|
|
|
|
- <h3>[method:this build]()</h3>
|
|
|
- <p>
|
|
|
- Processes the input geometry and prepares to return samples. Any configuration of the geometry or sampler must occur before this method is called. Time complexity is <i>O(n)</i> for a surface with <i>n</i> faces.
|
|
|
- </p>
|
|
|
-
|
|
|
<h3>[method:this setWeightAttribute]( [param:String name] )</h3>
|
|
|
<p>
|
|
|
Specifies a vertex attribute to be used as a weight when sampling from the surface. Faces with higher weights are more likely to be sampled, and those with weights of zero will not be sampled at all. For vector attributes, only <i>.x</i> is used in sampling.
|
|
|
<p>If no weight attribute is selected, sampling is randomly distributed by area.</p>
|
|
|
</p>
|
|
|
|
|
|
- <h3>[method:this sample]( [param:Vector3 position], [param:Vector3 normal] )</h3>
|
|
|
+ <h3>[method:this build]()</h3>
|
|
|
+ <p>
|
|
|
+ Processes the input geometry and prepares to return samples. Any configuration of the geometry or sampler must occur before this method is called. Time complexity is <i>O(n)</i> for a surface with <i>n</i> faces.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:this sample]( [param:Vector3 targetPosition], [param:Vector3 targetNormal] )</h3>
|
|
|
<p>
|
|
|
Selects a random point on the surface of the input geometry, returning the position and normal vector at that point. Time complexity is <i>O(log n)</i> for a surface with <i>n</i> faces.</i></p>
|
|
|
|
|
|
<h2>Source</h2>
|
|
|
|
|
|
<p>
|
|
|
- [link:https://github.com/mrdoob/three.js/blob/master/examples/js/math/MeshSurfaceSampler.js examples/js/math/MeshSurfaceSampler.js]
|
|
|
+ [link:https://github.com/mrdoob/three.js/blob/master/examples/js/math/MeshSurfaceSampler.js examples/js/math/MeshSurfaceSampler.js]
|
|
|
</p>
|
|
|
</body>
|
|
|
</html>
|
Don McCurdy