Merge pull request #127 from MrCSharp22/feature/support-ETCO-frames

Feature/support etco frames

Author: decriptor

src/TagLib/Id3v2/EventTimeCode.cs

@@ -0,0 +1,61 @@
+using System;
+using TagLib.Id3v2;
+
+namespace TagLib.Id3v2
+{
+	public class EventTimeCode : ICloneable
+	{
+		#region Private Properties
+
+		private EventType typeOfEvent;
+
+		private int time;
+
+		#endregion
+
+		#region Public Properties
+
+		public EventType TypeOfEvent
+		{
+			get { return typeOfEvent; }
+			set { typeOfEvent = value; }
+		}
+
+		public int Time
+		{
+			get { return time; }
+			set { time = value; }
+		}
+
+		#endregion
+
+		#region Public Constructors
+
+		public EventTimeCode(EventType typeOfEvent, 
+			int time)
+		{
+			this.typeOfEvent = typeOfEvent;
+			this.time = time;
+		}
+
+		#endregion
+
+		#region Static Methods
+
+		public static EventTimeCode CreateEmpty()
+		{
+			return new EventTimeCode(EventType.Padding, 0);
+		}
+
+		#endregion
+
+		#region ICloneable
+
+		public object Clone()
+		{
+			return new EventTimeCode(typeOfEvent, time);
+		}
+
+		#endregion
+	}
+}

src/TagLib/Id3v2/EventType.cs

@@ -0,0 +1,134 @@
+namespace TagLib.Id3v2
+{
+	/// <summary>
+	///    Specifies the event type used by a <see
+	///    cref="EventTimeCode" /> and <see cref="EventTimeCodesFrame"/>.
+	/// </summary>
+	public enum EventType
+	{
+		/// <summary>
+		/// The padding - no meaning
+		/// </summary>
+		Padding = 0x00,
+
+		/// <summary>
+		/// The end of initial silence
+		/// </summary>
+		EndOfInitialSilence = 0x01,
+
+		/// <summary>
+		/// The intro start
+		/// </summary>
+		IntroStart = 0x02,
+
+		/// <summary>
+		/// The main part start
+		/// </summary>
+		MainPartStart = 0x03,
+
+		/// <summary>
+		/// The outro start
+		/// </summary>
+		OutroStart = 0x04,
+
+		/// <summary>
+		/// The outro end
+		/// </summary>
+		OutroEnd = 0x05,
+
+		/// <summary>
+		/// The verse start
+		/// </summary>
+		VerseStart = 0x06,
+
+		/// <summary>
+		/// The refrain start
+		/// </summary>
+		RefrainStart = 0x07,
+
+		/// <summary>
+		/// The interlude start
+		/// </summary>
+		InterludeStart = 0x08,
+
+		/// <summary>
+		/// The theme start
+		/// </summary>
+		ThemeStart = 0x09,
+
+		/// <summary>
+		/// The variation start
+		/// </summary>
+		VariationStart = 0x0A,
+
+		/// <summary>
+		/// The key change
+		/// </summary>
+		KeyChange = 0x0B,
+
+		/// <summary>
+		/// The time change
+		/// </summary>
+		TimeChange = 0x0C,
+
+		/// <summary>
+		/// momentary unwanted noise (Snap, Crackle & Pop)
+		/// </summary>
+		MomentaryUnwantedNoise = 0x0D,
+
+		/// <summary>
+		/// The sustained noise
+		/// </summary>
+		SustainedNoise = 0x0E,
+
+		/// <summary>
+		/// The sustained noise end
+		/// </summary>
+		SustainedNoiseEnd = 0x0F,
+
+		/// <summary>
+		/// The intro end
+		/// </summary>
+		IntroEnd = 0x10,
+
+		/// <summary>
+		/// The main part end
+		/// </summary>
+		MainPartEnd = 0x11,
+
+		/// <summary>
+		/// The verse end
+		/// </summary>
+		VerseEnd = 0x12,
+
+		/// <summary>
+		/// The refrain end
+		/// </summary>
+		RefrainEnd = 0x13,
+
+		/// <summary>
+		/// The theme end
+		/// </summary>
+		ThemeEnd = 0x14,
+
+		/// <summary>
+		/// Profanity starts
+		/// </summary>
+		Profanity = 0x15,
+
+		/// <summary>
+		/// The profanity end
+		/// </summary>
+		ProfanityEnd = 0x16,
+
+		/// <summary>
+		/// The audio end
+		/// </summary>
+		AudioEnd = 0xFD,
+
+		/// <summary>
+		/// The audio file end
+		/// </summary>
+		AudioFileEnd = 0xFE,
+	}
+}

src/TagLib/Id3v2/FrameFactory.cs

@@ -295,6 +295,11 @@ public static Frame CreateFrame (ByteVector data, File file,
 				return new UrlLinkFrame(data, position,
 					header, version);
 
+			// Event timing codes (frames 4.6)
+			if (header.FrameId == FrameType.ETCO)
+				return new EventTimeCodesFrame(data, position, header,
+					version);
+
 			return new UnknownFrame (data, position, header,
 				version);
 		}

src/TagLib/Id3v2/FrameTypes.cs

@@ -96,5 +96,6 @@ internal static class FrameType {
 		public static readonly ReadOnlyByteVector WPAY = "WPAY";
 		public static readonly ReadOnlyByteVector WPUB = "WPUB";
 		public static readonly ReadOnlyByteVector WXXX = "WXXX";
+		public static readonly ReadOnlyByteVector ETCO = "ETCO";
 	}
 }