diff options
author | Karl Berry <karl@freefriends.org> | 2014-09-18 22:55:40 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-09-18 22:55:40 +0000 |
commit | ef7bdbe006ddc82d3fdaadc3b96f366063a88901 (patch) | |
tree | 654b93839e73295c8485ebf6409cbfd2881d321c | |
parent | 72a3407f1f7f62a992b22e01e21ee984c3a45327 (diff) |
dynblocks (18sep14)
git-svn-id: svn://tug.org/texlive/trunk@35193 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r-- | Master/texmf-dist/doc/latex/dynblocks/README | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf | bin | 279514 -> 280192 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex | 29 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty | 26 |
4 files changed, 30 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/latex/dynblocks/README b/Master/texmf-dist/doc/latex/dynblocks/README index 9303f961104..76058cc6c00 100644 --- a/Master/texmf-dist/doc/latex/dynblocks/README +++ b/Master/texmf-dist/doc/latex/dynblocks/README @@ -1,9 +1,9 @@ % * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * % Dynblocks package % -% Copyright (C) 2012 Claudio Fiandrino +% Copyright (C) 2012-2014 Claudio Fiandrino % -% v0.2a - 2012/27/09 +% v0.2b - 2014/18/09 % % * A simple way to create dynamic blocks * % diff --git a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf Binary files differindex a78a438d264..b0931fd5558 100644 --- a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf +++ b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.pdf diff --git a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex index 3aaf5fcdf7a..cff9e74b38b 100644 --- a/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex +++ b/Master/texmf-dist/doc/latex/dynblocks/dynblocks.tex @@ -43,8 +43,8 @@ \renewcommand\labelitemii{\color{DodgerBlue1!60}$\circ$} \newcommand{\name}{\textsf{dynblocks}} -\newcommand{\version}{0.2a} -\newcommand{\versiondate}{27/09/2012} +\newcommand{\version}{0.2b} +\newcommand{\versiondate}{187/09/2014} \author{Claudio Fiandrino \\ \footnotesize{\href{mailto:claudio.fiandrino@gmail.com}{claudio.fiandrino@gmail.com}}} \title{The \name{} package \footnote{This package has version number \textit{v}\version{} of \versiondate{}; it is released under and subject to the \href{http://www.latex-project.org/lppl/}{\LaTeX\ Project Public License (LPPL)}.}} @@ -54,13 +54,13 @@ \begin{abstract} The \name{} package allows to fully customize blocks aspect and dimension inside a presentation. -The original idea for this package came from \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer}{this question} in \href{http://tex.stackexchange.com/}{TeX.SE} and the core of the package is based on \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer/53797#53797}{this answer}. +The package originated from \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer}{this question} in \href{http://tex.stackexchange.com/}{TeX.SE}. The core functionalities of the package are based on \href{http://tex.stackexchange.com/questions/53784/overlay-images-and-block-in-beamer/53797#53797}{this answer}. \end{abstract} \tableofcontents \section{Introduction} -The purpose of the package is to have an instrument to customize several aspects of blocks (here called \emph{dynblocks}): +The purpose of the package is to provide an instrument to customize several aspects of blocks (here called \emph{dynblocks}): \begin{itemize} \item the width; \item the color @@ -74,7 +74,7 @@ The purpose of the package is to have an instrument to customize several aspects \item opacity \end{itemize} \end{itemize} -Notice that \emph{dynblocks} defined by \name{} differ mainly from usual beamer's blocks because no title is given. +Notice that \emph{dynblocks} defined by \name{} differ from usual beamer's blocks because no title is given. The package has the following requirements: \begin{itemize} @@ -83,6 +83,8 @@ The package has the following requirements: \item \textsf{xparse}. \end{itemize} +I would like to thank Enrico Gregorio for having pointed out an issue after the release of Ti\textit{k}Z 3.0.0 and \textsf{xparse} version 2014/08/25. + \section{Usage} To load the package use as usual: \cs{usepackage}\mbarg{options}\mcmd{dynblocks}. @@ -101,7 +103,7 @@ thanks to the command \cs{opaqueblock}\sarg{overlay spec}\mbarg{width}\marg{text \item multiple numbers separated by commas and delimited by braces: \texttt{<\{1,2,3\}>}; \item a single number followed by a dash: \texttt{<1->}. \end{itemize} -Moreover, it is also possible to make it \emph{invisible} forcing colors to become \texttt{gray} by means of \cs{invblock}\sarg{overlay spec}. For example, the following code, generates the two frames shown in figures \ref{fig:basic1} and \ref{fig:basic2}. +Moreover, it is also possible to make it \emph{invisible}, that is to force colors to become \texttt{gray} by means of \cs{invblock}\sarg{overlay spec}. For example, the following code, generates the two frames shown in figures \ref{fig:basic1} and \ref{fig:basic2}. \medskip \begin{lstlisting}[frame=lines] \documentclass{beamer} @@ -149,7 +151,7 @@ Moreover, it is also possible to make it \emph{invisible} forcing colors to beco \caption{The basic example} \end{figure} -In this example, it is possible to notice that the second \cs{opaqueblock} has not \texttt{width} specified; the default value is \cs{textwidth}, but if the block is placed inside a \emph{column} environment it inherits the \texttt{width} given there. To set different values of \texttt{width}, it is necessary to specify the optional argument as did for the first \cs{opaqueblock} of the example. +In this example, it is possible to notice that the second \cs{opaqueblock} has no specified \texttt{width}; the default value is \cs{textwidth}, but if the block is placed inside a \emph{column} environment it automatically inherits the \texttt{width} given there. To set different values of \texttt{width}, it is necessary to specify the optional argument as did for the first \cs{opaqueblock} of the example. The presence of an \cs{invblock} makes the first \cs{opaqueblock} invisible; this command needs to be placed immediately after an \cs{opaqueblock} because of two facts: \begin{itemize} @@ -157,10 +159,10 @@ The presence of an \cs{invblock} makes the first \cs{opaqueblock} invisible; thi \item it automatically shows the text of the previous \cs{opaqueblock}. \end{itemize} -Finally, both \cs{opaqueblock} and \cs{invblock} needs to be placed inside a \texttt{dynblock} environment. +Finally, both \cs{opaqueblock} and \cs{invblock} need to be placed inside a \texttt{dynblock} environment. \subsection{Change text alignment} -Thanks to the command \cs{setalignment}\marg{text spec} the text alignment changes according to the \meta{text spec} (for all possibilities please refer to the pgfmanual section 16.4.3 - version October 25, 2010). +Thanks to the command \cs{setalignment}\marg{text spec} the text alignment changes according to the \meta{text spec} (for all possibilities please refer to the pgfmanual section 17.4.3 - version December 20, 2013). Suppose, for instance, to modify the previous example in order to display the second block with center aligned text. The only change to do is: \medskip @@ -180,7 +182,7 @@ and this will lead to figure \ref{fig:align}. \label{fig:align}% \end{figure} -Notice that alignments can be local or global: if there is a definition in the preamble, perfectly admissible, all \emph{dynblocks} will be set according to this definition. Whereas the definition is set inside a group, the \emph{columns} environment or simply the \emph{dynblock} environment, it affects just local \emph{dynblocks}. It is even possible set a global definition and then change things locally. +Notice that the alignments can be local or global: if there is a definition in the preamble (global), all the \emph{dynblocks} will be set according to this definition. When the definition is set inside a group (a \emph{columns} environment or even simpler, the \emph{dynblock} environment), it affects only locally the \emph{dynblocks}. It is even possible set a global definition and then make local changes. \subsection{Text opacity and word alert} By default: @@ -195,7 +197,7 @@ To change these values two commands have been introduced: \end{itemize} where \meta{opacity spec} is a value in the interval $[0 \, , \, 1]$. Also these commands can be set locally or in a global fashion in the preamble. -Due to the opacity the usual \cs{alert} command is not more useful with \cs{invblock}s. The package provides a method to alert a word even in this case; the command to be used is \cs{dynalert}\sarg{overlay spec}\marg{text}; notice that through the proper usage of \meta{overlay spec}, \cs{dynalert} must not fall inside a \cs{opaqueblock}. This is a limitation, but the purpose for which it has been developed is different. +Due to the opacity, the usual \cs{alert} command is not more useful with \cs{invblock}s. The package provides a method to alert a word even in this case. The command to be used is \cs{dynalert}\sarg{overlay spec}\marg{text}. Note that with the proper usage of \meta{overlay spec}, \cs{dynalert} must not fall inside a \cs{opaqueblock}. This is a limitation because the purpose for which it has been developed is different. Assume, for example, to modify the reference example such that the opacity of \cs{invblock} will be set to $0.1$; furthermore, for the first block, the word ``\emph{itemize}'' will be alerted with \cs{alert}, while ``\emph{dynamic block}'' with \cs{dynalert} and for the second block (that does not have the correspondent \cs{invblock}) it is shown what happens with a wrong usage of \cs{dynalert}. The code is: \medskip @@ -585,7 +587,7 @@ with the final output shown in figure \ref{fig:estl}. \label{fig:estl}% \end{figure} -The decision of adopting the \emph{structure} as reference is due to the fact that this parameter assume an high relevance when customizing a theme. In the following example, it is shown a color customization of the Szeged theme and a particular effect that can be realized thanks to multiple \emph{dynblocks} inside the same \texttt{dynblock} environment: +The decision of adopting \emph{structure} as reference is due to the fact that this parameter is one of the most relevant while customizing a Beamer theme. In the following example, it is shown a color customization of the Szeged theme and a particular effect that can be realized thanks to multiple \emph{dynblocks} inside the same \texttt{dynblock} environment: \begin{lstlisting}[frame=lines] \documentclass{beamer} \usepackage[getthemecolors,roundedcorners,shadow]{dynblocks} @@ -630,8 +632,7 @@ The two frames obtained as outcome are shown in figures \ref{fig:szeg1} and \ref \caption{Example of a customized theme} \end{figure} - -Notice that the \texttt{getthemecolors} option has some drawbacks when used with particular Beamer color themes like: +Note that the \texttt{getthemecolors} option has some drawbacks when it is used with particular Beamer color themes like: \begin{itemize} \item albatross; \item beetle. diff --git a/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty b/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty index 361f1eee573..fbe3d929b64 100644 --- a/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty +++ b/Master/texmf-dist/tex/latex/dynblocks/dynblocks.sty @@ -1,5 +1,5 @@ % * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -% Copyright 2012 Claudio Fiandrino +% Copyright 2012-2014 Claudio Fiandrino % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 @@ -14,7 +14,7 @@ % The Current Maintainer of this work is Claudio Fiandrino. \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{dynblocks}[2012/27/09 v0.2a A simple way to create dynamic blocks.] +\ProvidesPackage{dynblocks}[2014/18/09 v0.2b A simple way to create dynamic blocks.] \RequirePackage{tikz} \RequirePackage{etoolbox} \RequirePackage{xparse} @@ -157,9 +157,9 @@ \setlength{\intdimension}{\z@} \addtolength{\intdimension}{#2} \ifbool{shadowed}{% true -\node[visib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup}; +\node[visib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup}; }{% false -\node[visib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup}; +\node[visib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup}; } \savetext{mytext}{#3} } @@ -168,9 +168,9 @@ \setlength{\intdimension}{\z@} \addtolength{\intdimension}{#2} \ifbool{shadowed}{% true -\node[fancyvisib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup}; +\node[fancyvisib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup}; }{% false -\node[fancyvisib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup}; +\node[fancyvisib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup}; } \savetext{mytext}{#3} } @@ -179,9 +179,9 @@ \setlength{\intdimension}{\z@} \addtolength{\intdimension}{#2} \ifbool{shadowed}{% true -\node[vshadevisib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup}; +\node[vshadevisib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup}; }{% false -\node[vshadevisib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup}; +\node[vshadevisib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup}; } \savetext{mytext}{#3} } @@ -190,21 +190,21 @@ \setlength{\intdimension}{\z@} \addtolength{\intdimension}{#2} \ifbool{shadowed}{% true -\node[oshadevisib=#2,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\begingroup #3 \endgroup}; +\node[oshadevisib=#2,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\begingroup #3 \endgroup}; }{% false -\node[oshadevisib=#2,dynvisible on=<#1>] (X) {\begingroup #3 \endgroup}; +\node[oshadevisib=#2,dynvisible on=<{#1}>] (X) {\begingroup #3 \endgroup}; } \savetext{mytext}{#3} } \NewDocumentCommand{\invblock}{r<>}{% \ifbool{shadowed}{% true -\node[invisib=\intdimension,dynvisible on=<#1>,drop shadow={opacity=\@shadowopacity,dynvisible on=<#1>}] (X) {\printthistext{\thethistext}}; +\node[invisib=\intdimension,dynvisible on=<{#1}>,drop shadow={opacity=\@shadowopacity,dynvisible on=<{#1}>}] (X) {\printthistext{\thethistext}}; }{% false -\node[invisib=\intdimension,dynvisible on=<#1>] (X) {\printthistext{\thethistext}}; +\node[invisib=\intdimension,dynvisible on=<{#1}>] (X) {\printthistext{\thethistext}}; } } -\NewDocumentCommand{\dynalert}{r<> m}{\alt<#1>{\pgfsetfillopacity{1}\myalert{#2}\pgfsetfillopacity{\@invopacity}}{#2}} +\NewDocumentCommand{\dynalert}{r<> m}{\alt<{#1}>{\pgfsetfillopacity{1}\myalert{#2}\pgfsetfillopacity{\@invopacity}}{#2}} \endinput |