Microsoft DirectX 8.1 (C++) |
Defines a subset of the DVD text string types.
Syntax
enum DVD_TextStringType {
// Disc structure identifiers (0x00..0x0f)
// These are empty strings whose string type
// is used to organize the content strings.
DVD_Struct_Volume = 0x01,
DVD_Struct_Title = 0x02,
DVD_Struct_ParentalID = 0x03,
DVD_Struct_PartOfTitle = 0x04,
DVD_Struct_Cell = 0x05,
// Stream (0x10..0x1f)
DVD_Stream_Audio = 0x10,
DVD_Stream_Subpicture = 0x11,
DVD_Stream_Angle = 0x12,
// Channel in stream (0x20..0x2f)
DVD_Channel_Audio = 0x20,
// Application information
// General (0x30..0x37)
// This is used to identify the name
// for the current node, that is, volume title,
// movie title, song title, and so on.
DVD_General_Name = 0x30,
DVD_General_Comments = 0x31,
// Title (0x38..0x3f)
DVD_Title_Series = 0x38,
DVD_Title_Movie = 0x39,
DVD_Title_Video = 0x3a,
DVD_Title_Album = 0x3b,
DVD_Title_Song = 0x3c,
DVD_Title_Other = 0x3f,
// Title (sub) (0x40..0x47)
DVD_Title_Sub_Series = 0x40,
DVD_Title_Sub_Movie = 0x41,
DVD_Title_Sub_Video = 0x42,
DVD_Title_Sub_Album = 0x43,
DVD_Title_Sub_Song = 0x44,
DVD_Title_Sub_Other = 0x47,
// Title (original) (0x48..0x4f)
DVD_Title_Orig_Series = 0x48,
DVD_Title_Orig_Movie = 0x49,
DVD_Title_Orig_Video = 0x4a,
DVD_Title_Orig_Album = 0x4b,
DVD_Title_Orig_Song = 0x4c,
DVD_Title_Orig_Other = 0x4f,
// Other info (0x50..0x57)
DVD_Other_Scene = 0x50,
DVD_Other_Cut = 0x51,
DVD_Other_Take = 0x52,
//These less-used categories are defined in
//the DVD specification but not in the
//DVD_TextStringType enumeration.
// Language 0x58..0x5b
// Work 0x5c..0x6b
// Character 0x6c..0x8f
// Data 0x90..0x93
// Karaoke 0x94..0x9b
// Category 0x9c..0x9f
// Lyrics 0xa0..0xa3
// Document 0xa4..0xa7
// Others 0xa8..0xab
// Reserved 0xac..0xaf
// Admin 0xb0..0xb7
// more admin 0xb8..0xc0
// Reserved 0xd0..0xdf
// vendor 0xe0..0xef
// extension 0xf0..0xf7
// reserved 0xf8..0xff
};
Elements
DVD_Struct_Volume
Indicates the top-level of the logical hierarchy. Refers to the entire contents of a one-sided disc or one side of a two-sided disc.
DVD_Struct_Title
Indicates that all content strings, until the next DVD_Struct_Title, belong to one title.
DVD_Struct_ParentalID
Indicates the parental ID of the following strings.
DVD_Struct_PartOfTitle
Indicates that all content strings, until the next DVD_Struct_PartOfTitle, belong to one chapter.
DVD_Struct_Cell
Indicates that all content strings, until the next DVD_Struct_Cell, belong to one cell, which can be a scene from a chapter.
DVD_Stream_Audio
Indicates that the following content strings refer to the audio stream.
DVD_Stream_Subpicture
Indicates that the following content strings refer to the subpicture stream.
DVD_Stream_Angle
Indicates that the following content strings refer to the angle.
DVD_Channel_Audio
Indicates that the following content strings refer to the audio channel.
DVD_General_Name
Indicates the most important content string. Strings of this type contain the name of the volume, title, chapter, and so on, and can follow any structure identifiers.
DVD_General_Comments
Identifies a content string with additional information about the title, chapter, and so on, described by the DVD_General_Name string. The exact nature or structure of these comments is not defined.
DVD_Title_Series
Identifies a content string containing the name of a series to which the title belongs.
DVD_Title_Movie
Identifies a content string with the main movie title.
DVD_Title_Video
Identifies a content string containing the name of the video title.
DVD_Title_Album
Identifies a content string containing the name of the album title.
DVD_Title_Song
Identifies a content string containing the name of the song title.
DVD_Title_Other
Identifies a content string containing the name of the title of some other genre.
DVD_Title_Sub_Series
Identifies a content string with the name of the series localized to a particular country/region.
DVD_Title_Sub_Movie
Identifies a content string with the movie title localized to a particular country/region.
DVD_Title_Sub_Video
Identifies a content string with the video title localized to a particular country/region.
DVD_Title_Sub_Album
Identifies a content string with the album title localized to a particular country/region.
DVD_Title_Sub_Song
Identifies a content string with the song title localized to a particular country/region.
DVD_Title_Sub_Other
Identifies a content string with the title of some other genre localized to a particular country/region.
DVD_Title_Orig_Series
Identifies a content string with the original name of the series.
DVD_Title_Orig_Movie
Identifies a content string with the original name of the movie.
DVD_Title_Orig_Video
Identifies a content string with the original name of the video.
DVD_Title_Orig_Album
Identifies a content string with the original name of the album.
DVD_Title_Orig_Song
Identifies a content string with the original name of the song.
DVD_Title_Orig_Other
Identifies a content string with the original name of the content.
DVD_Other_Scene
Identifies a content string pertaining to a particular scene in a movie or video.
DVD_Other_Cut
Identifies a content string pertaining to a particular cut in a movie or video.
DVD_Other_Take
Identifies a content string pertaining to a particular take in a movie or video.
Remarks
A DVD_TextStringType is returned in the IDvdInfo2::GetDVDTextStringAsUnicode and IDvdInfo2::GetDVDTextStringAsNative methods to identify how the disc authors have categorized the specified text string. See Working with DVD Text Strings for general information on text strings.
One important text string type not defined in this enumeration is 0xF0, the extension sorting text string type. You can use this type of string in many ways to enable players to sort the string data. It can be a unique number or a repetition of a previous string with the word order changed. For example, a string type of 0x30 that has the name "The Greatest Country Hits" might be followed by a string of type 0xF0 that says "Greatest Country Hits, The." As with content strings, the use of the sorting string is not strictly defined.
See Also