3.1 Primary Slide Functions
Creates and registers a slide. See Staging Slides for information
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
The normal way to make plain text. Returns (text str (current-main-font) (current-font-size)).
The normal way to make italic text. Returns (text str (cons 'italic (current-main-font)) (current-font-size)).
The normal way to make bold text. Returns (text str (cons 'bold (current-main-font)) (current-font-size)).
Bold-italic text. Returns (text str (list* 'bold 'italic (current-main-font)) (current-font-size)).
The normal way to make monospaced text. Returns (text str `(bold . modern) (current-font-size)).
The normal way to make serif text. Returns (text str 'roman (current-font-size)).
Creates title text. Returns ((current-titlet) str).
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
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: --- → —, --
→ –, `` → “,
'' → ”, ' →
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
See the spacing between lines is determined by the
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
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
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
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
Returns a function that takes a symbol and generates an outline
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
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