<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

  <!ENTITY dhfirstname "<firstname>Marc</firstname>">
  <!ENTITY dhsurname   "<surname>Leeman</surname>">
  <!ENTITY dhdate      "<date>Fri Dec 30 19:47:26 CET 2005</date>">
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>marc.leeman@gmail.com</email>">
  <!ENTITY dhusername  "Marc Leeman">
  <!ENTITY dhucpackage "<refentrytitle>dvdauthor</refentrytitle>">
  <!ENTITY dhpackage   "dvdauthor">

  <!ENTITY debian      "<productname>Debian</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>
<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2003</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>
	<refpurpose>
	Creates DVD-Video file structure
	</refpurpose>
</refnamediv>
<refsynopsisdiv>
	<cmdsynopsis>
	<command>dvdauthor</command>
<arg><option>-t </option></arg>
<arg><option>-o </option><replaceable class="parameter">VTSBASE</replaceable></arg>
<arg><option>-d <replaceable class="parameter">n</replaceable></option></arg>
<arg><replaceable class="parameter">options</replaceable></arg>
<arg>VOBFILE(s)</arg>
	</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
	<title>DESCRIPTION</title>
	<para>
	<command>dvdauthor</command> creates DVD-Video file structure
	</para>
</refsect1>
<refsect1>
	<title>OPTIONS</title>
	<variablelist>
	<varlistentry>
		<term>-v <replaceable class="parameter">VOPTS</replaceable></term>
		<listitem>
			<para>
			<replaceable>VOPTS</replaceable> is a plus (+) separated list of video options. dvdauthor will try to infer any unspecified options. pal, ntsc, 4:3, 16:9, 720xfull, 720x576, 720x480, 704xfull, 704x576, 704x480, 352xfull, 352x576, 352x480, 352xhalf, 352x288, 352x240, nopanscan, noletterbox. Default is ntsc, 4:3, 720xfull
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-a <replaceable class="parameter">AOPTS</replaceable></term>
		<listitem>
			<para>
			<replaceable>AOPTS</replaceable> is a plus (+) separated list of options for an audio track, with each track separated by a comma (,). For example -a ac3+en,mp2+de specifies two audio tracks: the first is an English track encoded in AC3, the second is a German track encoded using MPEG-1 layer 2 compression. ac3, mp2, pcm, dts, 16bps, 20bps, 24bps, drc, surround, nolang, 1ch, 2ch, 3ch, 4ch, 5ch, 6ch, 7ch, 8ch, and any two letter ISO 639 language abbreviation. Default is 1 track, mp2, 20bps, nolang, 2ch. 'ac3' implies drc, 6ch.
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-s <replaceable class="parameter">SOPTS</replaceable></term>
		<listitem>
			<para>
			<replaceable>SOPTS</replaceable> is a plus (+) separated list of options for a subpicture track, with each track separated by a comma (,). nolang and any two letter language abbreviation (see -a) Default is no subpicture tracks. 
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-p <replaceable class="parameter">FILE</replaceable></term>
		<listitem>
			<para>
			<replaceable>FILE</replaceable> specifies where to get the subpicture palette. Settable per title and per menu. If the filename ends in .rgb (case insensitive) then it is assumed to be RGB, otherwise it is YUV. Entries should be 6 hexadecimal digits. <replaceable>FILE</replaceable> defaults to xste-palette.dat
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-f <replaceable class="parameter">FILE</replaceable></term>
		<listitem>
			<para>
			<replaceable>FILE</replaceable> is either a file, a pipe, or a shell command ending in | which supplies an MPEG-2 system stream with VOB sectors inserted in the appropriate places (using mplex -f 8 to generate) 
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-c <replaceable class="parameter">COPTS</replaceable></term>
		<listitem>
			<para>
			<replaceable>COPTS</replaceable> is a comma (,) separated list of chapter markers. Each marker is of the form [[h:]mm:]ss[.frac] and is relative to the SCR of the next file listed (independent of any timestamp transposing that occurs within dvdauthor). The chapter markers ONLY apply to the next file listed. <replaceable>COPTS</replaceable> defaults to 0
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-m </term>
		<listitem>
			<para>
			creates a menu	
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-t </term>
		<listitem>
			<para>
			creates a title 
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-T </term>
		<listitem>
			<para>
			creates the table of contents file instead of a titleset. If this option is used, it should be listed first, and you may not specify any titles
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-e <replaceable class="parameter">EOPTS</replaceable></term>
		<listitem>
			<para>
			<replaceable>EOPTS</replaceable> makes the current menu the default for certain circumstances. EOPTS is a comma separated list of any of: 
			</para>
			<para>
			for TOC menus: title 
			</para>
			<para>
			for VTS menus: root, ptt, audio, subtitle, angle 
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-b <replaceable class="parameter">X1xY1-X2xY2,DEST</replaceable></term>
		<listitem>
			<para>
			creates a button of the specified size. See --instructions or -i for a description of DEST.
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-i <replaceable class="parameter">post=DEST</replaceable></term>
		<listitem>
			<para>
			executes the <replaceable>DEST</replaceable> executes the DEST instructions at the end of the title.  DEST is a plus separated list of the following: 
			</para>
			<para>
			vtsm[X][.Y] - jump to titleset X, menu Y.  Note that currently	a VMGM can only jump to menu 1, and a VTSM cannot specify another titleset.  
			</para>
			<para>
			vtsX[.Y] - jump to title X, chapter Y.  If specified on a titleset menu, then the title number refers to a title within the currently titleset.  
			</para>
			<para>
			vmgmX - jump to menu X in the VMGM (table of contents).  rsm - resume the movie.  
			</para>
			<para>
			exit - exits the DVD.  
			</para>
			<para>
			fpc - jump to the first play chain.  
			</para>
			<para>
			audioX - switch to audio track X.  
			</para>
			<para>
			subtitleX - switch to subtitle track X.  
			</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>-h </term>
		<listitem>
			<para>
			displays short usage
			</para>
		</listitem>
	</varlistentry>
	</variablelist>
</refsect1>
<refsect1>
	<title>USAGE</title>
	<para>
	<command>dvdauthor</command> -o dvd *.vob
	</para>
</refsect1>
<refsect1>
	<title>CAVEATS</title>
	<para>
	None.
	</para>
</refsect1>
<refsect1>
	<title>BUGS</title>
	<para>
	None.
	</para>
</refsect1>
<refsect1>
	<title>AUTHOR</title>
	<para>
	<author>
		<firstname>Marc</firstname>
		<surname>Leeman</surname>
		<contrib>This manual page was written by Marc Leeman &#60;marc.leeman@gmail.com&#62;, for the Debian GNU/Linux system (but may be used by others).</contrib>
	</author>
	</para>
</refsect1>
</refentry>
