Microsoft DirectX 9.0

DVD_TextStringType Enumeration

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 Hits" might be followed by a string of type 0xF0 that says "Greatest Hits, The." As with content strings, the use of the sorting string is not strictly defined.

See Also