matyalatte / blender-dds-addon

Blender addon to import and export dds textures

Blender-DDS-Addon v0.4.0

Blender addon to import and export dds textures

Features

• Import DDS textures as TGA (or HDR)
• Export textures as DDS
• Support many DXGI formats (including BC6, BC7, and ASTC)
• Support non-2D textures (cubemaps, arrays, and volume textures)

Download

You can download zip files from the release page.

• blender_dds_addon*_Windows.zip is for Windows.
• blender_dds_addon*_macOS.zip is for Mac (10.15 or later).
• blender_dds_addon*_Linux.zip is for Linux with GLIBC 2.27+ and GLIBCXX 3.4.26+.

The linux build only supports distributions using GLIBC and GLIBCXX.

Getting Started

Getting Started · matyalatte/Blender-DDS-Addon Wiki

Supported Formats

The addon supports most of the DXGI formats.

Here is a list of supported formats.

Supported DXGI Formats

• BC1_UNORM
• BC1_UNORM_SRGB
• BC2_UNORM
• BC2_UNORM_SRGB
• BC3_UNORM
• BC3_UNORM_SRGB
• BC4_UNORM
• BC4_SNORM
• BC5_UNORM
• BC5_SNORM
• BC6H_UF16
• BC6H_SF16
• BC7_UNORM
• BC7_UNORM_SRGB
• R32G32B32A32_FLOAT
• R32G32B32A32_UINT
• R32G32B32A32_SINT
• R32G32B32_FLOAT
• R32G32B32_UINT
• R32G32B32_SINT
• R16G16B16A16_FLOAT
• R16G16B16A16_UNORM
• R16G16B16A16_UINT
• R16G16B16A16_SNORM
• R16G16B16A16_SINT
• R32G32_FLOAT
• R32G32_UINT
• R32G32_SINT
• D32_FLOAT_S8X24_UINT
• R10G10B10A2_UNORM
• R10G10B10A2_UINT
• R11G11B10_FLOAT
• R8G8B8A8_UNORM
• R8G8B8A8_UNORM_SRGB
• R8G8B8A8_UINT
• R8G8B8A8_SNORM
• R8G8B8A8_SINT
• R16G16_FLOAT
• R16G16_UNORM
• R16G16_UINT
• R16G16_SNORM
• R16G16_SINT
• D32_FLOAT
• R32_FLOAT
• R32_UINT
• R32_SINT
• D24_UNORM_S8_UINT
• R8G8_UNORM
• R8G8_UINT
• R8G8_SNORM
• R8G8_SINT
• R16_FLOAT
• D16_UNORM
• R16_UNORM
• R16_UINT
• R16_SNORM
• R16_SINT
• R8_UNORM
• R8_UINT
• R8_SNORM
• R8_SINT
• A8_UNORM
• R1_UNORM
• R9G9B9E5_SHAREDEXP
• R8G8_B8G8_UNORM
• G8R8_G8B8_UNORM
• B5G6R5_UNORM
• B5G5R5A1_UNORM
• B8G8R8A8_UNORM
• B8G8R8X8_UNORM
• R10G10B10_XR_BIAS_A2_UNORM
• B8G8R8A8_UNORM_SRGB
• B8G8R8X8_UNORM_SRGB
• B4G4R4A4_UNORM
• A4B4G4R4_UNORM
• ASTC_4X4_UNORM
• ASTC_4X4_UNORM_SRGB
• ASTC_5X4_UNORM
• ASTC_5X4_UNORM_SRGB
• ASTC_5X5_UNORM
• ASTC_5X5_UNORM_SRGB
• ASTC_6X5_UNORM
• ASTC_6X5_UNORM_SRGB
• ASTC_6X6_UNORM
• ASTC_6X6_UNORM_SRGB
• ASTC_8X5_UNORM
• ASTC_8X5_UNORM_SRGB
• ASTC_8X6_UNORM
• ASTC_8X6_UNORM_SRGB
• ASTC_8X8_UNORM
• ASTC_8X8_UNORM_SRGB
• ASTC_10X5_UNORM
• ASTC_10X5_UNORM_SRGB
• ASTC_10X6_UNORM
• ASTC_10X6_UNORM_SRGB
• ASTC_10X8_UNORM
• ASTC_10X8_UNORM_SRGB
• ASTC_10X10_UNORM
• ASTC_10X10_UNORM_SRGB
• ASTC_12X10_UNORM
• ASTC_12X10_UNORM_SRGB
• ASTC_12X12_UNORM
• ASTC_12X12_UNORM_SRGB

Non-2D Textures

The addon supports non-2D textures except for partial cubemaps.
See wiki pages for the details.

• Cubemaps
• Texture Arrays

External Projects

Texconv-Custom-DLL

Texconv is a texture converter developed by Microsoft.
It's the best DDS converter as far as I know.
And Texconv-Custom-DLL is a cross-platform implementation I made.
The official Texconv only supports Windows but you can use it on Unix/Linux systems.
It is released under the MIT license.

astc-encoder

astc-encoder is a texture converter for ASTC formats.
It is released under the Apache-2.0 license.

License

Files in this repository are available under the MIT license.

For Developers

There are some documents for developers.

• How to Build: How to create a zip from the repository.
• Tools for development: How to test the addon.

blender-dds-addon's Issues

sRGB formats make textures lighter when exporting

Related to #10.

Here is an example. The second image is the exported one.

Texconv seems to do the colorspace conversion if the DXGI format is *_SRGB.
We have to disable it with the colorspace options.

But the custom build of texconv doesn't support the options.
So, we need to rebuild the DLL to restore them.

RuntimeError: Failed to get Image Editor. This is unexpected.

Blender 3.5, got this error importing texture below.

RuntimeError: Failed to get Image Editor. This is unexpected.
Traceback (most recent call last):
  File "\addons\blender_dds_addon\ui\import_dds.py", line 166, in execute_base
    import_dds(context, os.path.join(directory, file.name))
  File "\addons\blender_dds_addon\ui\import_dds.py", line 123, in import_dds
    space = get_image_editor_space(context)
  File "\addons\blender_dds_addon\ui\bpy_util.py", line 24, in get_image_editor_space
    raise RuntimeError('Failed to get Image Editor. This is unexpected.')
RuntimeError: Failed to get Image Editor. This is unexpected.

Support Apple Silicon

Blender supports ARM64 chips for macOS. (e.g. Apple M1)
But the DDS addon will raise an error (be56016) for them because libtexconv.dylib was built for x64.
It's possible to build the ARM64 version but I don't have mac for testing.

Please comment if you want the ARM64 build and you can test it with Apple silicon.
I'll upload it on this thread.

Certain DDS Files Not Including Alpha On Import

Game: Helldivers 2
Texture Type: Material LUT
Imported Format: RGBA16 UNORM

*DM Sent As Well, So You Know

BC5_SNORM Normal Map issue

BC5_SNORM Normals when imported into blender look different
original normal map

after importing into blender

Segfault on Linux with old Blender versions.

I noticed the addon will cause a segfault on Ubuntu22.04 with Blender versions older than or equal to 3.2.

I think it's a Blender issue posted here
Segfault on Linux when running third party Python library function with multithreading enabled

If you get the same problem, try to update your Blender to 3.3 or later.

After using the export to DDS, Blender freezes when closing.

windows10
blender3.6
If I modify texconv.py to unload the DLL immediately after converting the file, Blender still freezes. Idk if the dll cause the problem？
Additionally, when exporting to BC7 sRGB, the color becomes lighter even if the original format is BC7 sRGB. Only if I choose BC7, it works.

2D Array DDS With Mipmaps error on import

Just a simple thing, DDS arrays with mipmaps do not import due to being 'unexpected'.