From 3d156d75de3852dd36d0eeda33b17a2b6f10aa4a Mon Sep 17 00:00:00 2001 From: metamuffin Date: Tue, 7 Jan 2025 21:16:40 +0100 Subject: new proto doc --- doc/resources.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 doc/resources.md (limited to 'doc/resources.md') diff --git a/doc/resources.md b/doc/resources.md new file mode 100644 index 0000000..3add075 --- /dev/null +++ b/doc/resources.md @@ -0,0 +1,73 @@ +# Resource formats + +## Dictionary format + +``` +[kkkk vvvv KK... VV...]... + ^ ^ ^ ^ + | | | | value + | | | key + | | 16-bit kalue length + | 16-bit key length +``` + +## PrefabIndex + +| Key | Value Type | +| -------- | ---------- | +| \ | Resource | + +## Prefab + +| Key | Value Type | | +| ----------- | ----------------------- | --------- | +| mesh | Matrix3, Vec3, Resource | Multi key | +| light | Vec3, Resource | Multi key | +| environment | Resource | | + +## MeshPart + +Combinations of g__, va__ and tex_* are multiplied except normal which is added. +Defaults should be the identity for that operation, so default is 1 / white +except normals are zero. + +| Key | Value Type | | +| ---------------- | ------------- | ------------------ | +| index | Resource | | +| g_metallic | f32 | | +| g_roughness | f32 | | +| g_albedo | Vec3 | | +| g_transmission | f32 | | +| g_emission | Vec3 | | +| va_position | [Resource; 3] | | +| va_normal | [Resource; 3] | | +| va_texcoord | [Resource; 2] | | +| va_roughness | Resource | | +| va_metallic | Resource | | +| va_albedo | [Resource; 3] | | +| va_transmission | Resource | | +| va_emission | Resource | | +| tex_normal | Resource | Use color channels | +| tex_roughness | Resource | Use green channel | +| tex_metallic | Resource | Use blue channel | +| tex_albedo | Resource | Use color channels | +| tex_transmission | Resource | Use alpha channel | +| tex_emission | Resource | Use color channels | + +## LightPart + +| Key | Value Type | +| -------- | ---------- | +| radius | f32 | +| emission | Vec3 | + +## EnvironmentPart + +| Key | Value Type | | +| ------ | ---------- | ---------------- | +| skybox | Resource | | +| sun | Vec3, Vec3 | Direction, Color | + +## Texture + +WebP -- cgit v1.2.3-70-g09d2