select_layout_images() returns the figure's images matching selector
(and grid cell); update_layout_images() updates their properties like
update_layout() does; for_each_layout_image() replaces each one with
the result of fn.
Usage
select_layout_images(
fig,
selector = NULL,
row = NULL,
col = NULL,
secondary_y = NULL
)
update_layout_images(
fig,
patch = NULL,
...,
selector = NULL,
row = NULL,
col = NULL,
secondary_y = NULL,
overwrite = FALSE
)
for_each_layout_image(
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_image()).- ...
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_layout_images() returns a list of go_layout_image() objects; the
others return the modified figure.