Material Definition
Materials in Roomle are JSON files with defined attributes. One main material JSON and several texture JSON files (one for each texture variant).
Material JSON
Base color
Base color in sRGB color space
If a diffuse texture is present, its texel values will get multiplied with the basecolor in linear color space.
For diffuse reflection, avoid extreme values (0.0 or 1.0) and leave some headroom (min:0.04 and max:0.9).
Example: default white
Roughness
0.0
is perfectly smooth with sharp reflections
1.0
is completely matte/dull surface due to lots of microsurface scattering
Default 0.85
Metallic
Metallness of material
1.0
for metals
0.0
for dielectrics
A physical material is always either metal or non-metal (conductor or dielectric). Mixed values only make sense to mimic the appearance of layered materials (e.g. a bit of dust on a metal surface)
Default 0.0
Alpha / Opacity
Opacity factor
0.0
is completely invisible
1.0
completely opaque (the default)
Alpha / Transmission
Transmission factor. Useful for creating transparent materials like glass.
If an object is transmissive, its basecolor is used as transmissive color. This is useful to create colored glass.
0.0
fully opaque (the default) 1.0
is completely transmissive with (fresnel) reflections and specular highlights
transmissionIOR
is the transmissive index of refraction (IOR), controlling the angle in which light is refracted when entering/leaving. At the moment this won't have effect in real-time renderings.
Default is IOR of plate glass ( https://en.wikipedia.org/wiki/List_of_refractive_indices )
Example: clear glass (assuming the basecolor is completely white)
Real-time render related
Alpha cutoff
Alpha testing - use with alpha channel (opacity) texture
Fragment only gets rendered if alpha value is greater than this value.
defaults to 0.0
, meaning no alpha cutoff
Double sided
By default in real-time renderings a back-face culling is applied. This means polygons/triangles are only visible from one side. If doubleSided
is true, they are visible from both sides.
Useful for billboards, semi-transparent fabrics or plant leaves.
Default: false
Occlusion strength
If an occlusion texture is present, its values are scaled by this factor.
0
results in no occlusion, 1.0
is full occlusion (default).
Texture JSON
Here is a example texture file:
Resolution
Width and height in pixels
Tileable
If 1, texture repeats itself in both axes Default: 0
URL
URL of image file
Size
Real world width/height.
Necessary for universal texture application with correct scaling/sizing. The idea is that this texture/material can be applied to many different objects with a consistent size/scaling appearance as long as they fulfill this requirements:
The UVs are absolute in a certain unit (millimeter in our case)
Default: 0.0 (results in a uniform texture scale of 1.0, ordinary/normalized UV application)
Explanatory example
A 3D quad has the measurement 10 cm by 20 cm. Its correct UVs are in the rect x:0/y:0 to x:100/y:200. The texture we want to apply spans 50 by 50 mm.
The resulting texture tileable will be x = 50; y = 50. This way the texture is tiled twice on the x axis and 4 times on the y axis.
Mapping
Describes how texture channels are mapped to material channels.
RGB: Albedo color
RGBA: Albedo color plus alpha channel (opacity)
XYZ: Normal map (Open GL style Y-up)
ORM: Combined occlusion/roughness/metallic map (similar to glTF 2.0 specification)
Texture channel assignments
red | green | blue | alpha | |
---|---|---|---|---|
RGB | basecolor red | basecolor green | basecolor blue | - |
RGBA | basecolor red | basecolor green | basecolor blue | alpha |
XYZ | normal x | normal y | normal z | - |
ORM | occlusion | roughness | metallic | - |
Default: RGB
Occlusion Roughness Metallic composition
The texel values are in linear color space and are multiplied with their respective factor property values:
Metallic texel values are multiplied with the metallic factor value.
Occlusion texel values are multiplied with the occlusion strength factor value.
Roughness texel values are multiplied with the roughness factor value.
The occlusion is used in real-time rendering only.
Appendix
Last updated