1#lang scribble/doc
2@(require "ss.rkt")
3
4@title[#:tag "aspect"]{Fullscreen vs. Widescreen Aspect Ratio}
5
6Fullscreen (4:3, 1024 by 768) versus widescreen (16:9,  1360 by 766) aspect mode is a property of
7an individual slide that can be selected using the @racket[#:aspect]
8argument to @racket[slide]. The @racketmodname[slideshow/widescreen]
9language provides a variant of @racket[slide] that makes
10@racket['widescreen] the default value of @racket[#:aspect], while
11@racketmodname[slideshow/fullscreen] provides a variant of
12@racket[slide] that makes @racket['fullscreen] the default.
13
14When a slide's aspect is not specified, then it adopts an aspect that
15can be selected via the @DFlag{widescreen} or @DFlag{fullscreen} flag
16when Slideshow starts. (That selection can be made ``sticky'' as the
17default for future runs by using the @DFlag{save-aspect} flag.)
18Selecting an aspect also affects the values of @racket[client-w],
19@racket[client-h], @racket[full-page], and @racket[titleless-page]
20from @racketmodname[slideshow], but it does not affect the bindings
21from @racketmodname[slideshow/widescreen] or
22@racketmodname[slideshow/fullscreen]. Keep in mind that specifying
23@racket[#:aspect] for @racket[slide] does not affect the value of
24@racket[client-w], etc., for constructing the slide's content, but you
25can use @racket[get-client-w], etc., to obtain the aspect-specific
26metrics.
27
28Use the @racketmodname[slideshow] language for slides and libraries
29that are meant to adapt to a user's selected aspect, and use
30@racketmodname[slideshow/fullscreen] or
31@racketmodname[slideshow/widescreen] for slides and libraries that
32assume specific values for a slide's drawing area.
33
34@include-section["fullscreen.scrbl"]
35@include-section["widescreen.scrbl"]
36