plot_layout_properties {officer} | R Documentation |
Slide layout properties plot
Description
Plot slide layout properties into corresponding placeholders.
This can be useful to help visualize placeholders locations and identifiers.
All information in the plot stems from the layout_properties()
output.
See Details section for more info.
Usage
plot_layout_properties(
x,
layout = NULL,
master = NULL,
labels = TRUE,
title = TRUE,
type = TRUE,
id = TRUE,
cex = NULL,
legend = FALSE
)
Arguments
x |
an |
layout |
slide layout name or numeric index (row index from [layout_summary()). |
master |
master layout name where |
labels |
if |
title |
if |
type |
if |
id |
if |
cex |
named list or vector to specify font size for |
legend |
Add a legend to the plot (default |
Details
The plot contains all relevant information to reference a placeholder via the ph_location_*
function family:
-
label
: ph label (red, center) to be used inph_location_label()
. NB: The label can be assigned by the user in PowerPoint. -
type[idx]
: ph type + type index in brackets (blue, upper left) to be used inph_location_type()
. NB: The index is consecutive and is sorted by ph position (top -> bottom, left -> right). -
id
: ph id (green, upper right) to be used inph_location_id()
(forthcoming). NB: The id is set by PowerPoint automatically and lack a meaningful order.
See Also
Other functions for reading presentation information:
annotate_base()
,
color_scheme()
,
doc_properties()
,
layout_properties()
,
layout_summary()
,
length.rpptx()
,
slide_size()
,
slide_summary()
Examples
x <- read_pptx()
# select layout explicitly
plot_layout_properties(x = x, layout = "Title Slide", master = "Office Theme")
plot_layout_properties(x = x, layout = "Title Slide") # no master needed if layout name unique
plot_layout_properties(x = x, layout = 1) # use layout index instead of name
# plot current slide's layout (default if no layout is passed)
x <- read_pptx()
x <- add_slide(x, "Title Slide")
plot_layout_properties(x)
# change appearance: what to show, font size, legend etc.
plot_layout_properties(x, layout = "Two Content", title = FALSE, type = FALSE, id = FALSE)
plot_layout_properties(x, layout = 4, cex = c(labels = .8, id = .7, type = .7))
plot_layout_properties(x, 1, legend = TRUE)