File: dvd-menu.html

package info (click to toggle)
dvd-slideshow 0.8.6.1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,844 kB
  • sloc: sh: 8,836; makefile: 4
file content (280 lines) | stat: -rw-r--r-- 8,508 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
Content-type: text/html; charset=UTF-8

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of dvd-menu</TITLE>
</HEAD><BODY>
<H1>dvd-menu</H1>
Section: dvd-slideshow (1)<BR>Updated: 0.8.4<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

<P>

dvd-menu - Creates a DVD navigation menu with buttons.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<P>

dvd-menu <I>-t</I> &lt;<I>ButtonText1</I>&gt; ... <I>-t</I> &lt;<I>ButtonTextN</I>&gt; <I>-f</I> &lt;<I>XML_file1 | MPEG_file1</I>&gt; ... <I>-f</I> &lt;<I>XML_fileN | MPEG_fileN</I>&gt; [<I>-o</I> &lt;<I>output directory</I>&gt;] [<I>-n</I> &lt;<I>DVD Title</I>&gt;] [<I>-b</I> &lt;<I>background jpeg</I>&gt;] [<I>-e</I> &lt;<I>embed image</I>&gt;] [<I>-a</I> &lt;<I>audiofile</I>&gt;]  [<I>-p</I>] [<I>-c</I>] [<I>-D</I>] [<I>-W</I>] [<I>-mp2</I>] [<I>-iso</I>] [<I>-nomenu</I>] [<I>-L</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<P>

Creates a simple top-level DVD menu with buttons that link to movies.  Accepts the output XML files from dvd-slideshow or your own self-defined MPEG movies.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>

<P>

<P>
<DL COMPACT>
<DT><B>-t</B> &lt;<I>Button text</I>&gt;<DD>
The button text visible on the menu which will link to each corresponding (in order passed) -f option.  Use this option multiple times with -f to define multiple titles/buttons.
<P>
<DT><B>-f</B> &lt;<I>Input file</I>&gt;<DD>
Can be an XML file output from dvd-slidshow or a full-scale mpeg2 video in the proper format (.vob).  No error checking is done if you pass a MPEG2 .vob input file, so you are on your own. Use this option multiple times with -t to define multiple titles/buttons.
<P>
<DT>[<B>-o</B> &lt;<I>Output directory</I>&gt;]<DD>
Directory where the final DVD filesystem files VIDEO_TS/ will be written.
<P>
<DT>[<B>-n</B> &lt;<I>DVD Title</I>&gt;]<DD>
This will be printed at the top of the DVD menu page.
<P>
<DT>[<B>-b</B> &lt;<I>Background jpeg</I>&gt;]<DD>
Image to use for the background DVD menu. If no file is specified, a blue gradient will be used for the menu background.
<P>
<DT>[<B>-e</B> &lt;<I>embed image</I>&gt;]<DD>
Embed an image in the menu screen.  This image will show up to the left of the menu buttons.
<P>
<DT>[<B>-a</B> &lt;<I>Audio file</I>&gt;]<DD>
Audio file to play while the menu is active. Supports mp3, ogg, or wav formats at this point.
<P>
<DT>[<B>-mp2</B>]<DD>
Use mp2 audio by default (requires ffmpeg with ac3 encoding). The default audio format is now AC3 instead of mpeg2 sinceI have found that many DVD players do not play the audio when it is in mp2 format, so this may be a better, more compatible option for most people. 
<P>
<DT>[<B>-p</B>]<DD>
Use PAL output video format instead of NTSC.
<P>
<DT>[<B>-c</B>]<DD>
Use continuous &lt;post&gt; commands within dvdauthor.  This will make each video play one after another without going back up to the main menu until the last video is finished.  If this option is not used, the dvd will return to the top menu after playing each track.
<P>
<DT>[<B>-D</B>]<DD>
Do not call dvdauthor.  This will tell dvd-menu to create the menu and output xml files to pass to dvdauthor, but will not actually run dvdauthor.  Useful for people who want to modify their xml file before running dvdauthor.
<P>
<DT>[<B>-W</B>]<DD>
Do not generate 50% transparent white background overlays under the title and menu buttons.
<P>
<DT>[<B>-iso</B>]<DD>
Create iso image with mkisofs when finished.
<P>
<DT>[<B>-nomenu</B>]<DD>
Do not create a menu.  Useful for just finishing the dvdauthor xml file from one video that you want to just start playing when the user puts it into a dvd player.
<P>
<DT>[<B>-L</B>]<DD>
Create a low quality, half-slize menu.  This works with dvd-slideshow so you can render your whole project in low-quality mode and still test everything quickly.
<P>
<DT>[<B>-theme &lt;themefile&gt;</B>]<DD>
Use the given theme when setting variables/colors/etc. Themes are installed in /opt/dvd-slideshow/themes or in a local directory ~/.dvd-slideshow/themes
<P>
<DT>[<B>-fadein</B>]<DD>
Fade in from background before menu
<P>
<DT>[<B>-fadeout</B>]<DD>
Fade to background after menu buttons are pressed.
<P>
<DT>[<B>-vcd</B>]<DD>
(alpha) Create vcd .cue and .bin files (requires vcdimager)
<DT>[<B>-svcd</B>]<DD>
(alpha) Create svcd .cue and .bin files (requires vcdimager)
<P>
<DT><B>-h</B><DD>
Prints help file (basically this manpage).
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>CONFIGURATION</H2>

Settings can be passed on the command line, in a default ~/.dvd-slideshow/dvd-slideshowrc file, or in a theme file.  The order in which the script reads the settings is as follows:
<BR>

Default script settings --&gt; ~/.dvd-slideshow/dvd-slideshowrc --&gt; theme --&gt; command line
<BR>

so each successive setting will over-ride the previous settings if they are already set.
<P>
<DL COMPACT>
<DT><B>~/.dvd-slideshow/dvd-slideshowrc:</B><DD>
<BR>

With the syntax shown below, the following variables can be specified in the ~/.dvd-slideshow/dvd-slideshowrc file.  All lines are optional, and everything after the # character is not read.
<BR>

<P>
# general:
<BR>

menu_continuous_play=0 # set to 1 to play one file after another without going back up to menu.
<BR>

<P>
menu_fadein=0 # set to 1 to fade in to menu
<BR>

menu_fadeout=0 # set to 1 to fade out from menu after a button is pressed.
<BR>

<P>
menu_background=steelblue  # or, use hex #RRGGBB
<BR>

#menu_background=&quot;#882211&quot;      # use a hex RGB color if you wish
<BR>

#menu_background=&quot;mybackground.jpg&quot;     # specify a real image if you want
<BR>

## pick other colors here: <A HREF="http://www.imagemagick.org/script/color.php">http://www.imagemagick.org/script/color.php</A>
<BR>

<P>
menu_fade_to_image=&quot;black&quot;     # image to fade to/from before/after menu
<BR>

#menu_fade_to_image=&quot;#ff3344&quot;
<BR>

#menu_fade_to_image=&quot;myimage.jpg&quot;
<BR>

<P>
#menu_title_font=&quot;/usr/share/fonts/default/Type1/n019004l.pfb&quot; # Helvetical bold URW font
<BR>

menu_title_font_size=40
<BR>

menu_title_font_color=black
<BR>

menu_title_white_height=125
<BR>

menu_title_location_x=80
<BR>

menu_title_location_y=50
<BR>

#menu_title_justify=center
<BR>

<P>
menu_panel_height=28
<BR>

menu_panel_width=288
<BR>

menu_panel_location_x=360
<BR>

menu_panel_location_y=175  # distance of the top of the first menu item to the top of the screen
<BR>

<P>
#menu_button_font=&quot;/usr/share/fonts/default/Type1/n019004l.pfb&quot; # Helvetical bold URW font
<BR>

menu_button_font_size=21
<BR>

menu_button_font_color=black
<BR>

menu_button_hilight_color=red
<BR>

<P>
#menu_audio=myaudio1.mp3  
<BR>

</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>THEMES</H2>

A theme is just a file containing a list of configuration variables, and possibly also background images, fonts, or audio in the same directory.
<BR>

<P>
Any of the configuration variables can be placed in a dvd-slideshow theme file to control dvd-menu also.
<BR>

<P>
This will be explained more later...
<BR>

<A NAME="lbAH">&nbsp;</A>
<H2>FILES</H2>

<P>

<I>dvd-slideshow</I> 
<BR>

<I>dvd-menu</I> 
<BR>

<I>gallery1-to-slideshow</I> 
<BR>

<I>dir2slideshow</I> 
<BR>

<I>jigl2slideshow</I> 
<A NAME="lbAI">&nbsp;</A>
<H2>EXAMPLES</H2>

<P>

There are a few heavily-commented examples available in the examples section of the dvd-slideshow webpage, which you can find at <A HREF="http://dvd-slideshow.sourceforge.net">http://dvd-slideshow.sourceforge.net</A>
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHORS</H2>

<P>

Scott Dylewski &lt;scott at dylewski dot com&gt;
<BR>

<A HREF="http://dvd-slideshow.sourceforge.net">http://dvd-slideshow.sourceforge.net</A>
<A NAME="lbAK">&nbsp;</A>
<H2>SEE ALSO</H2>

<P>

<A HREF="/cgi-bin/man/man2html?1+dvd-slideshow">dvd-slideshow</A>(1)
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">CONFIGURATION</A><DD>
<DT><A HREF="#lbAG">THEMES</A><DD>
<DT><A HREF="#lbAH">FILES</A><DD>
<DT><A HREF="#lbAI">EXAMPLES</A><DD>
<DT><A HREF="#lbAJ">AUTHORS</A><DD>
<DT><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 20:09:28 GMT, December 30, 2015
</BODY>
</HTML>