Luna-Flow/geometry3d

本文档描述当前仓库 v0.5.1 基线。

当前基线包含与 Luna-Flow template 一致的维护脚本，以及对 Luna-Flow/linear-algebra@0.4.2 的兼容。

仓库定位

geometry3d 是一个基于 Luna-Flow/linear-algebra 的小型 MoonBit 3D geometry 基础库。它分离 core geometry、camera/view、frontend draw-list 和具体 renderer backend。

文档结构

• README.md：包定位与版本基线。
• doc_standard.md：文档维护约定。
• 子系统目录：每个目录包含 api.md、tutorial.md、design.md。

子系统概览

• core：Mesh、quad face、向量 helper、法线、可见性、4x4 TRS transform。
• view：camera、look_at、viewport、perspective 和 orthographic projection。
• frontend：Scene、RenderView、backend-neutral DrawList。
• backend-tui：TUI frame buffer、背景 pattern、Z-buffer、terminal y-scale、光栅化。
• backend-canvas：使用 frontend 软件 Z-buffer 的浏览器 Canvas 2D 输出。
• backend-gsap：使用画家顺序的 SVG polygon 输出与 GSAP 播放控制。
• demo：终端 demo 与导出辅助命令；demo_canvas 和 demo_gsap 提供浏览器 demo。

文档入口

• API Reference: core
• API Reference: view
• API Reference: frontend
• API Reference: backend-tui
• Backend Canvas: API, Tutorial, Design
• Backend GSAP: API, Tutorial, Design
• API Reference: demo
• Migration: v0.1 to v0.2