diff --git a/docs/zengin/textures/32bit_texture.md b/docs/zengin/textures/32bit_texture.md index 2b9eac4e5e..d581191000 100644 --- a/docs/zengin/textures/32bit_texture.md +++ b/docs/zengin/textures/32bit_texture.md @@ -1,25 +1,25 @@ # 32 Bit texture support -By default ZenGin supports only compresed `DXT1` and `DXT3` textures. [zSurface32 patch](https://worldofplayers.ru/threads/43009/page-3#post-1180504), created by Gratt improves texture quality by adding proper `RGBA8888`, `BGRA8888`, `ARGB8888` and `ABGR8888` format readout and DirectX 32 Bit surface support in ZenGin[^1]. +By default, ZenGin supports only compressed `DXT1` and `DXT3` textures. [zSurface32 patch](https://worldofplayers.ru/threads/43009/page-3#post-1180504), created by Gratt improves texture quality by adding proper `RGBA8888`, `BGRA8888`, `ARGB8888` and `ABGR8888` format readout and DirectX 32 Bit surface support in ZenGin[^1]. To use the patch you must have [Union](../union/index.md) installed. Download the `.patch` file [here](https://worldofplayers.ru/attachments/114570/), and put it into `system\` directory. !!! Warning - It is advised to use `BGRA8888` due to performance reasons, as other colorspaces require additional conversion at runtime. + It is advised to use `BGRA8888` due to performance reasons, as other [color spaces](https://en.wikipedia.org/wiki/RGBA_color_model) require additional conversion at runtime. ## Compilation ZenGin doesn’t natively support the compilation of such textures. This can only be achieved using external programs. The simplest method to create a texture is by utilizing [zTEXiPy](https://gitlab.com/Shoun2137/ztexipy). 1. Open your texture in zTEXiPy[^2]: -![zTEXiPy's splash dialog](../../assets/images/STEP_1.WEBP) +![zTEXiPy's splash dialog](../../assets/images/32bit-texture-support/STEP_1.WEBP) 2. Choose `Save TEX as...` 3. In this window: -![zTEXiPy's saving dialog](../../assets/images/STEP_3.WEBP) +![zTEXiPy's saving dialog](../../assets/images/32bit-texture-support/STEP_3.WEBP) - Uncheck `Generate Mipmaps` if your texture is meant to be used as UI. - Set the `Colorspace` to `BGRA8888 (zEnum:3)` or other supported format. 4. Press `Save` and check your texture in-game: -![Ingame Example](../../assets/images/EXAMPLE_INGAME.WEBP) +![In-game Example](../../assets/images/32bit-texture-support/EXAMPLE_INGAME.WEBP) ## But why? @@ -27,19 +27,19 @@ This type of texture is compatible with any asset, whether it’s armour or a sw === "BGRA8888 vs DXT3" - ![Comparison between BGRA8888 vs DXT3 (Alpha)](../../assets/images/EXAMPLE_1.WEBP) + ![Comparison between BGRA8888 vs DXT3 (Alpha)](../../assets/images/32bit-texture-support/EXAMPLE_1.WEBP){: style='background-color: white;'} - This example shows comparison between raw BGRA8888 colorspace and DXT3 (BC2)[^3] compression. - DXT3 shows noticible banding throughout entire texture wherever there's alpha channel, while BGRA8888 has smooth gradient transition. + This example shows comparison between raw BGRA8888 color space and DXT3 (BC2)[^3] compression. + DXT3 shows noticeable banding throughout entire texture wherever there's alpha channel, while BGRA8888 has smooth gradient transition. === "BGRA8888 vs DXT1" - ![Comparison between BGRA8888 vs DXT1](../../assets/images/EXAMPLE_2.WEBP) + ![Comparison between BGRA8888 vs DXT1](../../assets/images/32bit-texture-support/EXAMPLE_2.WEBP) - This example shows comparison between raw BGRA8888 colorspace and DXT1 (BC1)[^3] compression. + This example shows comparison between raw BGRA8888 color space and DXT1 (BC1)[^3] compression. DXT1 shows lossy quantization artifacts, while BGRA8888 has none. -[Source comparison files are available here.](../../assets/EXAMPLE_SOURCE.7z) +[Source comparison files are available here.](../../assets/examples/32bit_texture_support.7z) The drawback of using these textures is their large size, as they contain uncompressed color data. However, this is a small price to pay for the improved quality of the final product. diff --git a/docs/zengin/textures/index.md b/docs/zengin/textures/index.md index 55897b5d88..feb5193a25 100644 --- a/docs/zengin/textures/index.md +++ b/docs/zengin/textures/index.md @@ -1,9 +1,9 @@ # Textures -Textures are pictures that get projected onto 3D models and on a 2D user interface in the game. ZenGin uses its own texture format `.TEX`, that in fact is a container for the texture in one of available formats. This section will discuss how to work with textures in ZenGin. +Textures are pictures that get projected onto 3D models and on a 2D user interface in the game. ZenGin uses its own texture format `.TEX`, that actually is a container for the texture in one of available formats. This section will discuss how to work with textures in ZenGin. !!! Note - Technical documentaion of the `.TEX` texture format can be found in the [ZenKit documentaion](https://zk.gothickit.dev/engine/formats/texture/). + Technical documentation of the `.TEX` texture format can be found in the [ZenKit documentation](https://zk.gothickit.dev/engine/formats/texture/). ## Basics diff --git a/overrides/assets/EXAMPLE_SOURCE.7z b/overrides/assets/examples/32bit_texture_support.7z similarity index 100% rename from overrides/assets/EXAMPLE_SOURCE.7z rename to overrides/assets/examples/32bit_texture_support.7z diff --git a/overrides/assets/images/EXAMPLE_1.WEBP b/overrides/assets/images/32bit-texture-support/EXAMPLE_1.WEBP similarity index 100% rename from overrides/assets/images/EXAMPLE_1.WEBP rename to overrides/assets/images/32bit-texture-support/EXAMPLE_1.WEBP diff --git a/overrides/assets/images/EXAMPLE_2.WEBP b/overrides/assets/images/32bit-texture-support/EXAMPLE_2.WEBP similarity index 100% rename from overrides/assets/images/EXAMPLE_2.WEBP rename to overrides/assets/images/32bit-texture-support/EXAMPLE_2.WEBP diff --git a/overrides/assets/images/EXAMPLE_INGAME.WEBP b/overrides/assets/images/32bit-texture-support/EXAMPLE_INGAME.WEBP similarity index 100% rename from overrides/assets/images/EXAMPLE_INGAME.WEBP rename to overrides/assets/images/32bit-texture-support/EXAMPLE_INGAME.WEBP diff --git a/overrides/assets/images/STEP_1.WEBP b/overrides/assets/images/32bit-texture-support/STEP_1.WEBP similarity index 100% rename from overrides/assets/images/STEP_1.WEBP rename to overrides/assets/images/32bit-texture-support/STEP_1.WEBP diff --git a/overrides/assets/images/STEP_3.WEBP b/overrides/assets/images/32bit-texture-support/STEP_3.WEBP similarity index 100% rename from overrides/assets/images/STEP_3.WEBP rename to overrides/assets/images/32bit-texture-support/STEP_3.WEBP