Enum DVDSubPictureLangExt

Namespace: VisioForge.Core.Types.MediaInfo

Assembly: VisioForge.Core.dll

Specifies the language extension code for DVD subpicture streams, indicating the intended purpose and display characteristics of subtitles.

public enum DVDSubPictureLangExt

Fields

NotSpecified = 0

Language extension is not specified or unknown.

Used when the subpicture stream doesn't have a specific extension code assigned. Players should treat this as standard subtitles without special formatting or behavior.

CaptionNormal = 1

Normal caption subtitles with standard formatting.

Standard subtitles providing dialogue translation or transcription in normal-sized text. These are the most common subtitle type and are typically: - Positioned at the bottom of the screen - Using standard font size (approximately 5% of screen height) - White or yellow text with black outline/shadow - Displayed for foreign language films or for deaf/hard-of-hearing viewers

Caption subtitles generally only include spoken dialogue and may omit sound effects or speaker identification that would be included in closed captions.

CaptionBig = 2

Large-print caption subtitles for visually impaired viewers.

Enhanced subtitles with larger text size for improved readability: - Font size typically 150-200% of normal subtitles - May use high contrast colors (white on black background) - Simplified formatting to maximize legibility - Potentially reduced line length to accommodate larger text

These subtitles help viewers with: - Mild to moderate vision impairment - Viewing from greater distances - Small screen devices - Age-related vision changes

CaptionChildren = 3

Simplified caption subtitles designed for children.

Child-friendly subtitles with adaptations for young readers: - Simplified vocabulary appropriate for reading level - Shorter sentences and phrases - May include reading aids (color coding for different speakers) - Potentially slower display timing for developing readers - Removal of complex idioms or cultural references

These subtitles support: - Early literacy development - Language learning for children - Family viewing with mixed age groups - Educational content consumption

CCNormal = 5

Normal closed captions including dialogue and audio descriptions.

Comprehensive closed captions designed for deaf and hard-of-hearing viewers: - All dialogue with speaker identification when necessary - Sound effect descriptions [door slams], [thunder] - Music descriptions ♪ upbeat music ♪ - Tone indicators (sarcastically), (whispering) - Off-screen sounds and dialogue

Closed captions follow specific standards: - FCC guidelines in the United States - Ofcom standards in the United Kingdom - Similar accessibility regulations in other regions - Typically use specific formatting conventions for different audio elements

CCBig = 6

Large-print closed captions for visually impaired viewers who also need audio descriptions.

Combines the comprehensive information of closed captions with enhanced visibility: - All closed caption content (dialogue, sounds, music) - Larger text size (150-200% of normal) - High contrast formatting - May use abbreviated sound descriptions to fit space constraints

Serves viewers who have both: - Hearing impairment or deafness - Visual impairment requiring larger text This dual accommodation is important for aging populations and certain medical conditions affecting multiple senses.

CCChildren = 7

Simplified closed captions appropriate for children, including audio descriptions.

Child-appropriate closed captions that maintain accessibility while being age-appropriate: - Simplified vocabulary for both dialogue and sound descriptions - Child-friendly descriptions of scary or complex sounds - Color coding or icons for different speakers - Filtered content (may omit profanity or mature themes) - Educational enhancements (vocabulary helpers)

Particularly useful for: - Children with hearing impairments - Language learning in educational settings - Noisy environments where audio isn't practical - Building reading skills alongside viewing

Forced = 9

Forced subtitles displayed regardless of subtitle settings, typically for foreign language segments.

Forced subtitles appear automatically for specific scenes and cannot be turned off: - Foreign language dialogue in otherwise native-language films - Alien or fictional language translations - Sign language interpretation - On-screen text translations (signs, letters, computer screens) - Important text messages or emails shown on screen

Implementation notes: - Players must display these even when subtitles are "off" - Usually contains only subset of the film's content - Should not duplicate on-screen burned-in subtitles - May be empty for films without foreign language segments

Common examples: - Russian dialogue in English action films - Elvish in fantasy films - Text messages in thriller movies - News broadcasts in foreign languages

DirectorCommentsNormal = 13

Director's commentary as subtitles with normal formatting.

Special subtitle track containing director or filmmaker commentary: - Behind-the-scenes information synchronized with specific scenes - Technical details about filming locations, special effects - Artistic choices and creative decisions - Anecdotes about cast and crew - References to deleted scenes or alternate versions

These subtitles are typically: - Displayed in addition to or instead of dialogue subtitles - Color-coded or specially formatted to distinguish from dialogue - Synchronized with specific visual elements being discussed - Used when audio commentary track isn't available or practical

Advantages over audio commentary: - Can be read without replacing the film's audio - Accessible to deaf/hard-of-hearing viewers - Available in multiple languages more easily - Can include hyperlinks or chapter references

DirectorCommentsBig = 14

Director's commentary subtitles with large print formatting.

Large-format version of director commentary for improved readability: - Same content as normal director comments - Enlarged text for visually impaired viewers - May use condensed commentary to fit space constraints - High contrast formatting for better visibility

Allows visually impaired film enthusiasts to enjoy: - Behind-the-scenes insights - Technical filmmaking details - Director's artistic vision - Production anecdotes and trivia

DirectorCommentsChildren = 15

Simplified director's commentary subtitles suitable for younger audiences.

Age-appropriate filmmaker commentary for family films: - Simplified technical explanations - Focus on fun facts and trivia - Behind-the-scenes stories about actors and effects - Educational content about filmmaking - Avoidance of complex industry terminology

Designed to: - Inspire young filmmakers - Provide educational content - Maintain child-appropriate language - Encourage interest in movie-making - Complement family viewing experiences

Often found on: - Animated films - Family adventure movies - Educational DVDs - Children's television series

Examples

// Enumerating available subtitle streams
for (int i = 0; i < dvdInfo.SubpictureStreamCount; i++)
{
    var attrs = dvdInfo.GetSubpictureAttributes(i);
    string language = attrs.LanguageCode; // e.g., "en", "es", "fr"
    DVDSubPictureLangExt extension = attrs.LanguageExtension;

    Console.WriteLine($"Stream {i}: {language} - {GetSubtitleDescription(extension)}");

    // Auto-select forced subtitles
    if (extension == DVDSubPictureLangExt.Forced)
    {
        dvdPlayer.EnableSubpicture(i, true);
    }
}

string GetSubtitleDescription(DVDSubPictureLangExt ext)
{
    return ext switch
    {
        DVDSubPictureLangExt.CaptionNormal => "Subtitles",
        DVDSubPictureLangExt.CCNormal => "Closed Captions",
        DVDSubPictureLangExt.CaptionBig => "Large Subtitles",
        DVDSubPictureLangExt.CaptionChildren => "Kids Subtitles",
        DVDSubPictureLangExt.Forced => "Forced Only",
        DVDSubPictureLangExt.DirectorCommentsNormal => "Commentary",
        _ => "Subtitles"
    };
}

Remarks

DVD-Video allows multiple subpicture streams per title, each serving different purposes beyond simple language translation. The language extension code provides additional context about how the subtitles should be used and displayed, enabling DVDs to offer various subtitle options for different audiences and viewing preferences.

This system allows a single DVD to include: - Multiple subtitle sizes for vision-impaired viewers - Simplified language for children or language learners - Closed captions with sound effect descriptions - Director or actor commentary as subtitles - Forced subtitles for foreign language dialogue in otherwise native-language content

The language extension works in conjunction with the primary language code (ISO 639-1) to fully describe each subpicture stream. For example, a DVD might have: - English (Normal) - Standard subtitles - English (CC) - Closed captions with [sound effects] - English (Big) - Large print for visually impaired - English (Children) - Simplified vocabulary - Spanish (Forced) - Only for English scenes with Spanish dialogue

Players use these codes to: - Automatically select appropriate subtitles based on user preferences - Display forced subtitles regardless of subtitle on/off setting - Offer meaningful choices in the subtitle selection menu - Apply appropriate formatting (size, position) for different subtitle types

Table of Contents

Enum DVDSubPictureLangExt

Fields

Examples

Remarks