Skip to content

Sheen

glTF extension: KHR_materials_sheen
glTF properties: sheenColorFactor · sheenColorTexture · sheenRoughnessFactor · sheenRoughnessTexture

Sheen simulates the soft, retroreflective highlight characteristic of cloth and fabric surfaces. Requires KHR_materials_sheen to be enabled in the export options.

Shader Weight / gate attr Color attr Roughness attr
standardSurface, aiStandardSurface sheen (must be > 0) sheenColor sheenRoughness
openPBRSurface fuzzWeight (must be > 0) fuzzColor fuzzRoughness
StingrayPBS not supported not supported not supported

Sheen color and roughness share one texture image with an alpha channel:

Channel Data
RGB Sheen color (sRGB)
A Sheen roughness (Raw)

Note

Sheen data is only exported when the weight attribute (sheen / fuzzWeight) is greater than 0.0.


Sheen color

Factor only

standardSurface, aiStandardSurface: Set sheen > 0 and sheenColor to the desired color.
openPBRSurface: Set fuzzWeight > 0 and fuzzColor to the desired color.

The color value exports as sheenColorFactor. For standardSurface / aiStandardSurface, the color is only written when it is not default white [1, 1, 1].

Texture only

Color space: sRGB

Connect the texture outColor to the color attribute:

standardSurface · aiStandardSurface:
  aiImage.outColor  →  shader.sheenColor
  file.outColor     →  shader.sheenColor

openPBRSurface:
  aiImage.outColor  →  shader.fuzzColor
  file.outColor     →  shader.fuzzColor

Exports as sheenColorTexture (RGB channels of the combined sheen image).

Factor + texture (color tint)

To tint the texture color, use a colorComposite node:

standardSurface · aiStandardSurface:
  aiImage.outColor  →  colorComposite  →  shader.sheenColor

openPBRSurface:
  aiImage.outColor  →  colorComposite  →  shader.fuzzColor

The color tint exports as sheenColorFactor.


Sheen roughness

Factor only

standardSurface, aiStandardSurface: Set sheenRoughness directly.
openPBRSurface: Set fuzzRoughness directly.

Roughness is only written when the sheen weight gate is also active. Exports as sheenRoughnessFactor.

Packed texture (same image as sheen color)

Use a single RGBA image for both color and roughness:

standardSurface · aiStandardSurface:
  aiImage.outColor  →  shader.sheenColor
  aiImage.outAlpha  →  shader.sheenRoughness

openPBRSurface:
  aiImage.outColor  →  shader.fuzzColor
  aiImage.outAlpha  →  shader.fuzzRoughness

The exporter detects that both attributes share the same file and exports the RGBA image directly as the combined sheen texture. Exports as sheenColorTexture and sheenRoughnessTexture pointing to the same image.

Separate textures (auto-combined)

Connect different images for color and roughness. The exporter repacks them into a single RGBA image: color in RGB, roughness in A.

standardSurface · aiStandardSurface:
  textureA.outColor  →  shader.sheenColor
  textureB.outColorR →  shader.sheenRoughness

openPBRSurface:
  textureA.outColor  →  shader.fuzzColor
  textureB.outColorR →  shader.fuzzRoughness

Both maps must share the same dimensions.

Factor + texture

Add a multiplyDivide node between the roughness texture and the roughness attribute, same pattern used by other roughness maps.


UV transform

file nodes: set repeat, wrap, mirror, offset, and rotation on the connected place2dTexture.
aiImage nodes: wrap, scale, and offset export natively; rotation requires a place2dTexture.

UV set: assign via Maya's UV Set Editor or UV Linking — see UV Set Selection for node-type differences.

When color and roughness use a combined texture, the UV transform is read from the color texture node.


Notes

  • Sheen color texture is sRGB; sheen roughness is Raw. The combined RGBA image handles both.
  • Color and roughness share one glTF texture (RGB = color, A = roughness). Use the packed workflow or separate images — the exporter combines them automatically.
  • Sheen is not exported unless the weight gate (sheen for standardSurface/aiStandardSurface, fuzzWeight for openPBR) is greater than 0.0.
  • For standardSurface / aiStandardSurface, the color factor is only written when sheenColor is not white [1, 1, 1].
  • StingrayPBS does not export KHR_materials_sheen.