docs: expand engine documentation and modularize SVG diagrams
authorSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Tue, 7 Apr 2026 15:56:31 +0000 (18:56 +0300)
committerSvjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Tue, 7 Apr 2026 15:56:31 +0000 (18:56 +0300)
commitc31b9ef6e27470d353d6d47c52618ca6b30aede5
treea44303393fa00edf35ba339f024b6f3e7b380570
parenta4dd962eb49179a0b31548f876091ac1e580813e
docs: expand engine documentation and modularize SVG diagrams

Move all inline SVG diagrams into separate files for better
organization, reusability, and easier maintenance. Expand documentation
across core geometry classes (Point3D, Vertex), rendering pipeline,
lighting system, CSG operations, frustum culling, and texture mapping.

- Extract 21 SVG diagrams from org files into standalone .svg files
- Add comprehensive Color class docs explaining mutable field design
- Document Point3D/Vertex distinction with visual comparison diagram
- Expand geometry docs: edges, faces, meshes, normals, winding order
- Add documentation index table to AGENTS.md
- Update all diagram colors for dark theme compatibility
- Rename lerp to interpolate for clearer API naming
32 files changed:
AGENTS.md
doc/coordinate-system.svg [new file with mode: 0644]
doc/csg/bsp-tree.svg [new file with mode: 0644]
doc/csg/csg-intersect.svg [new file with mode: 0644]
doc/csg/csg-operations.svg [new file with mode: 0644]
doc/csg/csg-union.svg [new file with mode: 0644]
doc/csg/index.org
doc/csg/polygon-clipping.svg [new file with mode: 0644]
doc/edge.svg [new file with mode: 0644]
doc/face-triangle.svg [new file with mode: 0644]
doc/frustum-culling/frustum-diagram.svg [new file with mode: 0644]
doc/frustum-culling/index.org
doc/frustum-culling/p-vertex-aabb.svg [new file with mode: 0644]
doc/index.org
doc/mesh.svg [new file with mode: 0644]
doc/normal-vector.svg [new file with mode: 0644]
doc/perspective-correct-textures/index.org
doc/perspective-correct-textures/triangle-tessellation.svg [new file with mode: 0644]
doc/point3d-vertex.svg [new file with mode: 0644]
doc/rendering-loop/double-buffering.svg [new file with mode: 0644]
doc/rendering-loop/index.org
doc/rendering-loop/paint-segments.svg [new file with mode: 0644]
doc/rendering-loop/painters-algorithm.svg [new file with mode: 0644]
doc/rendering-loop/render-pipeline.svg [new file with mode: 0644]
doc/shading/ambient-light-comparison.svg [new file with mode: 0644]
doc/shading/distance-attenuation.svg [new file with mode: 0644]
doc/shading/index.org
doc/shading/lambert-cosine-law.svg [new file with mode: 0644]
doc/shading/shading-pipeline.svg [new file with mode: 0644]
doc/winding-order.svg [new file with mode: 0644]
src/main/java/eu/svjatoslav/sixth/e3d/geometry/Point3D.java
src/main/java/eu/svjatoslav/sixth/e3d/math/Vertex.java