Materials.addByCopy Method

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

Description

Add a Material to a Design by copying an existing Material from Favorites, a Library or from the Materials stored in the Design. This method currently only applies to the Materials collection from a Design and cannot be used to copy a Material to a library.

Syntax

"materials_var" is a variable referencing a Materials object.
returnValue = materials_var.addByCopy(materialToCopy, name)
"materials_var" is a variable referencing a Materials object.

#include <Core/Materials/Materials.h>

returnValue = materials_var->addByCopy(materialToCopy, name);

Return Value

Type Description
Material Returns the newly created Material or null if the copy operation failed.

Parameters

Name Type Description
materialToCopy Material The Material you want to copy. The Material to copy can be from Favorites, a Library or from the materials stored in the Design.
name string The Material name to apply to the copy.

Version

Introduced in version January 2016