1 files changed, 110 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
index de4449ad7da..60848464323 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
@@ -146,6 +146,8 @@ A presentation consists of a series of frames. Each frame consists of a series o
   \item
     \declare{|b|}, \declare{|c|}, \declare{|t|} will cause the frame to be vertically aligned at the bottom/center/top. This overrides the global placement policy, which is governed by the class options |t| and |c|.
   \item
+    \declare{|s|} will cause the content of the frame to be distributed vertically across the whole frame. For a reasonable usage of the option, the user has to add ``stretchable'' material to the frame content, e.g. |\vfill| or similar macros.
+  \item
     \declare{|noframenumbering|} tells \beamer\ not to step the |framenumber| counter for this frame.
   \item
     \declare{|fragile|\opt{|=singleslide|}} tells \beamer\ that the frame contents is ``fragile.'' This means that the frame contains text that is not ``interpreted as usual.'' For example, this applies to verbatim text, which is, obviously, interpreted somewhat differently from normal text.
@@ -293,7 +295,99 @@ Each frame consists of several components:
 \item some frame contents.
 \end{enumerate}
 
-A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using.
+A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using. 
+Figure \ref{fig:framelayers} shows an overview of the order in which the different components are drawn.
+
+\begin{figure}[htbp]
+% the following code is based on https://gist.githubusercontent.com/loopspace/c37dd788b217f2e963587278c3532f73/raw/f6e4708f36f661193ea7aed3cba7d389226658cc/beamerframe.tex
+\begin{tikzpicture}[z={(0.97,0)},x={(.55,.4)}]
+
+% colour palette generated by mycolor.space to match beamer's beamer@blendedblue
+\definecolor{fc_col1}{HTML}{3333b3}
+\definecolor{fc_col2}{HTML}{b1a3d9}
+\definecolor{fc_col3}{HTML}{fffade}
+\definecolor{fc_col4}{HTML}{68baa5}
+\definecolor{fc_col5}{HTML}{ae0000}
+
+\colorlet{base}{fc_col3}
+\colorlet{background canvas}{base}
+\colorlet{logo bg}{fc_col1}
+\colorlet{sidebar left}{fc_col4}
+\colorlet{sidebar right}{fc_col4}
+\colorlet{section in sidebar}{fc_col5}
+\colorlet{logo fg}{white}
+\colorlet{footline}{fc_col2}
+\colorlet{navigation symbols}{fc_col1}
+
+\pgfmathsetmacro{\bepgw}{12.8}
+\pgfmathsetmacro{\bepgh}{9.6}
+\newcommand{\component}[3][1]{%
+\path (#2) [draw,<-,thick] -- (#2 |- 0,-\bepgh-#1,0) node[below,text width=2cm,align=center] (#3) {#3};
+\stepcounter{zlayer}}
+\newcounter{zlayer}
+\setcounter{zlayer}{0}
+\def\zlayer{\the\value{zlayer}}
+
+\foreach \z in {0,...,10} {
+  \draw[gray,ultra thick] (0,-\bepgh,\z) -- (\bepgw,-\bepgh,\z) -- (\bepgw,0,\z);
+}
+
+% background canvas
+\fill[background canvas] (0,0,\zlayer) -- ++(\bepgw,0,0) -- ++(0,-\bepgh,0) -- ++(-\bepgw,0,0) -- cycle;
+\component[1]{1,-\bepgh,\zlayer}{background canvas}
+
+% background
+\draw[gray] \foreach \x in {0,...,\bepgw} \foreach \y in {0,...,\bepgh} {(\x,0,\zlayer) -- (\x,-\bepgh,\zlayer) (0,-\y,\zlayer) -- (\bepgw,-\y,\zlayer)};
+\component[2]{1,-\bepgh,\zlayer}{background}
+
+% left sidebar
+\fill[sidebar left] (0,0,\zlayer) -- ++(2,0,0) -- ++(0,-\bepgh,0) -- ++(-2,0,0) -- cycle;
+\component[3]{1,-\bepgh,\zlayer}{sidebar canvas left}
+
+% section in sidebar
+\node[yslant=.7,right,align=left,text=section in sidebar,font=\sffamily] at (0,-.45*\bepgh,\zlayer) (a section in sidebar) {First slide \\ Second slide \\ Third slide};
+\component[1]{1,-\bepgh,\zlayer}{section in sidebar}
+
+% right sidebar
+\fill[sidebar right] (\bepgw,0,\zlayer) -- ++(-2,0,0) -- ++(0,-\bepgh,0) -- ++(2,0,0) -- cycle;
+\component[2]{1,-\bepgh,\zlayer}{sidebar canvas right}
+
+% section in right sidebar
+\node[yslant=.7,left,align=right,text=section in sidebar,font=\sffamily] at (\bepgw,-.45*\bepgh,\zlayer) (a section in right sidebar) {First slide \\ Second slide \\ Third slide};
+\component[3]{1,-\bepgh,\zlayer}{section in right sidebar}
+
+%navigation
+\node[yslant=.7,above left,align=right,text=navigation symbols,font=\sffamily] at (\bepgw,-\bepgh,\zlayer) (navigation) {Navigation symbols};
+\component[1]{1,-\bepgh,\zlayer}{navigation symbols}
+
+% logo
+\fill[logo bg] (0,0,\zlayer) -- ++(2,0,0) -- ++(0,-2,0) -- ++(-2,0,0) -- cycle;
+\node[yslant=.7,text=logo fg,align=right,font=\sffamily] at (1,-1,\zlayer) {your\\ logo\\ here};
+\component[2]{1,-\bepgh,\zlayer}{logo}
+
+% headline
+\fill[footline] (0,0,\zlayer) -- ++(\bepgw,0,0) -- ++(0,-1,0) -- ++(-\bepgw,0,0) -- cycle;
+\node[yslant=.7,text=logo fg,align=left,font=\sffamily] at (1.5,-0.5,\zlayer) {Headline};
+\component[3]{1,-\bepgh,\zlayer}{headline}
+
+% content
+\node[yslant=.7,left,align=left,text=black,font=\sffamily] at (3,-.45*\bepgh,\zlayer) (a section in right sidebar) {Content};
+\component[1]{1,-\bepgh,\zlayer}{frame content}
+
+% footline
+\fill[footline] (0,-\bepgh,\zlayer) -- ++(\bepgw,0,0) -- ++(0,.5,0) -- ++(-\bepgw,0,0) -- cycle;
+\component[2]{1,-\bepgh,\zlayer}{footline}
+
+\addtocounter{zlayer}{-1}
+
+\foreach \z in {0,...,\zlayer} {
+  \draw[gray,ultra thick] (0,-\bepgh,\z) -- (0,0,\z) -- (\bepgw,0,\z);
+}
+
+\end{tikzpicture}
+\caption{Diagram of the order in which the different frame components are drawn (Image originally created by \href{https://tex.stackexchange.com/a/27302}{Andrew Stacey})}
+\label{fig:framelayers}
+\end{figure}
 
 \subsubsection{The Headline and Footline}
 
@@ -530,6 +624,8 @@ Adding a sidebar of a certain size, say 1\,cm, will make the main text 1\,cm nar
 
 Internally, the sidebars are typeset by showing them as part of the headline. The \beamer\ class keeps track of six dimensions, three for each side: the variables |\beamer@leftsidebar| and |\beamer@rightsidebar| store the (horizontal) sizes of the side bars, the variables |\beamer@leftmargin| and |\beamer@rightmargin| store the distance between sidebar and text, and the macros |\Gm@lmargin| and |\Gm@rmargin| store the distance from the edge of the paper to the edge of the text. Thus the sum |\beamer@leftsidebar| and |\beamer@leftmargin| is exactly |\Gm@lmargin|. Thus, if you wish to put some text right next to the left sidebar, you might write |\hskip-\beamer@leftmargin| to get there.
 
+For convenience, the width of the sidebar and the height of its headline are accessible through the macros |\beamersidebarwidth| and |\beamerheadheight|, respectively. 
+
 \begin{element}{sidebar left}\yes\yes\yes
   \colorfontparents{sidebar}
   The template is used to typeset the left sidebar. As mentioned above, the size of the left sidebar is set using the command
@@ -1152,6 +1248,17 @@ To change ``paper size'' and aspect ratio, you can use the following class optio
   Sets aspect ratio to 3:2, and frame size to 135\,mm by 90\,mm.
 \end{classoption}
 
+\begin{classoption}{aspectratio=xxxx}
+  Allows the user to set their own aspect ratio. For the height of the resulting frame, the default value of 96\,mm is used and the width will be calculated accordingly to match the desired aspect ratio.
+  
+  The custom aspect ratio allows for two to four digits and will be interpreted as shown in the following examples:
+  \begin{itemize}
+    \item two digits: |aspectratio=42| as 4:2
+    \item three digits: |aspectratio=137| as 13:7 (e.g. always in landscape format)
+    \item four digits: |aspectratio=1024| as 10:24
+  \end{itemize} 
+\end{classoption}
+
 Aside from using these options, you should refrain from changing the ``paper size.'' However, you \emph{can} change the size of the left and right margins, which default to 1\,cm. To change them, you should use the following command:
 
 \begin{command}{\setbeamersize\marg{options}}
@@ -1197,3 +1304,5 @@ You can also specify the number of slides in the frame ``by hand.'' To do so, yo
 This command will create a frame containing four slides. The first will contain the text ``This is slide number~1,'' the second ``This is slide number~2,'' the third ``This is slide number~4,'' and the fourth ``This is slide number~5.''
 
 A useful specification is just |<0>|, which causes the frame to have no slides at all. For example, |\begin{frame}<handout:0>| causes the frame to be suppressed in the handout version, but to be shown normally in all other versions. Another useful specification is |<beamer>|, which causes the frame to be shown normally in |beamer| mode, but to be suppressed in all other versions.
+
+Frames which are hidden with |<0>| behave like the |noframenumbering| option and will not be counted for the number of frames (this only applies if no mode is specified, e.g. not for |<all:0>|).