hide_depth

Context: depth

Synopsis

Hide the objects at the specified depth.

Syntax

hide_depth( [id,] depth)

Description

id - an optional ChipsId structure containing values to modify the currency state for the command or a string id to specify the frame.
depth - the depth value to hide.

The hide_depth command hides all objects at a specific depth. The objects remain hidden until display_depth ("ahelp display_depth") is called or they are moved to a depth which is not hidden. Objects which were hidden using another method, such as "hide_<object>", will remain hidden even if the depth is changed.

Example 1

chips> add_curve(range (10), range (10), 'line.color=blue
symbol.color=blue depth=50')
chips> add_curve(range (10), range (9,-1,-1), 'depth=100')
chips> add_hline(5, 'depth=50 color=red')
chips> hide_depth(50)

Create two curvess and a horizontal line at different depths. Hide everything at depth 50 (i.e. the line and the blue curve).

Example 2

chips> add_histogram([1,2,3],[3,5,2], 'fill.style=1 fill.color=red
depth=50')
chips> add_curve([1,2,3],[3,5,2], 'depth=100')
chips> add_label(3, 3, 'LABEL', 'depth=50')
chips> hide_label()
chips> set_plot_title ('My Plot')
chips> set_plot(['title.depth',50])
chips> hide_depth(50)
chips> set_histogram(["depth",150])
chips> set_label(["depth",150])

Create a histogram, a curve, and a label. The label is hidden with the hide_label command. Hide everything at depth 50.

Moving the histogram to a different depth makes it visible again. The same does not work with the label, because it was not hidden by the hide_depth command.

Bugs

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