Table of Contents

Class DVDSubpictureAttributes

Namespace
VisioForge.Core.Types.MediaInfo
Assembly
VisioForge.Core.dll

Represents the attributes and characteristics of a DVD subpicture stream.

public class DVDSubpictureAttributes

Inheritance

Inherited Members

Remarks

DVD subpicture streams contain overlay graphics that can be displayed on top of the main video. Each subpicture stream has specific attributes that define its content type, encoding format, language information, and special characteristics. These attributes help DVD players determine how to process and present the subpicture content to users.

Subpictures on DVDs are typically used for: - Subtitles in multiple languages - Closed captions for accessibility - Menu button highlights - Karaoke lyrics with timing information - Director's commentary indicators - Special graphical overlays

A DVD can contain up to 32 subpicture streams, allowing for extensive multilingual support and various overlay features. The player selects which stream to display based on user preferences, disc programming, and these attribute values.

Properties

CodingMode

Gets or sets the encoding format used for the subpicture graphics data.

public DVDSubPictureCoding CodingMode { get; set; }

Property Value

DVDSubPictureCoding

Remarks

DVD subpictures typically use run-length encoding (RLE) for compression, which is efficient for the type of graphics used in subtitles and overlays. The coding mode determines how the player should decode the subpicture data.

Standard DVD subpictures support: - 2-bit color depth (4 colors including transparency) - Run-length encoded compression - Resolution matching the video frame - Multiple rectangular regions per subpicture

Language

Gets or sets the human-readable language name or description of the subpicture stream.

public string Language { get; set; }

Property Value

string

Remarks

This property provides a user-friendly representation of the subpicture stream that can be displayed in player menus. For language subtitles, it typically contains the language name. For other types, it may describe the overlay's purpose.

The language string may be localized based on the DVD's target market or may use English names universally. Some DVDs include native language names (e.g., "Español" instead of "Spanish").

LanguageExtension

Gets or sets additional language classification information for the subpicture stream.

public DVDSubPictureLangExt LanguageExtension { get; set; }

Property Value

DVDSubPictureLangExt

Remarks

The language extension provides additional context about the subpicture content: - Normal: Standard subtitles or captions - Children: Simplified language or content appropriate for children - CC (Closed Captions): Include sound effects and speaker identification - Forced: Subtitles that should display even when subtitles are disabled - Director's Commentary: Special subtitle track with filmmaker notes

This information helps parents control content access and ensures appropriate subtitle selection for different audiences. Players may use this to implement parental controls or accessibility features.

LanguageID

Gets or sets the Windows Language Code Identifier (LCID) for language-type subpictures.

public int LanguageID { get; set; }

Property Value

int

Remarks

The LCID allows for precise language identification beyond simple ISO 639 codes, including regional variants (e.g., Spanish from Spain vs. Spanish from Mexico). This enables DVD players to match subtitles to specific user language preferences.

For non-language subpictures, this value may be 0 or undefined. Applications should only rely on this value when Type indicates language content.

Type

Gets or sets the type of content contained in the subpicture stream.

public DVDSubPictureType Type { get; set; }

Property Value

DVDSubPictureType

Remarks

The Type property is crucial for proper subpicture handling: - Language type: Indicates subtitles or captions that should be selectable based on language preferences - Other type: Indicates special overlays that may be displayed regardless of language settings - NotSpecified: The content type is unknown and should be handled generically

This property affects how the subpicture stream appears in player menus and whether it's automatically selected based on system language settings.