add opengl

Author: sudoevolve

docs/OpenGL/00-目录.md

@@ -0,0 +1,50 @@
+# OpenGL 教程目录（从概念 → 窗口 → 三角形 → 逐步深入）
+
+按顺序学即可：每篇都以“先看到结果”为优先级，然后再解释背后的关键概念与工程化组织方式。
+
+## 学习路线
+
+- [01-概念：GPU、驱动、上下文、渲染管线](01-概念-GPU驱动上下文渲染管线.md)
+- [02-搭工程：CMake + 窗口 + OpenGL Loader + 调试输出](02-搭工程-CMake窗口上下文Loader调试输出.md)
+- [03-第一个三角形：VAO/VBO/EBO + 最小 Shader](03-第一个三角形-VAO-VBO-EBO-最小Shader.md)
+- [04-坐标与变换：NDC、矩阵、MVP、右手系](04-坐标与变换-NDC-矩阵-MVP-右手系.md)
+- [05-顶点属性与插值：颜色、varying、Gamma 的直觉](05-顶点属性与插值-颜色-varying-Gamma直觉.md)
+- [06-纹理：采样、wrap/filter、mipmap、sRGB](06-纹理-采样-wrap-filter-mipmap-sRGB.md)
+- [07-相机：LookAt、轨道相机、第一人称相机](07-相机-LookAt-轨道相机-第一人称相机.md)
+- [08-深度与裁剪：depth test、face culling、clip space](08-深度与裁剪-depth-test-face-culling-clip-space.md)
+- [09-模型与网格：OBJ/GLTF（简化版）加载、法线、切线](09-模型与网格-OBJ-GLTF加载-法线-切线.md)
+- [10-光照基础：Lambert/Phong/Blinn-Phong 与能量直觉](10-光照基础-Lambert-Phong-BlinnPhong-能量直觉.md)
+- [11-阴影入门：Shadow Map 的最小实现与常见伪影](11-阴影入门-ShadowMap最小实现-常见伪影.md)
+- [12-离屏渲染：FBO、后处理、HDR/曝光](12-离屏渲染-FBO-后处理-HDR-曝光.md)
+- [13-性能与工程：状态切换、批处理、调试与 Profiling](13-性能与工程-状态切换-批处理-调试-Profiling.md)
+- [14-PBR 入门：BRDF 的直觉与实现骨架](14-PBR入门-BRDF直觉-实现骨架.md)
+
+## 参考阅读（Inigo Quilez）
+
+这些是 iquilezles.org/articles 的文章索引（外部链接），后续章节会逐步吸收其中的思路与技巧：
+
+- **颜色与基础工具**
+  - Procedural Color Palette：https://iquilezles.org/articles/palettes/
+  - Fast Signed Float Random（sfrand）：https://iquilezles.org/articles/sfrand/
+- **噪声与分形**
+  - Fractional Brownian Motion（fBM）：https://iquilezles.org/articles/fbm/
+  - Value Noise Derivatives（morenoise）：https://iquilezles.org/articles/morenoise/
+  - Gradient Noise Derivatives：https://iquilezles.org/articles/gradientnoise/
+- **SDF / Raymarching（建模、光照、抗锯齿）**
+  - Raymarching SDFs：https://iquilezles.org/articles/raymarchingdf/
+  - SDF Functions (3D)：https://iquilezles.org/articles/distfunctions/
+  - SDF Functions (2D)：https://iquilezles.org/articles/distfunctions2d/
+  - Smooth Minimum / Smooth Union（smin）：https://iquilezles.org/articles/smin/
+  - Normals in SDF（normalsSDF）：https://iquilezles.org/articles/normalsSDF/
+  - Soft Shadows in Raymarching（rmshadows）：https://iquilezles.org/articles/rmshadows/
+  - Filtering in Raymarching（ray differentials / mip artifacts）：https://iquilezles.org/articles/filteringrm/
+  - Terrain Raymarching：https://iquilezles.org/articles/terrainmarching/
+  - Binary Search Raycasting for SDF：https://iquilezles.org/articles/binarysearchsdf/
+  - Distance Fields（distance）：https://iquilezles.org/articles/distance/
+- **几何与实现小技巧**
+  - Polygon Normals and Areas：https://iquilezles.org/articles/areas/
+
+## 01 从这里开始
+
+- 下一篇：见 [01-概念：GPU、驱动、上下文、渲染管线](01-概念-GPU驱动上下文渲染管线.md)
+

docs/OpenGL/01-概念-GPU驱动上下文渲染管线.md

@@ -0,0 +1,140 @@
+# 01-概念：GPU、驱动、上下文、渲染管线
+
+目录页：见 [OpenGL 教程目录](00-目录.md)
+
+## 目标
+
+- 建立 OpenGL 学习的“地图”：你在操作什么、谁在执行、哪里会出错
+- 搞清楚“为什么我明明写了 glXXX 却什么也没显示”的常见原因分层
+- 为后续搭窗口与画三角形准备一套稳定的术语与直觉
+
+## 先决条件
+
+- 会写并编译运行一个最小 C++ 程序
+- 了解 CMake 的最基础用法（能生成并构建一个可执行程序）
+
+---
+
+## 1. OpenGL 不是一个库：它更像一套“协议”
+
+很多新手第一步就会卡在“我到底要装哪个 OpenGL”。关键点是：
+
+- **OpenGL API 头文件**：只是声明（告诉编译器函数长什么样）
+- **OpenGL 实现**：在显卡驱动里（Windows/Linux/macOS 的实现方式不同）
+- **你调用的 gl* 函数**：最终会进入驱动，驱动再把工作下发给 GPU 执行
+
+这也解释了两个现象：
+
+- 你换一台机器/换一个驱动，行为可能会不一样（尤其是 debug/兼容性部分）
+- 没有“创建了窗口/上下文”，调用 gl* 往往要么失败要么啥也不发生
+
+---
+
+## 2. 你需要先拿到“上下文”（Context），才谈得上渲染
+
+OpenGL 的大多数能力都绑定在一个上下文上。上下文里至少包含：
+
+- 你要使用的 OpenGL 版本与 Profile（比如 3.3 Core）
+- 大量 GPU 状态（深度测试开关、混合模式、绑定的 buffer/texture 等）
+- 与窗口系统相关的交换链（swap buffers）能力
+
+关键结论：
+
+- OpenGL 上下文通常由“窗口/平台库”创建（比如 GLFW/SDL/Qt 等）
+- 没有当前上下文（current context），调用 gl* 不是“空操作”，而是**未定义/报错/崩溃**的起点
+
+后面搭工程时，我们会用“窗口库 + loader”把它固定成可复用骨架。
+
+---
+
+## 3. 为什么需要 OpenGL Loader（GLAD/GLEW 等）
+
+现代 OpenGL 的大量函数在不同平台上不是直接链接得到的，而是需要：
+
+- 先创建上下文
+- 再通过平台 API 获取函数指针
+
+OpenGL Loader 做的事就是：在你有了上下文之后，帮你把 `glCreateShader`、`glGenVertexArrays` 这类函数指针加载出来。
+
+这件事如果顺序错了，最经典症状是：
+
+- 程序启动正常，但一调用某些 gl* 就崩溃（空函数指针）
+- 或者所有扩展函数都“不可用”
+
+---
+
+## 4. 渲染管线：从数据到像素的最短路径（现代 OpenGL 视角）
+
+把“画一个三角形”拆成最小闭环，你需要的只是下面这条链路：
+
+1. **CPU 侧准备顶点数据**（三个点的坐标）
+2. **把数据上传到 GPU**（Buffer：VBO）
+3. **告诉 GPU 怎么解释这段数据**（Vertex Attribute + VAO）
+4. **准备 Shader**（最少需要：顶点着色器 + 片元着色器）
+5. **发起绘制命令**（draw call）
+6. **交换前后缓冲**（你才能在窗口里看到结果）
+
+你会发现：这条链路里有两类东西贯穿始终：
+
+- **资源**：buffer、shader、texture……（需要创建、使用、释放）
+- **状态**：当前绑定了哪个 VAO/VBO、当前用哪个 program、是否启用深度测试……
+
+后面每一章的“工程化”，本质就是把资源与状态管理变得可控、可调试、可扩展。
+
+---
+
+## 5. “黑屏”到底在黑什么：按层排查
+
+OpenGL 初学的痛点几乎都能按层归类，这里先给一张排查地图，后面会逐步把每一层变成“可观测”：
+
+### 5.1 工程层（编译/链接/依赖）
+
+- 没链接窗口库
+- loader 没加进工程或初始化没调用
+
+### 5.2 上下文层（版本/Profile/创建顺序）
+
+- 你请求了 3.3 Core，但实际拿到的是别的版本/兼容模式
+- 调用 loader 初始化前没创建上下文
+
+### 5.3 Shader 层（编译失败但你没看到日志）
+
+- glsl 版本不匹配（`#version` 与上下文版本不一致）
+- 语法错误/变量没用导致被优化掉，输出不如预期
+
+### 5.4 顶点输入层（数据/布局错）
+
+- stride/offset 写错，导致顶点坐标读乱
+- VAO 没配好就 draw
+
+### 5.5 状态层（viewport/清屏/深度等）
+
+- 没设置 viewport 或 resize 后没更新
+- 没清 color/depth buffer，产生残影或看似“没画”
+
+这套分层会贯穿全教程：每引入一个新概念，都要把它放回“可观测的排查层级”里。
+
+---
+
+## 小练习
+
+### 练习 1：用自己的话复述“OpenGL 是什么”
+
+- 题目：用 3 句话解释 OpenGL、驱动、上下文之间的关系
+- 目标：把“我要装 OpenGL 吗”这个误区从脑子里删掉
+
+### 练习 2：写一份黑屏排查清单
+
+- 题目：把第 5 节按层写成一份 checklist（每层 3 条）
+- 目标：训练“先证伪底层假设，再看上层逻辑”的调试习惯
+
+---
+
+## 小结
+
+- OpenGL 更像一套协议：实现主要在驱动里，不是你直接链接的单个库
+- 先有上下文，再加载函数指针，再谈渲染
+- 现代 OpenGL 的最小闭环：数据 → buffer → attribute/VAO → shader → draw → swap
+- 黑屏要分层排查：工程 → 上下文 → shader → 顶点输入 → 状态
+
+下一篇：见 [02-搭工程：CMake + 窗口 + OpenGL Loader + 调试输出](02-搭工程-CMake窗口上下文Loader调试输出.md)