Appearance.roughness Property

Parent Object: Appearance
Defined in namespace "adsk::core" and the header file is <Core/Materials/Appearance.h>

Description

Gets and sets the surface roughness in the range 0 to 1, where 0 is a perfect mirror and 1 is fully matte. This maps to the surface_roughness property. The roughness can only be set for appearances in a Design or the favorites list.

Syntax

"appearance_var" is a variable referencing an Appearance object.
# Get the value of the property.
propertyValue = appearance_var.roughness

# Set the value of the property.
appearance_var.roughness = propertyValue
"appearance_var" Is a variable referencing an Appearance Object.
#include <Core/Materials/Appearance.h>

// Get the value of the property.
double propertyValue = appearance_var->roughness();

// Set the value of the property, where value_var is a double.
bool returnValue = appearance_var->roughness(value_var);
"appearance_var" Is a variable referencing an Appearance Object.
// Get the value of the property.
propertyValue = appearance_var.roughness;

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

Property Value

This is a read/write property whose value is a double.

Version

Introduced in version July 2026