DVDBuilder for C++  3.4
DVD Authoring Software Development Kit
<videoObject> Element

Description

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 255 Specifies the number of seconds to pause after the Video Object playback. The value 255 specifies infinite pause.
callback 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 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

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 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> Specifies an audio elementary stream.
<videoStream> Specifies a video elementary stream.
<subpictureStream> Specifies a subpicture elementary stream.

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.

<?xml version='1.0' encoding='utf-8'?>
<dvd version='2.3' xmlns='http://www.primosoftware.com/dvdbuilder/2.3'>
<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.

<?xml version='1.0' encoding='utf-8'?>
<dvd version='2.3' xmlns='http://www.primosoftware.com/dvdbuilder/2.3'>
<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.3, because the <audioStream> and <videoStream> tags require DVDBuilder project schema 2.2 or later.

<?xml version='1.0' encoding='utf-8'?>
<dvd version='2.3' xmlns='http://www.primosoftware.com/dvdbuilder/2.3'>
<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>

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.