ignifx.material

Material file (`ignifx/material-file`)#

A PBR or Standard material: colours in sRGB, factors unitless, textures as { "$asset": … } references.

Field	Kind	Default	Description
`format`	`str`	`"ignifx.material"`	Always "ignifx.material".
`formatVersion`	`u32`	`1`	The file format version; 1 before ignifx 1.0.
`type`	`enum`	`"pbr"`	The material family: pbr, standard, shader. "shader" arrives in Phase 7.
`name`	`str`	`""`	A human-readable name; glTF overrides match on it.
`baseColor`	`color`	`[1,1,1,1]`	PBR: sRGB base colour and alpha.
`metallic`	`f32`	`1`	PBR: metallic factor, 0 to 1.
`roughness`	`f32`	`1`	PBR: roughness factor, 0 to 1.
`normalScale`	`f32`	`1`	PBR: normal map strength.
`emissive`	`color`	`[0,0,0,1]`	sRGB emissive colour.
`occlusionStrength`	`f32`	`1`	PBR: how strongly occlusion darkens.
`alphaMode`	`enum`	`"opaque"`	How alpha is read: opaque, mask, blend.
`alphaCutoff`	`f32`	`0.5`	The cutoff a "mask" material discards below.
`alpha`	`f32`	`1`	Overall material alpha, 0 to 1.
`doubleSided`	`bool`	`false`	Whether back faces are drawn.
`unlit`	`bool`	`false`	Whether lighting is skipped entirely.
`environmentIntensity`	`f32`	`1`	PBR: environment map contribution.
`diffuse`	`color`	`[1,1,1,1]`	Standard: sRGB diffuse colour.
`specular`	`color`	`[1,1,1,1]`	Standard: sRGB specular colour.
`specularPower`	`f32`	`64`	Standard: specular exponent.
`baseColorTexture`	`asset`	`null`	PBR: the base colour map (sRGB).
`metallicRoughnessTexture`	`asset`	`null`	PBR: the packed ORM map.
`normalTexture`	`asset`	`null`	The tangent-space normal map.
`emissiveTexture`	`asset`	`null`	The emissive map (sRGB).
`occlusionTexture`	`asset`	`null`	PBR: a separate occlusion map.
`diffuseTexture`	`asset`	`null`	Standard: the diffuse map (sRGB).
`specularTexture`	`asset`	`null`	Standard: the specular map.
`opacityTexture`	`asset`	`null`	Standard: the opacity map.

Material file (ignifx/material-file)#

Material file (`ignifx/material-file`)#