/usr/share/doc/dvdauthor/html/spumux.html is in dvdauthor 0.7.0-1.3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>spumux</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="DVDAuthor"
HREF="index.html"><LINK
REL="UP"
TITLE="DVDAuthor Man Pages"
HREF="manpages.html"><LINK
REL="PREVIOUS"
TITLE="mpeg2desc"
HREF="r2319.html"><LINK
REL="NEXT"
TITLE="spuunmux"
HREF="spuunmux.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>DVDAuthor</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="r2319.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="spuunmux.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="SPUMUX"
></A
>spumux</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2404"
></A
><H2
>Name</H2
>spumux -- generates and multiplexes subtitles into an existing mpeg2 program stream</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2407"
></A
><H2
>Synopsis</H2
><P
><B
CLASS="COMMAND"
>spumux</B
> [-m dvd | -m cvd | -m svcd] [-s <TT
CLASS="REPLACEABLE"
><I
>stream</I
></TT
>] [-v <TT
CLASS="REPLACEABLE"
><I
>level</I
></TT
>] [-P] {<TT
CLASS="REPLACEABLE"
><I
>file</I
></TT
>} {< <TT
CLASS="REPLACEABLE"
><I
>mpeg</I
></TT
>} {> <TT
CLASS="REPLACEABLE"
><I
>mpeg-with-subtitles</I
></TT
>}</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2425"
></A
><H2
>Description</H2
><P
><B
CLASS="COMMAND"
>spumux</B
> encodes the subtitles and multiplexes it into the mpeg2 program stream.</P
><DIV
CLASS="GLOSSLIST"
><DL
><DT
><B
>-m <TT
CLASS="REPLACEABLE"
><I
>mode</I
></TT
></B
></DT
><DD
><P
> Sets the encoding for the subtitles. Can be dvd, cvd, or svcd.
Default is dvd. </P
></DD
><DT
><B
>-s <TT
CLASS="REPLACEABLE"
><I
>stream</I
></TT
></B
></DT
><DD
><P
>Sets the subtitle stream id. Default is 0.</P
></DD
><DT
><B
>-v <TT
CLASS="REPLACEABLE"
><I
>level</I
></TT
></B
></DT
><DD
><P
>Sets the verbosity level.</P
></DD
><DT
><B
>-P</B
></DT
><DD
><P
>Enables a progress bar.</P
></DD
></DL
></DIV
><P
>Here's a sample configuration file:</P
><PRE
CLASS="SYNOPSIS"
><subpictures>
<stream>
<spu start="<TT
CLASS="REPLACEABLE"
><I
>start-time</I
></TT
>" [ end="<TT
CLASS="REPLACEABLE"
><I
>end-time</I
></TT
>" ] [ image="<TT
CLASS="REPLACEABLE"
><I
>picture.png</I
></TT
>" ]
[ highlight="<TT
CLASS="REPLACEABLE"
><I
>picture.png</I
></TT
>" ] [ select="<TT
CLASS="REPLACEABLE"
><I
>picture.png</I
></TT
>" ]
[ transparent="<TT
CLASS="REPLACEABLE"
><I
>color-code</I
></TT
>" ] [ force="yes" ]
[ autooutline="infer" [ outlinewidth="<TT
CLASS="REPLACEABLE"
><I
>width</I
></TT
>" ]
[ autoorder="rows" | autoorder="columns" ] ]
[ xoffset="<TT
CLASS="REPLACEABLE"
><I
>x-coord</I
></TT
>" yoffset="<TT
CLASS="REPLACEABLE"
><I
>y-coord</I
></TT
>" ] >
<button [ name="<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" ] [ x0="<TT
CLASS="REPLACEABLE"
><I
>x0</I
></TT
>" ] [ y0="<TT
CLASS="REPLACEABLE"
><I
>y0</I
></TT
>" ] [ x1="<TT
CLASS="REPLACEABLE"
><I
>x1</I
></TT
>" ]
[ y1="<TT
CLASS="REPLACEABLE"
><I
>y1</I
></TT
>" ] [ up="<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" ] [ down="<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" ]
[ left="<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" ] [ right="<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" ] />
<action [ name="<TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
>" ] />
</spu>
</stream>
</subpictures></PRE
><P
> Each subtitle image is described by an <spu> tag. The start and
optional end attributes describe when the subtitle will be displayed
on the screen, in "HR:MM:SS.HU". The image attribute describes the
main subtitle image, which can either be a PNG or BMP file. If your
image is not a full screen image, you can use xoffset and yoffset to
move the picture around. In the advent that the author is unable to
use a graphics format with an alpha channel, then the transparent
attribute can be used to describe which color should become fully
transparent. The color is in hexadecimal as "RRGGBB". If you want to
force the display of the subtitle, regardless of whether the user has
enabled subtitles or not, you can use the force tag. When you are
making menus, the force tag is required. </P
><P
> The remaining attributes and tags are related to menu creation. The
highlight attribute shows what all the buttons look like when they are
highlighted (i.e. when you are using the arrows in the menu), and the
select attribute shows what all the buttons look like when the are
selected (i.e. for the 1-2 seconds after you press enter in the menu).
If either of these (or the image attribute) are omitted, then spumux
creates a blank (totally transparent) image. Obviously at least one
tag should be specified. </P
><P
> To aid in button creation, the autooutline attribute instructs spumux
to infer where the buttons are located. It does this by attempting to
draw rectangles around a composition of the highlight and select
images which do not intersect any opaque or semi-opaque pixels. In
order to support textual buttons, the attribute outlinewidth allows
you to specify the width of the rectangle which is tested. Wider
rectangles won't be able to squeeze between the letters. Finally,
autoorder describes which way to order the automatically detected
buttons, which is important for numerically selected buttons and for
mapping buttons to button names or to the implied names. </P
><P
> The button and action tags describe the buttons (visibly selectable
objects on the screen) and actions (commands that are executed as soon
as the associated key is pressed on the remote). If you are using the
autooutline feature, just designing buttons, are happy with the
inferred button navigation, and can deal with the simplistic naming
system, then you actually do not even need to specify any buttons or
actions. Otherwise, read on. </P
><P
> The name attribute is used to give a button or action an easy to refer
to name. By default they are numbered sequentially starting with "1".
The up, down, left, and right names describe which button or action
should be tied to the corresponding key when the current button is
highlighted, though if omitted spumux will use a reasonably
intelligent algorithm to determine which buttons to move to. </P
><P
> The (x0,y0) coordinates describe the upper left hand corner
inclusively, while the (x1,y1) coordinates describe the lower right
hand corner EXclusively. The coordinates start at 0,0 for the upper
left hand corner. Ideally, the y0 and y1 coordinates should both be
even, so the button edges fully empasses two interlaced scanlines,
even if there is no data in the extra scanline. Some DVD players will
fill in the extra scanline if it is not specified; spumux makes an
effort to ensure that will be transparent but there is no guarantee. </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2476"
></A
><H2
>Handling text based subtitles</H2
><P
> Spumux is also able to handle text subtitles, which will be rendered to
graphics by spumux. A lot of different text (must be non-graphic) formats
are supported (.sub, .srt, .ssa, .smi, .rt , .txt, .aqt, .jss, .js, ass).
Spumux will try to determine the format automatically. </P
><P
> If processing textbased subtitles no other streams can be defined, buttons
or others need to be processed in another pass with spumux, using another
xml file. </P
><P
> Following .xml file shows the available tags and their default settings.
Only the textsub tag is mandatory, defaults are used if the specific tag
is not specified. </P
><PRE
CLASS="SYNOPSIS"
><subpictures>
<stream>
<textsub filename="demo1.srt" characterset="ISO8859-1"
fontsize="28.0" font="arial.ttf" horizontal-alignment="left"
vertical-alignment="bottom" left-margin="60" right-margin="60"
top-margin="20" bottom-margin="30" subtitle-fps="25"
movie-fps="25" movie-width="720" movie-height="574"
force="yes"
/>
</stream>
</subpictures></PRE
><P
> The textsub tag defines the settings for the text to graphics rendering. </P
><P
> The filename attribute defines the path and name of the input text subtitle
file, this is the only attribute that is mandatory. </P
><P
> The characterset attribute defines the characterset to be used, available
charactersets can be found at http://www.gnu.org/software/libiconv. </P
><P
> The fontsize attribute defines the size of the font in font units.
The font attribute defines the font used. Spumux will look into the home
directory in subdirectory .spumux for fonts on linux systems and will
look into the windows/fonts and subdirectory spumux of the cygwin/mingw
home directory and into the exucution directory for windows based
execution for the specified font. Looking for free fonts? One listing is
here http://www.microsoft.com/typography/links/links.asp?type=free&part=1
(this is only about fonts, not about operating systems). </P
><P
> The horizontal-alignment attribute defines the horizontal alignment of the
subtitles. Options are: "left", "right", "center" and "default".
The "default" value causes spumux to use the attribute that is in the text
subtitle file if the format supports such an attribute. </P
><P
> The vertical-alignment attribute defines the vertical alignment.
Options are: "top", "center" and "bottom". </P
><P
> The margin attributes define the minimum blank pixel space between the
border of the image and the border of the subtitle lines. </P
><P
> Defining the subtitle-fps and movie-fps attributes make it possible for
spumux to recalculate the subtitle timing if these are not the same. </P
><P
> The movie-width and movie-height attributes define the maximum size of
the subtitle page, these shouldn't be larger than the fram-size of the
movie frame, normally they are the same. Some DVD-players more like
subtitle frames that are 2 or 4 pixels smaller in height. </P
><P
> The force option allows you to force the display of the subtitle,
regardless of whether the user has enabled subtitles or not. </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="r2319.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="spuunmux.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mpeg2desc</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="manpages.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>spuunmux</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
|