delete_point

Synopsis

Delete the specified point.

delete_point()
delete_point( [ChipsId] )
delete_point( "point_id" )
delete_point( "all" )

Description

Depending on the argument, the delete_point command deletes the current point, the point indicated in a ChipsId structure or by the point_id, or all points.

• (no argument) - the current point is deleted.
• ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
• point_id - identification tag given to each object that is created; use this to delete a specific point.
• all - deletes all points.

Example 1

chips> add_point(.6, .5, "style=plus")
chips> delete_point()

Create a point, then delete it.

Example 2

chips> id = ChipsId()
chips> add_point(.4, .5, "id=sq style=square")
chips> add_point(.8, .2, "id=tri style=uptriangle size=12")
chips> add_point(.6, .5, "style=plus")
chips> id.point = "sq"
chips> delete_point(id)

Three points are created; the second point is current after it is created. The id.point command sets the point value of the ChipsId structure to the first point. That point is then deleted.

Example 3

chips> add_point(.4, .5, "id=sq style=square")
chips> add_point(.8, .2, "id=tri style=uptriangle size=12")
chips> delete_point("all")

Two points are created, then the delete_point command deletes them both.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

concepts

chipsid, currency

points

add_point, current_point, display_point, get_point, hide_point, move_point, set_point, shuffle_point