ProjectPlanarNormalMap

Overview

ProjectPlanarNormalMap projects a tangent space normal map along the z axis by default. The direction can be set with a matrix, TRS controls, or a projector object based on the value of the projection_mode attribute.


Attribute Reference

General attributes

TRS_order

Int enum
  0 = “Scale Rot Trans” (default)
  1 = “Scale Trans Rot”
  2 = “Rot Scale Trans”
  3 = “Rot Trans Scale”
  4 = “Trans Scale Rot”
  5 = “Trans Rot Scale”

Order in which to apply transformations when 'projection_mode' is set to 'TRS'

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]

projection_matrix

Mat4d
default: [ [ 1, 0, 0, 0 ], [ 0, 1, 0, 0 ], [ 0, 0, 1, 0 ], [ 0, 0, 0, 1 ] ]

The transform to use for projection when 'projection_mode' is set to 'projection_matrix'

projection_mode

Int enum
  0 = “projector” (default)
  1 = “projection_matrix”
  2 = “TRS”

Source parameters to use for projection transform

projector

Node
default: None

The object whose transform to use for projection when 'projection_mode' is set to 'projector'

rotate

Vec3d
default: [ 0, 0, 0 ]

Rotation of the projection transform when 'projection_mode' is set to 'TRS'

rotation_order

Int enum
  0 = “xyz” (default)
  1 = “xzy”
  2 = “yxz”
  3 = “yzx”
  4 = “zxy”
  5 = “zyx”

Order in which to apply rotation transformations when 'projection_mode' is set to 'TRS'

scale

Vec3d
default: [ 1, 1, 1 ]

Scale of the projection transform when 'projection_mode' is set to 'TRS'

texture

String filename
default:

Filename that points to a texture .exr or .tx file (must be mip-mapped and tiled with maketx).

translate

Vec3d
default: [ 0, 0, 0 ]

Translation of the projection transform when 'projection_mode' is set to 'TRS'

use_reference_space

Bool
default: False

Use reference space position (ref_P) and normals (ref_N)

wrap_around

Bool
default: True

Controls whether to repeat (true) or clamp (false) the texture