Python转换VTF为PNG出现红绿蓝异常方块如何修复

• 你没有跳过VTF文件的文件头，直接把整个VTF二进制内容全部传入了解码器。VTF并非纯压缩纹理数据，文件开头存储了纹理尺寸、压缩格式、Mipmap层级等元信息，你把文件头的字节也当作压缩纹理块解码，直接导致解码数据错位。
• 你混淆了纹理压缩格式：代码注释标注压缩格式为DXT5（即BC3），但实际调用的是decode_bc5解码接口。BC5是仅存储R、G双通道的压缩格式，和带Alpha通道的BC3（DXT5）解码逻辑完全不兼容，格式错配会直接导致色彩解码异常。
• 你看到的规则排列的红/绿/蓝色块是块压缩错位解码产生的宏块伪影：BC类压缩格式以4x4像素为最小压缩单元，当传入的解码数据偏移错误、压缩格式不匹配时，每个4x4块都会被解码为错误的色彩值，最终呈现为规则排布的彩色方块，不存在特殊的专属命名。
• 你之前尝试的BGRA与RGBA通道互转逻辑本身没有问题，通道顺序错误只会造成整体色彩偏移，不会产生规则方块状的异常。

1. 先解析VTF文件头，拿到真实的纹理数据偏移，跳过文件头后再提取对应长度的压缩纹理数据，不要直接读取整个文件传入解码器。
2. 读取VTF头内存储的压缩格式枚举值，确认实际压缩格式后再调用对应的解码接口，不要靠猜测选择解码函数。

可参考如下修正后的代码：

import texture2ddecoder
import struct
from PIL import Image

img_width = 64
img_height = 64

with open('bracketsTest.vtf', 'rb') as f:
    vtf_binary = f.read()

# 读取VTF头中记录的头长度字段，自动计算压缩数据的起始偏移
vtf_header_size = struct.unpack('<I', vtf_binary[0x08:0x0C])[0]
# BC3(DXT5)格式下，每个4x4压缩块占16字节，计算64x64纹理对应的压缩数据总长度
compressed_data_length = (img_width // 4) * (img_height // 4) * 16
# 跳过文件头，提取纯压缩纹理数据
compressed_tex_data = vtf_binary[vtf_header_size : vtf_header_size + compressed_data_length]

# 确认格式为BC3(DXT5)则调用decode_bc3，若实际为BC5则替换为对应解码函数
decoded_bgra_data = texture2ddecoder.decode_bc3(compressed_tex_data, img_width, img_height)
# 转换通道顺序为RGBA后导出PNG
final_img = Image.frombytes("RGBA", (img_width, img_height), decoded_bgra_data, 'raw', "BGRA")
final_img.save('fixed_result.png')

补充校验：VTF头偏移0x52位置的2字节无符号整数为压缩格式枚举值，枚举值13对应BC3(DXT5)，枚举值23对应BC5，可先读取该值确认格式，避免选错解码接口。

内容的提问来源于stack exchange，提问作者noG23