Materials.addByCopy Method
Parent Object:
MaterialsDefined 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
| Material |
Returns the newly created Material or null if the copy operation failed. |
Parameters
| 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
