From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/media9/ChangeLog | 520 +++++ macros/latex/contrib/media9/README.md | 49 + macros/latex/contrib/media9/doc/files/3dsystem.fig | 273 +++ macros/latex/contrib/media9/doc/files/3dsystem.pdf | Bin 0 -> 5989 bytes macros/latex/contrib/media9/doc/files/3dsystem.tex | 29 + macros/latex/contrib/media9/doc/files/bird.mp3 | Bin 0 -> 735130 bytes macros/latex/contrib/media9/doc/files/boutona.pdf | Bin 0 -> 2363 bytes macros/latex/contrib/media9/doc/files/boutonb.pdf | Bin 0 -> 2203 bytes macros/latex/contrib/media9/doc/files/boutonc.pdf | Bin 0 -> 2364 bytes macros/latex/contrib/media9/doc/files/boutond.pdf | Bin 0 -> 2199 bytes macros/latex/contrib/media9/doc/files/boutone.pdf | Bin 0 -> 2236 bytes macros/latex/contrib/media9/doc/files/boutonf.pdf | Bin 0 -> 2208 bytes macros/latex/contrib/media9/doc/files/config.xml | 73 + .../contrib/media9/doc/files/ctan_lion_1200.png | Bin 0 -> 321886 bytes .../contrib/media9/doc/files/ctan_lion_200.png | Bin 0 -> 14220 bytes .../contrib/media9/doc/files/ctan_lion_400.png | Bin 0 -> 44332 bytes .../contrib/media9/doc/files/ctan_lion_800.png | Bin 0 -> 152532 bytes macros/latex/contrib/media9/doc/files/cube.asy | 46 + macros/latex/contrib/media9/doc/files/cube.mp4 | Bin 0 -> 262653 bytes .../latex/contrib/media9/doc/files/cubeposter.png | Bin 0 -> 3462 bytes macros/latex/contrib/media9/doc/files/dice.u3d | Bin 0 -> 160672 bytes macros/latex/contrib/media9/doc/files/dice.vws | 26 + macros/latex/contrib/media9/doc/files/dice.wrl | 119 + macros/latex/contrib/media9/doc/files/epix.asy | 22 + macros/latex/contrib/media9/doc/files/epix.prc | Bin 0 -> 55043 bytes .../latex/contrib/media9/doc/files/epixposter.pdf | Bin 0 -> 111371 bytes macros/latex/contrib/media9/doc/files/malte.js | 42 + macros/latex/contrib/media9/doc/files/malte.u3d | Bin 0 -> 105696 bytes macros/latex/contrib/media9/doc/files/random.mp4 | Bin 0 -> 20206 bytes macros/latex/contrib/media9/doc/media9.pdf | Bin 0 -> 3748849 bytes macros/latex/contrib/media9/doc/media9.tex | 1284 +++++++++++ macros/latex/contrib/media9/javascript/3Dmenu.js | 854 +++++++ .../latex/contrib/media9/javascript/3Dspintool.js | 29 + .../latex/contrib/media9/javascript/animation.js | 116 + .../latex/contrib/media9/javascript/asylabels.js | 85 + macros/latex/contrib/media9/media9.sty | 2385 ++++++++++++++++++++ macros/latex/contrib/media9/pdfbase.sty | 1412 ++++++++++++ macros/latex/contrib/media9/players/APlayer.mxml | 429 ++++ macros/latex/contrib/media9/players/APlayer.swf | Bin 0 -> 354878 bytes macros/latex/contrib/media9/players/APlayer9.mxml | 417 ++++ macros/latex/contrib/media9/players/APlayer9.swf | Bin 0 -> 206165 bytes macros/latex/contrib/media9/players/BSD-License | 32 + macros/latex/contrib/media9/players/SMPfixes.patch | 158 ++ macros/latex/contrib/media9/players/SlideShow.mxml | 482 ++++ macros/latex/contrib/media9/players/SlideShow.swf | Bin 0 -> 326715 bytes .../media9/players/StrobeMediaPlayback-license | 5 + .../contrib/media9/players/StrobeMediaPlayback.swf | Bin 0 -> 275747 bytes macros/latex/contrib/media9/players/VPlayer.mxml | 338 +++ macros/latex/contrib/media9/players/VPlayer.swf | Bin 0 -> 483412 bytes macros/latex/contrib/media9/players/VPlayer9.mxml | 318 +++ macros/latex/contrib/media9/players/VPlayer9.swf | Bin 0 -> 219242 bytes 51 files changed, 9543 insertions(+) create mode 100644 macros/latex/contrib/media9/ChangeLog create mode 100644 macros/latex/contrib/media9/README.md create mode 100644 macros/latex/contrib/media9/doc/files/3dsystem.fig create mode 100644 macros/latex/contrib/media9/doc/files/3dsystem.pdf create mode 100644 macros/latex/contrib/media9/doc/files/3dsystem.tex create mode 100644 macros/latex/contrib/media9/doc/files/bird.mp3 create mode 100644 macros/latex/contrib/media9/doc/files/boutona.pdf create mode 100644 macros/latex/contrib/media9/doc/files/boutonb.pdf create mode 100644 macros/latex/contrib/media9/doc/files/boutonc.pdf create mode 100644 macros/latex/contrib/media9/doc/files/boutond.pdf create mode 100644 macros/latex/contrib/media9/doc/files/boutone.pdf create mode 100644 macros/latex/contrib/media9/doc/files/boutonf.pdf create mode 100644 macros/latex/contrib/media9/doc/files/config.xml create mode 100644 macros/latex/contrib/media9/doc/files/ctan_lion_1200.png create mode 100644 macros/latex/contrib/media9/doc/files/ctan_lion_200.png create mode 100644 macros/latex/contrib/media9/doc/files/ctan_lion_400.png create mode 100644 macros/latex/contrib/media9/doc/files/ctan_lion_800.png create mode 100644 macros/latex/contrib/media9/doc/files/cube.asy create mode 100644 macros/latex/contrib/media9/doc/files/cube.mp4 create mode 100644 macros/latex/contrib/media9/doc/files/cubeposter.png create mode 100644 macros/latex/contrib/media9/doc/files/dice.u3d create mode 100644 macros/latex/contrib/media9/doc/files/dice.vws create mode 100644 macros/latex/contrib/media9/doc/files/dice.wrl create mode 100644 macros/latex/contrib/media9/doc/files/epix.asy create mode 100644 macros/latex/contrib/media9/doc/files/epix.prc create mode 100644 macros/latex/contrib/media9/doc/files/epixposter.pdf create mode 100644 macros/latex/contrib/media9/doc/files/malte.js create mode 100644 macros/latex/contrib/media9/doc/files/malte.u3d create mode 100644 macros/latex/contrib/media9/doc/files/random.mp4 create mode 100644 macros/latex/contrib/media9/doc/media9.pdf create mode 100644 macros/latex/contrib/media9/doc/media9.tex create mode 100644 macros/latex/contrib/media9/javascript/3Dmenu.js create mode 100644 macros/latex/contrib/media9/javascript/3Dspintool.js create mode 100644 macros/latex/contrib/media9/javascript/animation.js create mode 100644 macros/latex/contrib/media9/javascript/asylabels.js create mode 100644 macros/latex/contrib/media9/media9.sty create mode 100644 macros/latex/contrib/media9/pdfbase.sty create mode 100644 macros/latex/contrib/media9/players/APlayer.mxml create mode 100644 macros/latex/contrib/media9/players/APlayer.swf create mode 100644 macros/latex/contrib/media9/players/APlayer9.mxml create mode 100644 macros/latex/contrib/media9/players/APlayer9.swf create mode 100644 macros/latex/contrib/media9/players/BSD-License create mode 100644 macros/latex/contrib/media9/players/SMPfixes.patch create mode 100644 macros/latex/contrib/media9/players/SlideShow.mxml create mode 100644 macros/latex/contrib/media9/players/SlideShow.swf create mode 100644 macros/latex/contrib/media9/players/StrobeMediaPlayback-license create mode 100644 macros/latex/contrib/media9/players/StrobeMediaPlayback.swf create mode 100644 macros/latex/contrib/media9/players/VPlayer.mxml create mode 100644 macros/latex/contrib/media9/players/VPlayer.swf create mode 100644 macros/latex/contrib/media9/players/VPlayer9.mxml create mode 100644 macros/latex/contrib/media9/players/VPlayer9.swf (limited to 'macros/latex/contrib/media9') diff --git a/macros/latex/contrib/media9/ChangeLog b/macros/latex/contrib/media9/ChangeLog new file mode 100644 index 0000000000..fe6b6348a5 --- /dev/null +++ b/macros/latex/contrib/media9/ChangeLog @@ -0,0 +1,520 @@ +2019-07-11 + * v1.02 : media9.sty + * v0.33 : pdfbase.sty + * fix : dvipdfmx warning about off-page annotation, occuring if + ocgbase.sty is loaded at the same time + +2019-05-24 + * v1.01 : media9.sty + * v0.32 : pdfbase.sty + * fix : pdfbase: \pbs_pdfdest:nnnn (luaTeX version) + +2019-05-17 + * v1.0 : media9.sty + * v0.31 : pdfbase.sty + * fix : pdfbase: missing expansion when writing label to + aux file (PDF dest, dvips) + +2019-05-15 + * v0.99 : media9.sty + * v0.30 : pdfbase.sty + * fix : pdfbase, dvipdfmx: missing space after dim expression in + \pbs_pdfxform:nnnnn + +2019-05-10 + * v0.98 : media9.sty + * v0.29 : pdfbase.sty + * fix : deprecated expl3 commands replaced + +2019-05-02 + * v0.97 : media9.sty + * v0.28 : pdfbase.sty + * new : pdfbase.sty: PDF Link destinations (doc level navigation) + +2019-02-21 + * v0.96 : media9.sty + * v0.27 : pdfbase.sty + * fix : pdfbase.sty: XeLaTeX run failure + +2019-02-19 + * v0.95 : media9.sty + * v0.26 : pdfbase.sty + * fix : media9.sty: box scaling fixed after recent expl3 update + * new: pdfbase.sty: basic dvisvgm support + +2019-01-02 + * v0.94 : media9.sty + * v0.25 : pdfbase.sty + * fix : merge request (latex3 end-2018 deprecations) + +2018-06-07 + * v0.93 : media9.sty + * v0.24 : pdfbase.sty + * fix : pdfbase.sty: many cs now def'ed as `protected'; adjustments after + migration to GitLab + +2018-04-06 + * v0.92 : media9.sty + * v0.23 : pdfbase.sty + * fix : pdfbase.sty: nesting level counter for `\pbs_pdfxform:nnnnn' in dvips mode + +2018-03-29 + * v0.91 : media9.sty + * v0.22 : pdfbase.sty + * fix : pdfbase.sty: allow nested `\pbs_pdfxform:nnnnn' in dvips mode + +2018-02-28 + * v0.90 : media9.sty + * v0.21 : pdfbase.sty + * fix : pdfbase.sty: `?pdfmark' code delayed to begin of document + * new: pdfbase.sty: adding \pbs_add_form_font: and \pbs_last_form_font: for + using embedded fonts in PDF Forms + +2018-01-18 + * v0.89 : media9.sty + * v0.20 : pdfbase.sty + * fix : pdfbase.sty: end-of-dvi improved; VPlayer.mxml: `autoPlay' issue fixed + +2018-01-16 + * v0.88 : media9.sty + * v0.19 : pdfbase.sty + * fix : pdfbase.sty: improving \pbs_at_end_dvi:n using `atbegshi' package + +2018-01-04 + * v0.87 : media9.sty + * fix : media9.sty: fixing `kernel/invalid-variant' warnings + +2017-09-29 + * v0.86 : media9.sty + * v0.18 : pdfbase.sty + * fix : pdfbase.sty: improving \pbs_pdfxform:nnnnn for dvips + * new: pdfbase.sty: \pbs_literal:nn (raw PDF/Postscript insertion) + +2017-08-25 + * v0.85 : media9.sty + * v0.17 : pdfbase.sty + * fix : fixing output routine in pdfbase.sty: small vertical offset of page + content when loading package ocgx2 + +2017-08-23 + * v0.84 : media9.sty + * v0.16 : pdfbase.sty + * fix : output routine adjustments (pdfbase.sty) + +2017-07-27 + * v0.83 : media9.sty + * fix : non-functional \mediabutton (broken in v. 0.81) + +2017-07-25 + * v0.82 : media9.sty + * fix : deprecated expl3 function \file_add_path:nN (two occurrences) replaced + with \file_get_full_name:nN + +2017-07-24 + * v0.81 : media9.sty + * v0.15 : pdfbase.sty + * fix : replace some \bool_if:n(TF) because of their new greedy behaviour + implemented in expl3 + +2017-06-12 + * v0.80 : media9.sty + * fix : obsolete l3regex warning + +2017-04-25 + * v0.79 : media9.sty + * v0.14 : pdfbase.sty + * fix: improved A-Reader-related workaround for annotations/links + located on OCGs + +2017-03-23 + * v0.78 : media9.sty + * v0.13 : pdfbase.sty + * fix: ocg-related improvements + +2017-03-16 + * v0.77 : media9.sty + * v0.12 : pdfbase.sty + * fix: PDF annotation and Form XObject producing macros improved + +2017-02-08 + * v0.76 : media9.sty + * fix: error in the caption of Fig. 8, documentation `media9.pdf' rebuilt + +2017-02-03 + * v0.75 : media9.sty + * fix: RTL related (luaTeX) + +2017-01-30 + * v0.74 : media9.sty + * fix: usability in righ-to-left typesetting context + +2017-01-24 + * v0.73 : media9.sty + * v0.13 : pdfbase.sty + * fix: pdfbase.sty: xform generation via dvips: rescale oversized boxes to + fit within papersize to prevent cropping + +2017-01-10 + * v0.72 : media9.sty + * v0.12 : pdfbase.sty + * fix: pdfbase.sty, media9.sty: `landscape' environment: + drivers XeTeX and dvipdfmx also supported + +2017-01-09 + * v0.71 : media9.sty + * v0.11 : pdfbase.sty + * fix: pdfbase.sty: support for `landscape' environment of + the pdflscape/lscape packages + +2016-11-08 + * v0.70 : media9.sty + * v0.10 : pdfbase.sty + * fix: pdfbase.sty & pdftex: sometimes, incorrect page ressources + for marked content were written when using \pbs_pdfbdc:nn; + reported by _FrnchFrgg_ + +2016-06-08 + * v0.69 : media9.sty + * v0.9 : pdfbase.sty + * fix: incompatibility with LuaTeX 0.95.0 + +2016-03-22 + * v0.68 : media9.sty + * v0.8 : pdfbase.sty + * fix: no more dependent on `l3regex.sty' + +2016-03-11 + * v0.67 : media9.sty + * v0.7 : pdfbase.sty + * fix: minor adjustments + +2016-03-07 + * v0.66 : media9.sty + * v0.6 : pdfbase.sty + * fix: minor adjustments of pdfbase.sty + +2016-02-25 + * v0.65 : media9.sty + * v0.5 : pdfbase.sty + * fix: fixing possible colour leaking of play button overlay + and of m-button faces; minor adjustments of pdfbase.sty + +2016-02-13 + * v0.64 : media9.sty + * v0.4 : pdfbase.sty, with minor fixes + * fix: fixing \pdfliteral for BDC/EMC insertion + +2016-01-29 + * v0.63 : media9.sty + * fix: adjusted `atendvi'-related warning message + +2016-01-12 + * v0.62 : media9.sty + * fix : xr-hyper/zref-ralated error + +2015-11-26 + * v0.61 : media9.sty, with minor fixes + +2015-11-23 + * v0.3 : pdfbase.sty, with minor fixes + +2015-11-02 + * v0.60 : media9.sty + * v0.2 : pdfbase.sty + * fix: improved compatibility with ocgbase.sty + +2015-10-28 + * v0.59 : media9.sty + * v0.1 : pdfbase.sty + * new: code restructured (new file pdfbase.sty with commands + for low-level access to PDF features); now using new ocgbase.sty + from ocgx2 + +2015-09-01 + * fix: recompiled VPlayer, APlayer, SlideShow, StrobeMediaPlayback + +2015-08-18 + * v0.58 + * fix: bug in SlideShow (measuring player dimensions for dyn. images) + +2015-07-30 + * v0.57 + * fix: `autoPlay' option of VPlayer didn't work reliably + +2015-07-28 + * v0.56 + * fix: expl3[2015/07/14]-related adjustments + +2015-07-20 + * v0.55 + * fix: expl3-related adjustments + +2015-06-23 + * v0.54 + * fix: flashing of videos when played in a loop + +2015-06-03 + * v0.53 + * New: `SlideShow.swf' with support added for dynamic resolution images + +2015-05-11 + * v0.52 + * New: `SlideShow.swf' (image gallery viewer for embedded and remote + live or static image files in the PNG, JPEG and GIF formats); right-click + context menu added to players APlayer.swf, VPlayer.swf, SlideShow.swf + +2015-03-11 + * v0.51 + * Fix: compatibility with `fixocgx' package + +2015-02-24 + * v0.50 + * Fix: minor code changes; reorganized TDS packaging + +2015-01-21 + * v0.49 + * Fix: some more OCG related code changes + +2014-10-20 + * v0.48 + * fix: minor code change related to AcroForm and OCProperties catalog entries + +2014-09-23 + * v0.47 + * new: `width', `height', `totalheight', `keepaspectratio', `scale' added as + package options; option `3Drender' accepts optional opacity values with + `Transparent' and `TransparentWireframe' values; new entries in the CROSSECT + section of 3D views: OPACITY, VISIBLE, INTERSECTIONVISIBLE, PLANECOLOR, + INTERSECTIONCOLOR for adjusting clipping plane appearance + +2014-08-06 + * v0.46 + * fix: compilation failure in `tabular' environment; replacing deprecated l3 + functions; wrong foreground/background binding of RM annots + +2014-06-25 + * v0.45 + * fix: transparency in media button faces drawn with TikZ/PGF didn't work when + using the dvipdfmx/xetex driver + * new: [AV]Player ActionScript methods `play' and `pause' take optional time + offsets, allowing for playing portions of the media file + * Change: `depth' option deprecated and ignored if used, added `totalheight' + and `keepaspectratio' options + +2014-06-04 + * v0.44 + * fix: prevent the play button from being printed to paper or exported to + other file formats + * new: global and command option `attachfiles' + +2014-03-25 + * v0.43 + * fix: bugs related to AcroForm and OCProperties catalog entries; + documenation + +2014-03-21 + * v0.42 + * change: refined look for the play button overlay + * fix: minor bugs + +2014-03-06 + * v0.41 + * new: poster text, if provided, also shown in draft mode (instead of draft + box) + * new: updated VPlayer with `autoRewind' setting via FlashVars + +2014-02-17 + * v0.40 + * new: play button visible in AR only + * new: updated APlayer and VPlayer with new exposed ActionScript functions + `currentTime', `duration', `playing', `muted' + +2014-02-06 + * v0.39 + * fix: improved compatibility with `animate' package + +2013-12-04 + * v0.38 + * fix: bugs in 3Dmenu + +2013-11-27 + * v0.37 + * fix: error in case of control sequence used in the last argument of + \includemedia + +2013-11-26 + * v0.36 + * fix: Postscript error with zero size media annotations + * change: updated 3Dmenu.js, transformation of mesh group nodes now possible + +2013-11-15 + * v0.35 + * new: play button overlay, can be disabled with new option `noplaybutton' + * change: updated media players + +2013-11-12 + * v0.34 + * fix: `bigfiles' option and really big files caused dvips error + +2013-11-04 + * new: media player Flash components VPlayer9.swf, APlayer9.swf added + for compatibility with the Flash Player 9 plugin that is bundled with + Adobe Reader 9.4.1 for Linux + +2013-09-24 + * v0.33 + * fix: Adobe Reader prompting for "save changes" on closing + +2013-09-06 + * v0.32 + * change: `bigfiles' package option no longer requires `-dNOSAFER' with + ps2pdf. + +2013-08-26 + * v0.31 + * fix: expl3 related fix for correct 3D views file processing + +2013-08-16 + * v0.30 + * change: update to current expl3 version + +2013-07-19 + * v0.29 + * change: minor improvements of media buttons + +2013-06-07 + * fix: VPlayer updated + +2013-06-06 + * fix: APlayer & VPlayer updated, all players recompiled using + ApacheFlexSDK-4.9.1 + +2013-06-03 + * v0.28 + * fix: updated APlayer.swf + * new: options `draft' and `final' for media bottons + +2013-03-27 + * new: APlayer displays ID3 tags (artist, song, album), if available + +2013-03-20 + * v0.26 + * new: specifier for floating window position on screen, default is centred + * v0.27 + * fix: package option `windowed' did not work + +2013-03-08 + * v0.25 + * change: VPlayer.swf with transparent background; floating media window + now centred + +2013-02-21 + * v0.24 + * change: option `url' now deprecated + +2013-02-12 + * v0.23 + * change: minor usability improvements + +2013-01-31 + * v0.22 + * new: user command \mediabutton for creating media control buttons + +2013-01-23 + * v0.21 + * fix: swf media inserted after a 3D object didn't work, reported by C. + Sturm + +2013-01-21 + * v0.20 + * new: `hideBar' option (FlashVar) for APlayer.swf + +2013-01-07 + * v0.19 + * fix: default window size calculation for floating media window + +2012-12-21 + * v0.18 + * new: playback in floating window; VPlayer.swf can be configured for + stepping mode + +2012-11-26 + * v0.17 + * change: updated APlayer.swf with transparent background; poster is now inserted + into the page content stream, not in the appearance dictionary + +2012-11-20 + * v0.16 + * fix: `transparent' option now working with Flash content, updated + StrobeMediaPlayback.swf (OSMF-2.0) + +2012-10-04 + * v0.15 + * fix: error in case of multiple use of `3Dviews' option + +2012-10-02 + * v0.14 + * new: keyboard control added to VPlayer.swf and APlayer.swf + +2012-09-12 + * v0.13 + * fix: cross section related bug in 3Dmenu.js + * fix: asylabels.js with improved label control (requires asymptote-2.17) + +2012-09-07 + * v0.12 + * new: command option `3Dpsob' and 3d views file entry `PSOB' added on + request of J. Bowman (Asymptote) + * fix: empty option list of \includemedia led to crash, improved Asymptote + compatibility + +2012-08-14 + * v0.11 + * new: package option `bigfiles' added which defers file embedding to the + ps->pdf step; needed when latex aborts with error `TeX capacity exceeded' + * fix: minor fixes in 3Dmenu.js and media9.sty + +2012-07-31 + * v0.9, v.10 + * fix: new l3fp infix syntax for calculations; deprecated expl3 functions + replaced + +2012-07-24 + * v0.8 + * fix: changed behaviour of \fp_use:N (l3fp package) caused failure; + opening 3D views file lead to error due to changed behaviour of + \ior_open:Nn (l3file package) + +2012-05-02 + * v0.7 + * new: 3Dpartsattrs added as package option + +2012-04-25 + * v0.6 + * new: command options added: 3Dpartsattrs, label; + updated APlayer and VPlayer versions with exposed ActionScript functions + for player control from JavaScript + +2012-04-16 + * v0.5 + * fix: option 3Dortho did not work, documentation update + +2012-04-12 + * v0.4 + * new: dependency on babel package removed; code contributed by + Enrico Gregorio + * fix: annotation box size calculation produced non-intuitive results + +2012-04-03 + * v0.3 + * fix: `deactivate' option did not work + * new: enhanced StrobeMediaPlayback.swf video player included + +2012-03-16 + * 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/macros/latex/contrib/media9/README.md b/macros/latex/contrib/media9/README.md new file mode 100644 index 0000000000..17b5f71a77 --- /dev/null +++ b/macros/latex/contrib/media9/README.md @@ -0,0 +1,49 @@ +# The `media9` LaTeX Package + +© 2012--`\today` Alexander Grahn + +https://gitlab.com/agrahn/media9 + +## 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, MP3 formats into PDF documents with Acrobat-9/X compatibility. Playback of multimedia files relies on Adobe Flash Player which 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 + +Recent versions of +* l3kernel (LaTeX package) +* l3packages (LaTeX package) +* Ghostscript or Adobe Distiller for PS to PDF conversion +* dvipdfmx for DVI to PDF conversion +* Adobe Reader + +## Installation + +MiKTeX and TeXLive users should run the package manager for installation. + +Otherwise, a manual install into the local TeX-Directory-Structure (TDS) root directory can be done along the following steps: + +1. Download the TDS compliant package file [`media9.tds.zip`](http://mirror.ctan.org/install/macros/latex/contrib/media9.tds.zip) + +2. Find the local TDS root directory 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](http://mirrors.ctan.org/macros/latex/base/lppl.txt). diff --git a/macros/latex/contrib/media9/doc/files/3dsystem.fig b/macros/latex/contrib/media9/doc/files/3dsystem.fig new file mode 100644 index 0000000000..e2273139db --- /dev/null +++ b/macros/latex/contrib/media9/doc/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/macros/latex/contrib/media9/doc/files/3dsystem.pdf b/macros/latex/contrib/media9/doc/files/3dsystem.pdf new file mode 100644 index 0000000000..4d09d34fc4 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/3dsystem.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/3dsystem.tex b/macros/latex/contrib/media9/doc/files/3dsystem.tex new file mode 100644 index 0000000000..6bd2ffa196 --- /dev/null +++ b/macros/latex/contrib/media9/doc/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/macros/latex/contrib/media9/doc/files/bird.mp3 b/macros/latex/contrib/media9/doc/files/bird.mp3 new file mode 100644 index 0000000000..c9bee679cd Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/bird.mp3 differ diff --git a/macros/latex/contrib/media9/doc/files/boutona.pdf b/macros/latex/contrib/media9/doc/files/boutona.pdf new file mode 100644 index 0000000000..7ba15d820d Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/boutona.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/boutonb.pdf b/macros/latex/contrib/media9/doc/files/boutonb.pdf new file mode 100644 index 0000000000..605076e407 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/boutonb.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/boutonc.pdf b/macros/latex/contrib/media9/doc/files/boutonc.pdf new file mode 100644 index 0000000000..adf016f955 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/boutonc.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/boutond.pdf b/macros/latex/contrib/media9/doc/files/boutond.pdf new file mode 100644 index 0000000000..a8170efa61 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/boutond.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/boutone.pdf b/macros/latex/contrib/media9/doc/files/boutone.pdf new file mode 100644 index 0000000000..a87b38d6fd Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/boutone.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/boutonf.pdf b/macros/latex/contrib/media9/doc/files/boutonf.pdf new file mode 100644 index 0000000000..b687d0aa2e Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/boutonf.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/config.xml b/macros/latex/contrib/media9/doc/files/config.xml new file mode 100644 index 0000000000..4da63bba34 --- /dev/null +++ b/macros/latex/contrib/media9/doc/files/config.xml @@ -0,0 +1,73 @@ + + + + + Mow-the-lawn simulation (live remote image). + http://1.618034.com/corner-icon.png + + + "An algorithm must be seen to be believed." (Donald E. Knuth) +Remote image URL with dynamic size that is reloaded while resizing the display. + https://openclipart.org/image/@@@@@px/svg_to_png/137407/1304882618.png + + + CTAN lion drawing by Duane Bibby. Thanks to www.ctan.org. +Remote image with URLs at various resolutions ("responsive image"). + + http://mirrors.ibiblio.org/CTAN/macros/latex/contrib/media9/doc/files/ctan_lion_200.png + + http://mirrors.ibiblio.org/CTAN/macros/latex/contrib/media9/doc/files/ctan_lion_400.png + + http://mirrors.ibiblio.org/CTAN/macros/latex/contrib/media9/doc/files/ctan_lion_800.png + + http://mirrors.ibiblio.org/CTAN/macros/latex/contrib/media9/doc/files/ctan_lion_1200.png + + + Static embedded image file with initial rotation of 3x90°. +Press "r" or "R" to change orientation. + files/cubeposter.png + + diff --git a/macros/latex/contrib/media9/doc/files/ctan_lion_1200.png b/macros/latex/contrib/media9/doc/files/ctan_lion_1200.png new file mode 100644 index 0000000000..2350a76c2b Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/ctan_lion_1200.png differ diff --git a/macros/latex/contrib/media9/doc/files/ctan_lion_200.png b/macros/latex/contrib/media9/doc/files/ctan_lion_200.png new file mode 100644 index 0000000000..318c3f0a55 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/ctan_lion_200.png differ diff --git a/macros/latex/contrib/media9/doc/files/ctan_lion_400.png b/macros/latex/contrib/media9/doc/files/ctan_lion_400.png new file mode 100644 index 0000000000..167b806a02 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/ctan_lion_400.png differ diff --git a/macros/latex/contrib/media9/doc/files/ctan_lion_800.png b/macros/latex/contrib/media9/doc/files/ctan_lion_800.png new file mode 100644 index 0000000000..8090059600 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/ctan_lion_800.png differ diff --git a/macros/latex/contrib/media9/doc/files/cube.asy b/macros/latex/contrib/media9/doc/files/cube.asy new file mode 100644 index 0000000000..606375763d --- /dev/null +++ b/macros/latex/contrib/media9/doc/files/cube.asy @@ -0,0 +1,46 @@ +import math; +import bsp; +import animation; + +size(100,100); + +animation a; + +void face(face[] faces, path3 p, int j, int k) { + picture pic=faces.push(p); + filldraw(pic,project(p),Pen(j)); + int sign=(k % 2 == 0) ? 1 : -1; + transform t=scale(4)*transform(dir(p,0,sign),dir(p,0,-sign)); + label(pic,t*(string) j,project(0.5*(min(p)+max(p)))); +} + +void snapshot(transform3 t) +{ + static transform3 s=shift(-0.5*(X+Y+Z)); + save(); + + face[] faces; + int j=-1; + transform3 T=t*s; + for(int k=0; k < 2; ++k) { + face(faces,T*plane((1,0,0),(0,1,0),(0,0,k)),++j,k); + face(faces,T*plane((0,1,0),(0,0,1),(k,0,0)),++j,k); + face(faces,T*plane((0,0,1),(1,0,0),(0,k,0)),++j,k); + } + add(faces); + + a.add(); + restore(); +} + +int n=50; + +real step=360/n; +for(int i=0; i < n; ++i) + snapshot(rotate(i*step,X)); +for(int i=0; i < n; ++i) + snapshot(rotate(i*step,Y)); +for(int i=0; i < n; ++i) + snapshot(rotate(i*step,Z)); + +a.movie(loops=1,delay=50); diff --git a/macros/latex/contrib/media9/doc/files/cube.mp4 b/macros/latex/contrib/media9/doc/files/cube.mp4 new file mode 100644 index 0000000000..cbd115b211 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/cube.mp4 differ diff --git a/macros/latex/contrib/media9/doc/files/cubeposter.png b/macros/latex/contrib/media9/doc/files/cubeposter.png new file mode 100644 index 0000000000..ae57869756 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/cubeposter.png differ diff --git a/macros/latex/contrib/media9/doc/files/dice.u3d b/macros/latex/contrib/media9/doc/files/dice.u3d new file mode 100644 index 0000000000..ae14b756a1 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/dice.u3d differ diff --git a/macros/latex/contrib/media9/doc/files/dice.vws b/macros/latex/contrib/media9/doc/files/dice.vws new file mode 100644 index 0000000000..ef77a276fe --- /dev/null +++ b/macros/latex/contrib/media9/doc/files/dice.vws @@ -0,0 +1,26 @@ +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=Bottom + ROO=27 + C2C=0 0 -1 +END +VIEW=Fish Eye at Centre + AAC=130 +END diff --git a/macros/latex/contrib/media9/doc/files/dice.wrl b/macros/latex/contrib/media9/doc/files/dice.wrl new file mode 100644 index 0000000000..23b1ef92a2 --- /dev/null +++ b/macros/latex/contrib/media9/doc/files/dice.wrl @@ -0,0 +1,119 @@ +#VRML V1.0 ascii + +# dice.wrl +# based on the work of +# Peter Whitehouse +# 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/macros/latex/contrib/media9/doc/files/epix.asy b/macros/latex/contrib/media9/doc/files/epix.asy new file mode 100644 index 0000000000..60720aaba0 --- /dev/null +++ b/macros/latex/contrib/media9/doc/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/macros/latex/contrib/media9/doc/files/epix.prc b/macros/latex/contrib/media9/doc/files/epix.prc new file mode 100644 index 0000000000..99e33eed23 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/epix.prc differ diff --git a/macros/latex/contrib/media9/doc/files/epixposter.pdf b/macros/latex/contrib/media9/doc/files/epixposter.pdf new file mode 100644 index 0000000000..92506d1092 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/epixposter.pdf differ diff --git a/macros/latex/contrib/media9/doc/files/malte.js b/macros/latex/contrib/media9/doc/files/malte.js new file mode 100644 index 0000000000..4d019e43a6 --- /dev/null +++ b/macros/latex/contrib/media9/doc/files/malte.js @@ -0,0 +1,42 @@ +crank=this.scene.nodes.getByName("manivelle-1-1"); +cross=this.scene.nodes.getByName("croix-1-1"); + +function cntrClockWise(){dir=1; speed=lastspeed;} +function pause(){if(speed)lastspeed=speed; speed=0;} +function clockWise(){dir=-1; speed=lastspeed;} +function scaleSpeed(s){lastspeed*=s; if(speed) speed=lastspeed;} +function origSpeed(){lastspeed=1; if(speed) speed=lastspeed;} + +Ocrank=new Vector3(-0.025, 0, 0); +Ocross=new Vector3(0.025, 0, 0); + +axeZ=new Vector3(0,0,1); +mx4x4=new Matrix4x4(); + +var omega0=Math.PI; // init. angular frequency (half turn per second) +var dir=1; // init. direction +var speed=0; // speed multiplier +var lastspeed=1; +var alpha=0; + +timeEvHnd=new TimeEventHandler(); +timeEvHnd.onEvent=function(event) { + var dalpha=dir*speed*omega0*event.deltaTime; + if (dalpha!=0){ + mx4x4.setIdentity(); + mx4x4.rotateAboutLineInPlace(alpha,Ocrank,axeZ); + crank.transform.set(mx4x4); + with (Math){ + if (alpha<3*PI/2) beta=0; + else beta=-atan(sin(alpha+PI/4)/(sqrt(2)-cos(alpha+PI/4)))+PI/4; + } + mx4x4.setIdentity(); + mx4x4.rotateAboutLineInPlace(beta,Ocross,axeZ); + cross.transform.set(mx4x4); + alpha+=dalpha+2*Math.PI; + alpha%=2*Math.PI; + scene.update(); + } +} + +runtime.addEventHandler(timeEvHnd); diff --git a/macros/latex/contrib/media9/doc/files/malte.u3d b/macros/latex/contrib/media9/doc/files/malte.u3d new file mode 100644 index 0000000000..d4ea72aaa3 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/malte.u3d differ diff --git a/macros/latex/contrib/media9/doc/files/random.mp4 b/macros/latex/contrib/media9/doc/files/random.mp4 new file mode 100644 index 0000000000..36be0388e9 Binary files /dev/null and b/macros/latex/contrib/media9/doc/files/random.mp4 differ diff --git a/macros/latex/contrib/media9/doc/media9.pdf b/macros/latex/contrib/media9/doc/media9.pdf new file mode 100644 index 0000000000..fccdfd98a5 Binary files /dev/null and b/macros/latex/contrib/media9/doc/media9.pdf differ diff --git a/macros/latex/contrib/media9/doc/media9.tex b/macros/latex/contrib/media9/doc/media9.tex new file mode 100644 index 0000000000..628384f736 --- /dev/null +++ b/macros/latex/contrib/media9/doc/media9.tex @@ -0,0 +1,1284 @@ +% Copyright 2012--\today Alexander Grahn +% +% This material is subject to the LaTeX Project Public License. See +% http://mirrors.ctan.org/macros/latex/base/lppl.txt +% for the details of that license. +% +%\pdfcompresslevel=0 +%\pdfobjcompresslevel=0 +\listfiles +\documentclass[a4paper]{article} +\frenchspacing +\usepackage[utf8]{inputenc} +\usepackage{textcomp} +\usepackage[attachfiles]{media9} +%\usepackage[draft]{media9} +\usepackage{animate} +\usepackage{fancyvrb} +\usepackage{float} +\usepackage{amssymb} +\usepackage[UKenglish]{babel} +\usepackage{graphicx} +\usepackage{color} +\usepackage[T1]{fontenc} +%\usepackage{lmodern} +%\usepackage[scaled=0.85]{luximono} + \usepackage[tt=false]{libertine} %override beramono (doesn't look like tt font) + \usepackage[libertine]{newtxmath} +% \usepackage[scaled=0.83]{luximono} %override beramono (doesn't look like tt font) +\usepackage{microtype} +%\usepackage{float} +\usepackage{parskip} +\usepackage{tabls} +\usepackage{menukeys} +\usepackage{hyperref} +\usepackage{hypcap} +\def\keywords{embed flash movie LaTeX pdf 3d include sound swf mp3 video mp4 h.264 aac slideshow image gallery flv audio multimedia streamed media rtmp YouTube animation JavaScript pdfLaTeX dvips ps2pdf dvipdfmx XeLaTeX u3d prc Adobe Reader Foxit RichMedia annotation LuaLaTeX} +\hypersetup{ + bookmarksnumbered,linktocpage,breaklinks, + pdftitle={The media9 Package}, + pdfsubject={Documentation}, + pdfauthor={Alexander Grahn}, + pdfkeywords={\keywords}, + allcolors=blue +} +\usepackage[ocgcolorlinks]{ocgx2} + +%\usepackage{listings} +\usepackage{minted} + +\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{\keyshift} +\newsavebox{\spacebar} +\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 + +\def\parsedate#1/#2/#3\relax{ + \def\year{#1} + \def\month{#2} + \def\day{#3} +} +\usepackage{siunitx} + +\begin{document} +\makeatletter +%\title{The {\sffamily media9} Package\\Version \g@mix@version@tl} +\title{The {\sffamily media9} Package, v\g@mix@version@tl} +\expandafter\parsedate\g@mix@date@tl\relax %set current date to package date +\makeatother +\author{Alexander Grahn\\[1ex]\hypersetup{breaklinks=false}\url{https://gitlab.com/agrahn/media9}\hypersetup{breaklinks=true}} +\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 Adobe Reader-9/X compatibility.\\[0.2\baselineskip] +\begin{sloppypar}\foreignlanguage{nohyphenation}{\noindent\emph{Keywords}: \keywords}\end{sloppypar} +\end{abstract} + +\tableofcontents + +\section{Introduction} +This package provides an interface to embed, in the first place, interactive Flash (SWF) and 3D objects (Adobe U3D \& PRC) into PDF documents. Video and audio files or streams in the popular MP4, FLV and MP3 formats can be embedded as well. However, a media player Flash component is required for playback, as will be explained shortly. Playback of multimedia files uses Adobe Flash Player, which was bundled with Adobe Reader 9 and 10 versions. Unfortunately, beginning with Adobe Reader 11, it must be installed as a separate plug-in. + +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 `StrobeMediaPlayback.swf'~\cite{strobe}, maintained by Adobe and hosted on \href{http://sourceforge.net/projects/osmf.adobe/files/}{SourceForge.net}. Package `media9' comes with an enhanced version of `StrobeMediaPlayback.swf'. In addition, two simple players for video and audio, `VPlayer.swf' and `APlayer.swf' are included, which can be used instead. They provide sufficient functionality for playing embedded files and streamed media. + +There is yet another player bundled with `media9'. It is a simple image gallery viewer called `SlideShow.swf' which can display collections of embedded and remote images in the PNG, JPEG and GIF file formats. Remote images are downloaded at viewing time and can be configured to be refreshed at definite time intervals. + +Flash Player supports the efficient H.264 codec for video compression. MP4/H.264 video files can be encoded from existing video files and from numbered bitmap sequences using the \verb+ffmpeg+ (\url{http://ffmpeg.org}) or \verb+avconv+ (\url{http://libav.org}) command line tools (Libav is a fork from the FFmpeg code). In order to allow for precise seeking within video files it is necessary to encode them with a sufficient number of key frames. The command line for recoding an existing video file \verb+video.avi+ into \verb+video.mp4+ reads (one line; \verb+ffmpeg+ can be substituted with \verb+avconv+) +\begin{center} +\begin{Verbatim} + ffmpeg -i video.avi -vf scale="trunc(iw/2)*2:trunc(ih/2)*2" + -c:v libx264 -profile:v high -pix_fmt yuv420p + -g 30 -r 30 video.mp4 +\end{Verbatim} +\end{center} +From a sequence \verb+frame-0.png+, \verb+frame-1.png+, ... of bitmap files, an MP4 video is produced by +\begin{Verbatim} + ffmpeg -i frame-%d.png -vf scale="trunc(iw/2)*2:trunc(ih/2)*2" + -c:v libx264 -profile:v high -pix_fmt yuv420p + -g 30 -r 30 video.mp4 +\end{Verbatim} +Both examples insert a key frame (option `\verb+-g+') at every second since the frame rate is set to 30 fps. The video encoder requires even pixel numbers in both dimensions which is ensured by adding `\verb+-vf scale="..."+' to the option list. + +\emph{Note:} `media9' package replaces the now obsolete `movie15' package. `media9' is based on the RichMedia Annotation (Annotations are the interactive elements in a document, in PDF specification parlance.), 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 third-party plug-ins and which does not support recent media file formats. + +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. PDF documents which target \href{ftp://ftp.adobe.com/pub/adobe/reader/unix/9.x/9.4.1/}{Adobe Reader 9.4.1 for Linux} should use `VPlayer9.swf' and `APlayer9.swf' (also included in the `media9' package). These media player components are compatible with the older Flash Player 9 plugin that is bundled with the Reader for Linux. Recent versions of Foxit PDF Reader, which is available on the Windows platform, are known to render embedded Flash, video and audio content. Foxit also uses Adobe Flash Player plugin. On tablets and phones running Android or iOS, ezPDF Reader was reported to play video and sound files embedded with `media9'. + +\section{Requirements} +\begin{trivlist} +\item l3kernel (\LaTeX{} package), version $\ge \ExplFileDate$ +\item pdf\TeX{}, version $\ge1.40$ +\item Ghostscript, version $\ge9.15$, or Adobe Distiller for PS to PDF conversion +\item dvipdfmx, version $\ge 20190503$ for DVI to PDF conversion +\item Adobe Reader, version $\ge9$, but not greater than 9.4.1 on Linux; Foxit Reader (Flash, video, audio) +\item Adobe Flash Player plugin for Firefox +\end{trivlist} + +\section{Installation} +MiK\TeX{} and \TeX{}Live users should run the package manager for installation and updates. + +Otherwise, a manual installation into the \emph{local} TeX-Directory-Structure (TDS) root directory is done along the following steps: +\begin{enumerate} + \item Download the TDS compliant package file `\href{http://mirror.ctan.org/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 \TeX{}Live package manager. + \item Unzip `\verb+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[]{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 +bigfiles +draft +final +playbutton=... +noplaybutton +activate=... +deactivate=... +windowed=... +transparent +passcontext +attachfiles +3Dplaytype=... +3Dplaycount=... +3Dplayspeed=... +3Dtoolbar +3Dnavpane +3Dpartsattrs=... +3Dmenu +3Dbg=... +3Dlights=... +3Drender=... +\end{verbatim} +Except for `\verb+dvipdfmx+', `\verb+xetex+' and `\verb+bigfiles+', 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 the case of \verb+dvipdfmx+, package option `\verb+dvipdfmx+' is mandatory because it cannot be auto-detected. + +\begin{animateinline}[autoplay,loop,nomouse]{1}\strut\emph{Important:}\newframe[3]\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. + + Option `\verb+bigfiles+' is only relevant for the \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+ workflow. It may be needed if large media files cause \verb+latex+ to abort with error `\Verb+TeX capacity+ \Verb+exceeded+'. See Sect.\ \ref{bugs}.\enlargethispage{2\baselineskip} + + +\section{The user interface} +Package `media9' provides commands for media inclusion (\verb+\includemedia+) and insertion of media control buttons (\verb+\mediabutton+). The latter is introduced in Sect. \ref{mbtn}. + +\subsection{Media inclusion} +\begin{verbatim} +\includemedia[]{}{ +
} +\end{verbatim} + +The last argument, \verb+
+, is the main interactive application to be inserted into the PDF. In the case of Flash, this can be a local SWF file, or a URL, such as a YouTube video player. 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. A URL must be fully qualified, i.\,e., starting with either `\verb+http[s]://+' or `\verb+ftp://+'. 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 the 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++ defines the size of the rectangular region of the document page in which the media will be displayed. Moreover, \verb++ will be shown in case the media has not been activated. +%(Internally, \verb++ 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++ 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++ can be left blank in which case the size of the media rectangle should be set with options `\verb+width+' and `\verb+height+'. If a non-zero size \verb++ was provided, it can be resized using any combination of options `\verb+width+', `\verb+height+' or `\verb+totalheight+', `\verb+keepaspectratio+' and `\verb+scale+'. + +A list of directories where \TeX{} searches for media and resource files can be set-up by means of +\begin{verbatim} +\addmediapath{} +\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. + +\subsection{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} +label=