Table of Contents

Class DVDTitleAttributes

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

Represents the complete set of attributes and stream information for a DVD title.

public class DVDTitleAttributes

Inheritance

Inherited Members

Remarks

A DVD title is a complete program unit on a DVD, such as a movie, TV episode, or special feature. Each title contains its own set of video, audio, and subpicture streams, along with metadata that describes how these streams should be presented and what special features are available.

DVD structure hierarchy: - Disc → Titles → Chapters → Cells - Each title can have up to 99 chapters - Each title can contain up to 8 audio streams - Each title can contain up to 32 subpicture streams - Titles can have different aspect ratios, encoding formats, and features

Title attributes are crucial for: - Determining playback capabilities and requirements - Building stream selection menus - Enabling special features like karaoke or multi-angle viewing - Applying appropriate audio/video processing - Enforcing parental controls and region restrictions

Properties

AppMode

Gets or sets the application mode that indicates special features or processing requirements for this title.

public DVDTitleAppMode AppMode { get; set; }

Property Value

DVDTitleAppMode

Remarks

The application mode fundamentally changes how the DVD player should handle the title: - NotSpecified: Standard movie/video playback with normal controls - Karaoke: Enables vocal channel mixing, lyrics display, and possibly scoring features - Other: Custom application modes that may require special player support

When karaoke mode is active, the player should: - Enable audio channel selection/mixing controls - Ensure precise subpicture timing for lyrics synchronization - Potentially activate microphone input and echo effects - Display karaoke-specific UI elements like pitch indicators

AudioAttributes

Gets or sets an array containing detailed attributes for each audio stream in the title.

public DVDAudioAttributes[] AudioAttributes { get; set; }

Property Value

DVDAudioAttributes[]

Remarks

Each audio stream can have different characteristics: - Audio format (AC3, DTS, LPCM, MPEG) - Number of channels (mono, stereo, 5.1, 7.1) - Sample rate and bit depth - Language code and description - Special attributes (director's commentary, descriptive audio)

Players use these attributes to: - Display audio options in selection menus - Automatically select streams based on user language preferences - Configure audio decoders appropriately - Apply necessary downmixing for stereo output - Handle special features like karaoke channel separation

MultichannelAudioAttributes

Gets or sets extended information about multichannel audio capabilities for each stream.

public DVDMultichannelAudioAttributes[] MultichannelAudioAttributes { get; set; }

Property Value

DVDMultichannelAudioAttributes[]

Remarks

Multichannel attributes provide detailed information about: - Specific channel assignments (L, R, C, LFE, LS, RS) - Karaoke channel configurations (melody, vocal guides) - Downmix coefficients for stereo playback - Special processing flags (dialog normalization, dynamic range)

This information is particularly important for: - Home theater systems with full surround capabilities - Karaoke applications requiring channel separation - Ensuring proper audio presentation on various playback systems - Maintaining artistic intent across different speaker configurations

NumberOfAudioStreams

Gets or sets the total number of audio streams available in this title.

public int NumberOfAudioStreams { get; set; }

Property Value

int

Remarks

Multiple audio streams allow DVDs to provide: - Multiple language dubs of the same content - Different audio formats (Dolby Digital, DTS, PCM) - Commentary tracks from directors or actors - Descriptive audio for visually impaired viewers - Different mix versions (stereo, 5.1 surround, etc.)

The number of streams determines how many entries will be valid in the AudioAttributes array. Players should only present available streams to users for selection.

NumberOfSubpictureStreams

Gets or sets the total number of subpicture streams available in this title.

public int NumberOfSubpictureStreams { get; set; }

Property Value

int

Remarks

The high number of possible subpicture streams allows DVDs to support: - Subtitles in many languages (often 10-20 for international releases) - Both subtitles and closed captions for the same language - Special subtitle tracks (forced subs, commentary, trivia) - Different subtitle styles (standard vs. hearing impaired) - Region-specific subtitle variations

Not all 32 possible streams are typically used; the actual number of available streams is indicated by this property.

SubpictureAttributes

Gets or sets an array containing detailed attributes for each subpicture stream in the title.

public DVDSubpictureAttributes[] SubpictureAttributes { get; set; }

Property Value

DVDSubpictureAttributes[]

Remarks

Subpicture attributes describe each overlay stream: - Content type (language subtitles vs. graphics) - Language code and human-readable description - Special flags (forced display, closed captions) - Encoding format (typically 2-bit RLE) - Associated audio stream for synchronization

Players use these attributes to: - Build subtitle selection menus with proper language names - Automatically enable subtitles based on user preferences - Handle forced subtitles that display regardless of settings - Properly decode and display the subpicture graphics - Synchronize subtitle timing with audio and video

Special considerations: - Some subpictures may be empty (no actual content) but still present - Forced subtitles should display even when subtitles are disabled - Closed caption streams may include additional formatting information - Karaoke titles may use subpictures for synchronized lyrics

VideoAttributes

Gets or sets the video stream attributes for this title.

public DVDVideoAttributes VideoAttributes { get; set; }

Property Value

DVDVideoAttributes

Remarks

The video attributes define the primary visual presentation of the title: - Video compression format (MPEG-1 or MPEG-2) - Resolution (720x480 NTSC, 720x576 PAL, etc.) - Aspect ratio (4:3, 16:9 letterbox, 16:9 pan-scan) - Frame rate (29.97 fps NTSC, 25 fps PAL) - Bit rate and quality settings

DVDs support multiple video angles for the same title, allowing viewers to switch between different camera angles during playback. The video attributes apply to all angles within the title.