Class DVDKaraokeAttributes
- Namespace
- VisioForge.Core.Types.MediaInfo
- Assembly
- VisioForge.Core.dll
Represents the attributes and configuration of DVD karaoke audio tracks.
public class DVDKaraokeAttributesInheritance
Inherited Members
Remarks
DVD karaoke is a specialized format that extends standard DVD audio capabilities to support interactive singing experiences. This class encapsulates the metadata that describes how karaoke content is structured on the disc, including channel assignments, duet support, and guide vocal configurations.
Key concepts in DVD karaoke: - Multiple audio channels carry different elements (instrumental, guide vocals, effects) - Channels can be dynamically mixed based on user preferences - Support for solo and duet performances - Master of Ceremonies (MC) tracks for instruction or entertainment
The karaoke player uses these attributes to: - Configure the audio mixer for proper channel routing - Enable/disable guide vocals based on user skill level - Support duet mode with separate guide tracks for each singer - Display appropriate on-screen information about available features
Properties
ChannelAssignment
Gets or sets the channel assignment mode for this karaoke track.
public DVDKaraokeAssignment ChannelAssignment { get; set; }Property Value
Remarks
The channel assignment determines which audio channels contain instrumental music, guide vocals, and other karaoke elements. This affects how the audio mixer routes and combines channels during playback.
ChannelContents
Gets or sets an array describing the content type of each audio channel.
public DVDKaraokeContents[] ChannelContents { get; set; }Property Value
Remarks
Each element in the array corresponds to an audio channel and uses flags to indicate the types of content present in that channel. A channel may contain multiple content types (e.g., both guide vocal and sound effects).
The array size depends on the VisioForge.Core.Types.MediaInfo.DVDKaraokeAttributes.ChannelAssignment: - LR: 2 channels - LRM: 3 channels - LR1: 3 channels - LRM1: 4 channels - LR12: 4 channels - LRM12: 5 channels
Duet
Gets or sets a value indicating whether this karaoke track supports duet mode.
public bool Duet { get; set; }Property Value
Remarks
In duet mode: - Channel 1 typically contains guide vocals for the first singer - Channel 2 contains guide vocals for the second singer - Each singer can independently control their guide vocal volume - On-screen lyrics may be color-coded for each singer
MasterOfCeremoniesInGuideVocal1
Gets or sets a value indicating whether a Master of Ceremonies (MC) track is present in guide vocal channel 1.
public bool MasterOfCeremoniesInGuideVocal1 { get; set; }Property Value
Remarks
The Master of Ceremonies track typically contains: - Song introductions and announcements - Singing instructions or encouragement - Entertainment between verses
When enabled, the karaoke system can optionally play these announcements to enhance the karaoke experience, especially for beginners.
Version
Gets or sets the karaoke format version number.
public byte Version { get; set; }Property Value
Remarks
Different versions may support different features or channel configurations. Version 1 is the most common and widely supported.