General Editing

(int) ClearCell(undoable, layer_list)
This function will clear the content of the present mode (electrical or physical) part of the current cell. If the first argument is nonzero, the deletions will be added to the internal undo list, otherwise not. The latter is more efficient, though this makes the deletions irreversible. The second argument, if null or empty, indicates that all objects on all layers will be deleted, including subcells. Otherwise this can be set to a string containing a space-separated list of layer names, following an optional special character `!' or `^' which must be the first character in the string if used. If the special character does not appear, the deletions apply only to the layers listed. If the special character appears, the deletions apply only to the layers not listed. Recall that the internal name for the layer that contains subcells ls ``$$'', thus for example using ``! $$'' would delete all geometry but retain the subcells.

The return value is the number of objects deleted.

Commit()
The Commit functions terminates the present operation, adding it to the undo list. It will also redisplay any changes. This function should be called after each change or after a group of related changes. It is implicitly called when a script exits.

Undo()
This function will undo the most recent operation.

Redo()
This function will redo the last undone operation.

(int) SelectLast(types)
This function selects objects that have been created by the script functions since the last call to Commit or SelectLast (which calls Commit), according to type. The type argument is a string whose characters serve to enable selection of a given type of object: `b' for boxes, `p' for polygons, `w' for wires, `l' for labels, and `c' for instances. If this string is empty or null, then all objects will be selected. Objects that are created using PressButton or otherwise using Xic input implicitly call Commit, so can't be selected in this manner.