Appearance.normalTexture Property

Description

Gets and sets the path of a tangent-space normal map used as a texture for the appearance's surface_normal slot. Setting a path connects a new texture and setting an empty string disconnects the existing texture. Getting this property returns the filename of the connected texture or an empty string if there isn't one connected.

The image is interpreted as an OpenGL convention tangent-space normal map, which is the "normal_gl" variant from typical PBR sources. To use a heightmap or bump map instead, set this property to the image path and then change the texture's bumpmap_Type to bumpmap_height_map using appearanceProperties.itemById('surface_normal').value.properties.

The order in which colorTexture, normalTexture, and roughnessTexture are set matters, as described for colorTexture. As with colorTexture, the image is saved within the document but the path returned by the getter after the document has been saved and reopened can differ from the path that was set.

This property can only be set for appearances in a Design or the favorites list, and setting it fails if the appearance doesn't have a surface_normal slot. Appearances created using Appearances.add always support this property.

Syntax

# Get the value of the property.
propertyValue = appearance_var.normalTexture

# Set the value of the property.
appearance_var.normalTexture = propertyValue

#include <Core/Materials/Appearance.h>

// Get the value of the property.
string propertyValue = appearance_var->normalTexture();

// Set the value of the property, where value_var is a string.
bool returnValue = appearance_var->normalTexture(value_var);

// Get the value of the property.
propertyValue = appearance_var.normalTexture;

// Set the value of the property.
appearance_var.normalTexture = propertyValue;

Property Value

Version