DVDBuilder for .NET | Online Documentation

DVD Project File > <dvd> > <titleSet> > <titles> > <title> > <videoObject>

DVDBuilder(tm) 2.1.1 for .NET

<videoObject> Element

<title> Element | Topics | Example | Send Feedback

Specifies video content for the title.

<videoObject
   file="file"
   pause="num"
   callback="true|false"
   aspectRatio="4:3|16:9"
   resolution="720x480|704x480|352x480|352x240|720x576|704x576|352x576|352x288"
   frameRate="29.97|25"/>

Required Attributes

Attribute	Description
file	Specifies a file that contains an MPEG-2 movie.

Optional Attributes

Attribute	Option	Description
pause	0 to 254	Specifies the number of seconds to pause after the Video Object playback.
callback (Version 1.1.0.1)	true	Indicates that the video object data should be read from a stream object supplied by the user. The value of the 'file' attribute will be passed to the callback object for reference.
	false	Indicates that the video object data should be read from a standard file specified with the 'file' attribute.
aspectRatio (Version 1.1.0.1)	4:3	Indicates that the video stream of this video object use Normal (4:3) aspect ratio.
	16:9	Indicates that the video stream of this video object use Wide Screen (16:9) aspect ratio.
resolution (Version 1.1.0.1)	NTSC: 720x480 \| 704x480 \| 352x480 \| 352x240 PAL : 720x576 \| 704x576 \| 352x576 \| 352x288	NTSC 720 x 480 pixels MPEG-2 704 x 480 pixels MPEG-2 352 x 480 pixels MPEG-2 352 x 240 pixels MPEG-1 or MPEG-2 PAL 720 x 576 pixels MPEG-2 704 x 576 pixels MPEG-2 352 x 576 pixels MPEG-2 352 x 288 pixels MPEG-1 or MPEG-2
frameRate (Version 1.1.0.1)	NTSC: 29.97 PAL : 25	NTSC MPEG video must be encoded at 29.97 frames per second. PAL MPEG video must be encoded at 25 frames per second.

Child Elements

Element	Description
<audioStream> (Version 2.1.1.1)	Specifies an audio elementary stream.
<videoAtream> (Version 2.1.1.1)	Specifies a video elementary stream.
<subpictureStream> (Version 2.1.1.1)	Specifies a subpicture elementary stream.

Remarks

DVDBuilder automatically detects the aspect ratio, the resolution and the frame rate of each video stream. If the aspect ratio, resolution or frame rate are specified the values in the project XML the values detected from the video stream will be ignored. The reason for this behavior is to allow input from encoders/multiplexers which set wrong values for aspect ratio, resolution and frame rate in the MPEG-2 streams.

Example

The following example shows a DVD that has one title made of two video objects. When the first video object has been played the DVD player will pause the playback for 10 seconds and then will continue with the second video object.

Copy Code

<?xml version="1.0" encoding="utf-8"?>
<dvd version="1.1.0.1" xmlns="http://www.primosoftware.com/dvdbuilder">
  <videoManager firstPlayNavigate="Title=1;"/>
  <titleSet>
    <titles>
      <title id="1" chapters="00:00:00;">
        <videoObject file="1.mpg" pause="10"/>
        <videoObject file="2.mpg" pause="0"/>
      </title>
    </titles>
  </titleSet>
</dvd>

The following example shows a DVD that has one title made of two video objects. Aspect rate, resolution and frame rate are explicitly specified for each video object.

Copy Code

<?xml version="1.0" encoding="utf-8"?>
<dvd version="1.1.0.1" xmlns="http://www.primosoftware.com/dvdbuilder">
  <videoManager firstPlayNavigate="Title=1;"/>
  <titleSet>
    <titles>
      <title id="1" chapters="00:00:00;">
        <videoObject file="1.mpg" aspectRatio="4:3" resolution="720x576" frameRate="25"/>
        <videoObject file="2.mpg" aspectRatio="4:3" resolution="720x576" frameRate="25"/>
      </title>
    </titles>
  </titleSet>
</dvd>

The following example shows a DVD that has one title made of a video object using audio/video elementary streams. Note that the version attribute in the <dvd> tag is set to 2.1.1.1, because the <audioStream> and <videoStream> tags require DVDBuilder 2.1.1.1 or later.

Copy Code

<?xml version="1.0" encoding="utf-8"?>
<dvd version="2.1.1.1" xmlns="http://www.primosoftware.com/dvdbuilder">
  <videoManager firstPlayNavigate="Title=1;"/>
  <titleSet>

    <audioStreams>
      <stream languageCode="EN" mpegStreamID="0xC0" mpegSubstreamID="0x00"/>
    </audioStreams>

    <titles>
      <title id="1" chapters="00:00:00">

        <videoObject>
            <audioStream file="movie1.mpa" format="MPA"/>
            <videoStream file="movie1.mpv" />
        </videoObject>

      </title>
    </titles>
  </titleSet>
</dvd>

Group

<title> Element

Topics

Topic	Description
<audioStream> Element	Specifies an audio stream.
<videoStream> Element	Specifies a video stream.
<subpictureStream> Element	Specifies a subpicture stream.

Links

<title> Element, Topics, Example