GFTextureSetClassifier¶
API Reference / Standard / 类索引
- 路径：
addons/gf/standard/utilities/assets/gf_texture_set_classifier.gd - 模块：
Standard - 继承：
RefCounted - API：
public - 类别：运行时服务 (
runtime_service) - 首次版本：
6.0.0
纹理集命名分类与导入计划构建工具。 根据常见后缀把贴图文件归并为材质纹理集，并可生成 GFImportPlan。 它只做路径解析和计划输出，不创建材质、不执行导入、不绑定编辑器 UI。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 常量 | ROLE_ALBEDO |
const ROLE_ALBEDO: StringName = &"albedo" |
| 常量 | ROLE_NORMAL |
const ROLE_NORMAL: StringName = &"normal" |
| 常量 | ROLE_ROUGHNESS |
const ROLE_ROUGHNESS: StringName = &"roughness" |
| 常量 | ROLE_METALLIC |
const ROLE_METALLIC: StringName = &"metallic" |
| 常量 | ROLE_AO |
const ROLE_AO: StringName = &"ao" |
| 常量 | ROLE_HEIGHT |
const ROLE_HEIGHT: StringName = &"height" |
| 常量 | ROLE_EMISSION |
const ROLE_EMISSION: StringName = &"emission" |
| 方法 | classify_files |
static func classify_files(paths: PackedStringArray, options: Dictionary = {}) -> Dictionary: |
| 方法 | build_material_import_plan |
static func build_material_import_plan( paths: PackedStringArray, target_root: String, options: Dictionary = {} ) -> GFImportPlan: |
| 方法 | get_default_suffix_rules |
static func get_default_suffix_rules() -> Dictionary: |
常量¶
ROLE_ALBEDO¶
- API：
public - 首次版本：
6.0.0
Albedo/BaseColor 贴图角色。
ROLE_NORMAL¶
- API：
public - 首次版本：
6.0.0
Normal 贴图角色。
ROLE_ROUGHNESS¶
- API：
public - 首次版本：
6.0.0
Roughness 贴图角色。
ROLE_METALLIC¶
- API：
public - 首次版本：
6.0.0
Metallic/Metalness 贴图角色。
ROLE_AO¶
- API：
public - 首次版本：
6.0.0
Ambient Occlusion 贴图角色。
ROLE_HEIGHT¶
- API：
public - 首次版本：
6.0.0
Height/Displacement 贴图角色。
ROLE_EMISSION¶
- API：
public - 首次版本：
6.0.0
Emission 贴图角色。
方法¶
classify_files¶
- API：
public - 首次版本：
6.0.0
分类纹理路径。
参数：
| 名称 | 说明 |
|---|---|
paths |
输入路径列表。 |
options |
分类选项。 |
返回：分类报告。
结构：
paths: PackedStringArray texture file paths.options: Dictionary，可包含 suffix_rules、allowed_extensions 和 normalize_directory.return: Dictionary with ok, sets, unmatched, matched_count, unmatched_count, and suffix_rules.
build_material_import_plan¶
- API：
public - 首次版本：
6.0.0
static func build_material_import_plan( paths: PackedStringArray, target_root: String, options: Dictionary = {} ) -> GFImportPlan:
从纹理路径构建材质导入计划。
参数：
| 名称 | 说明 |
|---|---|
paths |
输入路径列表。 |
target_root |
目标材质目录。 |
options |
构建选项。 |
返回：导入计划。
结构：
paths: PackedStringArray texture file paths.options: Dictionary，可包含 material_extension、type_hint、suffix_rules、allowed_extensions 和 metadata。
get_default_suffix_rules¶
- API：
public - 首次版本：
6.0.0
获取默认后缀规则。
返回：后缀规则副本。
结构：
return: Dictionary mapping role StringName to Array[String] suffixes.