hide_contour

Context: contours

Synopsis

Hide the specified contour.

Syntax

hide_contour()
hide_contour( [ChipsId] )
hide_contour( "contour_id" )
hide_contour( "all" )

Description

Depending on the argument, this command hides the current contour, the contour indicated in a ChipsId structure or by the contour_id, or all contours.

(no argument) - the current contour is hidden.
ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
contour_id - identification tag given to each object that is created; use this to hide a specific contour.
all - hides all contours.

The contour is not deleted, just hidden. The display_contour command makes it visible again.

Example 1

chips> add_contour([[1,1,1], [1,3,1], [1,1,1]], 3,3)
chips> hide_contour()

Create a contour, then hide the current contour.

Example 2

chips> id = ChipsId()
chips> add_contour([[1,1,1], [1,3,1], [1,1,1]], 3,3,
[1.1,1.5,2,2.5],'id=levels')
chips> add_contour([1,2,5,3,3,6,0,0,1],3,3)
chips> id.contour = "levels"
chips> hide_contour(id)

Two contours are created; the second contour is current after it is created. The id.contour command sets the contour value of the ChipsId structure to the first contour. That contour is then hidden.

Example 3

chips> add_contour([[1,1,1], [1,3,1], [1,1,1]], 3,3,
[1.1,1.5,2,2.5],'color=lime style=solid')
chips> add_contour([1,2,5,3,3,6,0,0,1],3,3)
chips> hide_contour("all")

Two contours are created, then the hide_contour command hides them both.

Bugs

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