Merges connected topology elements that have the same value in the specified field.
(tpm_anadissolve source_id field var_id [result_name] [result_desc] [objtable] [objcolumn])
Returns T or nil.
| source_id | Source topology ID (real). Polygon or network topology only. |
| field | Dissolve field name (string), a standard Data Extension expression. For example, :Value@Tab1, .Layer. |
| var_id | Topology variables ID (real). |
| result_name | Name of new topology (string); topology is loaded but not open. If argument is omitted or nil, the dissolve results in a collection of AutoCAD objects. |
| result_desc | Resulting topology description (string) or nil. |
| objTable | Object data table name (string) or nil. |
| objColumn | Object data field name (string) or nil. |
The topology variables ID references a set of topology variables.
The function works for polygon or network topologies. If it finds two or more attached objects that have the same value in the specified dissolve field, it dissolves them.
- Dissolving polygons deletes their centroids and shared links and creates a new polygon with a new centroid.
- Dissolving links deletes shared nodes. The links are merged into one polyline.
The function writes the shared dissolve field value to the object data table and field that you specify and attaches the table to the result object. If this table does not exist, the function creates it. If the table you specify is already attached to one of the source objects, a table with default values is attached to the result object.