diff options
Diffstat (limited to 'Master/texmf-dist/doc')
16 files changed, 1827 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/movie15/README b/Master/texmf-dist/doc/latex/movie15/README new file mode 100644 index 00000000000..da337288db3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/README @@ -0,0 +1,371 @@ + ===================== + The movie15 Package + ===================== + +Author: + + Alexander Grahn + + +Description: + + * + * Note: + * This package is obsolete now. Consider using package `media9'. + * + + This package provides an interface to embed movies, sounds and 3D objects + into PDF documents for use with LaTeX as well as pdfLaTeX. It follows the + PDF-1.5 and PDF-1.6 specifications for embedding multimedia content. The + specification allows media file data to be completely incorporated into the + PDF output, thus producing self-contained PDF documents. A number of file + formats is supported. For a (possibly incomplete) list see the table at the + end of this file or refer to the PDF specification: + + PDF Reference, fifth edition: + Adobe Portable Document Format version 1.6, + Implementation note 144, Appendix H.3, + + available somewhere on Adobe's web site (http://www.adobe.com). + + Note, this file only gives a summary of usage and available command + options. Please refer to the documentation `movie15.pdf' in the `doc/' + directory for details and examples. + + Keywords: embed, movie, LaTeX, pdfLaTeX, PDF, 3D, JavaScript, include, + sound, video, multimedia, animation + + +Usage: + + \usepackage[<package options>]{movie15} + + Package option `3D' enables the 3D feature from the PDF-1.6 specification. + With option `draft' media files are not included. Instead, the file name + is printed in a box of size <width>x(<height>+<depth>). `final' does the + opposite, overriding a global draft option specified in the \documentclass + command. + + + \includemovie[<options>]{<width>}{<height>}{<media file>} + + <width> and <height> in TeX dimensions, may be left empty, see option `text' + + <media file> file name of the media clip + + + \movieref[<options>]{<label spec>}{<text>} + + makes <text> a hyperlink to the embedded media file which has been labelled + with <label spec> using the `label' option of the inclusion command. + + Provides a means to control the playback state and properties of the + referenced media. In 3D context, it can be used to define an additional view + of the object, to access a particular view from the list of predefined views + by index or to run a JavaScript. Moreover, links can be created for + calculating 3D camera settings. + + In addition to `play' (default), `stop', `resume', `pause', `close', + `3Dviewindex', `3Dcalculate' and `3Dgetview' it accepts `controls', `repeat', + `palindrome', `startat', `endat', `mouse', `rate', `volume', `default', + `3Dcoo', '3Droll', `3Dc2c', `3Droo', `3Dcaa' and `3Djscript' from the + subsequent list of command options. + + + Options: + + attach[=false] By default, the embedded data stream is re-used as + embedded file attachment, giving the user the + opportunity to extract the media file and to save + it to disk for later playback with an external + player. Re-use as file attachment can be + suppressed with `attach=false'. + + autoclose Close the media player when the page is closed. + Use of this option may be necessary for streamed + media, such as Real Video. + + autopause Pause playback when page is closed. + + autoplay Start playback when page is opened. Useful for + side by side movies to be played back + simultaneously. + + autostop Stops playing but keeps the media loaded when the + page is closed. The media is rewound to its + beginning or its `startat' position. This option + is set by default if neither of the options + `autopause', `autoclose' or `continue' is set. + + autoresume Resume previously paused playback when page + is opened. + + continue Continue playback in background on premature page + change. + + controls[=true|false] Display player specific controls. + + depth=<depth> Specifies how far the media display area should + extend below the reference line of the running + text. Any valid TeX dimension will be accepted. + + draft Locally switches to draft mode. + + externalviewer Opens and plays the media in an external + application. + + final Locally disables draft mode. + + inline[=false] Movie file data are embedded into the PDF output + by default. Embedding can be suppressed using + `inline=false'. + + label=<label spec> The media is labelled with <label spec> such that + it can be referenced by the `\movieref' command + somewhere else in the document. + + mimetype=<mimetype> Mime type of media. Must be specified if + <media file> has a non-standard file name + extension from which the mimetype cannot be + guessed. See table `Known file name extensions' + below. + + mouse[=true|false] Enable mouse interaction: Clicking onto the media + (giving it the focus) pauses the playback while + clicking outside resumes it. In 3D context this + option is set to `true' by default, but may be set + to `false' in order to make the 3D annotation + non-interactive. + + palindrome[=true|false] Play media forward and backward. + + playerid=<playerid> Forces a particular media player plug-in to be + used instead of the default one. Currently, the + following values are recognised: + AAPL_QuickTime, MACR_FlashPlayer, RNWK_RealPlayer, + MSFT_WindowsMediaPlayer, ADBE_MCI (Adobe builtin + player). + + poster The first frame of the movie or the frame at the + beginning of the movie section specified by the + `startat' and `endat' options is shown. + + poster=<image> Insert still image from file to be shown when + media is not activated. The file type depends on + the output driver: PS or EPS when using latex + together with dvips; PDF, PNG or JPEG when using + pdflatex. + + Deprecated. Use option `text' instead. + + See option `text' for a possibility to scale the + media display area according to the poster image + dimensions. + + rate=<rate> Playback rate (multiple of original speed). + + repeat[=<repeats>] Number of repeats. Without argument -> repeat + forever. + + startat=<offset> Start/stop playback at the specified offsets + endat=<offset> (time, frame, named marker). <offset> syntax: + + time:<seconds> + frame:<frame number> + marker:<quoted string> + {marker:<quoted string>, time:<seconds>} + {marker:<quoted string>, frame:<frame number>} + + text=<text> <text> is typeset onto the media display area. + <text> is centred horizontally and vertically. + If either or both of the <width> and <height> + arguments are left empty, any unspecified + dimension of the media clip is scaled to fit the + corresponding dimension, i. e. width or height, of + <text>. Likewise, the depth of the media display + is adjusted to the depth of <text> if the `depth' + option has not been given. + + This option can be used to scale the media display + area to the natural or scaled dimensions of the + poster image, e. g.: + + \includemovie[text={\includegraphics[scale=2]{ + path/to/poster}}]{}{}{path/to/movie} + + textoverposter[=false] Set this option to `false' if you wish <text> to + be obscured by the external poster image (if + specified). Deprecated. + + url Treat <media file> as URL. Sets option `inline' + to false automatically. + + volume=<volume> Percentage of original volume. + + 3Daac=<angle> This option sets the aperture angle of the camera, + measured in degrees. Fixed 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. + + 3Dc2c=<x> <y> <z> Direction vector C2C of arbitrary length, + originating in the centre of orbit and pointing + to the virtual camera; cf. option `3Dcoo' for the + number format of <x> <y> <z>. + + 3Dcoo=<x> <y> <z> Positional vector COO of the centre of orbit. + Only fixed point numbers in the range from + -999999999999999999.999999999999999999 to + +999999999999999999.999999999999999999 are + allowed. + + 3Droll=<roll> Prescribes an initial camera roll around the + optical axis (in clockwise direction, if <roll> + is greater than zero); measured in degrees. + + 3Droo=<r> Radius of orbit ROO of the virtual camera; cf. + option `3Dcoo' for the number format. + + 3Dviews=<views file> Further named, predefined views can be set in an + auxiliary file specified by the 3Dviews option. + The file <views file> contains lines which obey + the syntax: + +[<name>]{<coo_x> <coo_y> <coo_z>}{<c2c_x> <c2c_y> <c2c_z>}{<roo>}{<roll>}{<aac>} + + The <name> entry is optional. For <coo_x>, + <coo_y>, <coo_z>, <c2c_x>, <c2c_y>, <c2c_z>, <roo> + and <aac> the same rules as for the corresponding + options `3Dcoo', `3Dc2c', `3Droo' and `3Daac' + apply. + + 3Dbg=<r> <g> <b> This option sets the background colour of the + canvas. Only fixed point real numbers in the range + from 0 to 1 are allowed for the colour components. + + 3Dlights=<lighting scheme> Sets the default lighting scheme. Possible values + are: `None', `White', `Day', `Night', `Hard', + `Primary', `Blue', `Red', `Cube', `CAD', + `HeadLamp'. + + 3Drender=<render mode> Sets the default render mode. Possible values + are: `Solid', `SolidWireframe', `Transparent', + `TransparentWireframe', `BoundingBox', + `TransparentBoundingBox', + `TransparentBoundingBoxOutline', `Wireframe', + `ShadedWireframe', `HiddenWireframe', `Vertices', + `ShadedVertices', `Illustration', `SolidOutline', + `ShadedIllustration'. + + 3Djscript=<JavaScript file> Things like animation, lighting, background + colour etc. may also be script driven. Option + `3Djscript' associates a <JavaScript file> with + the 3D object. The script will be executed upon + activation of the object. + + 3Dresource=<resource file 1>[, 3Dresource=<resource file 2> [, ...]] + + Embeds additional 3D or rasterized image files for + use as resources in the 3D annotation. Possible + file types are U3D, Postscript (LaTeX + dvips) and + PDF/JPEG/PNG (pdfLaTeX). Embedded resources must + be loaded by the JavaScript method + + Resource("pdf://<resource path>") + + where <resource path> stands for the path to the + resource file as specified by the `3Dresource' + option. + + Additional options for use with `\movieref': + + play (Default) Immediately restarts playback. If new + playback settings have been specified through the + options given above, they override the original + settings being in effect during media inclusion. + + stop Stops and rewinds the media to its beginning or to + the `startat' position. + + resume Resumes paused media. In fact, this option makes + the hyperlink a toggle switch: repeated clicking + switches between paused and resumed state. + + pause Has the same effect as option `resume'. Added for + completeness only. + + close Immediately closes the media player. + + default Play the media at the original settings which were in + effect during media inclusion. + + 3Dviewindex=<index> Opens the first `F', last `L', next `N' or + previous `P' view from the list of additional + views, or the one indexed by an integer. `D' gives + access to the default view. + + 3Dcalculate[=<aac angle>] Creates a link for calculating `3Droo' and `3Dcoo' + settings of the virtual camera. The default + aperture angle of 30 degrees is used for the + calculation unless an optional <aac angle> has + been provided. + + 3Dgetview Camera settings corresponding to the current view + in the Reader are printed to a dialogue box. The + output is readily formatted to be inserted into a + file of predefined views, see option `3Dviews'. + + +Known file name extensions: + + Extension MIME type Description + ============================================================================= + aif, aifc, aiff audio/aiff Audio Interchange File + Format + au, snd audio/basic NeXT/Sun Audio Format + avi video/avi AVI (Audio/Video Inter- + leaved) + gif image/gif (animated) GIF + mid, rmi audio/midi MIDI (Musical Instrument + Digital Interface) + mov, qt video/quicktime Apple QuickTime + mp3, m3u audio/x-mp3 MPEG Audio Layer-3 + mp4 video/mp4 MPEG-4 Video/Audio + mpeg, mpg video/mpeg MPEG-1 & 2 Video + ra audio/vnd.rn-realaudio Real Audio + rm, rv application/vnd.rn-realmedia Real Media (video & sound) + smil application/smil Synchronized Multimedia + Integration Language + swf application/x-shockwave-flash (Adobe?) Macromedia Flash + u3d model/u3d Universal 3D File Format + wav audio/wav MS Audio Format + wma audio/x-ms-wma Windows Media Audio Format + wmv video/x-ms-wmv Windows Media Video Format + + +Requirements: + + package `fp', if option `3D' is selected + + pdfTeX, version >= 1.20 needed for PDF output + + Adobe Reader, version >=6 for playing movies/sound, + Adobe Reader, version >=7 for 3D objects + + Embedded media file data can also be extracted and saved to disk from within + Readers which support file attachments. This makes PDF documents a little more + portable to Readers which do not ship with a multimedia plugin. + + +Installation: + + Put the file movie15.sty to a place where TeX can find it. + + +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/movie15/files/3dsystem.fig b/Master/texmf-dist/doc/latex/movie15/files/3dsystem.fig new file mode 100644 index 00000000000..e2273139db8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/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/movie15/files/3dsystem.pdf b/Master/texmf-dist/doc/latex/movie15/files/3dsystem.pdf Binary files differnew file mode 100644 index 00000000000..998f4b622d8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/files/3dsystem.pdf diff --git a/Master/texmf-dist/doc/latex/movie15/files/3dsystem.tex b/Master/texmf-dist/doc/latex/movie15/files/3dsystem.tex new file mode 100644 index 00000000000..d2e23ceac73 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/files/3dsystem.tex @@ -0,0 +1,29 @@ +\begin{picture}(0,0)% +\includegraphics[clip, scale=1, viewport=0 3 433 424]{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}(6873.43196911197,6682.94424710425)(435,-6534.37806949807)% +\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/movie15/files/dice.u3d b/Master/texmf-dist/doc/latex/movie15/files/dice.u3d Binary files differnew file mode 100644 index 00000000000..ae14b756a16 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/files/dice.u3d diff --git a/Master/texmf-dist/doc/latex/movie15/files/dice.vws b/Master/texmf-dist/doc/latex/movie15/files/dice.vws new file mode 100644 index 00000000000..3b1bd9a7a4b --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/files/dice.vws @@ -0,0 +1,23 @@ +VIEW={Front} + %using defaults for COO, C2C, ROLL and AAC + 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/movie15/files/dice.wrl b/Master/texmf-dist/doc/latex/movie15/files/dice.wrl new file mode 100644 index 00000000000..23b1ef92a26 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/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/movie15/files/mailto.png b/Master/texmf-dist/doc/latex/movie15/files/mailto.png Binary files differnew file mode 100644 index 00000000000..12831c2410b --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/files/mailto.png diff --git a/Master/texmf-dist/doc/latex/movie15/files/random.mpg b/Master/texmf-dist/doc/latex/movie15/files/random.mpg Binary files differnew file mode 100644 index 00000000000..368cd368b6d --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/files/random.mpg diff --git a/Master/texmf-dist/doc/latex/movie15/javascript/animation.js b/Master/texmf-dist/doc/latex/movie15/javascript/animation.js new file mode 100644 index 00000000000..f0789891f44 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/javascript/animation.js @@ -0,0 +1,100 @@ +///////////////////////////////////////////////////////////////// +// +// animation.js +// +// JavaScript for use with `3Djscript' option of \includemovie +// +// * Activates keyframe animation embedded in the u3d file. +// * Arrow keys `Down', `Up' can be used for speeding up and +// slowing down a running animation, key `Home' for reverting +// to the default speed. +// +// * Adjustable parameters: +var rate = 1; // 1 --> use original speed as default +var palindrome = true; // true --> play forth and back +// +///////////////////////////////////////////////////////////////// + +//get the first animation in the scene +var myAnim = scene.animations.getByIndex(0); +myAnim.wallTime = 0; +myAnim.speed = 1; +myAnim.myLength = myAnim.endTime - myAnim.startTime; +scene.activateAnimation(myAnim); + +//method to set animation speed +myAnim.setSpeed = function (speed) { + speed = Math.abs(speed); + this.wallTime /= speed/this.speed; //correct the walltime + this.speed = speed; +}; + +//method to change animation speed by a factor +myAnim.changeSpeed = function (mult) { + this.wallTime /= mult; //correct the walltime + this.speed *= mult; +}; + +//set default speed +myAnim.setSpeed(rate); + +//menu items +runtime.addCustomMenuItem("faster", "Faster (Key Up)", "default", 0); +runtime.addCustomMenuItem("slower", "Slower (Key Down)", "default", 0); +runtime.addCustomMenuItem("default", "Default Speed (Key Home)", "default", 0); + +//menu handler to control speed +menuEventHandler = new MenuEventHandler(); +menuEventHandler.onEvent = function(e) { + if (e.menuItemName == "faster") { + myAnim.changeSpeed(1.25); + } + else if (e.menuItemName == "slower") { + myAnim.changeSpeed(1/1.25); + } + else if (e.menuItemName == "default") { + myAnim.setSpeed(rate); + } +}; +runtime.addEventHandler(menuEventHandler); + +//key handler to control speed +keyEventHandler = new KeyEventHandler(); +keyEventHandler.onKeyDown = true; +keyEventHandler.onEvent = function(e) { + switch(e.characterCode) { + case 30: //key up + myAnim.changeSpeed(1.05); + break; + + case 31: //key down + myAnim.changeSpeed(1/1.05); + break; + + case 4: //key home + myAnim.setSpeed(rate); + break; + + case 1: //key end + myAnim.setSpeed(rate); + break; + } +}; +runtime.addEventHandler(keyEventHandler); + +//run the animation using a TimeEventHandler +myTimer = new TimeEventHandler(); +myTimer.onTimeChange = true; +myTimer.onEvent = function(e) { + myAnim.wallTime += e.deltaTime; + if (palindrome == true) { + myAnim.currentTime = + myAnim.startTime + + myAnim.myLength/2 + * (1 - Math.cos(Math.PI * myAnim.speed/myAnim.myLength * myAnim.wallTime)); + } else { + myAnim.currentTime = myAnim.startTime + + (myAnim.speed * myAnim.wallTime % myAnim.myLength); + } +}; +runtime.addEventHandler(myTimer); diff --git a/Master/texmf-dist/doc/latex/movie15/javascript/lights.js b/Master/texmf-dist/doc/latex/movie15/javascript/lights.js new file mode 100644 index 00000000000..ba367dfbb6b --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/javascript/lights.js @@ -0,0 +1,51 @@ +//////////////////////////////////////////////////////////////////////// +// +// lights.js +// +// example JavaScript for use with `3Djscript' option of \includemovie +// +// * Adds light sources around the object for better illumination. +// +//////////////////////////////////////////////////////////////////////// +console.println(scene.lightScheme); +////first remove any scene lights +//for (var i = scene.lights.count - 1; i >= 0; i--) { +// scene.lights.removeByIndex(i); +//} +// +////new lights +////from left +//l1 = scene.createLight(); +//l1.color.set(1,1,1); +//l1.brightness = .4; +//l1.direction.set(1,0,0); +// +////from right +//l2 = scene.createLight(); +//l2.color.set(1,1,1); +//l2.brightness = .4; +//l2.direction.set(-1,0,0); +// +////from bottom +//l3 = scene.createLight(); +//l3.color.set(1,1,1); +//l3.brightness = .4; +//l3.direction.set(0,0,1); +// +////from top +//l4 = scene.createLight(); +//l4.color.set(1,1,1); +//l4.brightness = .4; +//l4.direction.set(0,0,-1); +// +////from front +//l5 = scene.createLight(); +//l5.color.set(1,1,1); +//l5.brightness = .4; +//l5.direction.set(0,1,0); +// +////from back +//l6 = scene.createLight(); +//l6.color.set(1,1,1); +//l6.brightness = .4; +//l6.direction.set(0,-1,0); diff --git a/Master/texmf-dist/doc/latex/movie15/javascript/turntable.js b/Master/texmf-dist/doc/latex/movie15/javascript/turntable.js new file mode 100644 index 00000000000..f839c5c3326 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/javascript/turntable.js @@ -0,0 +1,63 @@ +///////////////////////////////////////////////////////////////////// +// +// turntable.js +// +// JavaScript for use with `3Djscript' option of \includemovie +// +// * Greatly improves the rotational behaviour of the 3D object, +// prevents it from tilting to the side while dragging the mouse. +// This is achieved by suppressing the rolling of the camera about +// its optical axis. +// +///////////////////////////////////////////////////////////////////// + +// maximum pitch (degrees from horizontal) of the camera +var max_alpha = 88; +var min_beta = 90 - max_alpha; // the complement +var cos_min_beta = Math.cos(min_beta * Math.PI/180); +var tan_min_beta = Math.tan(min_beta * Math.PI/180); + +var camera = scene.cameras.getByIndex(0); +camera.axis_up = camera.up.subtract(camera.position); +camera.axis_up.normalize(); + +//updates the vertical axis of rotation whenever a predefined view +//is selected from the drop down list in the 3D toolbar +var cameraEventHandler = new CameraEventHandler(); +cameraEventHandler.onEvent = function (e) { + camera.axis_up = camera.up.subtract(camera.position); + camera.axis_up.normalize(); +} +runtime.addEventHandler(cameraEventHandler); + +//suppresses camera rolling and limits camera pitch +var mouseEventHandler = new MouseEventHandler(); +mouseEventHandler.onMouseMove = true; +mouseEventHandler.onEvent = function (e) { + runtime.setCurrentTool(runtime.TOOL_NAME_ROTATE); + var c2c = camera.position.subtract(camera.targetPosition); + var roo = c2c.length; + c2c.normalize(); + cos_beta = c2c.dot(camera.axis_up); //cos of enclosed angle + + //correct the camera position if it is too high or too low + if(Math.abs(cos_beta) > cos_min_beta) { + //auxiliary vectors a & b + var a = camera.axis_up.scale(cos_beta); + var b = c2c.subtract(a); + b.normalize(); + b.scaleInPlace(tan_min_beta * a.length); + + c2c.set(a.add(b)); + c2c.normalize(); + + camera.position.set(camera.targetPosition.add(c2c.scale(roo))); + cos_beta = c2c.dot(camera.axis_up); + } + + //suppress rolling + camera.up.set( + camera.position.add(camera.axis_up).add(c2c.scale(-cos_beta)) + ); +}; +runtime.addEventHandler(mouseEventHandler); diff --git a/Master/texmf-dist/doc/latex/movie15/movie15.pdf b/Master/texmf-dist/doc/latex/movie15/movie15.pdf Binary files differnew file mode 100644 index 00000000000..b65d018fbf3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/movie15.pdf diff --git a/Master/texmf-dist/doc/latex/movie15/movie15.tex b/Master/texmf-dist/doc/latex/movie15/movie15.tex new file mode 100644 index 00000000000..1f3ac063a63 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/movie15.tex @@ -0,0 +1,751 @@ +% Copyright 2004 Alexander Grahn +% +% This material is subject to the LaTeX Project Public License. See +% http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html +% for the details of that license. +% +\documentclass[a4paper]{article} +\pdfpagewidth595bp +\pdfpageheight842bp +\frenchspacing +\usepackage[3D]{movie15} +\usepackage{ragged2e} +\usepackage{amssymb} +\usepackage[UKenglish]{babel} +\usepackage{color} +\usepackage{graphicx} +\usepackage{hyperref} +\usepackage{textcomp} +\usepackage{lmodern} +\usepackage[T1]{fontenc} +\usepackage{float} +\usepackage{ifpdf} +\usepackage{parskip} +\usepackage{animate} + +\ifpdf\else + \makeatletter + \@latex@error{Please use pdfLaTeX to compile this documentation} + \makeatother +\fi + +\hypersetup{ + bookmarksnumbered,linktocpage,breaklinks, + pdftitle={The movie15 Package}, + pdfsubject={Documentation}, + pdfauthor={Alexander Grahn}, + pdfkeywords={embed, movie, LaTeX, pdfLaTeX, PDF, 3D, JavaScript, include, sound, video, multimedia, animation}, + citebordercolor={0 0 1}, + filebordercolor={0 0 1}, + linkbordercolor={0 0 1}, + menubordercolor={0 0 1}, + pagebordercolor={0 0 1}, + urlbordercolor={0 0 1} +} + +\begin{document} +\title{The {\sffamily movie15} Package} +\author{Alexander Grahn\\[1ex]\includegraphics[height=2.7ex]{mailto}} +\maketitle + +\begin{abstract}\noindent +A \LaTeX{} package for inclusion of movies, sounds and 3D objects into PDF documents with PDF-1.5/1.6 compatibility.\\[0.2\baselineskip] +\emph{Keywords}: embed, movie, LaTeX, pdfLaTeX, PDF, 3D, JavaScript, \mbox{include}, sound, video, multimedia, animation +\end{abstract} + +\begin{animateinline}[autoplay,loop]{1.5}\strut{\bf\color{red} Note:}\newframe\newframe[5]\end{animateinline} This package is obsolete now. Consider using package `media9'. +\tableofcontents + +%\newpage +\section{Introduction} + +The way multimedia content, i.\,e. movies and sounds, is included into PDF has changed with Adobe's PDF specification, version 1.5. PDF-1.5 supports a larger variety of movie and sound formats, limited only by the number of plug-ins available for Adobe Reader\textsuperscript{\scriptsize\textregistered}. With PDF-1.6, support for 3D objects, stored in the U3D file format, has been added. See Table \ref{table:mime} for a list of viable media formats. The specification allows media file contents to be completely embedded into the PDF output, thus producing self-contained PDF documents. + +This package provides an interface to embed movies, sounds and 3D objects into PDF documents for use with \LaTeX{} as well as pdf\LaTeX. Media file contents is incorporated into PDF output by default. This is done either directly during source processing using pdf\LaTeX{} or during conversion from Postscript to PDF using Ghostscript's \verb+ps2pdf+. + +The final PDF output can be viewed with Windows\textsuperscript{\scriptsize\textregistered} and Mac OS\textsuperscript{\scriptsize\textregistered} versions of Adobe Reader. However, embedded media file data can also be extracted and saved to disk from within Readers which support file attachments. This makes PDF documents a little more portable to Readers which do not ship with a multimedia plug-in. + +`movie15' works well together with the presentation making package `Beamer'. In particular it supports its overlay concept. See this \href{./overlay-example.pdf}{example}. +%which uses the `Beamer' class. +Also read the comments in the example's source file, `\verb+overlay-example.tex+', on how to use `movie15' with `Beamer'. + +\section{Installation} +The file `movie15.sty' should be stored in a place where \LaTeX{} can find it. + +\section{Requirements} +pdf\TeX{}, version $\ge1.20$, is needed for direct PDF output. + +If the package option `\verb+3D+' is set, `movie15' loads Michael Mehlich's `fp' package for fixed point arithmetic. Since it does not belong to the core packages of most \TeX{} distributions it must be installed prior to selecting the `\verb+3D+' option. + +Adobe Reader, version 6, is required for playing movies and sounds, version 7 for rendering embedded 3D content. + +%\newpage +\section{Using the package} +Invoke the package by putting the line +\begin{verbatim} + \usepackage[<package options>]{movie15} +\end{verbatim} +to the preamble of your document, i.\,e. somewhere between \verb+\documentclass+ and \verb+\begin{document}+. + +`movie15' honours the following package options: +\begin{verbatim} +3D +\end{verbatim} +Enables the 3D feature from the PDF-1.6 specification. Inclusion of 3D files into PDF is discussed separately in section~\ref{sec:3D}. + +\begin{verbatim} +draft +\end{verbatim} +Media files are not included. Just the file name is printed in a box of size \verb+<width>+$\times$(\verb+<height>++\verb+<depth>+). +\begin{verbatim} +final +\end{verbatim} +The opposite of draft. Useful to override a global draft option specified +in the \verb+\documentclass+ command. + +If PDF is generated via DVI and Postscript by the usual \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+ sequence of commands, the `graphicx' package is required. + +Note that several runs may be necessary to resolve internally created cross-references. Appropriate warnings will be issued in such cases. + +\section{The user interface} +\subsection{Media inclusion}\label{usrif} +Movies, sounds and 3D objects are embedded into the document using the command +\begin{verbatim} + \includemovie[<options>]{<width>}{<height>}{<media file>} +\end{verbatim} +Unless left empty, the \verb+<width>+ and \verb+<height>+ arguments must be given in valid \TeX{} dimensions. Horizontal and vertical dimensions of the media clip are scaled independently to fit \verb+<width>+ and \verb+<height>+ or, if the two latter are empty, to fit the size of the text box, given as argument to the `\verb+text+' option; see \hyperlink{lnk:textoption}{below}. \verb+<media file>+ specifies the file name of the media clip. If the media file is embedded as part of the final PDF output, which is the default, it may reside wherever \TeX{} or Ghostscript search for input files, depending on the PDF producing method. + +Below, common options to \verb+\includemovie+ are listed. Options specific to embedding of 3D content are discussed separately in section~\ref{sec:3D}. The impatient reader may advance directly to the \hyperlink{sec:3Dtut}{3D quick-start guide}, which summarizes the basic steps for embedding 3D objects. +\begin{verbatim} +attach[=false] +\end{verbatim} +By default, the embedded data stream is re-used as embedded file attachment. This makes `movie15' a little more portable to PDF Readers which do not have a multimedia plug-in because it gives the user the opportunity to extract the media file and to save it to disk for later playback with an external player. However, support of file attachments is required. Re-use as file attachment can be suppressed with option `\verb+attach=false+'. Note that `\verb+attach=false+' is a poor method to prevent the user from obtaining a copy of the media file. There are several (free) tools for decompressing and extracting stream objects from PDF files. +\begin{verbatim} +autoclose +\end{verbatim} +Close the media player when the page is closed. Use of this option may be necessary for streamed media, such as Real Video. +\begin{verbatim} +autopause +\end{verbatim} +Pause playing when the page is closed. +\begin{verbatim} +autoplay +\end{verbatim} +Start playback of the media clip after the page has opened. This is especially useful if there are multiple movie clips on the current page to be played at the same time. Also resumes playback of previously paused media. In the case of embedded sound being started this way, \verb+<width>+ and \verb+<height>+ can safely be set to `0pt' since no further user interaction is necessary to start playing. +\begin{verbatim} +autostop +\end{verbatim} +Stops playing but keeps the media loaded when the page is closed. The media is rewound to its beginning or its `\verb+startat+' position. This option is set by default if neither of the options `\verb+autopause+', `\verb+autoclose+' or `\verb+continue+' is set. +\begin{verbatim} +autoresume +\end{verbatim} +Resume previously paused playback when the page is opened again. +\begin{verbatim} +continue +\end{verbatim} +Continue playback in background on premature page change. However, paused media remain paused. So do media that have reached the end or that still show the poster. +\begin{verbatim} +controls +toolbar +\end{verbatim} +Player specific controls or toolbars are displayed during playback of the media clip, if available. The default is `\verb+false+'; controls are not shown. +\begin{verbatim} +depth=<depth> +\end{verbatim} +Specifies how far the media display area should extend below the bottom line of the running text. Any valid \TeX{} dimension is accepted. +\begin{verbatim} +draft +\end{verbatim} +Locally switches to draft mode. +\begin{verbatim} +externalviewer +\end{verbatim} +Opens and plays the media in an external application. +\begin{verbatim} +final +\end{verbatim} +Locally disables draft mode. +\begin{verbatim} +inline[=false] +\end{verbatim} +Media file \emph{data} are embedded into PDF output by default. +This can be suppressed with option `\verb+inline=false+'. +\begin{verbatim} +label=<label spec> +\end{verbatim} +The media is labelled with \verb+<label spec>+ such that it can be referenced by the \verb+\movieref+ command elsewhere in the document. The \verb+\movieref+ command creates a hyperlink to either stop, pause, resume the media, to play it with different settings, such as frame rate or volume, or to show a different part of it. See section~\ref{hyperlinks} for details. \verb+<label spec>+ may consist of any sequence of letters, digits or punctuation characters. +\begin{verbatim} +mimetype=<mimetype> +\end{verbatim} +According to the PDF specification, the viewer application needs to know the MIME type of \verb+<media file>+. Package `movie15' tries to make a guess from the file name extension. If, however, a media file is of unknown type or has a non-standard file name extension, its MIME type must be explicitly specified using this option. See Table \ref{table:mime} for a list of known file name extensions. +\begin{verbatim} +mouse[=true|false] +\end{verbatim} +Enable mouse interaction: Clicking onto the media (giving it the focus) pauses the playback while clicking outside resumes it. Alternatively, once the media has got the focus, repeated pressing of key `P' on the keyboard switches between Play and Pause (at least with some players). In 3D context it specifies whether the 3D annotation should be interactive, i.\,e. responsive to mouse interaction. 3D annotations are interactive by default. +\begin{verbatim} +palindrome[=true|false] +\end{verbatim} +The media is played forward and backward, if supported by the media player. In combination with option `\verb+repeat+' this forward-and-reverse playback repeats as many times as specified. Each complete forward and reverse playback counts as one repeat. +\begin{verbatim} +playerid=<playerid> +\end{verbatim} +Forces a particular media player plug-in to be used instead of the default one. Currently, the following values are recognized:\\[1ex] +{\tt\phantom{xxxx}AAPL\_QuickTime\\ +\phantom{xxxx}MACR\_FlashPlayer\\ +\phantom{xxxx}RNWK\_RealPlayer\\ +\phantom{xxxx}MSFT\_WindowsMediaPlayer\\ +\phantom{xxxx}ADBE\_MCI} (Adobe builtin player) +\begin{verbatim} +poster +\end{verbatim} +The first frame of the movie or the frame at the beginning of the movie section specified by the `\verb+startat+' option is shown. +\begin{verbatim} +poster=<image> +\end{verbatim} +Inserts still image from file \verb+<image>+ to be shown when the media clip is not activated. The file type of \verb+<image>+ depends on the output driver: PS or EPS when using \LaTeX{} together with \verb+dvips+; PDF, PNG or JPEG when using pdf\LaTeX. This option is obsolescent and should not be used any longer. Instead, use option `\verb+text+' if a still image from an external file is to be inserted. See option `\verb+text+' for a possibility to scale the media display area according to the poster image dimensions. +\begin{verbatim} +rate=<rate> +\end{verbatim} +\verb+<rate>+ specifies the playback rate, where $1$ is normal playback, $0.5$ is half speed, $2$ is double speed, $-1$ is normal speed in reverse etc. +\begin{verbatim} +repeat[=<repeats>] +\end{verbatim} +Specifies how often the media clip or embedded 3D animation will be played. Without argument this option causes the player to repeat forever. +\begin{verbatim} +startat=<offset> +endat=<offset> +\end{verbatim} +Start/stop playback at the specified offsets. \verb+<offset>+ may be an absolute time or frame value, or a named marker, or a marker plus a time or frame. In the latter case, time or frame values are regarded as relative to the named marker. Support of markers, time and frame offsets is media type dependent. Media incompatible offsets are ignored. The following syntax applies to \verb+<offset>+: +\begin{verbatim} + time:<time in seconds> + frame:<frame number> + marker:<quoted string> +\end{verbatim} +Some \verb+<offset>+ examples: +\begin{verbatim} + time:20.5 + frame:100 + {marker:'Chapter 1', time:60} +\end{verbatim} +\hypertarget{lnk:textoption}{} +\begin{verbatim} +text=<text> +\end{verbatim} +\verb+<text>+ is typeset onto and centred within the media display area which has been specified by the \verb+<width>+ and \verb+<height>+ arguments as well as the `\verb+depth+' option. If either or both of the \verb+<width>+ and \verb+<height>+ arguments are left empty, any unspecified dimension of the media display is scaled to match the corresponding dimension, i.\,e. width and height, of \verb+<text>+. Likewise, the depth of the media display is adjusted to the depth of \verb+<text>+ if the optional `\verb+depth+' has not been given. Therefore, option `\verb+text+' can be used to scale the media display to the natural or scaled dimensions of a poster image file, such as (requires package `graphicx'; \emph{also note the empty {\tt<width>} and {\tt<height>} arguments!}): +\begin{verbatim} + \includemovie[text={\includegraphics[scale=2]{path/to/poster}}] + {}{}{path/to/movie} +\end{verbatim} +In combination with the `\verb+poster+' option, which causes the poster image to be rendered from the movie during runtime, the PDF file size can be reduced somewhat by putting \verb+\includegraphics+ into a \verb+\phantom+ box: +\begin{verbatim} + \includemovie[ + poster, + text={\phantom{\includegraphics[scale=2]{path/to/poster}}} + ]{}{}{path/to/movie} +\end{verbatim} +\begin{verbatim} +textoverposter[=false] +\end{verbatim} +Set this option to `\verb+false+' if you wish \verb+<text>+ to be obscured by the external poster image which has been inserted with the poster option. Deprecated. +\begin{verbatim} +url +\end{verbatim} +Treat \verb+<media file>+ as URL. Sets option `\verb+inline+' to `\verb+false+' automatically. +\begin{verbatim} +volume=<percentage of original volume> +\end{verbatim} +The meaning of this option should be self explaining. + +\subsection{Inclusion of 3D objects}\label{sec:3D} +The PDF-1.6 specification, which was introduced with the advent of Adobe Acrobat/Reader 7, allows embedding of 3-dimensional graphic objects, such as CAD models or 3D scientific data, and lets the user interactively manipulate them. At the time of writing this documentation, the only supported file types were U3D~\cite{3diforg} and Adobe's PRC format, and only one commercial software~\cite{dexp} for exporting into the U3D format, yet from a number of CAD and 3D vector formats, including DXF and VRML, was known. Nevertheless, a try-out version of~\cite{dexp} can be downloaded without charge. + +Selection of the `\verb+3D+' package option enables the 3D feature. Most of the command options listed in section~\ref{usrif} do what they are supposed to do in the case of embedded 3D as well. Other options are ignored, in particular `\verb+startat+', `\verb+endat+', `\verb+volume+' and `\verb+playerid+'. Options `\verb+inline=false+' and `\verb+url+' are supported, but imply option `{\tt{}ex\-ter\-nal\-view\-er}', because the 3D Reader plug-in handles embedded files only. + +There are a few options to \verb+\includemovie+ 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$ around the centre of orbit, specified by the position vector $\overrightarrow{COO}$; $\sphericalangle AAC$ is the camera's aperture angle. In addition, the direction vector $\overrightarrow{C2C}$ is needed to specify the initial camera position. +\begin{figure}[ht] + \resizebox{\linewidth}{!}{\input{3dsystem}} + \caption{Camera and 3D object in the World System $XYZ$; centre of orbit position vector $\vec{COO}$, centre of orbit to camera direction vector $\vec{C2C}$, radius of orbit $ROO$, aperture angle of camera $\sphericalangle AAC$.}\label{3dscene} +\end{figure} + +The \emph{default view}, i.\,e. the view that is shown initially after activating the 3D object in the Reader, can be set using the options `\verb+3Dcoo+' for the centre of orbit, `\verb+3Dc2c+' for the centre of orbit to camera vector, `\verb+3Droo+' for the orbital radius and `\verb+3Daac+' for the aperture angle of the camera: +\begin{verbatim} +3Daac=<angle> +\end{verbatim} +This option sets the aperture angle of the camera, measured in degrees. Fixed 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{ex3d} in section~\ref{examples}. +\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. Only fixed point numbers in the range from\\[1ex] +\phantom{xxxx}$-999999999999999999.999999999999999999$\\ +to\\ +\phantom{xxxx}$+999999999999999999.999999999999999999$\\[1ex] +are allowed. +\begin{verbatim} +3Dcoo=<x> <y> <z> +\end{verbatim} +\verb+<x> <y> <z>+ specify the positional vector $\overrightarrow{COO}$ of the centre of orbit. See option `\verb+3Dc2c+' for the number format of \verb+<x> <y> <z>+. +\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. +\begin{verbatim} +3Droo=<r> +\end{verbatim} +\verb+<r>+ (always positive!) specifies the radius of orbit $ROO$ of the virtual camera. See option `\verb+3Dc2c+' for the number format of \verb+<r>+. + +Without the above options 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 view 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. Fortunately, it is possible to let the values of the corresponding options be determined automatically. Simply insert a hyperlink using the \verb+\movieref+ command together with the `\verb+3Dcalculate+' option. Once the settings for `\verb+3Droo+' and `\verb+3Dcoo+' have been calculated, the hyperlink can be removed again. See section \ref{hyperlinks} for an explanation and example \ref{ex3d} in section \ref{examples}. + +\begin{verbatim} +3Dbg=<r> <g> <b> +\end{verbatim} +This option sets the background colour of the canvas. Only fixed point real numbers in the range from 0 to 1 are allowed for the colour components. +\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} +\emph{Deprecated}. Superseeded by the `\verb+3Dviews2+' option and a new, more flexible views file syntax (see below). File \verb+<views file>+ specifies predefined camera positions. It contains lines with the following syntax: +\begin{verbatim} +[<name>]{<coo_x> <coo_y> <coo_z>}{<c2c_x> <c2c_y> <c2c_z>}{<roo>}{<roll>}{<aac>} +\end{verbatim} +The \verb+<name>+ entry is optional. If \verb+<name>+ is not given, a default name consisting of `View' followed by the number of the current entry in the list is formed. For \verb+<coo_x>+, \verb+<coo_y>+, \verb+<coo_z>+, \verb+<c2c_x>+, \verb+<c2c_y>+, \verb+<c2c_z>+, \verb+<roo>+, \verb+<roll>+ and \verb+<aac>+ the same rules as for the corresponding options `\verb+3Dcoo+', `\verb+3Dc2c+', `\verb+3Droo+', `\verb+3Droll+' and `\verb+3Daac+' apply. Empty braces, \verb+{}+, are possible and cause default values to be used. Trailing spaces or comment signs (\%) are allowed. Reading of the file stops either at its end, at the first empty line encountered or at the first line containing nothing but spaces and/or a comment sign followed by arbitrary stuff.% See option `\verb+3Dgetview+' of \verb+\movieref+ on how to get the camera settings of the current view in the Reader, which can be used to populate a file of additional views. + +\begin{verbatim} +3Dviews2=<views file> +\end{verbatim} +Instead of or in addition to the default view, 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, of every single part in the 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=<coo_x> <coo_y> <coo_z> + C2C=<c2c_x> <c2c_y> <c2c_z> + ROO=<roo> + AAC=<aac> + ROLL=<roll> + BGCOLOR=<r> <g> <b> + RENDERMODE=<render mode> + LIGHTS=<lighting scheme> + PART=<part name (required) as in the Model Tree> + VISIBLE=true | false + OPACITY=<part opacity> + RENDERMODE=<see option `3Drender' for possible values> + 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 contains optional entries for setting the camera position and global rendering attributes of the scene as well as \verb+PART+ subsections for setting rendering 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 a 3D object is composed of. Table~\ref{tab:parts} lists the possible entries in a \verb+PART+ sub-section. All entries are optional. \verb+<part name>+ is required 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). In order to avoid trouble it is recommended that part names be exclusively composed of ASCII characters. You may need to load the U3D/PRC model into the authoring application and edit the part names accordingly. + +The views file can be commented. As usual with \LaTeX, comments start with the percent sign. + +To facilitate the creation of a views file, a \verb+\movieref+ link with option `\verb+3Dgetview+' can be temporarily inserted into the document. When clicked, it outputs a complete \verb+VIEW+ section corresponding to the current view of the 3D object in the Reader GUI, including camera position as well as all part and viewing options that may be set via the context (right-click) menu of the 3D object. See section \ref{hyperlinks} for details. + +\begin{table} + \centering + \caption{Entries in a {\tt VIEW} section}\label{tab:views} + \begin{tabular}[t]{llp{0.3\linewidth}}\hline + key & type & value\\\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}'\\ + AAC & number & camera aperture angle, see option `{\tt 3Daac}'\\ + ROLL & number & camera roll, see option `{\tt 3Droll}'\\ + BGCOLOR & three numbers & canvas 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-section & part name as in the model tree, see Table~\ref{tab:parts} for list of possible entries\\ + \hline + \end{tabular} +\end{table} + +\begin{table} + \centering + \caption{Entries in a {\tt PART} sub-section}\label{tab:parts} + \begin{tabular}[t]{llp{0.3\linewidth}}\hline + key & type & value\\\hline\hline + 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}'\\ + \hline + \end{tabular} +\end{table} + +\begin{verbatim} +3Djscript=<JavaScript file> +\end{verbatim} +Things like animation, lighting, background etc. may also be script driven. Option `\verb+3Djscript+' associates \verb+<JavaScript file>+ with the 3D object. The script will be executed upon activation of the object. Refer to the Acrobat 3D JavaScript Reference~\cite{jscript3D} for details. Directory `\verb+doc/javascript+' contains JavaScript example files for animation and rotation control. The files work off-the-shelf with any 3D file and may be concatenated to combine their effects. +\begin{verbatim} +3Dresource=<resource file 1>[, 3Dresource=<resource file 2> [, ...]] +\end{verbatim} +Embeds additional 3D or \emph{rasterized} image files that can be used as resources while rendering the 3D artwork. Possible file types are U3D, Postscript (\LaTeX{} + \verb+dvips+) and PDF/JPEG/PNG (pdf\LaTeX). Embedded resources must be loaded by the JavaScript method +\begin{verbatim} + Resource('pdf://<resource path>') +\end{verbatim} +where {\tt<resource path>} stands for the path to the resource file as specified by the `\verb+3Dresource+' option. (This is just a naming convention; the files are physically embedded in the final PDF.) The following JavaScript loads an image file that was attached by `\verb+3Dresource=images/sunset.jpg+' as the 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.setImage(sunset); + } + runtime.addEventHandler(reh); +\end{verbatim} + +\subsection{Media hyperlinks}\label{hyperlinks} +A movie, sound or 3D object may serve as the destination of hyperlinks, which are inserted into the document using the command +\begin{verbatim} + \movieref[<options>]{<label spec>}{<text>} +\end{verbatim} +It makes \verb+<text>+ a hyperlink to the media that has been labelled with \verb+<label+ \verb+spec>+ using the `\verb+label+' option of the \verb+\includemovie+ command. Media hyperlinks can be inserted at any location within the document. Clicking onto the hyperlink causes the Reader to open the page containing the media it is pointing to. The primary purpose of media hyperlinks, however, is to provide a means to control the playback. + +\emph{In 2D context}, clicking onto the hyperlink causes the media to stop, pause or resume, or to restart at different settings, such as frame rate, volume, starting and ending positions, depending on the \verb+<options>+ being in effect. + +Options that control the playback \emph{characteristics} are: `\verb+controls+', `\verb+endat+', `\verb+mouse+', `\verb+palindrome+', `\verb+rate+', `\verb+repeat+', `\verb+startat+' and `\verb+volume+'. Their meaning is the same as for the \verb+\includemovie+ command and can be looked up in section~\ref{usrif}. Another option, `\verb+default+' causes the media to play at the original settings which were in effect during media inclusion. These options can be used in combination with the `\verb+play+' option only. + +The options which follow let the hyperlink change the playback \emph{state} of media. If none of them is specified, `\verb+play+' is assumed. +\begin{verbatim} +play +\end{verbatim} +Immediately restarts playback. If new playback settings have been specified through the options given above, they override the original settings being in effect during media inclusion. +\begin{verbatim} +stop +\end{verbatim} +Stops and rewinds the media to its beginning or to the `\verb+startat+' position. +\begin{verbatim} +resume +\end{verbatim} +Resumes paused media. In fact, this option makes the hyperlink a toggle switch: repeated clicking switches between paused and resumed state. +\begin{verbatim} +pause +\end{verbatim} +Has the same effect as option `\verb+resume+'. Added for completeness only. +\begin{verbatim} +close +\end{verbatim} +Immediately closes the media player. + +\emph{In 3D context}, \verb+\movieref+ can be used to define an additional view of the object, to access a particular view from the list of predefined views or to run a JavaScript. Moreover, a link can be created for calculating optimal camera settings `\verb+3Droo+' and `\verb+3Dcoo+', instead of finding them manually. The following options are recognized: +\begin{verbatim} +3Dviewindex=<index> +\end{verbatim} +Go to a predefined view of the 3D object. \verb+<index>+ can take `\verb+F+', `\verb+L+', `\verb+N+' or `\verb+P+' to access the first, last, next or previous element of the list of additional views, see option `\verb+3Dviews+' of {\tt \string\include\-movie}, or an integer specifying an index into the list. In the case of `\verb+N+' and `\verb+P+', repeated clicking onto the hyperlink allows to cycle through the list in forward or backward direction. `\verb+D+' gives access to the default view. +\begin{verbatim} +3Daac=<angle> +3Dc2c=<x> <y> <z> +3Dcoo=<x> <y> <z> +3Droll=<roll> +3Droo=<r> +\end{verbatim} +Instead of referencing an existing view of the 3D object, a new one can be defined using any of these options. See section~\ref{sec:3D}. +\begin{verbatim} +3Dcalculate[=<aac angle>] +\end{verbatim} +Mainly used during document authoring. Creates a link for calculating optimal `\verb+3Droo+' and `\verb+3Dcoo+' settings of the virtual camera, which may be used to define a default view. Clicking the link opens a dialogue box from which the settings can be copied to the clipboard for later insertion into the option list of \verb+\includemovie+. The parameter \verb+<aac angle>+ which is the camera aperture angle $\sphericalangle AAC$ used for calculation is optional. If omitted, the one set by \verb+\includemovie+ option `\verb+3Daac+' is taken. +\begin{verbatim} +3Dgetview +\end{verbatim} +Mainly used during document authoring. Camera settings as well as part and scene rendering attributes that correspond to the current view are printed to a dialogue box. The output is a readily formatted \verb+VIEWS+ section to be inserted into or appended to a file of predefined views. See option `\verb+3Dviews2+'. +\begin{verbatim} +3Djscript=<JavaScript file> +\end{verbatim} +Runs the script \verb+<JavaScript file>+ after clicking the link. Unlike the script that has been associated with the 3D annotation during object embedding, this JavaScript is not directly run by the JavaScript engine of the 3D plug-in, but is run by the Reader's own scripting engine. However, full access to the API of the 3D script engine is provided through the `\verb+context3D+' property of the `\verb+Annot3D+' object. For convenience, an associative array `\verb+annot3D+' has been provided for use within \verb+<JavaScript file>+, in order to easily access the `\verb+Annot3D+' object of the annotation the enclosing link is pointing to. The particular element of the array is referenced by the annotation's label \verb+<label spec>+, enclosed in quotation marks. As an example, the `\verb+scene+' object can be referenced within \verb+<JavaScript file>+ by +\begin{verbatim} + annot3D['<label spec>'].context3D.scene +\end{verbatim} +For details about Acrobat JavaScript and its Annot3D object, see \cite{jscript}. + +%\newpage +\subsection{Compatibility commands} +Two user commands have been provided that make `movie15' a replacement for the `multimedia' package which is part of Till Tantau's `Beamer' Class: +\begin{verbatim} + \movie[<options>]{<poster text>}{<media file>} +\end{verbatim} +\begin{verbatim} + \hyperlinkmovie[<options>]{<label spec>}{<text>} +\end{verbatim} +All of the optional arguments to \verb+\includemovie+ and \verb+\movieref+ can be used with the compatibility macros as well. In addition, they honour the following options: +\begin{verbatim} +height=<height of display> +width=<width of display> +\end{verbatim} +Set the horizontal and vertical dimensions of the media display area (\verb+\movie+ only). +\begin{verbatim} +autostart +\end{verbatim} +The same as `\verb+autoplay+'. +\begin{verbatim} +loop[=<repeats>] +\end{verbatim} +The same as `\verb+repeat+'. +\begin{verbatim} +once +\end{verbatim} +The same as `\verb+repeat=1+'. +\begin{verbatim} +showcontrols +\end{verbatim} +The same as `\verb+controls+'. +\begin{verbatim} +start=<offset in seconds>s +\end{verbatim} +Start playback at the specified temporal offset. The trailing `\verb+s+' is mandatory. +\begin{verbatim} +duration=<duration in seconds>s +\end{verbatim} +The duration of the media segment to be played. The trailing `\verb+s+' is mandatory. Note that `\verb+duration+' cannot be used together with option `\verb+startat+' from \verb+\includemovie+. In order to define a media segment options can be combined as follows: `\verb+startat+'/`\verb+endat+', `\verb+start+'/`\verb+endat+', `\verb+start+'/`\verb+duration+'. + +%\newpage +\section{Examples}\label{examples} +\begin{enumerate} +\item A short circular MPEG movie, taken from \href{http://www.linux-video.net/Samples/}{\tt http://www.linux-video.net/} \href{http://www.linux-video.net/Samples/}{\tt Samples/} + +\begin{minipage}{0.5\linewidth} +{\tt% + \string\includemovie[\\ + \phantom{xx}poster,\\ + \phantom{xx}text=(random.mpg),\\ + \phantom{xx}mouse,\\ + \phantom{xx}repeat\\ + ]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.375\string\linewidth\\ + \string}\string{random.mpg\string} +} +\end{minipage}% +\begin{minipage}{0.5\linewidth} +\begin{center} + \includemovie[poster, text=(random.mpg), mouse, repeat]{\linewidth}{.75\linewidth}{random.mpg} +\end{center} +\end{minipage} + +%\newpage +\item Another MPEG movie, loaded on the fly from \href{http://www.linux-video.net/Samples/}{\tt http://www.linux-video} \href{http://www.linux-video.net/Samples/}{\tt .net/Samples/}. Hence, a working Internet connection is required. This time, we force the QuickTime plug-in to be used instead of MediaPlayer (Windows boxes only). Well, the latter seems to be bugged. Quod erat expectandum. + +\begin{minipage}{0.5\linewidth} +{\tt% + \string\includemovie[\\ + \phantom{xx}poster,\\ + \phantom{xx}label=alien,\\ + \phantom{xx}text=(AlienSong.mpg),\\ + \phantom{xx}url,\\ + \phantom{xx}playerid=AAPL\_QuickTime,\\ + \phantom{xx}repeat\\ + ]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.375\string\linewidth\\ + \string}\string{http://www.linux-video.net/Samples/Mpeg1/AlienSong.mpg\string}\\ + \string\movieref[rate=0.5]\string{alien\string}\string{Slow\string}\\ + \string\movieref[default]\string{alien\string}\string{Normal\string}\\ + \string\movieref[rate=2]\string{alien\string}\string{Fast\string}\\ + \string\movieref[pause]\string{alien\string}\string{Play/Pause\string}\\ + \string\movieref[stop]\string{alien\string}\string{Stop\string} +} +\end{minipage}% +\begin{minipage}{0.5\linewidth} +\begin{center} + \includemovie[ + poster, + label=alien, + text=(AlienSong.mpg), + repeat, + playerid=AAPL_QuickTime, + url + ]{\linewidth}{.75\linewidth}{http://www.linux-video.net/Samples/Mpeg1/AlienSong.mpg}\\ +% ]{\linewidth}{.75\linewidth}{AlienSong.mpg}\\ +\movieref[rate=0.5]{alien}{Slow}\hfill +\movieref[default]{alien}{Normal}\hfill +\movieref[rate=2]{alien}{Fast}\hfill +\movieref[pause]{alien}{Play/Pause}\hfill +\movieref[stop]{alien}{Stop}\vspace{19 ex} +\end{center} +\end{minipage} + +%\newpage +\item\label{ex3d} Embedded U3D file. It is based on a VRML model by Peter Whitehouse, \href{http://www.wonko.info/vrml/index.htm}{\tt http://www.wonko.info/vrml/index.htm}. Conversion to U3D has been made with 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.% The JavaScript `{\tt turntable.js}' disables the annoying Gimbal rotation mode. + +\begin{minipage}[b]{0.5\linewidth} +{\tt% + \string\includemovie[\\ + \phantom{xx}poster,\\ + \phantom{xx}toolbar,\\ + \phantom{xx}label=dice,\\ + \phantom{xx}text=(dice.u3d),\\ + \phantom{xx}3Droo=27,\\ + \phantom{xx}3Dlights=Cube,\\ + \phantom{xx}3Djscript=turntable.js,\\ + \phantom{xx}3Dviews2=dice.vws\\ + ]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{dice.u3d\string}\\ + \string\movieref[\\ + \phantom{xx}3Dviewindex=N\\ + ]\string{dice\string}\string{Click here\string} \dots\\ + \string\movieref[\\ + \phantom{xx}3Dcalculate=60\\ + ]\string{dice\string}\string{This link\string} \dots +} +\end{minipage}% +\begin{minipage}[b]{0.5\linewidth} +\begin{center} + \includemovie[ + poster, + toolbar, %same as `controls' + label=dice, + text=(dice.u3d), + 3Droo=27, + 3Dlights=Cube, + 3Dviews2=dice.vws, + 3Djscript=turntable.js + ]{\linewidth}{\linewidth}{dice.u3d} +\end{center} +\movieref[3Dviewindex=N]{dice}{Click here} to cycle through the list of predefined views. \movieref[3Dcalculate=60]{dice}{This link} calculates 3D option settings for a 60\textdegree{} aperture angle of the virtual camera. +\end{minipage} + +\end{enumerate} + +%\newpage +\appendix +\section{3D quick-start guide}\hypertarget{sec:3Dtut}{} +\begin{enumerate} + \item Insert the 3D object with default camera settings and a {\tt \string\movieref} referencing it: + + {\tt% + \string\includemovie[poster, label=my\_label]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}my\_file.u3d\\ + \string}\string\\\\ + \string\movieref[3Dcalculate]\string{my\_label\string}\string{Click here!\string} + } + + \item Compile and recompile the document until no more `movie15' related warnings appear. + \item Open the PDF document in Adobe Reader and go to the page containing the 3D object. Click the link and wait for a dialogue box to pop up. Optionally, drag the object with the mouse to change the viewpoint of the camera (the dialogue must be closed beforehand) and click the link again. + \item Copy the settings ({\tt 3Droo=...}, {\tt 3Dcoo=...}, etc.) from the dialogue box into the option list of {\tt \string\include\-movie}. Remove the link from the document source: + + {\tt% + \string\includemovie[\\ + \phantom{xx}poster, 3Droo=33.3333, 3Dcoo=1.2345 9.8765 0\\ + ]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}my\_file.u3d\\ + \string} + } + + \item Again, compile and recompile the document until no more `movie15' related warnings appear. + \xdef\lastcount{\theenumi} +\end{enumerate} + +\emph{Optional steps:} + +\begin{enumerate} + \setcounter{enumi}{\lastcount} + \item Create a file with predefined views of the 3D object and attach it to the latter using the `{\tt{}3Dviews2}' option: + + {\tt% + \string\includemovie[\\ + \phantom{xx}..., label=my\_label, 3Dviews2=my\_views.vws\\ + ]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}my\_file.u3d\\ + \string} + } + + The views file can easily be populated using a temporarily inserted {\tt \string\movie\-ref} link: + + {\tt% + \string\movieref[3Dgetview]\string{my\_label\string}\string{Click here!\string} + } + + Manipulate the 3D object using the mouse and any of the `Part' and `Viewing' options from the 3D context menu in the Reader. Visibility, lighting, transparency, render mode etc. of individual parts or of the object as a whole can be changed this way. Sometimes you may wish to move the camera target into the centre of a single part or of a group of visible parts. The context menu items `Part Options$\rightarrow$Zoom to Part' and `Part Options$\rightarrow$Fit Visible' can be used for this purpose. + + When you are done, click the link to get the {\tt VIEW} section, readily formatted for insertion into the views file. Repeat this procedure to get any number of views you want to predefine. The views file can be edited manually to give meaningful names to the views (change the value of the {\tt VIEW} entry) or to further tweak camera settings, opacity etc. + + 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. + + \item Associate a JavaScript with the 3D object: + + {\tt% + \string\includemovie[\\ + \phantom{xx}..., 3Djscript=my\_script.js\\ + ]\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}.5\string\linewidth\\ + \string}\string{\\ + \phantom{xx}my\_file.u3d\\ + \string} + } + + JavaScript is \emph{not} required to make use of \emph{embedded} keyframe animation. Just click the `Play' button in the 3D toolbar of the 3D annotation. However, the example file `{\tt{}animation.js}' in the `{\tt{}doc/javascript}' directory provides additional controls (accessible via the context menu of the 3D annotation) that can be used to change the speed of a running animation. The `Up', `Down' and `Home' keys of the keyboard can also be used. + + Another useful example file you may want to experiment with is `{\tt{}turn\-table.js}'. It improves the rotational behaviour of the 3D object, because it prevents the object from tilting to the side while dragging the mouse. + + All files in `{\tt{}doc/javascript}' work off-the-shelf and can be copied into a single file in order to combine their effects. + +\end{enumerate} + +\section{Media formats} +\begin{table}[H] +\caption{Media formats for use with Adobe Reader (partially from \cite{pdfspec})}\label{table:mime} +\RaggedRight +\begin{tabular}[t]{llp{0.36\linewidth}}\hline +Extension & MIME type & Description\\\hline\hline\\[-2.5ex] +aif, aifc, aiff & audio/aiff & Audio Interchange File Format\\ +au, snd & audio/basic & NeXT/Sun Audio Format\\ +avi & video/avi & Audio/Video Interleaved\\ +gif & image/gif & (animated) GIF\\ +mid, rmi & audio/midi & Musical Instrument Digital Interface\\ +mov, qt & video/quicktime & Apple QuickTime\\ +mp3, m3u & audio/x-mp3 & MPEG Audio Layer-3\\ +mp4 & video/mp4 & MPEG-4 Video\\ +mpeg, mpg & video/mpeg & MPEG-1 \& 2 Video\\ +prc & model/prc & Adobe PRC Format (3D), requires Reader-8.1 or higher\\ +ra & audio/vnd.rn-realaudio & Real Audio\\ +rm, rv & application/vnd.rn-realmedia & Real Media (video \& sound)\\ +smil & application/smil & Synchronized Multimedia Integration Language\\ +swf & application/x-shockwave-flash & (Adobe?) Macromedia Flash\\ +u3d & model/u3d & Universal 3D File Format\\ +wav & audio/wav & MS Audio Format\\ +wma & audio/x-ms-wma & Windows Media Audio\\ +wmv & video/x-ms-wmv & Windows Media Video\\\hline +\end{tabular} +\end{table} + +\begin{thebibliography}{9} + \bibitem{pdfspec} Adobe Systems Inc.: \emph{PDF Reference, fifth edition: Adobe Portable Document Format version 1.6}, 2004, Implementation note 144, Appendix H.3, available at \href{http://www.adobe.com/devnet/pdf/pdf_reference.html}{\tt http://www.adobe.com/devnet/pdf/pdf\_reference.html} + \bibitem{3diforg} \href{http://www.3dif.org/}{\tt http://www.3dif.org/} + \bibitem{dexp} \href{http://www.righthemisphere.com/products/dexp/}{\tt http://www.righthemisphere.com/products/dexp/} + \bibitem{jscript3D} Adobe Systems Inc.: \emph{JavaScript for Acrobat\textsuperscript{\scriptsize\textregistered} 3D Annotations API Ref\-er\-ence}, 2006, available at \href{http://www.adobe.com/devnet/acrobat/javascript3d.html}{\tt http://www.adobe.com/devnet/acrobat/} \href{http://www.adobe.com/devnet/acrobat/javascript3d.html}{\tt javascript3d.html} + \bibitem{jscript} Adobe Systems Inc.: \emph{JavaScript for Acrobat\textsuperscript{\scriptsize\textregistered} API Reference}, 2006, available at \href{http://www.adobe.com/devnet/acrobat/javascript.html}{\tt http://www.adobe.com/devnet/acrobat/javascript.html} +\end{thebibliography} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf b/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf Binary files differnew file mode 100644 index 00000000000..10aaf5da387 --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/overlay-example.pdf diff --git a/Master/texmf-dist/doc/latex/movie15/overlay-example.tex b/Master/texmf-dist/doc/latex/movie15/overlay-example.tex new file mode 100644 index 00000000000..d2c791e256e --- /dev/null +++ b/Master/texmf-dist/doc/latex/movie15/overlay-example.tex @@ -0,0 +1,47 @@ +% Copyright 2006 Alexander Grahn +% +% This material is subject to the LaTeX Project Public License. See +% http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html +% for the details of that license. +% +\documentclass{beamer} +\setbeamertemplate{navigation symbols}{} +\usepackage{movie15} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% Some hints on using movie15 with /presentation/ packages +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +% 1. Options `autopause' and `autoresume' should be set, as this prevents the +% movie from being rewound when passing from one overlay to the next. + +% 2. Within presentations, \movieref's must be put on the /same/ overlay as +% their target. + +% 3. If the /same/ media file is to be inserted at multiple locations within a +% presentation, all instances must be given unique labels using the `label' +% option, even if no \movieref's are associated with the included media. + +\begin{document} +\begin{frame} + \begin{itemize} + \item<+-> 1st overlay + \item<+-> 2nd overlay + \begin{center} + \includemovie[ + poster, + autopause, autoresume, + text={\parbox{0.35\linewidth}{\tiny + http://www.linux-video.net/\\Samples/Mpeg1/AlienSong.mpg% + }}, + playerid=AAPL_QuickTime, + url + ]{0.4\linewidth}{0.3\linewidth}{% + http://www.linux-video.net/Samples/Mpeg1/AlienSong.mpg% + } + \end{center} + \item<+-> 3rd overlay + \item<+-> 4th overlay + \end{itemize} +\end{frame} +\end{document} |