Edge projection based on three-mesh-bvh to extract visible projected lines along the y-axis into flattened line segments for scalable 2d rendering. Additonally includes a silhouette mesh generator based on clipper2-js to merge flattened triangles.
Generator
More granular API with control over when edge trimming work happens.
const generator = new ProjectionGenerator();
generator.generate( geometry );
let result = task.next();
while ( ! result.done ) {
result = task.next();
}
const lines = new LineSegments( result.value, material );
scene.add( lines );Promise
Simpler API with less control over when the work happens.
const generator = new ProjectionGenerator();
const geometry = await generator.generateAsync( geometry );
const mesh = new Mesh( result.value, material );
scene.add( mesh );sortEdges = true : BooleanWhether to sort edges along the Y axis before iterating over the edges.
iterationTime = 30 : NumberHow long to spend trimming edges before yielding.
angleThreshold = 50 : NumberThe threshold angle in degrees at which edges are generated.
includeIntersectionEdges = true : BooleanWhether to generate edges representing the intersections between triangles.
*generate(
geometry : MeshBVH | BufferGeometry,
options : {
onProgress: ( percent : Number ) => void,
}
) : BufferGeometryGenerate the edge geometry using a generator function.
generateAsync(
geometry : MeshBVH | BufferGeometry,
options : {
onProgress: ( percent : Number ) => void,
signal: AbortSignal,
}
) : Promise<BufferGeometry>Generate the geometry with a promise-style API.
Used for generating a projected silhouette of a geometry using the clipper2-js project. Performing these operations can be extremely slow with more complex geometry and not always yield a stable result.
iterationTime = 10 : NumberHow long to spend trimming edges before yielding.
doubleSided = false : BooleanIf false then only the triangles facing upwards are included in the silhouette.
sortTriangles = false : BooleanWhether to sort triangles and project them large-to-small. In some cases this can cause the performance to drop since the union operation is best performed with smooth, simple edge shapes.
output = OUTPUT_MESH | OUTPUT_LINE_SEGMENTS | OUTPUT_BOTHWhether to output mesh geometry, line segments geometry, or both in an array ( [ mesh, line segments ] );
*generate(
geometry : BufferGeometry,
options : {
onProgress: ( percent : Number ) => void,
}
) : BufferGeometryGenerate the geometry using a generator function.
generateAsync(
geometry : BufferGeometry,
options : {
onProgress: ( percent : Number ) => void,
signal: AbortSignal,
}
) : Promise<BufferGeometry>Generate the silhouette geometry with a promise-style API.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent