Appearance Object

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

Description

An appearance.

Methods

Name Description
classType Static function that all classes support that returns the type of the class as a string. The returned string matches the string returned by the objectType property. For example if you have a reference to an object and you want to check if it's a SketchLine you can use myObject.objectType == fusion.SketchLine.classType().
copyTo **RETIRED** Copies this appearance to the specified target.
deleteMe Deletes the Appearance from the Design. This method is only valid for appearances that are in a Design and are unused.

Properties

Name Description
appearanceProperties returns the collection of Properties that define this appearance
hasTexture Property that indicates if this appearance has a texture associated with it.
id The unique internal ID of this Appearance.
isUsed Returns true if this Appearance is used in the Design.
isValid Indicates if this object is still valid, i.e. hasn't been deleted or some other action done to invalidate the reference.
name Returns the name of this Appearance. This is the localized name shown in the UI.
objectType This property is supported by all objects in the API and returns a string that contains the full name (namespace::objecttype) describing the type of the object.

It's often useful to use this in combination with the classType method to see if an object is a certain type. For example: if obj.objectType == adsk.core.Point3D.classType():
parent Property that returns the Parent object of this Appearance (a MaterialLibrary, Design, or AppearanceFavorites collection).
usedBy Returns a collection of the entities currently using this appearance. This property is only valid for an appearance in a Design and where the IsUsed property returns true. The collection returned can contain

Accessed From

Appearances.addByCopy, Appearances.item, Appearances.itemById, Appearances.itemByName, BRepBody.appearance, BRepFace.appearance, ConfigurationAppearanceCell.appearance, CustomGraphicsAppearanceColorEffect.appearance, FavoriteAppearances.add, FavoriteAppearances.item, FavoriteAppearances.itemById, FavoriteAppearances.itemByName, Material.appearance, MaterialPreferences.appearanceOverride, MeshBody.appearance, Occurrence.appearance

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 August 2014