From af14449ca54db54ac0712ab70e5f5a4f74fad699 Mon Sep 17 00:00:00 2001 From: DevGeniusCode <136935333+DevGeniusCode@users.noreply.github.com> Date: Tue, 11 Mar 2025 02:02:07 +0200 Subject: [PATCH 1/3] Add Texture Guidelines --- Asset/Art/dds/texture_guidelines.md | 78 +++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 Asset/Art/dds/texture_guidelines.md diff --git a/Asset/Art/dds/texture_guidelines.md b/Asset/Art/dds/texture_guidelines.md new file mode 100644 index 00000000..759e9266 --- /dev/null +++ b/Asset/Art/dds/texture_guidelines.md @@ -0,0 +1,78 @@ +# Texture Guidelines + +In *Generals Zero Hour*, there are several variations of textures adapted to different seasons, weather conditions, +times of day, and more. Each variation is updated accordingly, and the suffixes in the DDS filenames indicate the type +and condition of the texture. + +## Texture Naming Structure + +>[!TIP] +> the `_en` and `_rn` textures invalid because 99% of textures with these suffixes do not have proper night lighting but are simply darkened versions of +> the base texture. They only increase the brightness from `_dn` to `_en`. + +### Summer Textures + +- ``: Pristine texture. +- `_d`: Damaged texture. +- `_e`: Really Damaged texture. +- `_r`: Rubble texture. +- `_g`: Garrison texture. +- `_dg`: Damaged Garrison texture. + +### Winter Textures + +- `_s`: Pristine Snow texture. +- `_ds`: Damaged Snow texture. +- `_es`: Really Damaged Snow texture. +- `_rs`: Rubble Snow texture. +- `_sg`: Snow Garrison texture. +- `_dsg`: Damaged Snow Garrison texture. + +### Summer Night Textures + +- `_n`: Night texture. +- `_dn`: Damaged Night texture. +- `_en`: Invalid texture, to be removed with Mod Builder. +- `_rn`: Invalid texture, to be removed with Mod Builder. +- `_ng`: Night Garrison texture. +- `_dng`: Damaged Night Garrison texture. + +### Winter Night Textures + +- `_sn`: Snow Night texture. +- `_dsn`: Damaged Snow Night texture. +- `_esn`: Invalid texture, to be removed with Mod Builder. +- `_rsn`: Invalid texture, to be removed with Mod Builder. +- `_sng`: Snow Night Garrison texture. +- `_dsng`: Damaged Snow Night Garrison texture. + +## Vehicle Texture Variations + +- ``: Pristine vehicle texture. +- `_d`: Damaged vehicle texture. +- `_d1`: Wrecked vehicle texture. + +## PSD Layer Naming Conventions + +- If the background layer is flattened, it is the original retail texture (DDS) in the best available quality. +- If the bottom layer is not the original retail texture (DDS), it will have a name representing the source texture in + sufficient detail (e.g., `cbcnvstr01_s.dds realesr-general-wdn-x4v3` or a processed AI-upscaled texture like + `cbcnvstr01 merged`). +- If PSD textures are modified, the edits should propagate to lower-order textures that use higher-order merged + textures (Pristine → Damaged, Summer → Winter, etc.). +- Layer and group names should be in lowercase and use common keywords like "damage", "light", "barricades", "snow", or + any other relevant name. +- Layer and group names may end with a texture variant suffix (e.g., `_d`, `_g`, `_e`) to help identify the origin + texture variant. These layers and groups can be copied to other texture variants and should be identical if they share + the same name within the same texture set. +- Groups used to assemble an alpha channel should be named `_alpha` and will be hidden before saving the image file. + +## Working with Textures + +1. **Editing Software**: Use software like **Photoshop**, **GIMP**, or **Paint.NET** for editing DDS + textures. + +2. **PSD**: When working with **PSD** files, maintain an organized layer structure and use clear names for each texture + variant (e.g., `_d`, `_g`). Layers with an alpha channel should be named `_alpha` and hidden before saving the file. + +3. **Saving and Conversion**: After editing, save the texture as a **DDS** file to ensure optimal quality and file size. From 62e58ac639a8e41615978e3b3ad9f175d5542d6e Mon Sep 17 00:00:00 2001 From: DevGeniusCode <136935333+DevGeniusCode@users.noreply.github.com> Date: Tue, 11 Mar 2025 02:07:44 +0200 Subject: [PATCH 2/3] Add Texture Guidelines in Navbar --- Asset/Art/dds/texture_guidelines.md | 4 ++-- Asset/_Navbar.md | 3 +-- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/Asset/Art/dds/texture_guidelines.md b/Asset/Art/dds/texture_guidelines.md index 759e9266..98e79c10 100644 --- a/Asset/Art/dds/texture_guidelines.md +++ b/Asset/Art/dds/texture_guidelines.md @@ -7,8 +7,8 @@ and condition of the texture. ## Texture Naming Structure >[!TIP] -> the `_en` and `_rn` textures invalid because 99% of textures with these suffixes do not have proper night lighting but are simply darkened versions of -> the base texture. They only increase the brightness from `_dn` to `_en`. +> the `_en` and `_rn` textures invalid because 99% of textures with these suffixes do not have proper night lighting but +> are simply darkened versions of the base texture. They only increase the brightness from `_dn` to `_en`. ### Summer Textures diff --git a/Asset/_Navbar.md b/Asset/_Navbar.md index 799f645a..179f8468 100644 --- a/Asset/_Navbar.md +++ b/Asset/_Navbar.md @@ -6,8 +6,7 @@ - Models - W3D - Textures - - TGA - - DDS + - [Texture Guidelines](Art/dds/texture_guidelines.md) - Audio & Video - WAV - BIK From 6b26ec5b18b99c77daef9d64707715a7294c8221 Mon Sep 17 00:00:00 2001 From: DevGeniusCode <136935333+DevGeniusCode@users.noreply.github.com> Date: Tue, 11 Mar 2025 15:02:20 +0200 Subject: [PATCH 3/3] Fix --- Asset/Art/dds/texture_guidelines.md | 30 ++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/Asset/Art/dds/texture_guidelines.md b/Asset/Art/dds/texture_guidelines.md index 98e79c10..978ffa05 100644 --- a/Asset/Art/dds/texture_guidelines.md +++ b/Asset/Art/dds/texture_guidelines.md @@ -54,18 +54,21 @@ and condition of the texture. ## PSD Layer Naming Conventions -- If the background layer is flattened, it is the original retail texture (DDS) in the best available quality. -- If the bottom layer is not the original retail texture (DDS), it will have a name representing the source texture in - sufficient detail (e.g., `cbcnvstr01_s.dds realesr-general-wdn-x4v3` or a processed AI-upscaled texture like - `cbcnvstr01 merged`). -- If PSD textures are modified, the edits should propagate to lower-order textures that use higher-order merged - textures (Pristine → Damaged, Summer → Winter, etc.). -- Layer and group names should be in lowercase and use common keywords like "damage", "light", "barricades", "snow", or - any other relevant name. -- Layer and group names may end with a texture variant suffix (e.g., `_d`, `_g`, `_e`) to help identify the origin - texture variant. These layers and groups can be copied to other texture variants and should be identical if they share - the same name within the same texture set. -- Groups used to assemble an alpha channel should be named `_alpha` and will be hidden before saving the image file. +- If the Background layer is flattened, then it is the original retail texture (DDS) in best discovered quality. +- If the bottom layer is not the original retail texture (DDS), then it has a name that represents the source texture + name in sufficient detail. That can be a DDS or TGA or a processed (AI upscale) texture, for example + `cbcnvstr01_s.dds realesr-general-wdn-x4v3`. Or a "merged" aka composited PSD image of the same (and never another!) + texture set, for example `cbcnvstr01 merged`. +- If PSD textures are modified, then their edits need to move to lower order textures that use higher order merged + textures (Pristine -> Damages, Summer -> Winter, ...). +- Layer & Group names are lower case and use common keywords such as "damage", "light", "barricades", "snow", or any + other name that gives it meaning. +- Layer & Group names may end on a texture variant suffix (`_d`, `_g`, `_e`, ...) which helps to identify the origin + texture variant. +- Layers & Groups can be copied to other texture variants and are expected to be identical if they share the same name + within the same texture set. +- Groups meant to be used to assemble an alpha channel are named `_alpha` and will be hidden before saving the image + file. ## Working with Textures @@ -75,4 +78,5 @@ and condition of the texture. 2. **PSD**: When working with **PSD** files, maintain an organized layer structure and use clear names for each texture variant (e.g., `_d`, `_g`). Layers with an alpha channel should be named `_alpha` and hidden before saving the file. -3. **Saving and Conversion**: After editing, save the texture as a **DDS** file to ensure optimal quality and file size. +3. **Saving and Conversion**: After editing, textures should not be manually exported as DDS files. This should be +handled automatically by the build pipeline using Mod Builder to ensure optimal quality and file size.