Moves the layer down the layer tree (towards the root layer) if the parent layer is not the root layer.

l_layer_promote(widget, layer)

Arguments

widget

widget path or layer object of class 'l_layer'

layer

layer id. If the widget argument is of class 'l_layer' then the layer argument is not used

Value

0 if success otherwise the function throws an error

Examples

p <- l_plot() g1 <- l_layer_group(p) g2 <- l_layer_group(p, parent=g1) l1 <- l_layer_oval(p, x=0:1, y=0:1, parent=g2) l_layer_printTree(p) l_layer_promote(p, l1) l_layer_printTree(p) l_layer_promote(p, l1) l_layer_printTree(p)