When a BY_REFERENCE GeometryArray object is created, the user creates geometry arrays and populates those arrays with geometry data. There are no geometry arrays internal to the Geometry object no copy of the geometry data made. Instead the BY_REFERENCE GeometryArray object simply stores a reference to the user array(s) of geometry data.
There are two good reasons for using BY_REFERENCE GeometryArray:
- if the geometry data is dynamic
- if the geometry data requires too much memory
This program shows how to implement the dynamic geometry data by a BY_REFERENCE GeometryArray.