hide_point

Context: points

Synopsis

Hide the specified point.

Syntax

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

Description

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

(no argument) - the current point is hidden.
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 hide a specific point.
all - hides all points.

The point is not deleted, just hidden. The display_point command makes it visible again.

Example 1

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

Create a point, then hide the current point.

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> id.point = "sq"
chips> hide_point(id)

Two 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 hidden.

Example 3

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> hide_point("all")

Three points are created, then the hide_point command hides them both.

Bugs

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