GeometryInstance

Description:
An instance of another element (symbol), specially positioned by this element.

Remarks:
A GeometryInstance represents a set of geometry stored by Revit in a default configuration, and then transformed into the proper location as a result of the properties of the element. The most common situation where GeometryInstances are encountered is in Family instances. Revit uses GeometryInstances to allow it to store a single copy of the geometry for a given family and reuse it in multiple instances. Note that not all Family instances will include GeometryInstances. When Revit needs to make a unique copy of the family geometry for a given instance (because of the effect of local joins, intersections, and other factors related to the instance placement) no GeometryInstance will be encountered; instead the Solid geometry will be found at the top level of the hierarchy. Another example of GeometryInstance usage is in Rebar element visible in fine 3D Views. Here, each segement of a rebar is a GeometryInstance. In this case the Symbol Element is contaning all the geometries that are instanced. A GeometryInstance offers the ability to read its geometry through the GetSymbolGeometry() and GetInstanceGeometry() methods. These methods return another Autodesk.Revit.DB.GeometryElement which can be parsed just like the first level return.

Inheritance Hierarchy:
System.Object
  Autodesk.Revit.DB.APIObject
    Autodesk.Revit.DB.GeometryObject
      Autodesk.Revit.DB.GeometryInstance

public class GeometryInstance : GeometryObject

Public Class GeometryInstance _
	Inherits GeometryObject

public ref class GeometryInstance : public GeometryObject

Name	Return Type	Description	Inherited From
M GetDocument()	Document	Gets the document that contains the symbol of this instance.
M GetInstanceGeometry()	GeometryElement	Computes the geometric representation of the instance.
M GetInstanceGeometry(Transform)	GeometryElement	Computes a transformation of the geometric representation of the instance.
M GetSymbolGeometryId()	SymbolGeometryId	Gets the SymbolGeometryId that contains data about the symbol of this instance.
M GetSymbolGeometry()	GeometryElement	Computes the geometric representation of the symbol which generates this instance.
M GetSymbolGeometry(Transform)	GeometryElement	Computes a transformation of the geometric representation of the symbol which generates this instance.
M Dispose()	None	Causes the object to release immediately any resources it may be utilizing.	APIObject
M op_Equality(GeometryObject, GeometryObject)	bool	Determines whether two GeometryObjects are the same.	GeometryObject
M Equals(Object)	bool	Determines whether the specified is equal to the current .	GeometryObject
M GetHashCode()	int	Gets the integer value of the geometry object as hash code	GeometryObject
M op_Inequality(GeometryObject, GeometryObject)	bool	Determines whether two GeometryObjects are different.	GeometryObject

Name	Return Type	Description	Inherited From
P SymbolGeometry	GeometryElement	The geometric representation of the symbol which generates this instance.
P Transform	Transform	The affine transformation from the local coordinate space of the symbol into the coordinate space of the instance.
P IsReadOnly	bool	Identifies if the object is read-only or modifiable.	APIObject
P GraphicsStyleId	ElementId	The ElementId of the GeometryObject's GraphicsStyle	GeometryObject
P Id	int	A unique integer identifying the GeometryObject in its associated non view-specific GeometryElement.	GeometryObject
P IsElementGeometry	bool	Indicates whether this geometry is obtained directly from an Element.	GeometryObject
P Visibility	Visibility	The visibility.	GeometryObject