MaterialAsset Object

Derived from: Asset Object

Description

The MaterialAsset object is derived from the Asset object and represents a material. A material is a simple asset that references an appearance and a physical properties asset.

Methods

Name	Description
CopyTo	Method that copies this asset to the specified target and returns the new asset. A failure will occur if you attempt to copy it to the location where it already exists.
Delete	Method that deletes this asset from the library. An asset can only be deleted if it is not currently being used, which you can determine using the IsUsed property.
Duplicate	Method that creates a copy of this asset within the document using a new display name. This method is only valid when called on an asset that is owned by a document. A failure will occur if you attempt to copy an asset that isn’t owned by a document and if the.

Properties

Name	Description
AppearanceAsset
Application	Returns the top-level parent application object. When used the context of Inventor, an Application object is returned. When used in the context of Apprentice, an ApprenticeServer object is returned.
AssetType	Gets the data type that returns whether this is an appearance, physical properties, or material asset.
Category
CategoryName	Gets the name of the category this Asset is designated to be in. This can include the the category and subcategories which are delimited by a colon.
Count	Gets the number of items in this collection.
DisplayName
HasTexture	Gets the flag that indicates if this asset has texture.
IsReadOnly	Gets the boolean flag that indicates if this asset is read-only. If True any attempted edits will fail.
IsUsed	Gets the boolean flag that indicates if this asset is being used in the document or in a material definition.
Item	Allows integer-indexed access to items in the collection.
Name	Gets the key name of the asset. This name will remain constant for all languages and is the name used as input to the Item property.
Parent	Read-only property that returns the parent object of this asset. This can return an AssetLibrary, or Document object.
PhysicalPropertiesAsset
Type	Gets the constant that indicates the type of this object.

Samples

Name	Description
Write out all materials to a file.	This sample writes out information about all of the materials in all libraries. This can be useful when trying to use the API to modify existing materials by allowing to easily see what information is available for a material.
Write out all document materials to a file.	This sample writes out information about all of the materials in the active document. This can be useful when trying to use the API to modify existing materials by allowing you to easily see what information is available for a material.

Version

Introduced in version 2014