Skip to main content
Glama

TAIGA Texture 是一个紧凑的程序化材质实验室,内置确定性的 Texture DSL,既可由人工编写,也可由 LLM 驱动。

TTX 是 Taiga TeXture 的技术缩写。它指代文件格式与工具链;该语言本身称为 Texture DSL。

在浏览器中编辑材质,检查 PBR 通道与立方体预览,然后通过 CLI 或 MCP 自动化同一引擎。

Related MCP server: genart-mcp

功能

  • Texture DSL — 纯前向字段,具有确定性种子和编译期成本上限。

  • 材质工作台 — 实时源码编辑、PBR 通道视图、平铺检查、参数滑块,以及交互式摄影棚光照立方体。

  • PBR ZIP 导出 — 将当前浏览器中的材质下载为 Base Color、Height、OpenGL Normal、Roughness、Metallic、metadata 及其 .ttx 源文件。

  • 程序化材质库 — 陶瓷、皮革、缝线皮革、橡木、花岗岩、帆布、锈蚀钢、大理石,以及多尺度干裂地表。

  • LLM 工具接口 — 结构化校验诊断、确定性分析、PNG 渲染、多尺度检查、CLI 和 stdio MCP。

  • 无运行时依赖 — 浏览器工作台是一个 HTML 文件;自动化工具使用 Node.js 内置模块。

本地运行

克隆仓库,并在支持 WebGL 2 的浏览器中打开 ttx-bench.html。

git clone https://github.com/kawaiiTaiga/taigas-texture.git
cd taigas-texture

在 Windows 上:

Start-Process .\ttx-bench.html

可选验证:

npm test

导出到 Blender、Unity、Unreal 或 Godot

在浏览器工作台中,选择预览分辨率,然后点击 PBR export → download .zip。压缩包内含五张标准 PNG 贴图、material.json、一份简短的集成说明,以及权威的 .ttx 源文件。

将 Base Color 用作 sRGB。将 Height、Normal、Roughness 和 Metallic 作为 Non-Color/Linear 数据加载。法线贴图遵循 OpenGL(+Y);如需 DirectX 法线工作流,请反转其绿色通道。

CLI

# Discover bundled and library materials
node ttx-cli.mjs examples --json

# Validate one example
node ttx-cli.mjs validate --example saddle --json

# Render PBR views
node ttx-cli.mjs render --example ceramic --out renders/ceramic --resolution 256 --json

# Inspect the same point across scales
node ttx-cli.mjs render-scales materials/parched-earth.ttx \
  --out renders/parched-earth --zooms 1,4,16,64 --center 0.5,0.5 --json

MCP

启动无依赖的 stdio 服务器:

node ttx-mcp-server.mjs

MCP 配置示例:

{
  "mcpServers": {
    "taigas-texture": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH>/ttx-mcp-server.mjs"]
    }
  }
}

提供的工具:

  • list_material_examples

  • get_material_example

  • validate_material

  • render_material

  • render_material_multiscale

材质示例

seed = 17
tile = 1
var glaze_h = 0.53

field cells = worley(u, v, freq=15, jitter=1, out=edge, seed=3)
field crack = 1 - smoothstep(0.004, 0.052, cells)
field h = clamp(0.52 - 0.11*crack, 0, 1)

out height = h
out albedo = hsv(glaze_h, 0.42, 0.72*(1 - 0.48*crack))
out rough = clamp(0.20 + 0.44*crack, 0, 1)
out metal = 0

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers