Skip to content

docs: add style selection guide and visual comparison for vnf_vertex_array (#521)#1967

Open
junhinhow wants to merge 1 commit intoBelfrySCAD:masterfrom
junhinhow:docs/vnf-styles-521
Open

docs: add style selection guide and visual comparison for vnf_vertex_array (#521)#1967
junhinhow wants to merge 1 commit intoBelfrySCAD:masterfrom
junhinhow:docs/vnf-styles-521

Conversation

@junhinhow
Copy link
Copy Markdown

Summary

  • Add practical guidance on choosing triangulation styles for vnf_vertex_array()
  • Add visual comparison example showing 5 styles side-by-side on the same wavy surface with wireframe overlay
  • Document when to use each style: default/alt for smooth, min_edge for varying curvature, convex/concave for textures, quincunx for heightfields (with saddle artifact warning), quad for speed

Test plan

  • New example compiles in OpenSCAD
  • Documentation follows BOSL2 format conventions
  • No changes to code logic

🤖 Generated with Claude Code

…array (BelfrySCAD#521)

Add practical guidance on when to use each triangulation style
in vnf_vertex_array():
- default/alt: smooth surfaces
- min_edge: avoid thin triangles with variable curvature
- convex/concave: consistent curvature direction (textures)
- quincunx: heightfield textures (beware saddle artifacts)
- quad: fastest but faces may be non-coplanar

Add visual comparison example showing wireframe of 5 styles
side by side on the same wavy surface.
@junhinhow junhinhow force-pushed the docs/vnf-styles-521 branch from f6c8408 to ddc44f8 Compare April 6, 2026 13:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant