movie15 update (26jul06)

git-svn-id: svn://tug.org/texlive/trunk@1928 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 53 insertions, 4 deletions

diff --git a/Master/texmf-dist/doc/latex/movie15/movie15.pdf b/Master/texmf-dist/doc/latex/movie15/movie15.pdf
index 650f59c5676..ab049fb499a 100644
--- a/Master/texmf-dist/doc/latex/movie15/movie15.pdf
+++ b/Master/texmf-dist/doc/latex/movie15/movie15.pdf
diff --git a/Master/texmf-dist/doc/latex/movie15/movie15.tex b/Master/texmf-dist/doc/latex/movie15/movie15.tex
index 5a253ea8d75..20b5c3ab5ff 100644
--- a/Master/texmf-dist/doc/latex/movie15/movie15.tex
+++ b/Master/texmf-dist/doc/latex/movie15/movie15.tex
@@ -14,6 +14,7 @@
 \usepackage{graphicx}
 \usepackage{hyperref}
 \usepackage{textcomp}
+
 \pdfpagewidth595bp
 \pdfpageheight842bp
 \parindent0pt
@@ -51,6 +52,8 @@ This package provides an interface to embed movies, sounds and 3D objects into P
 
 The final PDF output can be viewed with Windows\textsuperscript{\scriptsize\textregistered} and Mac OS\textsuperscript{\scriptsize\textregistered} versions of Adobe Reader. However, embedded media file data can also be extracted and saved to disk from within Readers which support file attachments. This makes PDF documents a little more portable to Readers which do not ship with a multimedia plug-in.
 
+`movie15' works well together with the presentation making packages `Beamer' and `Powerdot'. In particular it supports their overlay concept. See this \href{./overlay-example.pdf}{example} which uses the `Beamer' class. Also read the comments in the example's source file, `\verb+overlay-example.tex+', on how to use `movie15' with presentation packages.
+
 \section{Installation}
 The file `movie15.sty' should be stored in a place where \LaTeX{} can find it.
 
@@ -69,7 +72,7 @@ If PDF is generated via DVI and Postscript by the usual \verb+latex+ $\rightarro
 
 In the case of pdf\LaTeX{}, the `graphicx' and `hyperref' packages are not required.
 
-Note that more than one run may be necessary to resolve internally created cross-references. Appropriate warnings will be issued in such cases.
+Note that several runs may be necessary to resolve internally created cross-references. Appropriate warnings will be issued in such cases.
 
 \section{Requirements}
 pdf\LaTeX{}, version $\ge1.20$, is needed for direct PDF output.
@@ -383,7 +386,7 @@ duration=<duration in seconds>s
 \end{verbatim}
 The duration of the media segment to be played. The trailing `\verb+s+' is mandatory. Note that `\verb+duration+' cannot be used together with option `\verb+startat+' from \verb+\includemovie+. In order to define a media segment options can be combined as follows: `\verb+startat+'/`\verb+endat+', `\verb+start+'/`\verb+endat+', `\verb+start+'/`\verb+duration+'.
 
-\newpage
+%\newpage
 \section{Examples}\label{examples}
 \begin{enumerate}
 \item A short circular MPEG movie, taken from \href{http://www.linux-video.net/Samples/}{\tt http://www.linux-video.net/} \href{http://www.linux-video.net/Samples/}{\tt Samples/}
@@ -409,6 +412,7 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
 \end{minipage}
 
 %\enlargethispage{15ex}\thispagestyle{empty}
+\newpage
 \item Another MPEG movie, loaded on the fly from \href{http://www.linux-video.net/Samples/}{\tt http://www.linux-video} \href{http://www.linux-video.net/Samples/}{\tt .net/Samples/}. Hence, a working Internet connection is required. This time, we force the QuickTime plug-in to be used instead of MediaPlayer (Windows boxes only). Well, the latter seems to be bugged. Quod erat expectandum.
 
 \begin{minipage}{0.5\linewidth}
@@ -434,13 +438,14 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
 \begin{minipage}{0.5\linewidth}
 \begin{center}
   \includemovie[poster, label=alien, text=(AlienSong.mpg), url, playerid=AAPL_QuickTime, repeat]{\linewidth}{.75\linewidth}{http://www.linux-video.net/Samples/Mpeg1/AlienSong.mpg}\\
+  %\includemovie[poster, label=alien, text=(AlienSong.mpg), playerid=AAPL_QuickTime, repeat]{\linewidth}{.75\linewidth}{AlienSong.mpg}\\
 \movieref[rate=0.5]{alien}{Slow}\hfill
 \movieref{alien}{Normal}\hfill
 \movieref[rate=2]{alien}{Fast}\hfill
 \movieref[pause]{alien}{Pause/Resume}\vspace{19 ex}
 \end{center}
 \end{minipage}
-\newpage
+
 \item\label{ex3d} Embedded U3D file. It is based on a VRML model by Peter Whitehouse \href{mailto:pwhitehouse@optusnet.com.au}{\tt <pwhitehouse@optusnet.com.au>}. Conversion to U3D has been made with DeepExploration\textsuperscript{\scriptsize\textregistered}\cite{dexp}. A file `{\tt dice.vws}' that provides additional views and a JavaScript `{\tt dice.js}' defining light sources have been associated with the 3D object.
 
 \begin{minipage}{0.5\linewidth}
@@ -480,7 +485,6 @@ The duration of the media segment to be played. The trailing `\verb+s+' is manda
     3Djscript=dice.js]{\linewidth}{\linewidth}{dice.u3d}
 \end{center}
 \movieref[3Dviewindex=N]{dice}{Click here} to cycle through the list of additional views. \movieref[3Dcalculate=60]{dice}{This link} calculates 3D option settings for a 60\textdegree{} aperture angle of the virtual camera.
-
 \end{minipage}
 
 \end{enumerate}
diff --git a/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf b/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf
new file mode 100644
index 00000000000..0eb32f511c4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf
diff --git a/Master/texmf-dist/doc/latex/movie15/overlay-example.tex b/Master/texmf-dist/doc/latex/movie15/overlay-example.tex
new file mode 100644
index 00000000000..5aa70abc012
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/movie15/overlay-example.tex
@@ -0,0 +1,45 @@
+% Copyright 2006 Alexander Grahn
+%
+% This material is subject to the LaTeX Project Public License. See
+%    http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
+% for the details of that license.
+%
+\documentclass{beamer}
+\setbeamertemplate{navigation symbols}{}
+\usepackage{movie15}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Some hints on using movie15 with /presentation/ packages
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% 1. Options `autopause' and `autoresume' should be set, as this prevents the
+%    movie from being rewound when passing from one overlay to the next.
+
+% 2. Within presentations, \movieref's must be put on the /same/ overlay as
+%    their target.
+
+% 3. If the /same/ media file is to be inserted at multiple locations within a
+%    presentation, all instances must be given unique labels using the `label'
+%    option, even if no \movieref's are associated with the included media.
+
+\begin{document}
+\begin{frame}
+  \begin{itemize}
+    \item<+-> 1st overlay
+    \item<+-> 2nd overlay
+      \begin{center}
+      \includemovie[
+        poster,
+        autopause, autoresume,
+        text=(AlienSong.mpg),
+        playerid=AAPL_QuickTime,
+        url
+      ]{0.5\linewidth}{0.375\linewidth}{%
+        http://www.linux-video.net/Samples/Mpeg1/AlienSong.mpg%
+      }
+      \end{center}
+    \item<+-> 3rd overlay
+    \item<+-> 4th overlay
+  \end{itemize}
+\end{frame}
+\end{document}