Namespace:
Autodesk.Revit.DB
DirectShapeLibrary
Class
Description:
DirectShapeLibrary is used to store pre-created geometry for further referencing via the definition/instance mechanism. It is not persistent: the scope of a library object is usually a single data creation session.
DirectShapeLibrary is used to store pre-created geometry for further referencing via the definition/instance mechanism. It is not persistent: the scope of a library object is usually a single data creation session.
Remarks:
There are two ways to add a definition to the library. The first is to add the definition as an array of geometry objects. A DirectShape created as an instance of that definition will hold a copy of predefined geometry, transformed as requested. If the definition was added as a DirectShapeType, a DirectShape object created as an instance of that definition will reference the type. Its geometry would be an instance of type geometry.
There are two ways to add a definition to the library. The first is to add the definition as an array of geometry objects. A DirectShape created as an instance of that definition will hold a copy of predefined geometry, transformed as requested. If the definition was added as a DirectShapeType, a DirectShape object created as an instance of that definition will reference the type. Its geometry would be an instance of type geometry.
DirectShapeLibrary Class Members:
| Name | Description | Inherited From |
|---|---|---|
| IsValidObject | Specifies whether the .NET object represents a valid Revit entity. |
| Name | Description | Inherited From |
|---|---|---|
| AddDefinition(String, GeometryObject) | Add a definition to be reused by instances. A definition is a single geometry object. | |
| AddDefinition(String, IList<GeometryObject>) | Add a definition to be reused by instances. A definition is a collection of geometry objects. | |
| AddDefinitionType | Add a definition to be reused by instances. Adding a definition type will change how the instances are created. When asked to create a definition, the library object will look for a corresponding type object. If one is found, it will create an instance of geometry stored in the type object. If it is not found, the library will look for a list of geometry objects stored as definition, and will copy and transform these to create an instance. | |
| Contains | A quick check whether a definition already exists in the library. Checks for stored geometry objects only. | |
| ContainsType | A quick check whether a definition type already exists in the library. Checks for type objects only. | |
| Dispose | Releases all resources used by the DirectShapeLibrary | |
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object ) | Object |
| FindDefinition | Find a definition by id | |
| FindDefinitionType | Find a DirectShapeType element by definition id. The element will be used for creating instances of that definition. | |
| GetDirectShapeLibrary | Get the currently active Library object | |
| GetHashCode | Serves as the default hash function. (Inherited from Object ) | Object |
| GetType | Gets the Type of the current instance. (Inherited from Object ) | Object |
| Reset | Removes all definitions from library. This is useful when importing several self-contained data sets within one session. Once a data set is imported, keeping the definitions specific to that data set will slow down the searches. | |
| ToString | Returns a string that represents the current object. (Inherited from Object ) | Object |