install media9

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

14 files changed, 1318 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/media9/ChangeLog b/Master/texmf-dist/doc/latex/media9/ChangeLog
new file mode 100644
index 00000000000..8c71cf9651d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/ChangeLog
@@ -0,0 +1,8 @@
+2012-03-15
+	* v0.2
+	* new: LuaLaTeX support
+	* fix: wrong poster dimension in dvi output; fp numbers in PDF objects had
+	too many decimal places for dvipdfmx
+
+2012-03-01
+	* initial release (v0.1) to CTAN
diff --git a/Master/texmf-dist/doc/latex/media9/README b/Master/texmf-dist/doc/latex/media9/README
new file mode 100644
index 00000000000..6d6ee2b48d9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/README
@@ -0,0 +1,84 @@
+                             ==========================
+                              The media9 LaTeX Package
+                             ==========================
+
+
+Author:
+
+Alexander Grahn
+
+
+Description:
+
+This package provides an interface to embed interactive Flash (SWF)
+and 3D objects (Adobe U3D & PRC) as well as video and sound files or
+streams in the popular MP4, FLV and MP3 formats into PDF documents
+with Acrobat-9/X compatibility. Playback of multimedia files uses the
+built-in Flash Player of Adobe Reader and does, therefore, not depend
+on external plug-ins. Flash Player supports the efficient H.264 codec
+for video compression.
+
+This package is based on the RichMedia Annotation, an Adobe addition to
+the PDF specification. It replaces the now obsolete `movie15' package.
+
+*
+* Note that Adobe Reader for Linux has dropped Flash support since
+* version 9.4.2.
+*
+
+Supported PDF making workflows are:
+  *  pdfLaTeX, LuaLaTeX
+  *  (Lua)LaTeX --> dvips --> ps2pdf/Distiller
+  *  (Xe)LaTeX --> (x)dvipdfmx
+
+The package was written in the new LaTeX3 syntax.
+
+
+Requirements:
+
+  *  l3kernel (LaTeX package), version >=2011/06/19
+  *  l3packages (LaTeX package), version >=2011/07/02
+  *  pdfTeX, version >=1.30
+  *  Ghostscript, version >=8.31 or Adobe Distiller for PS to PDF conversion
+  *  dvipdfmx, version >=20080607 for DVI to PDF conversion
+  *  Adobe Reader, version >=9
+
+
+Installation:
+
+MiKTeX users should run the package manager for installation.
+
+Unfortunately, `media9' is not in TeXLive. It must be installed manually
+into the local TeX-Directory-Structure (TDS) root directory along the
+following steps:
+
+1.) Download the TDS compliant package file
+http://tug.ctan.org/tex-archive/install/macros/latex/contrib/media9.tds.zip.
+
+2.) Find the local TDS root directory which is intended for packages
+that are not maintained by the TeXLive package manager by running
+
+  kpsewhich -var-value TEXMFLOCAL
+
+on the command line.
+
+3.) Unzip media9.tds.zip into the local TDS root directory previously
+found. Depending on the location of this directory, you may need to be
+logged in as Root/Administrator.
+
+4.) After installation, update the filename database by running
+
+  texhash
+
+on the command line. Again, Root/Administrator privileges may be required.
+
+For updating the package, repeat the steps given above.
+
+
+License:
+
+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.
diff --git a/Master/texmf-dist/doc/latex/media9/files/3dsystem.fig b/Master/texmf-dist/doc/latex/media9/files/3dsystem.fig
new file mode 100644
index 00000000000..e2273139db8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/3dsystem.fig
@@ -0,0 +1,273 @@
+#FIG 3.2
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+0 32 #9c0000
+0 33 #8c8c8c
+0 34 #8c8c8c
+0 35 #424242
+0 36 #8c8c8c
+0 37 #424242
+0 38 #8c8c8c
+0 39 #424242
+0 40 #8c8c8c
+0 41 #424242
+0 42 #8c8c8c
+0 43 #424242
+0 44 #e2e2ee
+0 45 #94949a
+0 46 #dbdbdb
+0 47 #a1a1b7
+0 48 #ededed
+0 49 #e0e0e0
+0 50 #86acff
+0 51 #7070ff
+0 52 #c6b797
+0 53 #eff8ff
+0 54 #dccba6
+0 55 #404040
+0 56 #808080
+0 57 #c0c0c0
+0 58 #8e8f8e
+0 59 #aaaaaa
+0 60 #555555
+0 61 #8e8e8e
+0 62 #d7d7d7
+0 63 #aeaeae
+0 64 #bebebe
+0 65 #515151
+0 66 #e7e3e7
+0 67 #000049
+0 68 #797979
+0 69 #303430
+0 70 #414141
+0 71 #c7b696
+0 72 #414541
+0 73 #e7e7e7
+0 74 #717571
+0 75 #dd9d93
+0 76 #f1ece0
+0 77 #c3c3c3
+0 78 #e2c8a8
+0 79 #e1e1e1
+0 80 #d2d2d2
+0 81 #da7a1a
+0 82 #f1e41a
+0 83 #887dc2
+0 84 #d6d6d6
+0 85 #8c8ca5
+0 86 #4a4a4a
+0 87 #8c6b6b
+0 88 #5a5a5a
+0 89 #636363
+0 90 #b79b73
+0 91 #4193ff
+0 92 #bf703b
+0 93 #db7700
+0 94 #dab800
+0 95 #006400
+0 96 #5a6b3b
+0 97 #d3d3d3
+0 98 #8e8ea4
+0 99 #f3b95d
+0 100 #89996b
+0 101 #646464
+0 102 #b7e6ff
+0 103 #86c0ec
+0 104 #bdbdbd
+0 105 #d39552
+0 106 #98d2fe
+0 107 #8c9c6b
+0 108 #f76b00
+0 109 #5a6b39
+0 110 #8c9c6b
+0 111 #8c9c7b
+0 112 #184a18
+0 113 #adadad
+0 114 #f7bd5a
+0 115 #636b9c
+0 116 #f7f7f7
+0 117 #de0000
+0 118 #adadad
+0 119 #f7bd5a
+0 120 #adadad
+0 121 #f7bd5a
+0 122 #636b9c
+0 123 #526b29
+0 124 #949494
+0 125 #006300
+0 126 #00634a
+0 127 #7b844a
+0 128 #e7bd7b
+0 129 #a5b5c6
+0 130 #6b6b94
+0 131 #846b6b
+0 132 #529c4a
+0 133 #d6e7e7
+0 134 #526363
+0 135 #186b4a
+0 136 #9ca5b5
+0 137 #ff9400
+0 138 #ff9400
+0 139 #00634a
+0 140 #7b844a
+0 141 #63737b
+0 142 #e7bd7b
+0 143 #184a18
+0 144 #f7bd5a
+0 145 #dedede
+0 146 #f3eed3
+0 147 #f5ae5d
+0 148 #95ce99
+0 149 #b5157d
+0 150 #eeeeee
+0 151 #848484
+0 152 #7b7b7b
+0 153 #005a00
+0 154 #e77373
+0 155 #ffcb31
+0 156 #29794a
+0 157 #de2821
+0 158 #2159c6
+0 159 #f8f8f8
+0 160 #e6e6e6
+0 161 #21845a
+0 162 #cccccc
+0 163 #999999
+0 164 #b2b2b2
+0 165 #c9c9c9
+0 166 #dfd8df
+0 167 #f7f3f7
+0 168 #cdcdcd
+0 169 #6c6c6c
+5 1 0 1 0 7 45 -1 -1 0.000 0 0 1 1 1543.224 2237.643 2833 2393 2598 2996 2143 3390
+	2 0 1.00 60.00 120.00
+	2 0 1.00 60.00 120.00
+5 1 2 1 0 7 52 -1 -1 4.000 1 0 1 1 11576.552 9623.869 442 3442 1349 2035 2462 729
+	0 0 1.00 60.00 120.00
+	0 0 1.00 60.00 120.00
+5 1 2 1 0 7 52 -1 -1 4.000 1 1 1 1 7430.119 -1873.223 802 1109 1315 2055 2088 3055
+	0 0 1.00 60.00 120.00
+	0 0 1.00 60.00 120.00
+6 4753 4744 6037 5510
+5 1 0 1 0 7 100 -1 -1 0.000 0 0 0 0 5712.721 5265.408 5756 4952 5978 5093 6024 5322
+5 1 2 1 0 7 100 -1 -1 2.000 1 0 0 0 5442.537 5285.331 4944 5096 5258 4785 5692 4814
+5 1 2 1 0 7 100 -1 -1 2.000 1 1 0 0 5841.704 5281.825 5968 5335 5808 5149 5709 5316
+5 1 2 1 0 7 100 -1 -1 2.000 1 0 0 0 5122.611 5132.487 4986 5129 5207 5025 5230 5217
+5 1 0 1 0 7 98 -1 -1 0.000 1 0 0 0 5468.833 4766.333 5072 5236 5056 5222 5039 5206
+5 1 0 1 0 7 98 -1 -1 0.000 1 1 0 0 5071.511 5140.272 5011 5132 5012 5154 5026 5181
+5 1 0 1 0 7 98 -1 -1 0.000 1 0 0 0 5945.000 5164.000 5794 5382 5778 5370 5760 5354
+5 1 0 1 0 7 50 -1 -1 0.000 1 1 0 0 5659.846 5403.315 5786 5455 5627 5271 5528 5438
+5 1 0 1 0 7 50 -1 -1 0.000 0 0 0 0 5260.632 5406.447 4760 5215 5074 4904 5510 4932
+5 1 0 1 0 7 50 -1 -1 0.000 0 0 0 0 5529.852 5383.891 5574 5071 5795 5212 5841 5439
+5 1 0 1 0 7 50 -1 -1 0.000 1 0 0 0 4941.237 5252.972 4804 5250 5026 5145 5049 5338
+5 1 0 1 0 7 98 -1 -1 0.000 1 0 0 0 5442.380 5294.428 5068 4904 5255 4787 5689 4813
+5 1 0 1 0 7 98 -1 -1 0.000 1 1 0 0 5789.373 5293.415 5732 5285 5733 5307 5747 5333
+5 1 0 1 0 7 98 -1 -1 0.000 1 1 0 0 5825.000 5279.500 5704 5271 5704 5288 5706 5303
+1 3 2 1 0 7 100 -1 -1 2.000 1 6.0772 5123 5130 111 111 5123 5130 5234 5130
+1 3 2 1 0 7 100 -1 -1 2.000 1 6.0772 5844 5281 111 111 5844 5281 5955 5281
+1 3 0 1 0 7 50 -1 -1 0.000 1 6.0772 4940 5254 111 111 4940 5254 5050 5274
+1 3 0 1 0 7 50 -1 -1 0.000 1 6.0772 5662 5402 111 111 5662 5402 5703 5507
+2 1 0 1 0 7 100 -1 -1 0.000 0 0 -1 0 0 2
+	 5692 4814 5756 4952
+2 1 2 1 0 7 100 -1 -1 2.000 0 1 -1 0 0 2
+	 6024 5320 5968 5335
+2 1 2 1 0 7 100 -1 -1 2.000 0 1 -1 0 0 2
+	 4941 5094 4986 5129
+2 1 2 1 0 7 100 -1 -1 2.000 0 1 -1 0 0 2
+	 4761 5215 4944 5096
+2 1 2 1 0 7 98 -1 -1 2.000 0 1 -1 0 0 2
+	 5049 5338 5228 5220
+2 1 2 1 0 7 98 -1 -1 2.000 0 1 -1 0 0 2
+	 5528 5438 5709 5319
+2 1 2 1 0 7 98 -1 -1 2.000 0 1 -1 0 0 2
+	 4806 5250 4989 5131
+2 1 2 1 0 7 98 -1 -1 2.000 0 1 -1 0 0 2
+	 5786 5454 5968 5336
+2 1 0 1 0 7 98 -1 -1 0.000 0 1 -1 0 0 2
+	 4953 5157 4992 5131
+2 1 0 1 0 7 80 -1 -1 0.000 0 0 -1 0 0 2
+	 4971 4954 5153 4835
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 4804 5251 4842 5227
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 4760 5215 4804 5250
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5049 5338 5528 5438
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5841 5439 5786 5455
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5510 4932 5574 5071
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5528 5438 5565 5413
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5841 5439 6023 5322
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5755 4952 5574 5071
+2 1 0 1 0 7 50 -1 -1 0.000 0 1 -1 0 0 2
+	 5690 4814 5510 4932
+2 1 2 1 0 7 100 -1 -1 2.000 0 1 -1 0 0 2
+	 5228 5217 5708 5316
+-6
+6 1009 1590 1714 2595
+6 1399 1782 1714 2435
+5 1 0 0 0 7 55 -1 2 0.000 0 0 0 0 1438.929 2167.804 1604 1949 1708 2220 1500 2435
+2 3 0 0 7 7 55 -1 2 0.000 1 0 -1 0 0 6
+	 1399 1782 1604 1948 1501 2435 1462 2428 1460 1899 1399 1782
+-6
+2 3 0 2 0 7 50 -1 14 0.000 1 0 -1 0 0 5
+	 1300 1607 1613 2067 1322 2533 1024 2058 1300 1607
+2 3 0 2 0 7 54 -1 14 0.000 1 0 -1 0 0 6
+	 1322 2534 1406 2580 1692 2125 1610 2073 1323 2535 1322 2534
+2 3 0 2 0 7 54 -1 10 0.000 1 0 -1 0 0 5
+	 1300 1605 1384 1668 1693 2117 1618 2072 1300 1605
+-6
+1 1 1 1 0 7 50 -1 -1 4.000 1 5.7596 3060 3330 405 900 3060 3330 3465 3337
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 1 3
+	1 1 2.00 120.00 240.00
+	1 1 2.00 120.00 240.00
+	 2205 1305 2205 6165 7245 7155
+2 1 0 1 0 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	1 1 2.00 120.00 240.00
+	 2205 6165 5985 4095
+2 1 1 1 4 7 50 -1 -1 4.000 0 1 -1 1 0 2
+	2 0 1.00 60.00 120.00
+	 5440 5973 5440 5112
+2 1 1 1 4 7 50 -1 -1 4.000 0 1 -1 1 0 2
+	2 0 1.00 60.00 120.00
+	 4331 6582 5440 5973
+2 1 0 2 4 7 50 -1 -1 0.000 0 0 -1 1 0 2
+	2 0 2.00 120.00 240.00
+	 2205 6165 5440 5112
+2 1 1 1 1 7 50 -1 -1 4.000 0 1 -1 1 0 2
+	2 0 1.00 60.00 120.00
+	 4621 4954 4014 5283
+2 1 1 1 1 7 50 -1 -1 4.000 0 1 -1 1 0 2
+	2 0 1.00 60.00 120.00
+	 4014 5283 4014 4048
+2 1 0 2 1 7 60 -1 -1 0.000 0 0 -1 1 0 2
+	2 0 2.00 120.00 240.00
+	 5441 5112 4014 4048
+2 1 1 1 1 7 60 -1 -1 4.000 0 1 -1 1 0 2
+	2 0 1.00 66.00 130.50
+	 5441 5112 4622 4953
+2 1 1 1 4 7 49 -1 -1 4.000 0 1 -1 1 0 2
+	2 0 1.00 60.00 120.00
+	 2205 6165 4331 6582
+2 1 3 2 1 7 70 -1 -1 7.500 0 1 -1 0 0 2
+	 5443 5112 1683 2312
+2 1 1 1 0 7 100 -1 -1 4.000 0 0 -1 0 0 3
+	 3465 2532 1335 2060 2532 4025
+4 0 1 50 -1 0 12 0.0000 3 195 1845 4470 4308 $\\overrightarrow{C2C}$\001
+4 0 0 50 -1 0 12 0.0000 3 165 315 6013 4272 $Y$\001
+4 0 0 50 -1 0 12 0.0000 3 165 315 7140 7372 $X$\001
+4 0 0 50 -1 0 12 0.0000 3 165 300 2266 1297 $Z$\001
+4 0 4 50 -1 0 12 0.0000 3 195 1905 4090 5815 $\\overrightarrow{COO}$\001
+4 2 0 50 -1 0 12 0.0000 3 195 690 2160 6210 $(0,0,0)$\001
+4 1 0 50 -1 0 12 0.0000 3 195 1755 2835 2310 $\\sphericalangle AAC$\001
+4 0 1 50 -1 0 12 0.0000 3 165 570 3635 3680 $ROO$\001
diff --git a/Master/texmf-dist/doc/latex/media9/files/3dsystem.pdf b/Master/texmf-dist/doc/latex/media9/files/3dsystem.pdf
new file mode 100644
index 00000000000..4d09d34fc43
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/3dsystem.pdf
diff --git a/Master/texmf-dist/doc/latex/media9/files/3dsystem.tex b/Master/texmf-dist/doc/latex/media9/files/3dsystem.tex
new file mode 100644
index 00000000000..6bd2ffa1964
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/3dsystem.tex
@@ -0,0 +1,29 @@
+\begin{picture}(0,0)%
+\includegraphics[clip, scale=1, viewport=0 0 435 423.334371108344]{3dsystem}%
+\end{picture}%
+\setlength{\unitlength}{4144sp}%
+%
+\begingroup\makeatletter\ifx\SetFigFont\undefined%
+\gdef\SetFigFont#1#2#3#4#5{%
+  \reset@font\fontsize{#1}{#2pt}%
+  \fontfamily{#3}\fontseries{#4}\fontshape{#5}%
+  \selectfont}%
+\fi\endgroup%
+\begin{picture}(6905.17992277992,6720)(435,-6602)%
+\put(4471,-3469){\makebox(0,0)[lb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,1}$\overrightarrow{C2C}$}%
+}}}}%
+\put(6014,-3433){\makebox(0,0)[lb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,0}$Y$}%
+}}}}%
+\put(7141,-6533){\makebox(0,0)[lb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,0}$X$}%
+}}}}%
+\put(2267,-458){\makebox(0,0)[lb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,0}$Z$}%
+}}}}%
+\put(4091,-4976){\makebox(0,0)[lb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{1,0,0}$\overrightarrow{COO}$}%
+}}}}%
+\put(2161,-5371){\makebox(0,0)[rb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,0}$(0,0,0)$}%
+}}}}%
+\put(2836,-1471){\makebox(0,0)[b]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,0}$\sphericalangle AAC$}%
+}}}}%
+\put(3636,-2841){\makebox(0,0)[lb]{\smash{{\SetFigFont{12}{14.4}{\familydefault}{\mddefault}{\updefault}{\color[rgb]{0,0,1}$ROO$}%
+}}}}%
+\end{picture}%
diff --git a/Master/texmf-dist/doc/latex/media9/files/dice.u3d b/Master/texmf-dist/doc/latex/media9/files/dice.u3d
new file mode 100644
index 00000000000..ae14b756a16
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/dice.u3d
diff --git a/Master/texmf-dist/doc/latex/media9/files/dice.vws b/Master/texmf-dist/doc/latex/media9/files/dice.vws
new file mode 100644
index 00000000000..df43434781b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/dice.vws
@@ -0,0 +1,22 @@
+VIEW=Front
+  ROO=27
+END
+VIEW=Back
+  ROO=27
+  C2C=0 1 0
+END
+VIEW=Left
+  ROO=27
+  C2C=-1 0 0
+END
+VIEW=Right
+  ROO=27
+  C2C=1 0 0
+END
+VIEW=Top
+  ROO=27
+  C2C=0 0 1
+END
+VIEW=Fish Eye at Centre
+  AAC=130
+END
diff --git a/Master/texmf-dist/doc/latex/media9/files/dice.wrl b/Master/texmf-dist/doc/latex/media9/files/dice.wrl
new file mode 100644
index 00000000000..23b1ef92a26
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/dice.wrl
@@ -0,0 +1,119 @@
+#VRML V1.0 ascii
+
+# dice.wrl
+# based on the work of
+# Peter Whitehouse <pwhitehouse@optusnet.com.au>
+# http://www.wonko.info/vrml/dice.txt
+
+Separator {
+    DEF _dice Shape {
+        geometry Box {
+          size 8 8 8
+        }
+    }
+    DEF _sphere0 Separator {
+        Material { diffuseColor [ 0.2 0.8 0.2 ] }
+        Translation { translation  -2 2 -4  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_0 Separator {
+        Material { diffuseColor [ 0.2 0.8 0.2 ] }
+        Translation { translation  2 -2 -4  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1 Separator {
+        Material { diffuseColor [ 1 0.5 0.8 ] }
+        Translation { translation  -2 2 4  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_0_1 Separator {
+        Material { diffuseColor [ 1 0.5 0.8 ] }
+        Translation { translation  2 -2 4  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2 Separator {
+        Material { diffuseColor [ 1 0.5 0.8 ] }
+        Translation { translation  0 0 4  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_3 Separator {
+        Material { diffuseColor [ 0.3 0.3 1 ] }
+        Translation { translation  -4 2 1.5  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_0_1_3 Separator {
+        Material { diffuseColor [ 0.3 0.3 1 ] }
+        Translation { translation  -4 2 -1.5  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_3_4 Separator {
+        Material { diffuseColor [ 0.3 0.3 1 ] }
+        Translation { translation  -4 0 1.5  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_0_1_3_4 Separator {
+        Material { diffuseColor [ 0.3 0.3 1 ] }
+        Translation { translation  -4 -2 -1.5  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_4 Separator {
+        Material { diffuseColor [ 0.3 0.3 1 ] }
+        Translation { translation  -4 -2 1.5  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_6 Separator {
+        Material { diffuseColor [ 1 1 0 ] }
+        Translation { translation  0 4 0  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_7 Separator {
+        Material { diffuseColor [ 1 1 0 ] }
+        Translation { translation  2 4 -2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_6_7 Separator {
+        Material { diffuseColor [ 1 1 0 ] }
+        Translation { translation  2 4 2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_7_8 Separator {
+        Material { diffuseColor [ 1 0 0 ] }
+        Translation { translation  -2 -4 -2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_6_7_8 Separator {
+        Material { diffuseColor [ 1 0 0 ] }
+        Translation { translation  -2 -4 2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_7_9 Separator {
+        Material { diffuseColor [ 1 0 0 ] }
+        Translation { translation  2 -4 -2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_6_7_9 Separator {
+        Material { diffuseColor [ 1 0 0 ] }
+        Translation { translation  2 -4 2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_7_8_9 Separator {
+        Material { diffuseColor [ 1 1 0 ] }
+        Translation { translation  -2 4 -2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_2_3_5_6_7_8_9 Separator {
+        Material { diffuseColor [ 1 1 0 ] }
+        Translation { translation  -2 4 2  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_3_10 Separator {
+        Material { diffuseColor [ 0 1 1 ] }
+        Translation { translation  4 0 0  }
+        Sphere { radius 1.00000 }
+    }
+    DEF _sphere0_1_3_4_12 Separator {
+        Material { diffuseColor [ 0.3 0.3 1 ] }
+        Translation { translation  -4 0 -1.5  }
+        Sphere { radius 1.00000 }
+    }
+}
diff --git a/Master/texmf-dist/doc/latex/media9/files/epix.asy b/Master/texmf-dist/doc/latex/media9/files/epix.asy
new file mode 100644
index 00000000000..48e25aa5591
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/epix.asy
@@ -0,0 +1,22 @@
+//Asymptote source file of epix.prc
+//
+//taken from http://asymptote.sourceforge.net/gallery/3D%20graphs/
+//and slightly modified
+//
+//run asy -k --tex=pdflatex on this file to generate standalone PRC
+
+import graph3;
+
+size(200,200,IgnoreAspect);
+
+//currentprojection=perspective(4,2,3);
+currentprojection=perspective(0,0,1);
+
+real f(pair z) {return z.y^3/2-3z.x^2*z.y;}
+
+draw(surface(f,(-1,-1),(1,1),nx=10,Spline),green,render(merge=true));
+draw(Label("$y$",1),(0,0,0)--(0,2,0),red,Arrow3);
+
+draw(Label("$x$",1),(0,0,0)--(2,0,0),red,Arrow3);
+draw(Label("$z$",1),(0,0,0)--(0,0,2.5),red,Arrow3);
+label("$z=\frac{1}{2}y^3-3x^2y$",(0.25,0.25,2),NE);
diff --git a/Master/texmf-dist/doc/latex/media9/files/epix.prc b/Master/texmf-dist/doc/latex/media9/files/epix.prc
new file mode 100644
index 00000000000..fa22b4ca5eb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/epix.prc
diff --git a/Master/texmf-dist/doc/latex/media9/files/mailto.png b/Master/texmf-dist/doc/latex/media9/files/mailto.png
new file mode 100644
index 00000000000..12831c2410b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/mailto.png
diff --git a/Master/texmf-dist/doc/latex/media9/files/random.mp4 b/Master/texmf-dist/doc/latex/media9/files/random.mp4
new file mode 100644
index 00000000000..cde209339b8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/files/random.mp4
diff --git a/Master/texmf-dist/doc/latex/media9/media9.pdf b/Master/texmf-dist/doc/latex/media9/media9.pdf
new file mode 100644
index 00000000000..9a469702e9a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/media9.pdf
diff --git a/Master/texmf-dist/doc/latex/media9/media9.tex b/Master/texmf-dist/doc/latex/media9/media9.tex
new file mode 100644
index 00000000000..d8c003089b3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/media9/media9.tex
@@ -0,0 +1,761 @@
+% Copyright 2012 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.
+%
+%\pdfcompresslevel=0
+%\pdfobjcompresslevel=0
+\documentclass[a4paper]{article}
+\frenchspacing
+%\usepackage[draft]{media9}
+\usepackage{media9}
+\usepackage{animate}
+\usepackage{fancyvrb}
+
+\usepackage{float}
+\usepackage{amssymb}
+\usepackage[UKenglish]{babel}
+\usepackage{graphicx}
+\usepackage{color}
+\usepackage{lmodern}
+\usepackage{microtype}
+\usepackage[T1]{fontenc}
+%\usepackage{float}
+\usepackage{parskip}
+\usepackage{tabls}
+\usepackage{menukeys}
+\usepackage{hyperref}
+\def\keywords{embed Flash movie LaTeX PDF 3D include sound swf mp3 video MP4 H.264 FLV audio multimedia streamed media rtmp YouTube animation JavaScript pdfLaTeX dvips ps2pdf dvipdfmx XeLaTeX U3D PRC Adobe Reader RichMedia annotation LuaLaTeX}
+\hypersetup{
+  bookmarksnumbered,linktocpage,breaklinks,
+  pdftitle={The media9 Package},
+  pdfsubject={Documentation},
+  pdfauthor={Alexander Grahn},
+  pdfkeywords={\keywords},
+  citebordercolor={0 0 1},
+  filebordercolor={0 0 1},
+  linkbordercolor={0 0 1},
+  menubordercolor={0 0 1},
+  pagebordercolor={0 0 1},
+  urlbordercolor={0 0 1}
+}
+
+\def\XeLaTeX{X\kern-.1667em\lower.5ex\hbox{\reflectbox{E}}\kern-.125em\LaTeX}
+\def\pXepLaTeX{(X\kern-.1667em\lower.5ex\hbox{\reflectbox{E}})\kern-.125em\LaTeX}
+
+\graphicspath{{files/}}
+\addmediapath{files}
+
+\hyphenation{Ja-va-Script}
+
+\newsavebox{\COO}
+\savebox{\COO}{$\overrightarrow{COO}$}
+\newsavebox{\CtoC}
+\savebox{\CtoC}{$\overrightarrow{C2C}$}
+
+\renewcommand{\textfraction}{0.0}
+\renewcommand{\topfraction}{1.0}
+\renewcommand{\bottomfraction}{1.0}
+
+\ifpdf\else
+  \makeatletter
+  \@latex@error{Please use pdfLaTeX to compile this documentation}
+  \makeatother
+\fi
+
+\begin{document}
+\title{The {\sffamily media9} Package}
+\author{Alexander Grahn\\[1ex]\includegraphics[height=2.7ex]{mailto}}
+\maketitle
+
+\begin{abstract}\noindent
+A \LaTeX{} package for embedding interactive Adobe Flash (SWF) and 3D files (Adobe U3D \& PRC) as well as video and sound files or streams (FLV, MP4/H.246, MP3) into PDF documents with Acrobat-9/X compatibility.\\[0.2\baselineskip]
+\emph{Keywords}: \keywords
+\end{abstract}
+
+\tableofcontents
+
+\section{Introduction}
+This package provides an interface to embed interactive Flash (SWF) and 3D objects (Adobe U3D \& PRC) as well as video and sound files or streams in the popular MP4, FLV and MP3 formats into PDF documents. Playback of multimedia files uses the built-in Flash Player of Adobe Reader and does, therefore, not depend on external plug-ins. Flash Player supports the efficient H.264 codec for video compression.
+
+Among the supported media types, video and sound files require an additional Flash (SWF) application for playback, which must be either embedded into the PDF or loaded at runtime from the internet. There are numerous such players, both open-source and commercial, available on the internet. One of them is the highly configurable open-source `Strobe Media Playback'~\cite{strobe}, maintained by Adobe and downloadable from SourceForge.net. Package `media9' comes with two simple players for video and audio, `VPlayer.swf' and `APlayer.swf', which can be used instead. They provide sufficient functionality for playing embedded files and streamed media.
+
+\emph{Note:} `media9' package replaces the now obsolete `movie15' package. `media9' is based on the RichMedia Annotation, an Adobe addition to the PDF specification~\cite{supplement}, while `movie15' uses the old multimedia framework (`Screen Annotation') of pre-9 Readers which depends on external plug-ins and which does not support recent media file formats. Annotations are the interactive parts in a document, in PDF specification parlance.
+
+Package `media9' supports the usual PDF making workflows, i.\,e. pdf\LaTeX{}, Lua\LaTeX, \LaTeX{} $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+/Distiller and \pXepLaTeX{} $\rightarrow$ \verb+(x)dvipdfmx+.
+
+The final PDF can be viewed in current Adobe Readers on MS Windows and other platforms. On Unix platforms including Linux, however, support of Flash, video and sound was discontinued at Reader version 9.4.2, probably for security reasons.
+
+\section{Requirements}
+\begin{trivlist}
+\item l3kernel (\LaTeX{} package), version $\ge 2011/06/19$
+\item l3packages (\LaTeX{} package), version $\ge 2011/07/02$
+\item pdf\TeX{}, version $\ge1.30$
+\item Ghostscript, version $\ge8.31$ or Adobe Distiller for PS to PDF conversion
+\item dvipdfmx, version $\ge20080607$ for DVI to PDF conversion
+\item Adobe Reader, version $\ge9$
+\end{trivlist}
+
+\section{Installation}
+MiK\TeX{} users should run the package manager for installation.
+
+Unfortunately, `media9' is not in TeXLive. It must be installed manually into the \emph{local} TeX-Directory-Structure (TDS) root directory along the following steps:
+\begin{enumerate}
+  \item Download the TDS compliant package file `\href{http://tug.ctan.org/tex-archive/install/macros/latex/contrib/media9.tds.zip}{media9.tds.zip}' from CTAN.
+  \item Find the local TDS root directory by running\\
+  {\tt\phantom{xx}kpsewhich -var-value TEXMFLOCAL}\\
+on the command line. The local TDS root directory is intended for packages that are not maintained by the TeXLive package manager.
+  \item Unzip `\href{http://tug.ctan.org/tex-archive/install/macros/latex/contrib/media9.tds.zip}{media9.tds.zip}' into the local TDS root directory previously found. Depending on the location of this directory, you may need to be logged in as Root/Administrator.
+  \item After installation, update the filename database by running `{\tt texhash}' on the command line. Again, Root/Administrator privileges may be required.
+\end{enumerate}
+For updating the package, repeat the steps given above.
+
+\section{Using the package}\label{pkguse}
+Invoke the package by putting the line
+\begin{verbatim}
+    \usepackage[<package options>]{media9}
+\end{verbatim}
+to the preamble of your document, i.\,e. somewhere between \verb+\documentclass+ and \verb+\begin{document}+.
+
+`media9' honours the package options:
+\begin{verbatim}
+dvipdfmx
+xetex
+draft
+final
+activate=...
+deactivate=...
+transparent
+passcontext
+3Dplaytype=...
+3Dplaycount=...
+3Dplayspeed=...
+3Dtoolbar
+3Dnavpane
+3Dmenu
+3Dbg=...
+3Dlights=...
+3Drender=...
+\end{verbatim}
+Except for `\verb+dvipdfmx+' and `\verb+xetex+', the options above are also available (among others) as command options and will be explained shortly. However, if used as package options they have global scope, taking effect on all embedded media in the document. In turn, command options locally override global settings. Options without an argument are boolean options and can be negated by appending `\verb+=false+'.
+
+\XeLaTeX{} will be auto-detected. Therefore package option `\verb+xetex+' is optional. However, in case of  \verb+dvipdfmx+, package option `\verb+dvipdfmx+' is mandatory because it cannot be auto-detected.
+
+\begin{animateinline}[autoplay,loop]{1.5}\strut\emph{Important:}\newframe\newframe[5]\end{animateinline} If PDF is generated via DVI and Postscript by the command sequence \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+, \verb+dvips+ option `\verb+-Ppdf+' should \emph{not} be set when converting the intermediate DVI into Postscript. If you cannot do without, put `\verb+-D 1200+' \emph{after} `\verb+-Ppdf+' on the command line. Users of \LaTeX-aware text editors with menu-driven toolchain invocation, such as \TeX{}nicCenter, should check the configuration of the \verb+dvips+ call.
+
+\section{The user interface}
+Package `media9' provides the command
+\begin{verbatim}
+\includemedia[<options>]{<poster text>}{
+    <main Flash (SWF) file or URL  |  3D (PRC, U3D) file>}
+\end{verbatim}
+Its last argument, \verb+<main Flash (SWF) file or URL | 3D (PRC, U3D) file>+, is the main interactive application to be inserted into the PDF. In case of Flash, this can be a local SWF file, or a URL, such as a YouTube video. A local file will become part of the final PDF file, while Flash content from a URL requires an internet connection when the user activates it in Adobe Reader. As for 3D content, Adobe Reader only supports U3D or PRC files embedded in the PDF; they cannot be loaded or streamed during runtime. The most frequent use of \verb+\includemedia+ will likely be embedding video or sound files for playback in Adobe Reader. For this we need some media player, which is an SWF file we embed as our main application. It will be configured to load, upon activation, a particular video or sound file that was embedded as a resource into the PDF or is to be streamed from the internet. This will be shown later. Note that a local file (main application or resource) will only once be physically embedded in order to keep final PDF file size small. If the same file (identified by MD5 checksum) appears in other \verb+\includemedia+ commands, only a reference will be inserted that points to the same storage location in the PDF.
+
+Argument \verb+<poster text>+ defines the size of the rectangular region of the document page in which the media will be displayed. Moreover, \verb+<poster text>+ will be shown in case the media has not been activated.
+%(Internally, \verb+<poster text>+ is put into a \LaTeX{} box, which is used as the appearance of the PDF annotation, i.\,e. the interactive region created by \verb+\includemedia+, in PDF specification parlance.)
+\verb+<poster text>+ can be anything that \LaTeX{} can typeset, such as an \verb+\includegraphics+ command serving as a poster image, a PGF/TikZ/PSTricks inline graphics or just ordinary text. Alternatively, \verb+<poster text>+ can be left blank in which case the size of the media rectangle should be set with options `\verb+width+', `\verb+height+' and optionally with `\verb+depth+'. If sizing options `\verb+width+' and `\verb+height+' are given \emph{together} with \verb+<poster text>+, \verb+<poster text>+ will be shrunk or stretched to fit exactly into the rectangle defined by the options, possibly changing the original aspect ratio of the poster text. On the other hand, if only one of `\verb+width+' or `\verb+height+' is given, the other dimension of \verb+<poster text>+ is scaled such that the original aspect ratio is preserved.
+
+A list of directories where \TeX{} searches for media and resource files can be set-up by means of
+\begin{verbatim}
+\addmediapath{<directory>}
+\end{verbatim}
+This command appends one directory at a time to the search list. To specify more directories, just use it repeatedly. The path separator is always `\verb+/+', independent from the operating system.
+
+The following section explains all command options provided. They are passed to the media inclusion command as a comma separated list enclosed in a pair of square brackets.
+
+\section{Command options}
+A subset of the command options (see Sect. \ref{pkguse}) can also be used as package options, which lets them apply to all embedded media. Some of the options listed here are meaningful only for a specific media type (either Flash or 3D), which will be noted explicitly if not obvious. Dedicated sections covering Flash, video and sound as well as 3D inclusion will follow later on in this document.
+
+\begin{verbatim}
+width=<width>,
+height=<height>,
+depth=<depth>
+\end{verbatim}
+Resize the media playback area, overriding the original dimensions of the {\tt<poster text>} argument. Option `\verb+depth+' specifies how far the playback area should extend below the base line of the running text. If only one or two of these options are given, the remaining, unspecified dimensions are scaled to maintain the aspect ratio of \verb+<poster text>+. Any valid \TeX{} dimension is accepted as a parameter. In addition, the length commands \verb+\width+, \verb+\height+, \verb+\depth+ and \verb+\totalheight+ can be used to refer to the original dimensions of \verb+<poster text>+.
+
+\begin{verbatim}
+scale=<factor>
+\end{verbatim}
+Scales the playback area by \verb+<factor>+.
+
+\begin{verbatim}
+url
+\end{verbatim}
+(Flash only) The \emph{last argument} of \verb+\includemedia+ is interpreted as a URL from which the Flash content is to be downloaded on activation of the playback area. Does \emph{not} refer to online resources configured via `\verb+flashvars+' option.
+\begin{verbatim}
+addresource=<local file>,
+addresource=<another local file>,
+...
+\end{verbatim}
+Every invocation of this option embeds another local file that is required to run the main Flash application or 3D file (last argument of \verb+\includemedia+). Typically, this option is used to embed video files, media player skins, XML files (such as databases), additional objects to appear in a 3D scene etc. If an already embedded file is needed in another \verb+\includemedia+ command, this option must be given there again. However, the file in question will only once be physically embedded in order to keep the PDF file small.
+\begin{verbatim}
+flashvars={<some_var=some_val&another_var=another_val&...>}
+\end{verbatim}
+(Flash only) Usually, Flash applications can be configured via ActionScript variables the programmer of the application has made visible from outside. A typical use would be to set the video source of a media player to point to an embedded MP4 file or to a live stream, or to set the speaker volume for playback of an MP3 file. The argument of the \verb+flashvars+ option is a list of \verb+<variable>=<value>+ pairs separated by `\verb+&+' and enclosed in a pair of braces (\verb+{...}+). Note: If a variable is to be set to point to an embedded resource, the value of the variable must be given in exactly the same way as with the `\verb+addresource+' option. Otherwise the name of the embedded file cannot be resolved. For example,
+\begin{verbatim}
+  addresource=path/to/video.mp4
+\end{verbatim}
+implies
+\begin{verbatim}
+  flashvars={vid=path/to/video.mp4&...}
+\end{verbatim}
+if, for a particular media player, the video source is set through ActionScript variable `\verb+vid+'.
+
+(Note for 3D) Resource files used in 3D scenes cannot be loaded by means of ActionScript variables. This must be done by 3D JavaScript during activation of the 3D scene in the Reader. 3D JavaScript can be attached using option `\verb+add3Djscript+', see below.
+\begin{verbatim}
+activate=onclick | pageopen | pagevisible 
+\end{verbatim}
+Decides on how to activate the media annotation. `\verb+activate=onclick+' is default behaviour and does not need be given explicitly; embedded media is activated when the user clicks on it or through a JavaScript. It is recommended to provide a poster image with the \verb+<poster text>+ argument in that case. `\verb+pageopen+' and `\verb+pagevisible+' automatically activate the media when the page becomes visible; `{\tt pagevisible}' is better for two-up and continuous page display.
+\begin{verbatim}
+deactivate=onclick | pageclose | pageinvisible 
+\end{verbatim}
+Decides on how to de-activate the media annotation. `\verb+deactivate=onclick+' is default behaviour and does not need be given explicitly; media is de-activated when the user right-clicks on it and selects `Disable Content', or through a JavaScript. `\verb+pageclose+' and `\verb+pageinvisible+' automatically de-activate the media when the user navigates away from the page containing the media; `{\tt page\-in\-visible}' is better for two-up and continuous page display.
+\begin{verbatim}
+draft
+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}
+transparent
+\end{verbatim}
+Indicates whether underlying page content is visible through transparent areas of the embedded media. Doesn't seem to work well for Flash content. Default is `\verb+transparent=false+'; media artwork is drawn over an opaque background prior to composition over the page content.
+\begin{verbatim}
+passcontext
+\end{verbatim}
+(Flash only) If set, user right-clicks are passed through to the context menu of the embedded Flash application, replacing the default Adobe Reader context menu. Useful for cases where the Flash programmer provided additional functionality through the context menu of his application.
+\begin{verbatim}
+3Dtoolbar
+\end{verbatim}
+Indicates whether a 3D toolbar should be shown in the Reader on top of the embedded 3D model.
+\begin{verbatim}
+3Dnavpane
+\end{verbatim}
+If set, the 3D navigation pane displaying the 3D Model Tree becomes visible in the Reader when the content is initially activated.
+\begin{verbatim}
+3Dcoo=<x> <y> <z>
+\end{verbatim}
+\verb+<x> <y> <z>+ specify the positional vector $\overrightarrow{COO}$ of the centre of orbit of the virtual camera. Real numbers in fixed and floating point notation are accepted.
+\begin{verbatim}
+3Dc2c=<x> <y> <z>
+\end{verbatim}
+\verb+<x> <y> <z>+ specify a direction vector $\overrightarrow{C2C}$ of arbitrary length, originating in the centre of orbit and pointing to the virtual camera. Real numbers in fixed and floating point notation are accepted.
+\begin{verbatim}
+3Droll=<roll>
+\end{verbatim}
+Prescribes an initial camera roll around the optical axis (in clockwise direction, if \verb+<roll>+ is greater that zero); measured in degrees and given as fixed or floating point real number.
+\begin{verbatim}
+3Dc2w=<12 element camera-to-world matrix>
+\end{verbatim}
+This option directly sets the camera-to-world transformation matrix according to the PDF specification. This is an expert option to be used \emph{instead} of the `\verb+3Dc2c+', `\verb+3Dcoo+' and `\verb+3Droll+' options. Only fixed point real numbers are accepted.
+\begin{verbatim}
+3Droo=<r>
+\end{verbatim}
+\verb+<r>+ is a positive fixed or floating point number specifying the radius of orbit $ROO$ of the virtual camera. Good values can be found by means of the `\verb+3Dmenu+' option.
+\begin{verbatim}
+3Daac=<angle>
+\end{verbatim}
+This option sets the aperture angle of the camera, measured in degrees, for the perspective view mode. Fixed and floating point real numbers between 0 and 180 are admissible. A sensible value of 30 is pre-set by default. Larger values can be used to achieve wide-angle or fish-eye effects. See example~\ref{u3dex} in section~\ref{sec:3Dintro}. This option excludes the use of the `\verb+3Dortho+' option.
+\begin{verbatim}
+3Dortho[=<orthographic scaling factor>]
+\end{verbatim}
+Switches from the default perspective to orthographic view mode. In orthographic view, the 3D object is parallelly projected onto the virtual camera chip. The projected image is scaled by \verb+<orthographic scaling factor>+ before reaching the camera chip; default value is 1. The optimal value for the scaling factor is given by $1/D$, where $D$ is the diameter of the smallest enclosing sphere of the 3D object in World coordinate units. Fixed and floating point real numbers are accepted. The camera should be positioned outside the 3D object. For this, the radius of orbit (option `\verb+3Droo+') should be greater than $D/2$. Good values for orthographic scaling and orbital radius can easily be found by means of the `\verb+3Dmenu+' option. Option `\verb+3Dortho+' excludes the use of the `\verb+3Daac+' option.
+\hypertarget{3dmenu}{}%
+\begin{verbatim}
+3Dmenu
+\end{verbatim}
+Mainly used during document authoring. Adds three entries, `\emph{\sffamily Generate Default View}', `\emph{\sffamily Get Current View}' and `\emph{\sffamily Cross Section}' to the context (right-click) menu of an activated 3D annotation. Moreover, it allows individual parts of the scene to be scaled, translated and rotated against the remaining scene objects using the keyboard. Their new position can be saved in the current view. Parts to be modified should be highlighted with the mouse first (the part's bounding box becomes visible). Then, arrow keys \keys{\arrowkeyleft}, \keys{\arrowkeyright} let the part spin around its vertical axis, and \keys{\arrowkeyup}, \keys{\arrowkeydown} tilt against the vertical position. \keys{X}, \keys{\shift+X}, \keys{Y}, \keys{\shift+Y}, \keys{Z}, \keys{\shift+Z} translate the selected part along the World axes and \keys{S}, \keys{\shift+S} scale the part.
+
+`\emph{\sffamily Generate Default View}' computes optimal camera settings such that the visual parts of the object fit tightly into the viewing area. The result is printed, formatted as a list of \verb+\includemedia+ options, into the JavaScript console. The calculation is based on the 3D object size and its position in the World coordinate system as well as the current viewing mode (perspective or orthographic). 
+
+`\emph{\sffamily Cross Section}' is a toggle switch to add or remove a cross section to or from the current view. If a part of the 3D scene was previously selected, the central rotating point of the section plane is put into the part's centre, otherwise into the target point of the camera. The section plane can be rotated around the vertical axis and tilted against its upright position using the arrow keys \keys{\arrowkeyleft}, \keys{\arrowkeyright}, \keys{\arrowkeyup} and \keys{\arrowkeydown}. Keys \keys{X}, \keys{\shift+X}, \keys{Y}, \keys{\shift+Y}, \keys{Z}, \keys{\shift+Z} move the section plane along the World axes.
+
+`\emph{\sffamily Get Current View}' from the context menu writes camera settings, any part alterations, an optional cross section as well as part and scene rendering attributes of the current view into the JavaScript console. The output is a readily formatted \verb+VIEW+ section to be inserted into or appended to a file of predefined views. See option `\verb+3Dviews+'. All settings reachable via the `\emph{\sffamily Part Options}' and `\emph{\sffamily Viewing Options}' context menu items are written to the \verb+VIEW+ section.
+
+\begin{verbatim}
+3Dbg=<r> <g> <b>
+\end{verbatim}
+This option sets the background colour of the 3D scene. Only fixed point real numbers in the range from 0 to 1 are allowed for the colour components. Option `\verb+transparent+' may not be set at the same time.
+\begin{verbatim}
+3Dlights=<lighting scheme>
+\end{verbatim}
+Sets the default lighting scheme. The following values are honoured: `\verb+None+', `\verb+White+', `\verb+Day+', `\verb+Night+', `\verb+Hard+', `\verb+Primary+', `\verb+Blue+', `\verb+Red+', `\verb+Cube+', `\verb+CAD+', `\verb+HeadLamp+'. The default is to use the lighting scheme as specified within the 3D artwork.
+\begin{verbatim}
+3Drender=<render mode>
+\end{verbatim}
+\begin{flushleft}
+Sets the default render mode. The following values are honoured: `\verb+Solid+', `\verb+SolidWireframe+', `\verb+Transparent+', `\verb+TransparentWireframe+', `\verb+BoundingBox+', `\verb+TransparentBoundingBox+', `\verb+TransparentBoundingBoxOutline+', `\verb+Wireframe+', `\verb+ShadedWireframe+', `\verb+HiddenWireframe+', `\verb+Vertices+', `\verb+ShadedVertices+', `\verb+SolidOutline+', `\verb+Illustration+', `\verb+ShadedIllustration+'.
+\end{flushleft}
+\begin{verbatim}
+3Dviews=<views file>
+\end{verbatim}
+Instead of or in addition to the default view (options `\verb+3Dcoo+', `\verb+3Dc2c+', `\verb+3Droll+', `\verb+3Droo+', `\verb+3Daac+', `\verb+3Dortho+'), further \emph{named views} can be set in an auxiliary file \verb+<views file>+. Besides the virtual camera position, it is possible to adjust the rendering attributes, such as visibility and transparency, as well as position and scaling of every single part in the 3D scene. Moreover, background colour and scene lighting can be set individually for every view. The additional views can later be selected either from a drop down list in the tool bar that is associated with the activated 3D object in the Reader or from the context menu of the 3D object.
+
+The file \verb+<views file>+ is structured into view sections, one for every view:
+\begin{verbatim}
+  VIEW[=<optional name>]
+    COO=<x> <y> <z>
+    C2C=<x> <y> <z>
+    ROLL=<roll>
+  %  C2W=<camera-to-world matrix> % instead of COO, C2C and ROLL
+    ROO=<roo>
+    AAC=<aac>
+  %  ORTHO[=<othographic scaling factor>] % instead of AAC
+    BGCOLOR=<r> <g> <b>
+    RENDERMODE=<render mode>
+    LIGHTS=<lighting scheme>
+    CROSSSECT
+      CENTER=<x> <y> <z>
+      NORMAL=<x> <y> <z>
+    END  
+    PART=<part name  as in the Model Tree (required, optional if UTF16NAME present)>
+      UTF16NAME=<part name as hex encoded Unicode string>
+      VISIBLE=true | false
+      OPACITY=<part opacity>
+      RENDERMODE=<part render mode>
+      TRANSFORM=<12 element transformation matrix>
+    END
+    PART=<...>
+      ...
+    END
+    etc.
+  END
+
+  VIEW
+    ...
+  END
+
+  etc.
+\end{verbatim}
+A view section starts with the keyword \verb+VIEW+, optionally followed by a name for the view, and ends with the keyword \verb+END+. If no name is given to the view, a default one is created, consisting of `View' followed by the number of the current \verb+VIEW+ section in the file. A \verb+VIEW+ section may contain optional entries for setting the camera position and global rendering attributes of the scene, a \verb+CROSSSECT+ subsection as well as \verb+PART+ subsections for setting rendering and other attributes of parts individually. Table~\ref{tab:views} lists the entries in a \verb+VIEW+ section.
+
+Part sub-sections are opened by \verb+PART=<part name>+ and closed by \verb+END+. There may be as many part subsections as there are parts in a 3D scene. Table~\ref{tab:parts} lists the possible entries in a \verb+PART+ sub-section. All entries are optional. However, a \verb+UTF16NAME+ entry is recommended, as the part name may contain non-ASCII characters. The value of the \verb+UTF16NAME+ key is the part name as a hex-encoded Unicode string. If \verb+UTF16NAME+ is not used, the part name in the 3D file must be entirely composed of ASCII characters. In that case, \verb+<part name>+ is mandatory and must match the part name as indicated in the Model Tree of the 3D object (accessible via right-click onto the model in the Reader). The part can be scaled and repositioned by means of a \verb+TRANSFORM+ entry which takes a 12-element transformation matrix as its value. Remaining entries in a part sub-section control the visual appearance of the part.
+
+A view section may contain at most one \verb+CROSSSECT+ sub-section. It inserts a section plane at a definite position and orientation in the 3D space, controlled by optional \verb+CENTER+ and \verb+NORMAL+ entries. See Table~\ref{tab:crosss} for explanation.
+
+The views file can be commented. As usual, comments start with the percent sign.
+
+To facilitate the creation of a views file, option `\verb+3Dmenu+' can be added to \verb+\includemedia+ (see above). It creates context (right-click) menu entry `Get Current View' which outputs a complete \verb+VIEW+ section corresponding to the current view of the 3D object in the Reader, including camera position, an optional cross section, and all part and viewing options that can be modified via the 3D toolbar (option `\verb+3Dtoolbar+') or the context menu of the 3D object (entries `\emph{\sffamily Part Options}', `\emph{\sffamily Viewing Options}'). Hence, apart from tweaking one or another entry, there should no need for writing views files by hand.
+\begin{verbatim}
+3Dplaytype=linear | oscillating
+\end{verbatim}
+According to the PDF specification, embedded keyframe animations can be played in two ways. If set to `\verb+linear+', keyframe animations are driven linearly from beginning to end, while `\verb+oscillating+' lets the animation play in a forth-and-back manner.
+\begin{verbatim}
+3Dplaycount=<integer number>
+\end{verbatim}
+A non-negative \verb+<integer number>+ represents the number of times the animation is played. A negative integer indicates that the animation is infinitely repeated. This value is ignored if option \verb+3Dplaytype+ is not set.
+\begin{verbatim}
+3Dplayspeed=<positive number>
+\end{verbatim}
+This option can be used to adjust the keyframe animation speed. A value of `1' corresponds to the default speed defined in the 3D file.
+\begin{verbatim}
+add3Djscript=<3D JavaScript file>,
+add3Djscript=<another 3D JavaScript file>,
+...
+\end{verbatim}
+Things like animation, lighting, background of 3D objects etc. may also be script driven. Every invocation of `\verb+add3Djscript+' associates another JavaScript file with the 3D object. Upon activation of the 3D object, the scripts are executed once in the order of their inclusion. Refer to the Acrobat 3D JavaScript Reference~\cite{jscript3D} for syntax details. The following 3D JavaScript loads an image file that was attached by `\verb+addresource=images/sunset.jpg+' and uses it as the scene background.
+\begin{verbatim}
+  sunset = new Image(new Resource('pdf://images/sunset.jpg')); 
+  reh = new RenderEventHandler(); 
+  reh.onEvent = function(event) { 
+    runtime.removeEventHandler(this); 
+    event.canvas.background.image=sunset; 
+  }
+  runtime.addEventHandler(reh); 
+\end{verbatim}
+\hypertarget{3dscripts}{}For convenience, subdirectory `javascript' of the `media9' installation contains three 3D JavaScript files which may come in handy at times: `animation.js' enables embedded keyframe animation in 3D files; `3Dspintool.js' enables the Spin tool of the 3D plugin for easier rotating the 3D object with the mouse; `asylabels.js' adds `billboard behaviour' to text labels in Asymptote generated PRC files for improved visibility, they always face the camera while dragging the 3D object with the mouse.
+
+\begin{table}[bp]%[p]%[htbp]
+  \centering
+  \caption{Entries in a {\tt VIEW} section.}\label{tab:views}
+  \begin{tabular}[t]{p{0.24\linewidth}lp{0.4\linewidth}}\hline
+  key & type & remarks\\\hline\hline
+  COO & three numbers & centre of orbit, see option `{\tt 3Dcoo}'\\ 
+  C2C & three numbers & centre of orbit to camera vector, see option `{\tt 3Dc2c}'\\ 
+  ROO & number & radius of orbit, see option `{\tt 3Droo}'\\ 
+  C2W & 12 numbers & camera-to-world transformation matrix, see option `{\tt 3Dc2w}'\\ 
+  AAC & number & camera aperture angle, see option `{\tt 3Daac}'\\ 
+  ORTHO & number (optional) & enables orthographic view, see option `{\tt 3Dortho}'\\
+  ROLL & number & camera roll, see option `{\tt 3Droll}'\\ 
+  BGCOLOR & three numbers & 3D scene background colour (RGB), see option `{\tt 3Dbg}'\\ 
+  RENDERMODE & string & render mode of the 3D object, see option `{\tt 3Drender}'\\ 
+  LIGHTS & string & lighting scheme, see option `{\tt 3Dlights}'\\
+  PART\,\,(sub-sec\-tion) & string & part name as in the model tree; optional if a UTF16NAME entry is present in the sub-section opened by a PART keyword, otherwise required; see Table~\ref{tab:parts} for list of possible entries\\
+  CROSSSECT~(sub-section) & -- & see Table~\ref{tab:crosss} for list of possible entries\\
+  \hline
+  \end{tabular}
+\end{table}
+
+\begin{table}%[p]%[htbp]
+  \centering
+  \caption{Entries in a {\tt PART} sub-section.}\label{tab:parts}
+  \begin{tabular}[t]{llp{0.5\linewidth}}\hline
+  key & type & remarks\\\hline\hline
+  UTF16NAME & hex string & part name in UTF-16 (aka Unicode), encoded as a hexadecimal string; optional, but useful for part names composed of non-latin characters;\\
+  VISIBLE & boolean & a flag (`{\tt true}' or `{\tt false}') indicating the visibility of this part\\
+  OPACITY & number & a number between 0.0 and 1.0 specifying the opacity of this part\\
+  RENDERMODE & string & rendermode of this part, overrides global {\tt RENDERMODE} value in parent {\tt VIEW} section, see option `{\tt 3Drender}'\\
+  TRANSFORM & 12 numbers & transformation matrix defining the part's position and scaling\\
+  \hline
+  \end{tabular}
+\end{table}
+
+\begin{table}%[p]%[htbp]
+  \centering
+  \caption{Entries in a {\tt CROSSSECT} sub-section.}\label{tab:crosss}
+  \begin{tabular}[t]{llp{0.5\linewidth}}\hline
+  key & type & remarks\\\hline\hline
+  CENTER & three numbers & central point coordinates of the section plane\\
+  NORMAL & three numbers & normal vector coordinates of the section plane pointing into the cut-off region\\
+  \hline
+  \end{tabular}
+\end{table}
+
+\clearpage
+\section[Embedding Flash, video and sound (with examples)]{Embedding Flash, video and sound}
+A YouTube video clip, as shown in Fig.~\ref{alien}, may serve as a basic example of loading Flash content from a URL to be displayed in an embedded fashion in a PDF document. Indeed, a YouTube clip is nothing more than a small SWF file which loads a video stream and other necessary resources, such as user controls and a player skin from a remote server. It can be configured via ActionScript variables, to play several videos in a row, to play a video in a loop etc. Player parameters are documented on \url{http://code.google.com/apis/youtube/player_parameters.html} and can be passed to the player using either the `\verb+flashvars+' option, as in the example, or appended to the URL string after the video ID. A question mark `\verb+?+' must be put between the video ID and the parameter string. Some of the documented parameters, such as `\verb+rel+', seem to have an effect only if they are passed as part of the URL.
+
+\begin{figure}[bp]
+\begin{Verbatim}
+\includemedia[
+  width=0.6\linewidth,height=0.45\linewidth,
+  activate=pageopen,
+  flashvars={%
+    modestbranding=1% no YT logo in control bar
+   &autohide=1%     % controlbar autohide
+   &showinfo=0%     % no title and other info before start
+   &rel=0%          % no related videos after end
+  },%                
+  url               % Flash loaded from URL
+]{}{http://www.youtube.com/v/Mdc3o7wOwNA?rel=0}
+\end{Verbatim}
+%\begin{minipage}{0.5\linewidth}
+\begin{center}
+\includemedia[
+  width=0.6\linewidth,height=0.45\linewidth,
+  activate=pageopen,
+  flashvars={%
+    modestbranding=1% no YT logo in control bar
+   &autohide=1%       controlbar autohide
+   &showinfo=0%       no title and other info before start
+%   &rel=0%           no display of related videos
+  },
+  url
+]{}{http://www.youtube.com/v/Mdc3o7wOwNA?rel=0}
+%]{}{http://www.youtube.com/v/k0BGuONQWUw?loop=1}
+\end{center}
+%\end{minipage}
+\caption{A YouTube video as an example of a Flash application loaded from a URL.}\label{alien}
+\end{figure}
+
+Video and sound files are always loaded and then played by a media player application. Two simple players, `VPlayer.swf' for video and `APlayer.swf' for sound, are installed along with the `media9.sty' package file. Although they do not have user controls, minimal interactivity for play, pause and resume is provided via left mouse button press and release. The players support MP4 video and MP3 sound files and streams. They were compiled, using the free Adobe Flex SDK~\cite{flex}, from XML source files which reside in the same directory as the players. More sophisticated players are available, e.\,g.~\cite{strobe}. There is no need to copy `VPlayer.swf' and `APlayer.swf' into the directory of the document source for embedding. They will be found by \LaTeX{} without taking any further action.
+
+Like YouTube videos, media players are configured via ActionScript variables which are passed using option `\verb+flashvars+'. Table~\ref{playerparams} lists parameters available for VPlayer.swf and APlayer.swf.
+
+Playback of an embedded video is shown in Fig.~\ref{video}a. Besides embedded files, `VPlayer.swf' also supports video that is streamed from remote servers via HTTP and RTMP protocols, as shown in Fig.~\ref{video}b.
+
+\begin{table}
+\centering
+\caption{Parameters for media players VPlayer.swf and APlayer.swf shipping with media9. Parameters must be passed as `{\tt\&}'-separated string using `{\tt flashvars}' option.}\label{playerparams}
+\begin{tabular}[t]{p{0.4\linewidth}p{0.5\linewidth}}\hline
+parameter & description\\\hline\hline
+{\tt source=<file path or URL>} & (required) path to embedded media file (see option `{\tt addresource}'), or URL (http, rtmp) to stream or online media file\\
+{\tt autoPlay=true|false} & if {\tt=true}, automatically starts playback after activation (see option `{\tt activation})'\\
+{\tt loop=true|false} & if {\tt=true}, media is played in a loop\\
+{\tt volume=<value between 0.0 and 1.0>} & sets volume of the sound\\
+{\tt balance=<value between -1.0 and 1.0>} & (APlayer.swf only) sets balance of sound speakers\\\hline
+\end{tabular}
+\end{table}
+
+\begin{figure}
+\centering
+\begin{Verbatim}
+\includemedia[
+  width=0.4\linewidth,height=0.3\linewidth,
+  activate=pageopen,
+  addresource=files/random.mp4,
+  flashvars={%
+    source=files/random.mp4% same path as in addresource!
+   &loop=true%               loop video
+  }  
+]{}{VPlayer.swf}
+\end{Verbatim}
+\makebox[\linewidth]{a)\hfill\includemedia[
+  width=0.6\linewidth,height=0.45\linewidth,
+  activate=pageopen,
+  addresource=files/random.mp4, %embeds video file
+  flashvars={%
+    source=files/random.mp4% same path as in addresource!
+   &loop=true%             % loop video
+  }  
+]{}{VPlayer.swf}\hfill}
+\vskip 1ex
+\begin{Verbatim}
+\includemedia[
+  width=0.6\linewidth,height=0.45\linewidth,
+  activate=pageopen,
+  flashvars={%
+     autoPlay=true%
+    &source=rtmp://streaming.music.indiana.edu:1935/onDemand/%
+      mp4:media/20090327_VarRussianTheme-h264-480.m4v%
+  }
+]{}{VPlayer.swf}
+\end{Verbatim}
+\makebox[\linewidth]{b)\hfill\includemedia[
+  width=0.6\linewidth,height=0.45\linewidth,
+  activate=pageopen,
+  flashvars={%
+    autoPlay=true%
+    &source=rtmp://streaming.music.indiana.edu:1935/onDemand/mp4:media/20090327_VarRussianTheme-h264-480.m4v%
+  }
+]{}{VPlayer.swf}\hfill}
+\caption{Example of (a) an embedded MP4 video file and (b) streamed video from an RTMP server. Both examples use `VPlayer.swf', physically embedded in the PDF.}\label{video}
+\end{figure}
+
+%\enlargethispage{2ex}
+Sound files and streams in the MP3 format can be played with `APlayer.swf'. Fig.~\ref{radio} contains examples of an audio live stream and a downloaded MP3 sound file. Instead of being embedded, the player is loaded from a CTAN mirror during runtime because an internet connection is required anyway for streaming the audio.
+
+\begin{figure}[bp]
+%\flushright
+\begin{Verbatim}
+    \includemedia[
+      flashvars={%
+        source=http://mp3.live.tv-radio.com/franceculture%
+               /all/franceculturehautdebit.mp3%
+       &autoPlay=true%
+      },
+      url  %refers to APlayer.swf, not to `source' flashvar!
+    ]{\color{blue}\fbox{Listen live to Radio France Culture}}{%
+      http://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/latex/%
+	  contrib/media9/players/APlayer.swf%
+    }
+\end{Verbatim}
+\makebox[\linewidth]{a)\hfill\includemedia[
+  flashvars={%
+    source=http://mp3.live.tv-radio.com/franceculture/all/franceculturehautdebit.mp3%
+   &autoPlay=true%
+  },
+  url
+]{\color{blue}\fbox{Listen live to Radio France Culture}}{%
+%APlayer.swf%
+%http://www.ctan.org/tex-archive/macros/latex/contrib/media9/players/APlayer.swf%
+http://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/latex/contrib/media9/players/APlayer.swf%
+}\hfill}
+\vskip 4ex
+\begin{Verbatim}
+    \includemedia[
+      flashvars={%
+        source=http://www.openbsd.org/songs/song50.mp3%
+       &autoPlay=true%
+      },
+      url
+    ]{\color{blue}\fbox{Listen to OpenBSD 4.9 release song.}}{%
+      http://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/latex/%
+	  contrib/media9/players/APlayer.swf%
+    }
+\end{Verbatim}
+\makebox[\linewidth]{b)\hfill\includemedia[
+  flashvars={%
+    source=http://www.openbsd.org/songs/song49.mp3%
+   &autoPlay=true%
+  },
+  url 
+]{\color{blue}\fbox{Listen to OpenBSD 4.9 release song.}}{%
+%APlayer.swf%
+http://mirrors.ibiblio.org/pub/mirrors/CTAN/macros/latex/contrib/media9/players/APlayer.swf%
+}\hfill}
+\caption{Example of (a) streamed audio and (b) progressively downloaded MP3. The sound player, APlayer.swf, is loaded from a CTAN mirror upon activation.}\label{radio}
+\end{figure}
+
+\clearpage
+\section[Embedding 3D objects (with examples)]{Embedding 3D objects}
+\subsection{Introduction}\label{sec:3Dintro}
+Adobe Acrobat/Reader 7 was the first version to allow for embedding 3-di\-men\-sion\-al graphic objects, such as CAD models or 3D scientific data, that can be manipulated interactively by the user. U3D was the first supported format and was mainly developed by Right Hemisphere and Adobe. U3D had some deficiencies and was later replaced by the PRC format after Adobe purchased the original developer, the French company `Trade and Technology France'. U3D is still supported, but PRC is preferred as it allows for exact representation of curved surfaces and better compression. Both, U3D and PRC specifications are public~\cite{u3d,prc}.
+
+Currently, the only open-source PRC writing software is Asymptote~\cite{asy}. It is a descriptive 2D and 3D vector graphics language and interpreter which uses \TeX{} to typeset labels and equations, allowing for high quality mathematical figures and technical drawings. An impressive gallery of examples can be found on its Web site.
+
+MathGL~\cite{mathgl} is an open-source library for the creation of mathematical drawings which can export to the intermediate IDTF format. IDTF can then be converted into U3D using the open-source `Universal 3D Sample Software'~\cite{u3dlib}.
+
+MeshLab~\cite{meshlab} is an open-source conversion and processing software for 3D mesh data which can import from and export to a number of file formats. Its U3D export filter is based on~\cite{u3dlib}.
+
+There are a few options to \verb+\includemedia+ which define how the 3D object is positioned within the view port of a virtual camera, or conversely, how the virtual camera is positioned and oriented within a coordinate system, called `The World', which bears the 3D object at a fixed position. Fig.~\ref{3dscene} should help to visualize the scenery: The virtual camera is orbiting at a distance of $ROO$ (option `\verb+3Droo+') around the centre of orbit, specified by the position vector $\overrightarrow{COO}$ (option `\verb+3Dcoo+'); $\sphericalangle AAC$ (option `\verb+3Daac+') is the camera's aperture angle. The direction vector $\overrightarrow{C2C}$ (option `\verb+3Dc2c+') is needed to specify the initial camera position. The camera may be given an initial roll angle (option `\verb+3Droll+') around its optical axis $(-1)\cdot\overrightarrow{C2C}$.
+\begin{figure}[ht]
+  \resizebox{\linewidth}{!}{\input{files/3dsystem}}
+  \caption{Camera and 3D object in the World System $XYZ$; centre of orbit position vector \usebox{\COO}, centre of orbit to camera direction vector \usebox{\CtoC}, radius of orbit $ROO$, aperture angle of camera $\sphericalangle AAC$.}\label{3dscene}
+\end{figure}
+Fig.~\ref{3dscene} shows the camera parameters for the perspective view mode. Alternatively, the orthographic view mode may be chosen. In orthographic view, the 3D object is parallelly projected onto the virtual camera chip. Before reaching the camera chip, the projected image must be scaled in order to fit onto the chip. Orthographic view can be enabled using the `\verb+3Dortho+' option which takes the scaling factor as its argument.
+
+Above options define the default view, i.\,e. the view that is shown initially after activating the 3D object in the Reader. Of course, once activated, the camera position can be changed using the mouse and one can change forth and back between perspective and orthographic viewing modes using the 3D tool bar.
+
+By default, the virtual camera sits at the origin $(0,0,0)$ of the World, looking in the positive $Y$ direction, i.\,e. default settings of \verb+3Droo=0+, \verb+3Dcoo=0 0 0+ and \verb+3Dc2c=0 -1 0+ are assumed. (Note that $\overrightarrow{C2C}$ is the opposite of the optical axis vector.) Thus, in order to get a `front view' of the 3D object it is sufficient to set the radius of orbit, i.\,e. the distance between camera and object appropriately. Sometimes you may want to adjust the orbital centre, i.\,e. the target of the camera as well, in particular, if the object is irregularly shaped or if it is not centred around the World origin. Fortunately, it is possible to let the values of the corresponding options be determined automatically. Choosing option `\verb+3Dmenu+' adds `\emph{\sffamily Generate Default View}' to the context menu of the activated 3D scene. Selecting this entry calculates and outputs optimal camera settings which can be inserted into the option list of \verb+\includemedia+.
+
+Additional resource files that are needed to render the 3D scene can be embedded using the `\verb+addresource+' option. Typical resources are bitmaps and Flash files (even animated and interactive ones), to be used as materials or scene backgrounds, as well as additional 3D objects in the U3D or PRC file format. The allowed file formats of \emph{bitmapped} image files depend on the \LaTeX workflow. \LaTeX{} $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+/Distiller accepts PS and EPS files; pdf\LaTeX{} accepts PNG, JPEG and JBIG2; \pXepLaTeX{} $\rightarrow$ \verb+(x)dvipdfmx+ accepts  PNG and JPEG. 3D JavaScript is necessary to load these resources upon activation. 3D JavaScript files are attached using the `\verb+add3Djscript+' option.
+
+Below, two examples of embedded 3D files are shown. The first one, Fig.~\ref{asyex} is a PRC file generated with Asymptote. Note the text labels always facing the camera thanks to the attached 3D JavaScript file `asylabels.js'. The second example, Fig.~\ref{u3dex}, demonstrates the use of a views file which defines additional named views of the 3D object. Moreover, the possibilities of the extended 3D context menu can be evaluated. They were enabled by adding the `\verb+3Dmenu+' option to \verb+\includemedia+. All part and scene rendering attributes that can be changed via the `\emph{\sffamily Part Options}' and `\emph{\sffamily Viewing Options}' menu entries, as well as a cross section to be added with the `\emph{\sffamily Cross Section}' menu entry can be saved into a new view (`\emph{\sffamily Get Current View}'). Position, orientation and scaling of individual parts and of the cross section can be changed using the keyboard (keys \keys{\arrowkeyleft}, \keys{\arrowkeyright}, \keys{\arrowkeyup}, \keys{\arrowkeydown}, \keys{X}, \keys{\shift+X}, \keys{Y}, \keys{\shift+Y}, \keys{Z}, \keys{\shift+Z}, \keys{S}, \keys{\shift+S}).
+
+\begin{figure}[bp]
+\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,
+  3Dcoo=-21.371112823486328 -19.702425003051758 -395.4008483886719,
+  3Droo=472.3543474473915,
+  3Dc2c=4 2 3
+]{}{epix.prc}
+\end{Verbatim}
+\centering
+\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,
+  3Dcoo=-21.371112823486328 -19.702425003051758 -395.4008483886719,
+  3Droo=472.3543474473915,
+  3Dc2c=4 2 3,
+]{}{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}
+
+\begin{figure}[bp]
+\begin{Verbatim}
+\includemedia[
+  width=0.5\linewidth,height=0.5\linewidth,
+  activate=pageopen,
+  3Dtoolbar,
+  3Dviews=dice.vws,
+  3Dmenu
+]{}{dice.u3d}
+\end{Verbatim}
+Contents of `dice.vws':
+\begin{Verbatim}
+  VIEW=Front
+    ROO=27
+  END
+  VIEW=Back
+    ROO=27
+    C2C=0 1 0
+  END
+  VIEW=Left
+    ROO=27
+    C2C=-1 0 0
+  END
+  VIEW=Right
+    ROO=27
+    C2C=1 0 0
+  END
+  VIEW=Top
+    ROO=27
+    C2C=0 0 1
+  END
+  VIEW=Fish Eye at Centre
+    AAC=130
+  END
+\end{Verbatim}
+\centering
+\includemedia[
+  width=0.5\linewidth,height=0.5\linewidth,
+  activate=pageopen,
+  3Dtoolbar,
+  3Dviews=dice.vws,
+  3Dmenu,
+]{}{dice.u3d}
+\caption{Embedded U3D file, based on a VRML model by Peter Whitehouse, \url{http://www.wonko.info/vrml/index.htm}; conversion to U3D was done using DeepExploration\textsuperscript{\scriptsize\textregistered}\cite{dexp}. The file `{\tt dice.vws}' provides predefined views to be selected from the 3D toolbar or by right click.}\label{u3dex}
+\end{figure}
+
+\clearpage
+\subsection{3D quick-start guide}\label{sec:3Dtut}
+\begin{enumerate}
+  \item Insert the 3D object with default camera settings and with extended context menu enabled (option `\verb+3Dmenu+'):
+
+\begin{Verbatim}
+  \includemedia[
+    width=0.5\linewidth,height=0.5\linewidth,
+    activate=pageopen,
+    3Dmenu
+  ]{}{myfile.u3d}
+\end{Verbatim}
+
+  \item Compile the document.
+  \item Open the PDF document in Adobe Reader and go to the page containing the 3D object. Select `\emph{\sffamily Generate Default View}' from the 3D context menu (right mouse click) and wait for the JavaScript console to pop up. Optionally, drag the object with the mouse to change the viewpoint of the camera and select `\emph{\sffamily Generate Default View}' again. This will re-adjust the distance between camera and target to fit all visible parts tightly into the viewport. The options printed into the console are updated accordingly.
+  \item Copy the camera settings ({\tt 3Droo=...}, {\tt 3Dcoo=...}, etc.) from the console into the option list of {\tt \string\include\-media}.
+  \item Compile the document again.
+  \xdef\lastcount{\theenumi}
+\end{enumerate}
+
+\emph{Optional steps} (option `{\tt 3Dmenu}' required):
+
+\begin{enumerate}
+  \setcounter{enumi}{\lastcount}
+  \item Additional, named views; cross sections; rescaled, repositioned parts:
+  \begin{itemize}
+    \item[a)] Open a text file, e.\,g. `myviews.vws', to be populated with additional views of the 3D object.
+    \item[b)] Manipulate the 3D object using the mouse (camera position) and via 3D context menu items `\emph{\sffamily Part Options}' and `\emph{\sffamily Viewing Options}' (visibility, rendering attributes, background etc.); the camera target can be moved into the centre of a single part via `\emph{\sffamily Part Options}'$\rightarrow$`\emph{\sffamily Zoom to Part}'.
+	\item[c)] Add a cross section plane, adjust its position using the keyboard, keyboard keys are given \hyperlink{3dmenu}{here}.
+	\item[d)] Adjust scaling and position of individual parts using the keyboard, keyboard keys are given \hyperlink{3dmenu}{here}.
+	\item[e)] Re-adjust the camera distance using either `\emph{\sffamily Generate Default View}' or `\emph{\sffamily Part Options}'$\rightarrow$`\emph{\sffamily Fit Visible}'.
+    \item[f)] When you are done, select `\emph{\sffamily Get Current View}' to get the {\tt VIEW} section, readily formatted for insertion into the views file. Repeat steps (a)--(f) to get any number of views you want to define. The views file can be edited manually to give meaningful names to the views (change the value of the {\tt VIEW} key), or to further tweak camera settings, opacity, part options etc.
+    \item[g)] Attach the views file with option `{\tt 3Dviews}':
+\begin{Verbatim}
+  \includemedia[
+    width=0.5\linewidth,height=0.5\linewidth,
+    activate=pageopen,
+    3Dviews=myviews.vws,
+    3Dmenu
+  ]{}{myfile.u3d}
+\end{Verbatim}
+	If you are satisfied with the predefined views in the views file, the default view first specified through the options of {\tt\string\includemovie} can be deleted. The first view in the views file becomes the default view then.
+  \end{itemize}
+  \item Associate any number of 3D JavaScript files with the 3D object:
+\begin{Verbatim}
+  \includemedia[
+    width=0.5\linewidth,height=0.5\linewidth,
+    activate=pageopen,
+    add3Djscript=somescript.js,
+    add3Djscript=otherscript.js,
+    3Dviews=myviews.vws,
+    3Dmenu
+  ]{}{myfile.u3d}
+\end{Verbatim}
+A few 3D JavaScript files ready to be used are already installed along with `media9.sty', see \hyperlink{3dscripts}{above}.
+\end{enumerate}
+
+\section{Acknowledgements}
+This package was written using the new \LaTeX3 syntax which was a lot of fun. Many thanks to the \LaTeX3 team!
+
+\begin{thebibliography}{9}
+  \bibitem{strobe} Adobe Systems Inc.: \emph{Strobe Media Playback}, 2010, available at \url{http://osmf.org/strobe_mediaplayback.html}
+
+  \bibitem{supplement} Adobe Systems Inc.: \emph{Adobe Supplement to ISO 32000, BaseVersion 1.7, ExtensionLevel 3}, 2008, available at \url{http://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/adobe_supplement_iso32000.pdf}
+
+  \bibitem{jscript3D} Adobe Systems Inc.: \emph{JavaScript for Acrobat 3D Annotations API Ref\-er\-ence}, available at \url{http://livedocs.adobe.com/acrobat_sdk/10/Acrobat10_HTMLHelp/JS_3D_Intro.90.1.html}
+
+  \bibitem{jscript} Adobe Systems Inc.: \emph{JavaScript for Acrobat API Reference}, available at \url{http://livedocs.adobe.com/acrobat_sdk/10/Acrobat10_HTMLHelp/JS_API_AcroJSPreface.87.1.html}
+
+  \bibitem{flex} Adobe Systems Inc.: \emph{Adobe Flex SDK}, available at \url{http://www.adobe.com/products/flex.html}
+
+  \bibitem{u3d} ECMA International: \emph{Universal 3D File Format (ECMA-363), 4th Edition}, 2007, available at \url{http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-363\%204th\%20Edition.pdf}
+
+  \bibitem{prc} Adobe Systems Inc.: \emph{PRC Format Specification}, available at \url{http://livedocs.adobe.com/acrobat_sdk/10/Acrobat10_HTMLHelp/API_References/PRCReference/PRC_Format_Specification/index.html}
+
+  \bibitem{asy} A. Hammerlindl, J. Bowman and T. Prince: \emph{Asymptote: The Vector Graphics Language}, available at \url{http://asymptote.sourceforge.net}
+
+  \bibitem{mathgl} A. A. Balakin: \emph{MathGL - library for scientific graphics}, available at \url{http://mathgl.sourceforge.net}
+
+  \bibitem{u3dlib} T. O'Rourke, T. Strelchun: \emph{Universal 3D Sample Software}, available at \url{http://sourceforge.net/projects/u3d}
+
+  \bibitem{meshlab} P. Cignoni \emph{et al.}: \emph{MeshLab}, available at \url{http://meshlab.sourceforge.net}
+
+  \bibitem{dexp} RightHemisphere Inc.: \emph{DeepExploration}, \url{http://www.righthemisphere.com/products/dexp/}
+%  \bibitem{swftools} R. B\"ohme, M. Kramm: \emph{Swftools}, available at \url{http://www.swftools.org}
+\end{thebibliography}
+
+\end{document}