/// <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();
}
/// <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
/// langref="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>
/// 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;
}
}