3.1 Primary Slide Functions
Creates and registers a slide. See
Staging Slides for information
about
elements.
When this function is first called in non-printing mode, then the
viewer window is opened. Furthermore, each call to the function
yields, so that the viewer window can be refreshed, and so
the user can step through slides.
If title is not #f, then a title is shown for the
slide. The name is used in the slide-navigation dialog, and
it defaults to title.
If layout is 'top, then the content is top-aligned,
with (* 2 gap-size) space between the title and the
content. The 'tall layout is similar, but with only
gap-size. The 'center mode centers the content
(ignoring space consumed by the title). The 'auto mode is
like 'center, except when title is non-#f
and when the space between the title and content would be less than
(* 2 gap-size), in which case it behaves like 'top.
The inset argument supplies an inset that makes the
slide-viewing window smaller when showing the slide. See
make-slide-inset for more information.
If secs argument for #:timeout is not #f,
then the viewer automatically advances from this slide to the next
after secs seconds, and manual advancing skips this slide.
If condense? is ture, then in condense mode (as specified by
the -c command-line flag), the slide is not created and
registered.
Generates a paragraph pict that is no wider than width units,
and that is exactly width units if fill? is true. If
fill? is #f, then the result pict is as wide as the
widest line.
Each list within elements is spliced into the sequence of
string and pict elements. If decode? is true, then strings
among the elements are decoded by performing the following
substitutions: --- → —, --
→ –, `` → “,
'' → ”, ' →
’. In addition, to better work with
at-exp notation, if an element is "\n",
then it is dropped along with any spaces at the start of the next
element.
Strings are split at spaces for word-wrapping to fit the page, and a
space is added between elements. If a string element starts with one
of the following punctuation marks (after decoding), however, no space
is added before the string:
- ' , . :
; ? ! ) ” ’
The align argument specifies how to align lines within the
paragraph.
See the spacing between lines is determined by the
current-line-sep parameter.
Like
para, but with
blt followed by
(/ gap-size 2) space appended horizontally to the resulting paragraph,
aligned with the top line. The paragraph width of
blt plus
(/ gap-size 2) is subtracted from the maximum width of the
paragraph.
Like
item, but an additional
(* 2 gap-size) is
subtracted from the paragraph width and added as space to the left of
the pict. Also,
o-bullet is the default bullet, instead of
bullet.
Creates a pict that embeds the given one, and is the same size as the
given pict, but that when clicked during a presentation calls
thunk.
Scales
pict so that it is displayed on the screen as
(pict-width pict) pixels wide and
(pict-height pict)
pixels tall. The result is
pict when using a 1024 by 768
display.
Returns a function that takes a symbol and generates an outline
slide.
The ... above applies to all three arguments together. Each
trio of arguments defines a section for the outline:
The section name is either a symbol or a list of symbols. When
the outline function is called later to make an outline, the
given symbol is compared to the section’s symbol(s), and the
section is marked as current if the symbol matches.
The title is used as the displayed name of the
section.
The subitems are displayed when the section is
active. It can be #f or null (for historical
reasons) if no subitems are to be displayed. Otherwise, it
should be a function that takes a symbol (the same one passed
to the outline maker) and produces a pict.
Combines strings and picts to be used as a slide element for (usually
hidden) commentary. Use the result as an argument to
slide.
Returns
#t if
v is a comment produced by
comment.