A curated technical notebook of mathematical visualizations, graphics experiments, p5.js sketches, C/C++ OpenGL/GLUT studies, PyQt editor-tooling notes, and browser-adapted demos from the Machine-Learning-Compatible-Game-Engine ecosystem.
This is now organized as:
chapters -> lessons -> inline visualizers -> original source links
The notebook pages are meant to feel like interactive technical notes. You read a short concept block, manipulate an inline canvas, inspect a code fragment, then continue down the same page without entering an embedded mini-site.
| Path | Role |
|---|---|
sources/ |
Preserved historical imports with subtree history. |
notebook/ |
Curated chapters and short lessons with inline visualizers. |
web/demos/ |
Standalone full-page playgrounds for larger exploration. |
docs/ |
Migration, build, shader, PyQt, and security notes. |
assets/ |
Shared CSS and JavaScript for the static notebook shell. |
| Step | Chapter | Why it matters |
|---|---|---|
| 00 | Orientation | Learn the source/notebook/demo/docs model. |
| 01 | Trigonometry and Functions | Plot functions and map math coordinates to pixels. |
| 02 | Recursion and Fractal Trees | Deepest interactive chapter with eight lessons. |
| 03 | Superformula and Supershapes | Explore parametric shape generation. |
| 04-10 | Remaining chapters | Studyable lesson scaffolds for GLUT/OpenGL, shaders, PyQt, execution safety, and related engine work. |
The fractal tree chapter is still the deepest chapter and model chapter for the notebook UX. It includes:
- persistent navigation with breadcrumbs, back/home controls, source links, demo links, and previous/next lesson controls;
- eight short lessons from recursion basics through wind animation;
- matching browser demos under
web/demos/tree/; - inline canvases, code fragments, observation prompts, and challenges.
All other chapters now have 3-5 studyable lessons with inline visualizers and source links. Some visualizers are browser-safe recreations of native GLUT/OpenGL/PyQt ideas; the original native code remains under sources/ for reading.
Start here: notebook/02-recursion-and-fractal-trees/
C++/GLUT/OpenGL projects do not run directly on GitHub Pages. PyQt is desktop GUI tooling, not browser-native. cpp-on-the-web is documented as an infrastructure prototype and must not expose public arbitrary C++ execution.
See docs/ for migration, build, shader, PyQt, and security strategy notes.