Microsoft DirectX 9.0

DVDTextStringType

The DVDTextStringType enumeration type indicates the type of information contained in a DVD text string.

Syntax

typedef enum DVDTextStringType{
  // Disc structure identifiers (0x00..0x0f)
  // These are empty strings whose string type
  // is used to organize the content strings.
  dvdStruct_Volume  = 0x1,
  dvdStruct_Title  = 0x2,
  dvdStruct_ParentalID  = 0x3,
  dvdStruct_PartOfTitle  = 0x4,
  dvdStruct_Cell  = 0x5,
  dvdStream_Audio  = 0x10,
  dvdStream_Subpicture  = 0x11,
  dvdStream_Angle  = 0x12,
  // Channel in stream (0x20..0x2f)
  dvdChannel_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.
  dvdGeneral_Name  = 0x30,
  dvdGeneral_Comments  = 0x31,

  // Title (0x38..0x3f)
  dvdTitle_Series  = 0x38,
  dvdTitle_Movie  = 0x39,
  dvdTitle_Video  = 0x3a,
  dvdTitle_Album  = 0x3b,
  dvdTitle_Song  = 0x3c,
  dvdTitle_Other  = 0x3f,

  // Title (sub) (0x40..0x47)
  dvdTitle_Sub_Series  = 0x40,
  dvdTitle_Sub_Movie  = 0x41,
  dvdTitle_Sub_Video  = 0x42,
  dvdTitle_Sub_Album  = 0x43,
  dvdTitle_Sub_Song  = 0x44,
  dvdTitle_Sub_Other  = 0x47,

  // Title (original) (0x48..0x4f)
  dvdTitle_Orig_Series  = 0x48,
  dvdTitle_Orig_Movie  = 0x49,
  dvdTitle_Orig_Video  = 0x4a,
  dvdTitle_Orig_Album  = 0x4b,
  dvdTitle_Orig_Song  = 0x4c,
  dvdTitle_Orig_Other  = 0x4f,

  // Other info (0x50..0x57)
  dvdOther_Scene  = 0x50,
  dvdOther_Cut  = 0x51,
  dvdOther_Take  = 0x52
};

Elements

dvdStruct_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 DVDTextStringType method 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