/// <summary>
/// Reads the file with a specified read style.
/// </summary>
/// <param name="propertiesStyle">
/// A <see cref="ReadStyle" /> value specifying at what level
/// of accuracy to read the media properties, or <see
/// cref="ReadStyle.None" /> to ignore the properties.
/// </param>
void Read (ReadStyle propertiesStyle)
{
// TODO: Support Id3v2 boxes!!!
tag = new CombinedTag ();
Mode = AccessMode.Read;
try {
var parser = new FileParser (this);
if ((propertiesStyle & ReadStyle.Average) == 0)
parser.ParseTag ();
else
parser.ParseTagAndProperties ();
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
UdtaBoxes.AddRange (parser.UserDataBoxes);
// Ensure our collection contains at least a single empty box
if (UdtaBoxes.Count == 0) {
var dummy = new IsoUserDataBox ();
UdtaBoxes.Add (dummy);
}
// Check if a udta with ILST actually exists
if (IsAppleTagUdtaPresent ())
TagTypesOnDisk |= TagTypes.Apple; //There is an udta present with ILST info
// Find the udta box with the Apple Tag ILST
IsoUserDataBox udtaBox = FindAppleTagUdta ();
if (null == udtaBox) {
udtaBox = new IsoUserDataBox ();
}
apple_tag = new AppleTag (udtaBox);
tag.SetTags (apple_tag);
// If we're not reading properties, we're done.
if ((propertiesStyle & ReadStyle.Average) == 0) {
Mode = AccessMode.Closed;
return;
}
// Get the movie header box.
var mvhd_box = parser.MovieHeaderBox;
if (mvhd_box == null) {
Mode = AccessMode.Closed;
throw new CorruptFileException ("mvhd box not found.");
}
var audio_sample_entry = parser.AudioSampleEntry;
var visual_sample_entry = parser.VisualSampleEntry;
// Read the properties.
properties = new Properties (mvhd_box.Duration, audio_sample_entry, visual_sample_entry);
} finally {
Mode = AccessMode.Closed;
}
}
/// <summary>
/// Removes a set of tag types from the current instance.
/// </summary>
/// <param name="types">
/// A bitwise combined <see cref="TagLib.TagTypes" /> value
/// containing tag types to be removed from the file.
/// </param>
/// <remarks>
/// In order to remove all tags from a file, pass <see
/// cref="TagTypes.AllTags" /> as <paramref name="types" />.
/// </remarks>
public override void RemoveTags (TagTypes types)
{
if ((types & TagTypes.Apple) != TagTypes.Apple || apple_tag == null)
return;
apple_tag.DetachIlst ();
apple_tag = null;
tag.SetTags ();
}
private void Read(ReadStyle propertiesStyle)
{
tag = new CombinedTag();
Mode = AccessMode.Read;
try
{
FileParser parser = new FileParser(this);
if (propertiesStyle == ReadStyle.None)
{
parser.ParseTag();
}
else
{
parser.ParseTagAndProperties();
}
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
udta_boxes.AddRange(parser.UserDataBoxes);
if (udta_boxes.Count == 0)
{
IsoUserDataBox dummy = new IsoUserDataBox();
udta_boxes.Add(dummy);
}
if (IsAppleTagUdtaPresent())
{
TagTypesOnDisk |= TagTypes.Apple;
}
IsoUserDataBox udtaBox = FindAppleTagUdta();
if (null == udtaBox)
{
udtaBox = new IsoUserDataBox();
}
apple_tag = new AppleTag(udtaBox);
tag.SetTags(apple_tag);
if (propertiesStyle == ReadStyle.None)
{
Mode = AccessMode.Closed;
return;
}
IsoMovieHeaderBox mvhd_box = parser.MovieHeaderBox;
if (mvhd_box == null)
{
Mode = AccessMode.Closed;
throw new CorruptFileException("mvhd box not found.");
}
IsoAudioSampleEntry audio_sample_entry = parser.AudioSampleEntry;
IsoVisualSampleEntry visual_sample_entry = parser.VisualSampleEntry;
properties = new Properties(mvhd_box.Duration, audio_sample_entry, visual_sample_entry);
}
finally
{
Mode = AccessMode.Closed;
}
}
/// <summary>
/// Gets a tag of a specified type from the current instance,
/// optionally creating a new tag if possible.
/// </summary>
/// <param name="type">
/// A <see cref="TagLib.TagTypes" /> value indicating the
/// type of tag to read.
/// </param>
/// <param name="create">
/// A <see cref="bool" /> value specifying whether or not to
/// try and create the tag if one is not found.
/// </param>
/// <returns>
/// A <see cref="Tag" /> object containing the tag that was
/// found in or added to the current instance. If no
/// matching tag was found and none was created, <see
/// langword="null" /> is returned.
/// </returns>
/// <remarks>
/// At the time of this writing, only <see cref="AppleTag" />
/// is supported. All other tag types will be ignored.
/// </remarks>
public override TagLib.Tag GetTag(TagTypes type, bool create)
{
if (type == TagTypes.Apple)
{
if (apple_tag == null && create)
{
apple_tag = new AppleTag(udta_box);
tag.SetTags(apple_tag);
}
return(apple_tag);
}
return(null);
}
/// <summary>
/// Gets a tag of a specified type from the current instance,
/// optionally creating a new tag if possible.
/// </summary>
/// <param name="type">
/// A <see cref="TagLib.TagTypes" /> value indicating the
/// type of tag to read.
/// </param>
/// <param name="create">
/// A <see cref="bool" /> value specifying whether or not to
/// try and create the tag if one is not found.
/// </param>
/// <returns>
/// A <see cref="Tag" /> object containing the tag that was
/// found in or added to the current instance. If no
/// matching tag was found and none was created, <see
/// langword="null" /> is returned.
/// </returns>
/// <remarks>
/// At the time of this writing, only <see cref="AppleTag" />
/// is supported. All other tag types will be ignored.
/// </remarks>
public override Tag GetTag (TagTypes type, bool create)
{
if (type == TagTypes.Apple) {
if (apple_tag == null && create) {
IsoUserDataBox udtaBox = FindAppleTagUdta ();
if (null == udtaBox) {
udtaBox = new IsoUserDataBox ();
}
apple_tag = new AppleTag (udtaBox);
tag.SetTags (apple_tag);
}
return apple_tag;
}
return null;
}
/// <summary>
/// Reads the file with a specified read style.
/// </summary>
/// <param name="propertiesStyle">
/// A <see cref="ReadStyle" /> value specifying at what level
/// of accuracy to read the media properties, or <see
/// cref="ReadStyle.None" /> to ignore the properties.
/// </param>
private void Read(ReadStyle propertiesStyle)
{
// TODO: Support Id3v2 boxes!!!
tag = new CombinedTag();
Mode = AccessMode.Read;
try {
FileParser parser = new FileParser(this);
if (propertiesStyle == ReadStyle.None)
{
parser.ParseTag();
}
else
{
parser.ParseTagAndProperties();
}
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
udta_box = parser.UserDataBox;
if (udta_box != null && udta_box.GetChild(BoxType.Meta)
!= null && udta_box.GetChild(BoxType.Meta
).GetChild(BoxType.Ilst) != null)
{
TagTypesOnDisk |= TagTypes.Apple;
}
if (udta_box == null)
{
udta_box = new IsoUserDataBox();
}
apple_tag = new AppleTag(udta_box);
tag.SetTags(apple_tag);
// If we're not reading properties, we're done.
if (propertiesStyle == ReadStyle.None)
{
Mode = AccessMode.Closed;
return;
}
// Get the movie header box.
IsoMovieHeaderBox mvhd_box = parser.MovieHeaderBox;
if (mvhd_box == null)
{
Mode = AccessMode.Closed;
throw new CorruptFileException(
"mvhd box not found.");
}
IsoAudioSampleEntry audio_sample_entry =
parser.AudioSampleEntry;
IsoVisualSampleEntry visual_sample_entry =
parser.VisualSampleEntry;
// Read the properties.
properties = new Properties(mvhd_box.Duration,
audio_sample_entry, visual_sample_entry);
} finally {
Mode = AccessMode.Closed;
}
}