Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document rules for Texture Restoration and PSD layer names #21

Open
xezon opened this issue Mar 10, 2025 · 7 comments · May be fixed by #23
Open

Document rules for Texture Restoration and PSD layer names #21

xezon opened this issue Mar 10, 2025 · 7 comments · May be fixed by #23

Comments

@xezon
Copy link
Contributor

xezon commented Mar 10, 2025

Document rules for Texture Restoration and PSD layer names. Please reach out to me and we go through it.

@xezon
Copy link
Contributor Author

xezon commented Mar 10, 2025

Notes on texture naming conventions.

Some original textures do deviate from this convention (by mistake), but most of them are like this.

Structure texture name variants

Summer texture suffix:

<none> : Pristine
_d : Damaged
_e : Really Damaged
_r : Rubble
_g : Garrison
_dg : Damaged Garrison

Winter texture suffix:

_s : Pristine Snow
_ds : Damaged Snow
_es : Really Damaged Snow
_rs : Rubble Snow
_sg : Snow Garrison
_dsg : Damaged Snow Garrison

Summer Night texture suffix

_n : Night
_dn : Damaged Night
_en : Invalid texture, to be removed with Mod Builder
_rn : Invalid texture, to be removed with Mod Builder
_ng : Night Garrison
_dng : Damaged Night Garrison

Winter Night texture suffix

_sn : Snow Night
_dsn : Damaged Snow Night
_esn : Invalid texture, to be removed with Mod Builder
_rsn : Invalid texture, to be removed with Mod Builder
_sng : Snow Night Garrison
_dsng : Damaged Snow Night Garrison

Vehicle name variations

<none> : Pristine
_d : Damaged
_d1 : Wreck

@xezon
Copy link
Contributor Author

xezon commented Mar 10, 2025

PSD Layer Naming Conventions

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 upscaled) 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 identifying 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.

@DevGeniusCode
Copy link
Collaborator

DevGeniusCode commented Mar 10, 2025

The texture with the most different variations is cbtower02 with 27 different variations, including dsng

_en : Invalid texture, to be removed with Mod Builder
_rn : Invalid texture, to be removed with Mod Builder

Is there a special reason this suffix is invalid? Since there are a variety of texture/model files with this extension

@xezon
Copy link
Contributor Author

xezon commented Mar 10, 2025

Is there a special reason this suffix is invalid?

Because 99% of them contain no proper night lights but a darkened version of a base texture. All it does is increase the brightness of the structure from _DN to _EN.

@DevGeniusCode DevGeniusCode linked a pull request Mar 11, 2025 that will close this issue
@xezon
Copy link
Contributor Author

xezon commented Mar 11, 2025

Next to write: Typical errors in textures.

@DevGeniusCode
Copy link
Collaborator

Next to write: Typical errors in textures.

I can create a script that will display all files with spelling errors (and also specify an ini file or model that it appears in or is in use, would that be useful?

@xezon
Copy link
Contributor Author

xezon commented Mar 11, 2025

I can create a script that will display all files with spelling errors (and also specify an ini file or model that it appears in or is in use, would that be useful?

ArcticDolphin suggested something similar. PSD file verification would be pretty nice. There can be a lot of pitfalls that could verified by tooling. For example to check if a "merged" layer actually contains the merged version of the referenced PSD (for example layer house merged is expected to be identical to a house.psd composite).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants