ImageNormalMap
Overview
ImageNormalMap applies tangent space normal mapping to materials. It is typically referenced by the input_normal attribute of a material.
Attribute Reference
UVs attributes
input_texture_coordinates
Vec3f bindable
default: [ 0, 0, 0 ]
When 'texture_coordinates' is set to 'input texture coordinates', UVs are generated by evaluating the map bound to this attribute
offset
Vec2f
default: [ 0, 0 ]
Translates the UV coordinates in texture space. The order of operations is rotation, scale, and then offset.
rotation_angle
Float
default: 0.0
Rotation of the UV coordinates in texture space in degrees. The order of operations is rotation, scale, and then offset.
rotation_center
Vec2f
default: [ 0.5, 0.5 ]
The UV coordinate around which to rotate. The order of operations is rotation, scale, and then offset.
scale
Vec2f
default: [ 1, 1 ]
Scales the UV coordinates in texture space. The order of operations is rotation, scale, and then offset.
texture_coordinates
Int enum
0 = “texture” (default)
1 = “input texture coordinates”
Selects which texture coordinates to use. 'texture' uses the surface UVs. 'input texture coordinates' uses the map bound to 'input_texture_coordinates'.
General attributes
default_value
Vec3f
default: [ 0, 0, 1 ]
Default value to be used for missing udims when 'use_default_value_when_missing' is enabled
normal_encoding
Int enum
0 = “[0,1]” (default)
1 = “[-1,1]”
Most normal maps are encoded [0,1]. Only certain rare floating point normal maps are encoded [-1,1]
tangent_space_normal_texture
String filename
default:
Filename that points to a tangent space normal texture .exr or .tx file (must be mip-mapped and tiled with maketx). If 'udim_files' is empty and a 'UDIM' token is present in the filename, then 'UDIM' will be replaced with the udim number (i.e. 1001, 1002, etc.)
use_default_value_when_missing
Bool
default: False
Uses the 'default_value' for missing udims and does not report error
wrap_around
Bool
default: True
Controls whether to repeat (true) or clamp (false) the texture