跳到主要内容

表面材质生成

生成 PBR 表面材质：无缝纹理 PNG（导入为 Default Texture）+ 可直接使用的 Unity .mat 材质，默认保存到 Assets/TJGenerators/History/。

开始​

从GUI开始​

菜单：AI > 生成 > 生成表面材质，或参考 生成3D模型 的开始部分。

从CLI开始​

使用 generate_material 工具生成 PBR 材质。生成完成后，材质自动保存并可在场景中使用。

输入模式（至少提供其一）：

模式参数说明
文生材质prompt纯文字描述
图生材质image_path（可加 prompt）参考图 + 文字指导
材质类型预设preset_id13 种预设（自动补充类型提示词）
图案模板pattern_id12 种纹理图案（需预生成模板）

组合提示词构成：preset.prompt + ", " + style.prompt + ", " + 你的 prompt。设置 preset_id + style_id 后通常无需再写详细 prompt。

模型​

火山 SeeDream Material（唯一模型）​

  • generator_id： huoshan_seedream_material（唯一，默认）
  • 适用场景： 3D 物体表面 PBR 材质（金属、木头、石头、布料等）
  • 输出： 无缝 PNG 纹理（Default Texture）+ Unity .mat 材质
  • 关键参数：
    • prompt：附加文字描述（与 preset + style 组合）
    • image_path：参考图路径（若 pattern_id 模板存在会被其覆盖）
    • preset_id：材质类型预设
    • pattern_id：纹理图案模板（需预生成）
    • style_id：表面状态
    • size：纹理尺寸（默认 2048x2048）

材质类型预设（preset_id，13 种，自动设置 Metallic/Smoothness）​

ID名称MetallicSmoothness
metal金属0.90.8
wood木头00.3
stone石头00.1
fabric布料00.3
leather皮革00.3
concrete混凝土00.1
brick砖块00.1
tile瓷砖00.1
glass玻璃00.95
ceramic陶瓷00.5
grass草地00.5
sand沙地00.5
snow雪地00.5

纹理图案模板（pattern_id，12 种）​

uniform（均匀平滑）、horizontal_lines（水平条纹）、vertical_lines（垂直条纹）、cross_hatch（交叉网格）、diagonal（对角线）、wave（波浪）、noise（噪点粗糙）、honeycomb（蜂窝）、brick_layout（砖块排列）、scales（鳞片）、cracks（裂纹）、woven（编织）。

表面状态（style_id，5 种）​

new（崭新）、aged（做旧）、dirty（脏污）、wet（潮湿）、weathered（风化）。

尺寸选项（size，3 种）​

1024x1024（1K，移动端）、2048x2048（2K，默认）、4096x4096（4K，特写/hero）。

优化​

提示词 + 预设组合​

  • 优先使用 preset_id + style_id，比纯文字描述更能引导 AI 生成准确 PBR 值
  • 组合示例： preset_id: "metal" + style_id: "aged" + prompt: "rusted iron with orange patina"
  • 图案模板能快速生成规则纹理（地砖、墙砖、蜂窝结构等），减少反复尝试
  • 描述表面而非物体（避免写 "a sword"，应描述表面质感）；可加 "seamless tileable"

尺寸选择​

  • 1024x1024：移动端/小游戏，文件小
  • 2048x2048（推荐）：桌面端，质量与性能平衡
  • 4096x4096：Hero 资产/特写，文件大

并行生成​

  • 最大 5 个并发任务

图案模板预生成​

  • ⚠️ pattern_id 需先在 Unity Editor 中通过 AI > 开发 > 生成纹理走势模板图 预生成模板
  • 模板文件不存在时，pattern_id 会被忽略并回退使用 image_path

注意事项​

  • ⚠️ 生成耗时 60–180 秒
  • ⚠️ 至少提供 prompt / preset_id / pattern_id / image_path 之一；preset_id 单独即可
  • ⚠️ 材质 ≠ 精灵：材质用于 3D 物体表面 PBR 纹理，精灵用于 2D 图标/头像——不要混用工具
  • ⚠️ 图案模板需预生成：使用 pattern_id 前需先运行 Editor 菜单 AI > 开发 > 生成纹理走势模板图
  • ⚠️ 材质类型预设会自动设置 Metallic/Smoothness，无需手动调整
  • ⚠️ 输出路径：默认 Assets/TJGenerators/History/
  • ⚠️ Domain Reload：生成期间不要在磁盘写入 .cs 文件