select_shapes() returns the figure's shapes matching selector
(and grid cell); update_shapes() updates their properties like
update_layout() does; for_each_shape() replaces each one with
the result of fn.
Usage
select_shapes(fig, selector = NULL, row = NULL, col = NULL, secondary_y = NULL)
update_shapes(
fig,
patch = NULL,
...,
selector = NULL,
row = NULL,
col = NULL,
secondary_y = NULL,
overwrite = FALSE
)
for_each_shape(
fig,
fn,
selector = NULL,
row = NULL,
col = NULL,
secondary_y = NULL
)Arguments
- fig
A
go_figureobject.- selector
Which objects to use:
NULL(all), indices into the matching objects, a named list of property values that must all match, or a function that takes an object and returnsTRUEorFALSE.- row, col
Only objects on this subplot grid row and/or column's axes.
- secondary_y
Only objects on secondary (
TRUE) or primary (FALSE) y axes.- patch
A named list of property updates (see
go_layout_shape()).- ...
Further named updates (names may use magic underscores).
- overwrite
If
TRUE, replace nested objects instead of merging.- fn
A function that takes an object and returns the modified object. If it returns anything other than a list, the object is left unchanged.
Value
select_shapes() returns a list of go_layout_shape() objects; the
others return the modified figure.