DVDBuilder for C++  3.4
DVD Authoring Software Development Kit
Enumerations
primo::dvdbuilder::DVDBuilderError Namespace Reference

DVDBuilderError namespace. More...

Enumerations

enum  Enum {
  _ProjectErrorStart = 0x00000100,
  _ProjectErrorEnd = 0x000001FF,
  _VideoErrorStart = 0x00000200,
  _VideoErrorEnd = 0x000002FF,
  _AudioErrorStart = 0x00000300,
  _AudioErrorEnd = 0x000003FF,
  _BitmapErrorStart = 0x00000400,
  _BitmapErrorEnd = 0x000004FF,
  _MultiplexerErrorStart = 0x00000500,
  _MultiplexerErrorEnd = 0x000005FF,
  _OtherErrorStart = 0x00001F00,
  _OtherErrorEnd = 0x00001FFF,
  Success = GenericError::Success,
  InternalError = GenericError::InternalError,
  NoProject = DVDBuilderError::_ProjectErrorStart,
  InvalidProjectXml = DVDBuilderError::_ProjectErrorStart + 1,
  ProjectVersionMissing = DVDBuilderError::_ProjectErrorStart + 2,
  UnsupportedProjectVersion = DVDBuilderError::_ProjectErrorStart + 3,
  VideoManagerMissing = DVDBuilderError::_ProjectErrorStart + 4,
  VideoManagerFirstPlayMissing = DVDBuilderError::_ProjectErrorStart + 5,
  InvalidButton = DVDBuilderError::_ProjectErrorStart + 6,
  InvalidMenu = DVDBuilderError::_ProjectErrorStart + 7,
  MenuIdMissing = DVDBuilderError::_ProjectErrorStart + 8,
  DuplicateMenuId = DVDBuilderError::_ProjectErrorStart + 9,
  NoTitlesets = DVDBuilderError::_ProjectErrorStart + 10,
  NoTitles = DVDBuilderError::_ProjectErrorStart + 11,
  NoMenus = DVDBuilderError::_ProjectErrorStart + 12,
  TitleIdMissing = DVDBuilderError::_ProjectErrorStart + 13,
  DuplicateTitleId = DVDBuilderError::_ProjectErrorStart + 14,
  NoChapters = DVDBuilderError::_ProjectErrorStart + 15,
  NoVob = DVDBuilderError::_ProjectErrorStart + 16,
  VobFileMissing = DVDBuilderError::_ProjectErrorStart + 17,
  TooManyTitles = DVDBuilderError::_ProjectErrorStart + 18,
  FirstChapterNotZeroTime = DVDBuilderError::_ProjectErrorStart + 19,
  ChaptersOutOfOrder = DVDBuilderError::_ProjectErrorStart + 20,
  InvalidChapterTime = DVDBuilderError::_ProjectErrorStart + 21,
  InvalidProjectVobAspectRatio = DVDBuilderError::_ProjectErrorStart + 22,
  InvalidProjectVobResolution = DVDBuilderError::_ProjectErrorStart + 23,
  InvalidProjectVobFrameRate = DVDBuilderError::_ProjectErrorStart + 24,
  MenuVobTooBig = DVDBuilderError::_ProjectErrorStart + 25,
  ElementaryStreamFileMissing = DVDBuilderError::_ProjectErrorStart + 26,
  InvalidAudioEsFormat = DVDBuilderError::_ProjectErrorStart + 27,
  InvalidElementaryStream = DVDBuilderError::_ProjectErrorStart + 28,
  TooManyButtons = DVDBuilderError::_ProjectErrorStart + 29,
  InconsistentTitleContentSpecified = DVDBuilderError::_ProjectErrorStart + 30,
  ChapterFileMissing = DVDBuilderError::_ProjectErrorStart + 31,
  InvalidVideoFrameRate = DVDBuilderError::_VideoErrorStart,
  InvalidVideoFormat = DVDBuilderError::_VideoErrorStart + 1,
  InvalidVideoAspectRatio = DVDBuilderError::_VideoErrorStart + 2,
  InvalidVideoResolution = DVDBuilderError::_VideoErrorStart + 3,
  InconsistentVideoStreams = DVDBuilderError::_VideoErrorStart + 4,
  InvalidAudioFormat = DVDBuilderError::_AudioErrorStart,
  InvalidAudioFrequency = DVDBuilderError::_AudioErrorStart + 1,
  SubpictureEncodingError = DVDBuilderError::_BitmapErrorStart,
  InvalidBitmapDimensions = DVDBuilderError::_BitmapErrorStart + 1,
  UnexpectedBitmapColor = DVDBuilderError::_BitmapErrorStart + 2,
  InvalidBitmap = DVDBuilderError::_BitmapErrorStart + 3,
  UnsupportedBitmapCompression = DVDBuilderError::_BitmapErrorStart + 4,
  UnsupportedBitmapColorDepth = DVDBuilderError::_BitmapErrorStart + 5,
  MultiplexerError = DVDBuilderError::_MultiplexerErrorStart,
  MultiplexerParams = DVDBuilderError::_MultiplexerErrorStart + 1,
  MultiplexerUnderrun = DVDBuilderError::_MultiplexerErrorStart + 2,
  DataStreamError = DVDBuilderError::_OtherErrorStart + 1,
  InvalidNavigationCommand = DVDBuilderError::_OtherErrorStart + 2,
  Interrupted = DVDBuilderError::_OtherErrorStart + 3
}
 The DVDBuilderError::Enum type defines a range of error codes which are returned by the DVDBuilder::error() method. More...
 

Detailed Description

DVDBuilderError namespace.

See also
DVDBuilder::error
Version
1.0

Enumeration Type Documentation

enum Enum

The DVDBuilderError::Enum type defines a range of error codes which are returned by the DVDBuilder::error() method.

Each error code has an auxiliary message that helps to identify the error. It is called an error hint and is returned by the method DVDBuilder::GetErrorHint(). Some error codes do not have a hint since such is not needed to identify the error. Other error codes specify as hints invalid project element or the path to a problematic input file. The hint format is specific to the error code that it explains but there are some common conventions:

  • A text in italics specifies portions of the hint that are replaced by a concrete value.
  • When several project elements are placed one after another, separated by a space, this represents a (partial) hierarchy of project elements leading to the element where the error is located. The first element in a series is located near the root of the XML structure. Each successive element is located deeper.

Hint samples (definition and actual string):

hint: none

actual string: empty

hint: line:num column:num error-message

actual string: line:1 column:5 Unknown error.

hint: x.x.x.x

actual string: 1.1.0.1

hint: <videoManager> <menu id="\em num "> <button attributes >

actual string: <videoManager> <menu id="100"> <button left="10" top=(missing) height="30" width="100" navigate=(missing)>

This hint specifies a button with missing 'top' and 'navigate' attributes. The button is located in a menu with an id '10'. The menu itself is in the video manager.

hint: <titleSet nn > <menu id="\em duplicate-menu-id ">

actual string: <titleSet 02> <menu id="5">

This hint species a menu with id '5'. The menu is located in the second titleset in the dvd structure. NOTE: Titlesets are numbered from 01 to 99, but the numbering is implicitly based on their order in the project file.

hint: <titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

actual string: <titleSet 01> <title id="1"> file="C:\tmp\movies\test.mpg"

This hint specifies a video file "C:\tmp\movies\test.mpg" which is defined in a title with id '1'. The title is located in the first titleset defined in the project.

Version
1.0
Enumerator
_ProjectErrorStart 

This is not an actual error code.

This is a base value for DVDBuilder errors.

Success 

= 0

The operation is successful.

Hint: none

InternalError 

= 0x3

Unexpected error in DVDBuilder

Hint: none | error-message

NoProject 

= 0x100

No project is specified (neither buffer, not filename)

Hint: none

Version
2.0
InvalidProjectXml 

= 0x101

Malformed project XML

Hint: line:num column:num error-message

Version
2.0
ProjectVersionMissing 

= 0x102

Project version is not specified in the project

Hint: none

Version
2.0
UnsupportedProjectVersion 

= 0x103

The project version is higher then maximum recognized by DVDBuilder

Hint (maximum supported project version by DVDBuilder): x.x.x.x

Version
2.0
VideoManagerMissing 

= 0x104

There's no video manager in the project file. A <videoManager> element is required.

Hint: none

Version
2.0
VideoManagerFirstPlayMissing 

= 0x105

The video manager needs a first play command. It is executed when the DVD disc is loaded in the player. The command is set by the attribute 'firstPlayNavigate' of the <videoManager> element.

Hint: none

Version
2.0
InvalidButton 

= 0x106

A <button> element is not defined correctly.

Hint (one of the following):

<videoManager> <menu id="\em num "> <button attributes >

<titleSet nn > <menu id="\em num "> <button attributes >

Version
2.0
InvalidMenu 

= 0x107

A <menu> element is not defined correctly.

Hint (The invalid menu is either in the video manager or in a title set):

<videoManager> <menu id="\em num ">

<titleSet nn > <menu id="\em num ">

Version
2.0
MenuIdMissing 

= 0x108

A <menu> element has no 'id' attribute.

Hint (The invalid menu is either in the video manager or in a title set):

<videoManager>

<titleSet nn >

Version
2.0
DuplicateMenuId 

= 0x109

A menu has the same id as another menu and the conflict cannot be resolved. Menu id's must be unique within a titleset and within the video manager. Additionally the root menu of a titleset must not conflict with the root menu of another titleset.

Hint (The invalid menu is either in the video manager or in a title set):

<videoManager> <menu id="\em duplicate-menu-id ">

<titleSet nn > <menu id="\em duplicate-menu-id ">

Version
2.0
NoTitlesets 

= 0x10A

A DVD must have at least one video titleset.

Hint: none

Version
2.0
NoTitles 

= 0x10B

There are no titles in the titleset.

Hint: none

Version
2.0
NoMenus 

= 0x10C

The <menus> element is empty. When used it must contain at least one <menu> element.

Hint: none

Version
2.0
TitleIdMissing 

= 0x10D

A <title> element has no 'id' attribute

Hint (The titleset where the title is defined):

<titleSet nn >

Version
2.0
DuplicateTitleId 

= 0x10E

The attribute 'id' with the same value is used in more than one <title>.

Hint (The titleset where the duplicate title is defined and the title itself):

<titleSet nn > <title id="\em duplicate-title-id ">

Version
2.0
NoChapters 

= 0x10F

A title must have at least one chapter.

Hint: title-id

Version
2.0
NoVob 

= 0x110

A title must have at least one video object.

Hint: title-id

Version
2.0
VobFileMissing 

= 0x111

A <videoObject> element has no 'file' attribute or it's empty.

Hint: parent-title-id

Version
2.0
TooManyTitles 

= 0x112

A DVD disc can contain up to 99 titles.

Hint: none

Version
2.0
FirstChapterNotZeroTime 

= 0x113

The first chapter in a title must start from 00:00:00

Hint: title-id

Version
2.0
ChaptersOutOfOrder 

= 0x114

The defined chapters must be successive in time.

Hint: title-id

Version
2.0
InvalidChapterTime 

= 0x115

The chapter time should be before the end of the video object; it should be in the form hh:mm:ss.

Hint: title-id

Version
2.0
InvalidProjectVobAspectRatio 

= 0x116

The aspect ratio specified in the project file is invalid. It must be either 4:3 or 16:9.

Hint: <title id="\em num "> file="\em file-path "

Version
2.0
InvalidProjectVobResolution 

= 0x117

The resolution is not specified correctly in the project file. Allowed resolutions:

NTSC: 720x480 | 704x480 | 352x480 | 352x240

PAL: 720x576 | 704x576 | 352x576 | 352x288

Hint: <title id="\em num "> file="\em file-path "

Version
2.0
InvalidProjectVobFrameRate 

= 0x118

The framerate is not specified correctly in the project file. It must be either 29.97 fps (NTSC) or 25 fps (PAL).

Hint: <title id="\em num "> file="\em file-path "

Version
2.0
MenuVobTooBig 

= 0x119

The menu VOB cannot be bigger than 1GB.

Hint: none

Version
2.0
ElementaryStreamFileMissing 

= 0x11A

An elementary stream (<videoStream>, <audioStream> or <subpictureStream>) element has no 'file' attribute or it's empty.

Hint: parent-title-id

Version
2.1.1
InvalidAudioEsFormat 

= 0x11B

The audio format is invalid. The audio format must be MPA, AC3 or DTS.

Hint: <audioStream file="\em file-path " format="\em audio-format "

Version
2.1.1
InvalidElementaryStream 

= 0x11C

The specified elementary stream file is invalid.

Hint (one of the following):

<videoStream file="\em file-path "

<audioStream file="\em file-path "

<subpictureStream file="\em file-path "

Version
2.1.1
TooManyButtons 

= 0x11D

A 4:3 menu can contain up to 36 buttons. A 16:9 menu can contain up to 18 buttons.

Hint: none

Version
2.1.3
InconsistentTitleContentSpecified 

= 0x11E

A title content must be specified by either <videoObject> or by <chapter> elements. It is invalid input files to be specified in both <videoObject> and <chapter> elements.

Hint: title-id

Version
3.2
ChapterFileMissing 

= 0x11F

A <chapter> element has no 'file' attribute or it's empty.

Hint: parent-title-id

Version
3.2
InvalidVideoFrameRate 

= 0x200

The frame rate of the input video stream must be either 29.97 fps for NTSC or 25 fps for PAL.

Hint (one of the following):

<videManager> <menu id="\em num "> file="\em file-path "

<titleSet nn > <menu id="\em num "> file="\em file-path "

<titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

Version
2.0
InvalidVideoFormat 

= 0x201

The format of the input video must be either MPEG-1 or MPEG-2 program stream. NOTE: An elementary stream (raw video) is not accepted even if it's encoded with MPEG-1 or MPEG-2.

Hint (one of the following):

<videManager> <menu id="\em num "> file="\em file-path "

<titleSet nn > <menu id="\em num "> file="\em file-path "

<titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

Version
2.0
InvalidVideoAspectRatio 

= 0x202

The aspect ratio of the input video must be either 4:3 or 16:9.

Hint (one of the following):

<videManager> <menu id="\em num "> file="\em file-path "

<titleSet nn > <menu id="\em num "> file="\em file-path "

<titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

Version
2.0
InvalidVideoResolution 

= 0x203

The resolution of the input video must be one of the following:

NTSC: 720x480 | 704x480 | 352x480 | 352x240

PAL: 720x576 | 704x576 | 352x576 | 352x288

Hint (one of the following):

<videManager> <menu id="\em num "> file="\em file-path "

<titleSet nn > <menu id="\em num "> file="\em file-path "

<titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

Version
2.0
InconsistentVideoStreams 

= 0x204

A specific group of videos is required to have the same video parameters. The requirement applies to:

1. all video objects in a titleset;

2. all menu backgrounds in a titleset or in the video manager

Hint (one of the following):

<videoManager> <menus>

<titleSet nn > <menus>

<titleSet nn > <titles>

Version
2.0
InvalidAudioFormat 

= 0x300

The format of the input audio streams must be one of the following: LCPM, AC3, MPEG-1 Layer II or DTS.

Hint (one of the following):

<videManager> <menu id="\em num "> file="\em file-path "

<titleSet nn > <menu id="\em num "> file="\em file-path "

<titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

Version
2.0
InvalidAudioFrequency 

= 0x301

The frequency (sampling rate) of the input audio must be either 48000 Hz or 96000 Hz.

hint (one of the following):

<videManager> <menu id="\em num "> file="\em file-path "

<titleSet nn > <menu id="\em num "> file="\em file-path "

<titleSet nn > <title id="\em num "> file="\em file-path " [(callback)]

Version
2.0
SubpictureEncodingError 

= 0x400

Subpicture encoding error. The encoded subpicture size exceeds 52KB.

Hint: bitmap-file

Version
2.0
InvalidBitmapDimensions 

= 0x401

The bitmap width and height must be positive and divisible by 2 (even numbers).

A positive height indicates that the row order is the usual upside-down.

BMP File Format: Pixels are stored "upside-down" with respect to normal image raster scan order, starting in the lower left corner, going from left to right, and then row by row from the bottom to the top of the image. Uncompressed Windows bitmaps can also be stored from the top row to the bottom, if the image height value is negative.

Hint: bitmap-file

Version
2.0
UnexpectedBitmapColor 

= 0x402

The mask bitmap specified by the file attribute of a <mask> element, contains a color that is different from the colors specified by the "patternColor", "backgroundColor", "emphasis1Color", and "emphasis2Color" attributes of the <mask> element. For text only masks, this error usually means that the text pattern has been drawn using an anti-aliasing algorithm. The anti-aliasing algorithm introduces pixels of various colors at the edge of the text to smooth the text display. In most cases that effect can be seen by magnifying the mask image.

Hint: bitmap-file

Version
2.0
InvalidBitmap 

= 0x403

The input file is not a valid bitmap

Hint: bitmap-file

Version
2.0
UnsupportedBitmapCompression 

= 0x404

The input file is a compressed bitmap. An uncompressed bitmap is required.

Hint: bitmap-file

UnsupportedBitmapColorDepth 

= 0x405

The input bitmap does not have the supported color depth. The supported color depth is: 8-bit, 24-bit or 32-bit.

Hint: bitmap-file

Version
2.0
MultiplexerError 

= 0x500

A general MPEG multiplexer error.

Hint: file="\em video-file " [(callback)]

Version
1.0
MultiplexerParams 

= 0x501

Invalid parameters (e.g. no audio/video streams, or streams with invalid format) are passed to the multiplexer.

Hint: file="\em video-file " [(callback)]

Version
2.0
MultiplexerUnderrun 

= 0x502

The multiplexer has run out of input data.

Hint: file="\em video-file " [(callback)]

Version
2.0
DataStreamError 

= 0x1F01

A call to an DataStream method failed.

Hint: file="\em video-file " [(callback)]

Version
1.0
InvalidNavigationCommand 

= 0x1F02

Invalid navigation command. Wrong title ID, menu ID or chapter number found in a navigational attribute.

Hint (one of the following):

<videoManager firstPlayNavigate="\em command ">

<videoManager> <menu id="\em id "> <button navigate="\em command ">

<titleSet nn > <title id="\em id " postNavigate="\em command ">

<titleSet nn > <menu id="\em id "> <button navigate="\em command ">

Version
1.0
Interrupted 

= 0x1F03

Operation was interrupted by user.

Hint: none