TextureImportSettings

命名空间: XCEngine::Resources

类型: class

继承: ImportSettings

描述: 纹理资源导入设置类，配置纹理导入时的各种参数选项。

概述

TextureImportSettings 继承自 ImportSettings，提供了纹理资源导入时的完整配置选项。包括纹理类型、目标格式、Mipmap 生成、压缩质量、各向异性、sRGB 转换、翻转操作、法线图生成等功能。

公共方法

方法	描述
`Clone`	克隆一份导入设置
`LoadFromJSON`	从 JSON 加载设置
`SaveToJSON`	保存设置到 JSON
`SetTextureType`	设置纹理类型
`GetTextureType`	获取纹理类型
`SetTargetFormat`	设置目标格式
`GetTargetFormat`	获取目标格式
`SetGenerateMipmaps`	设置是否生成 Mipmap
`GetGenerateMipmaps`	获取是否生成 Mipmap
`SetMipmapFilter`	设置 Mipmap 滤波器
`GetMipmapFilter`	获取 Mipmap 滤波器
`SetMaxAnisotropy`	设置最大各向异性级别
`GetMaxAnisotropy`	获取最大各向异性级别
`SetSRGB`	设置是否 sRGB
`GetSRGB`	获取 sRGB 设置
`SetFlipVertical`	设置是否垂直翻转
`GetFlipVertical`	获取垂直翻转设置
`SetFlipHorizontal`	设置是否水平翻转
`GetFlipHorizontal`	获取水平翻转设置
`SetBorderColor`	设置边框颜色
`GetBorderColor`	获取边框颜色
`SetCompressionQuality`	设置压缩质量
`GetCompressionQuality`	获取压缩质量
`SetUseHardwareCompression`	设置是否使用硬件压缩
`GetUseHardwareCompression`	获取硬件压缩设置
`SetMaxSize`	设置最大纹理尺寸
`GetMaxSize`	获取最大纹理尺寸
`SetGenerateNormalMap`	设置是否生成法线贴图
`GetGenerateNormalMap`	获取法线贴图生成设置
`SetNormalMapStrength`	设置法线贴图强度
`GetNormalMapStrength`	获取法线贴图强度

枚举类型

MipmapFilter

Mipmap 滤波算法。

值	描述
`Box`	Box 滤波器
`Kaiser`	Kaiser 滤波器

CompressionQuality

纹理压缩质量级别。

值	描述
`Low`	低质量压缩
`Medium`	中等质量压缩
`High`	高质量压缩
`Ultra`	超高质量压缩

使用示例

#include <XCEngine/Resources/TextureImportSettings.h>

TextureImportSettings settings;
settings.SetTextureType(TextureType::Texture2D);
settings.SetGenerateMipmaps(true);
settings.SetMipmapFilter(MipmapFilter::Kaiser);
settings.SetSRGB(true);
settings.SetCompressionQuality(CompressionQuality::High);
settings.SetMaxAnisotropy(16);
settings.SetMaxSize(2048);
settings.SetGenerateNormalMap(true);
settings.SetNormalMapStrength(1.0f);

// 保存设置
Containers::String json = settings.SaveToJSON();

// 克隆设置
auto cloned = settings.Clone();

3.8 KiB Raw Blame History Unescape Escape