summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/media9/media9.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/media9/media9.tex')
-rw-r--r--Master/texmf-dist/doc/latex/media9/media9.tex59
1 files changed, 29 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/latex/media9/media9.tex b/Master/texmf-dist/doc/latex/media9/media9.tex
index c4e999d836f..e6187eee6dd 100644
--- a/Master/texmf-dist/doc/latex/media9/media9.tex
+++ b/Master/texmf-dist/doc/latex/media9/media9.tex
@@ -148,6 +148,7 @@ xetex
bigfiles
draft
final
+noplaybutton
activate=...
deactivate=...
windowed=...
@@ -249,6 +250,10 @@ final
\end{verbatim}
With `\verb+draft+' the media is not embedded. Instead, a box is inserted that has the dimensions of \verb+<poster text>+, subject to the resizing options `\verb+width+', `\verb+height+', `\verb+depth+' and `\verb+scale+'. Option `\verb+final+' does the opposite as it forces the media to be embedded. Both options can be used to reduce compilation time during authoring of a document. To get the most out of them it is recommended to set `\verb+draft+' globally as a package or class option and to set `\verb+final+' locally as a command option of the media annotation that is currently worked on. After the document has been finished, the global `\verb+draft+' option can be removed.
\begin{verbatim}
+ noplaybutton
+\end{verbatim}
+Disables the transparent play button normally laid over the inactive media annotation.
+\begin{verbatim}
windowed[= false | [<width>x<height>][@<position>] ]
\end{verbatim}
The media is played in a floating window, instead of being played in an embedded fashion. The floating window size is specified via the optional argument \verb+<width>x<height>+, where \verb+<width>+ and \verb+<height>+ are given in pixels (integer numbers without unit). If the size is not given, a default size is guessed from the annotation size. Optionally, the position of the floating window on the screen can be specified through \verb+@<position>+, where \verb+<position>+ may assume one of `\verb+tl+', `\verb+cl+', `\verb+bl+', `\verb+bc+', `\verb+br+', `\verb+cr+', `\verb+tr+', `\verb+tc+' or `\verb+cc+'. The position specifiers have the following meaning:\quad{\fboxsep=1pt\fbox{\vtop{\hbox{\ttfamily\fbox{\rule{0pt}{1.5ex}tl} \fbox{\rule{0pt}{1.5ex}tc} \fbox{\rule{0pt}{1.5ex}tr}} \hbox{\ttfamily\fbox{\rule{0pt}{1.5ex}cl} \fbox{\rule{0pt}{1.5ex}cc} \fbox{\rule{0pt}{1.5ex}cr}} \hbox{\ttfamily\fbox{\rule{0pt}{1.5ex}bl} \fbox{\rule{0pt}{1.5ex}bc} \fbox{\rule{0pt}{1.5ex}br}}}}}\\[0.5ex]
@@ -622,11 +627,11 @@ parameter & description\\\hline\hline
\begin{Verbatim}
\includemedia[
label=some_dice,
- width=0.4\linewidth,height=0.3\linewidth,
- activate=pageopen,
+ width=0.6\linewidth,height=0.45\linewidth,
addresource=random.mp4, %two video files
addresource=cube.mp4,
- transparent,
+ transparent, %transparent player background
+ activate=pageopen,
flashvars={
source=random.mp4
&loop=true % loop video
@@ -650,14 +655,14 @@ parameter & description\\\hline\hline
\makebox[\linewidth]{\hfill\includemedia[
label=some_dice,
width=0.6\linewidth,height=0.45\linewidth,
- activate=pageopen,
- addresource=random.mp4,
+ addresource=random.mp4, %two video files
addresource=cube.mp4,
- transparent,
+ transparent, %transparent player background
+ activate=pageopen,
flashvars={
source=random.mp4
- &loop=true
- &scaleMode=letterbox
+ &loop=true % loop video
+ &scaleMode=letterbox % preserve aspect ratio while scaling the video
}
]{}{VPlayer.swf}\hfill}
\makebox[\linewidth]{\hfill%
@@ -770,30 +775,26 @@ http://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/latex/contrib/media9/players/
\centering
\begin{Verbatim}
\includemedia[
- width=0.4\linewidth,height=0.3\linewidth,
- activate=pageopen,
+ %activate=onclick, % default
addresource=cube.mp4,
- transparent,
flashvars={
source=cube.mp4
+ &autoPlay=true % start playing on activation
&loop=true
- &scaleMode=letterbox
}
-]{}{VPlayer9.swf}
+]{\includegraphics[height=0.45\linewidth]{cubeposter}}{VPlayer9.swf}
\end{Verbatim}
\vspace{1ex}
\hfill\includemedia[
- width=0.6\linewidth,height=0.45\linewidth,
- activate=pageopen,
+ activate=onclick, %default
addresource=cube.mp4,
- transparent,
flashvars={
- source=cube.mp4
- &loop=true
- &scaleMode=letterbox
+ source=cube.mp4
+ &autoPlay=true %start playing on activation
+ &loop=true
}
-]{}{VPlayer9.swf}\hfill
-\vspace{1ex}
+]{\includegraphics[height=0.45\linewidth]{cubeposter}}{VPlayer9.swf}\hfill
+\vspace{2ex}
\begin{Verbatim}
\includemedia[
addresource=bird.mp3,
@@ -814,7 +815,7 @@ http://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/latex/contrib/media9/players/
transparent
]{\color{blue}\framebox[0.5\linewidth][c]{Singing bird}}{APlayer9.swf}\hfill
\vspace{2ex}
-\caption{Video and sound examples that should run in Adobe Reader for Linux up to version \href{ftp://ftp.adobe.com/pub/adobe/reader/unix/9.x/9.4.1/}{9.4.1}. Here, players `VPlayer9.swf' and `APlayer9.swf' are used. Both are compatible with Adobe Flash Player 9 plugin that is bundled with the Reader.}\label{ar941ex}
+\caption{Video and sound examples that should run in Adobe Reader for Linux up to version \href{ftp://ftp.adobe.com/pub/adobe/reader/unix/9.x/9.4.1/}{9.4.1}. Here, players `VPlayer9.swf' and `APlayer9.swf' are used. Both are compatible with Adobe Flash Player 9 plugin that is bundled with the Reader. Also, the video player needs to be activated by mouse click (which is the default). We provide a poster image that is shown in the inactive state.}\label{ar941ex}
\end{figure}
\clearpage
@@ -846,30 +847,28 @@ Below, several examples of embedded 3D files are shown. The first one, Fig.~\ref
\begin{Verbatim}
\includemedia[
width=0.8\linewidth,height=0.8\linewidth,
- activate=pageopen,
add3Djscript=asylabels.js, %upright text labels
add3Djscript=3Dspintool.js, %let scene rotate about z-axis
% 3Dcoo, 3Droo values found with `Generate Default View' from
% context menu
3Dmenu,
3Dc2c=4 2 3,
- 3Dcoo=6.01792049407959 12.437679290771484 0.18967819213867188,
- 3Droo=479.9268773794643,
-]{}{epix.prc}
+ 3Dcoo=4.413303375244141 2.195653200149536 -0.000011444091796875,
+ 3Droo=429.49035778293376,
+]{\includegraphics{epixposter}}{epix.prc}
\end{Verbatim}
\vspace{1ex}
\includemedia[
width=0.8\linewidth,height=0.8\linewidth,
- activate=pageopen,
add3Djscript=asylabels.js, %upright text labels
add3Djscript=3Dspintool.js, %let scene rotate about z-axis
% 3Dcoo, 3Droo values found with `Generate Default View' from
% context menu
3Dmenu,
3Dc2c=4 2 3,
- 3Dcoo=6.01792049407959 12.437679290771484 0.18967819213867188,
- 3Droo=479.9268773794643,
-]{}{epix.prc}
+ 3Dcoo=4.413303375244141 2.195653200149536 -0.000011444091796875,
+ 3Droo=429.49035778293376,
+]{\includegraphics{epixposter}}{epix.prc}
\caption{Embedded PRC file produced with Asymptote, making use of convenience 3D JavaScripts `asylabels.js' and `3Dspintool.js' mentioned
{\leavevmode\pdfstartlink attr{/Border[0 0 1]/C[0 0 1]/H/I}user{/Subtype/Link/A<</D(3dscripts)/S/GoTo>>}above\pdfendlink}.}\label{asyex}
\end{figure}