HC_Edit_Cellular_Volume_Cells
-
void
HC_Edit_Cellular_Volume_Cells(Key key, int offset, int ndelete, int insert_list_length, int const insert_list[]) - void HC_Edit_Cellular_Volume_Cells(Key key, int offset, int ndelete, int insert_list_length, int const insert_list)
Creates or deletes cells in a previously declared cellular volume.
Edit_Cellular_Volume_Cells() lets you modify a complex volume as it sits in the database. You don’t have to delete and reinsert the volume from scratch.
Edit_Cellular_Volume_Cells() changes the originally specified cell_list (see Insert_Cellular_Volum() ), starting at offset in terms of the number of whole cells.
First, if ndelete is non-zero then ndelete cells are dissolved from offset through offset+ ndelete - 1. The points referenced by those cells still exist.
If insert_list_length is non-zero, new cells are then constructed using the information in insert_list, to a maximum of insert_list_length. The new cells are inserted in the list just before offset.
Finally, the offsets of the cells are renumbered to reflect any changes.
HC_Edit_Cellular_Volume_Points, HC_Show_Cellular_Volume, HC_Delete_Segment, HC_Delete_By_Key, HC_Flush_Contents, HC_Flush_By_Key, HC_Insert_Cellular_Volume.Parameters
key: - The unique identifier returned by a previous call to Insert_Cellular_Volume().
offset: - Number of the cell in the original volume definition before which to start inserting or at which to begin deleting. “0” is the first. If specified as “-1”, editing starts after the old final cell.
ndelete: - Number of cells to delete.
insert_list_length: - Number of integers in insert_list.
insert_list: - Encoded description of how to connect the existing vertices to build new cells for the volume. See Insert_Cellular_Volume() for format.