Table of Contents

Class DVDMenuAttributes

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

Represents the attributes of a DVD menu, providing comprehensive information about the menu's multimedia components.

public class DVDMenuAttributes

Inheritance

Inherited Members

Remarks

DVD menus are interactive screens that allow users to navigate and select various options on a DVD disc. They typically include a background video or still image, optional audio (such as background music), and subpicture overlays for buttons and navigation elements.

The menu system in DVD-Video consists of several types: - Title Menu: The main menu accessed when a disc is first played - Root Menu: Top-level menu for disc navigation - Subpicture Menu: For selecting subtitle tracks - Audio Menu: For choosing audio streams - Angle Menu: For multi-angle content selection - Chapter Menu: For direct chapter access

Menu attributes define the technical characteristics of these interactive elements, including video format, audio properties, and subpicture specifications for button highlights and text overlays.

Properties

AudioAttributes

Gets or sets the audio attributes when audio is present in the menu.

public DVDAudioAttributes AudioAttributes { get; set; }

Property Value

DVDAudioAttributes

Remarks

Menu audio typically uses simpler encoding than main feature audio: - Common formats: AC-3 (Dolby Digital) 2.0, PCM - Lower bitrates than feature audio (e.g., 192 kbps) - Usually stereo rather than surround sound

This property is only valid when VisioForge.Core.Types.MediaInfo.DVDMenuAttributes.AudioPresent is true.

AudioPresent

Gets or sets a value indicating whether audio is present in the menu.

public bool AudioPresent { get; set; }

Property Value

bool

Remarks

Menu audio is optional and typically used for: - Background music to enhance the viewing experience - Sound effects for button navigation - Ambient sounds matching the menu theme

Not all DVD menus include audio; simple text-based menus often omit it to reduce disc space usage.

CompatibleRegion

Gets or sets an array indicating which DVD regions are compatible with this menu.

public bool[] CompatibleRegion { get; set; }

Property Value

bool[]

Remarks

DVD region coding is a digital rights management technique that restricts playback to specific geographical regions. The array contains 8 boolean values corresponding to regions 1-8:

  • Region 1: USA, Canada, US Territories
  • Region 2: Europe, Japan, Middle East, South Africa
  • Region 3: Southeast Asia, South Korea, Taiwan, Hong Kong
  • Region 4: Australia, New Zealand, Latin America
  • Region 5: Eastern Europe, Russia, India, Africa
  • Region 6: China
  • Region 7: Reserved for future use
  • Region 8: International venues (aircraft, cruise ships)

A value of true at index [n-1] indicates the menu is playable in region n. Region-free menus will have all values set to true.

SubpictureAttributes

Gets or sets the subpicture attributes when subpictures are present in the menu.

public DVDSubpictureAttributes SubpictureAttributes { get; set; }

Property Value

DVDSubpictureAttributes

Remarks

Menu subpictures define the interactive elements: - Button highlight colors and transparency - Selection state graphics (normal, selected, activated) - Positioning and dimensions of interactive areas - Color lookup table (CLUT) for the 4-color palette

The DVD specification allows menus to have up to 36 buttons per page, with sophisticated highlight and selection effects defined through subpicture streams.

This property is only valid when VisioForge.Core.Types.MediaInfo.DVDMenuAttributes.SubpicturePresent is true.

SubpicturePresent

Gets or sets a value indicating whether subpicture streams are present in the menu.

public bool SubpicturePresent { get; set; }

Property Value

bool

Remarks

Subpictures in DVD menus are used for: - Button highlight graphics (selection rectangles, color changes) - Text overlays for button labels - Animated transitions between button states - Visual feedback for user navigation

Subpictures use a 2-bit color depth (4 colors) with transparency, allowing for simple but effective overlay graphics without consuming significant bandwidth.

VideoAttributes

Gets or sets the video attributes of the menu, including resolution, aspect ratio, and encoding format.

public DVDVideoAttributes VideoAttributes { get; set; }

Property Value

DVDVideoAttributes

Remarks

Menu video can be either motion video (typically MPEG-2) or still images. Common menu video specifications include: - NTSC: 720x480 at 29.97 fps - PAL: 720x576 at 25 fps - Aspect ratios: 4:3 or 16:9 (anamorphic)

Still menus use single frames but maintain the same resolution and aspect ratio specifications as motion menus.