docs: Document stub/not-implemented methods in resources module

Fixed discrepancies between source code and documentation:
- AsyncLoader: Document Initialize() ignores workerThreadCount, Submit() doesn't do actual async loading, Update() is stub
- ResourceManager: Document UnloadUnused() and ReloadResource() are stubs
- ResourceCache: Document OnZeroRefCount() and Flush() are stubs
- ResourceDependencyGraph: Document TopologicalSort() returns empty (stub)
- ResourceFileSystem: Document GetResourceInfo() doesn't fill modifiedTime, EnumerateResources() is stub
- FileArchive: Document Enumerate() is stub
- ResourcePackageBuilder: Document AddDirectory() is stub
- ImportSettings: Document LoadFromJSON/SaveToJSON are stubs
- TextureImportSettings/MeshImportSettings: Document JSON methods are stubs
- TextureLoader/MeshLoader/MaterialLoader/ShaderLoader/AudioLoader: Document GetDefaultSettings() returns nullptr
- AudioLoader: Document ParseWAVData() is stub, Load() doesn't parse WAV headers
- ShaderLoader: Document DetectShaderType/ParseShaderSource are stubs
- MaterialLoader: Document ParseMaterialData() is stub
- Texture: Document Create() mipLevels=0 behavior, GenerateMipmaps() returns false
- Mesh: Document MeshLoader::Load() is example only
- IResourceLoader: Document GetDefaultSettings() returns nullptr for all loaders
This commit is contained in:
2026-03-19 01:16:12 +08:00
parent 8c719418d0
commit 7e4c48d4f9
21 changed files with 192 additions and 37 deletions

View File

@@ -1,12 +1,34 @@
# Quaternion::Normalized
# Quaternion::Normalized / Normalize
## 实例方法
```cpp
Quaternion Normalized() const
Quaternion Normalize(const Quaternion& q)
```
返回当前四元数的归一化副本(不修改原四元数)。
**返回:** `Quaternion` - 归一化后的四元数副本
**复杂度:** O(1)
**示例:**
```cpp
Quaternion unit = quat.Normalized(); // quat 保持不变
```
## 静态方法
```cpp
static Quaternion Normalize(const Quaternion& q)
```
归一化四元数。
**参数:**
- `q` - 要归一化的四元数
**返回:** `Quaternion` - 归一化后的四元数
**复杂度:** O(1)
@@ -14,6 +36,5 @@ Quaternion Normalize(const Quaternion& q)
**示例:**
```cpp
Quaternion unit = quat.Normalized();
Quaternion unit2 = Quaternion::Normalize(quat);
Quaternion unit = Quaternion::Normalize(quat);
```