Appearances.addByCopy Method

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

Description

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

Syntax

"appearances_var" is a variable referencing an Appearances object.
returnValue = appearances_var.addByCopy(appearanceToCopy, name)
"appearances_var" is a variable referencing an Appearances object.

#include <Core/Materials/Appearances.h>

returnValue = appearances_var->addByCopy(appearanceToCopy, name);

Return Value

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

Parameters

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

Samples

Name Description
Material API Sample

Demonstrates using materials and appearance using the API.

To use the sample, create a new Python or C++ script and copy and paste this code, replacing the default code. The sample also used an external appearance library which you can get here. Copy that to any location on your computer and edit the path in the script. When running the script, have a design open that contains a body in the root component.

Version

Introduced in version January 2016