/// <summary>
/// Parses boxes for a specified range, looking for tags and
/// properties.
/// </summary>
/// <param name="start">
/// A <see cref="long" /> value specifying the seek position
/// at which to start reading.
/// </param>
/// <param name="end">
/// A <see cref="long" /> value specifying the seek position
/// at which to stop reading.
/// </param>
/// <param name="handler">
/// A <see cref="IsoHandlerBox" /> object that applied to the
/// range being searched.
/// </param>
private void ParseTagAndProperties(long start, long end,
IsoHandlerBox handler)
{
BoxHeader header;
for (long position = start; position < end;
position += header.TotalBoxSize)
{
header = new BoxHeader(file, position);
ByteVector type = header.BoxType;
if (type == BoxType.Moov ||
type == BoxType.Mdia ||
type == BoxType.Minf ||
type == BoxType.Stbl ||
type == BoxType.Trak)
{
ParseTagAndProperties(
header.HeaderSize + position,
header.TotalBoxSize + position,
handler);
}
else if (type == BoxType.Stsd)
{
stsd_boxes.Add(BoxFactory.CreateBox(
file, header, handler));
}
else if (type == BoxType.Hdlr)
{
handler = BoxFactory.CreateBox(file,
header, handler) as
IsoHandlerBox;
}
else if (mvhd_box == null &&
type == BoxType.Mvhd)
{
mvhd_box = BoxFactory.CreateBox(file,
header, handler) as
IsoMovieHeaderBox;
}
else if (udta_box == null &&
type == BoxType.Udta)
{
udta_box = BoxFactory.CreateBox(file,
header, handler) as
IsoUserDataBox;
}
else if (type == BoxType.Mdat)
{
mdat_start = position;
mdat_end = position + header.TotalBoxSize;
}
if (header.TotalBoxSize == 0)
{
break;
}
}
}
/// <summary>
/// Resets all internal fields.
/// </summary>
private void ResetFields()
{
mvhd_box = null;
udta_box = null;
moov_tree = null;
udta_tree = null;
stco_boxes.Clear();
stsd_boxes.Clear();
mdat_start = -1;
mdat_end = -1;
}
/// <summary>
/// Constructs and initializes a new instance of <see
/// cref="AppleTag" /> for a specified ISO user data box.
/// </summary>
/// <param name="box">
/// A <see cref="IsoUserDataBox" /> from which the tag is to
/// be read.
/// </param>
public AppleTag(IsoUserDataBox box)
{
if (box == null)
{
throw new ArgumentNullException("box");
}
meta_box = box.GetChild(BoxType.Meta) as IsoMetaBox;
if (meta_box == null)
{
meta_box = new IsoMetaBox("mdir", null);
box.AddChild(meta_box);
}
ilst_box = meta_box.GetChild(BoxType.Ilst)
as AppleItemListBox;
if (ilst_box == null)
{
ilst_box = new AppleItemListBox();
meta_box.AddChild(ilst_box);
}
}
/// <summary>
/// Parses boxes for a specified range, looking for tags.
/// </summary>
/// <param name="start">
/// A <see cref="long" /> value specifying the seek position
/// at which to start reading.
/// </param>
/// <param name="end">
/// A <see cref="long" /> value specifying the seek position
/// at which to stop reading.
/// </param>
private void ParseTag(long start, long end)
{
BoxHeader header;
for (long position = start; position < end;
position += header.TotalBoxSize)
{
header = new BoxHeader(file, position);
if (header.BoxType == BoxType.Moov ||
header.BoxType == BoxType.Mdia ||
header.BoxType == BoxType.Minf ||
header.BoxType == BoxType.Stbl ||
header.BoxType == BoxType.Trak)
{
ParseTag(header.HeaderSize + position,
header.TotalBoxSize + position);
}
else if (udta_box == null &&
header.BoxType == BoxType.Udta)
{
udta_box = BoxFactory.CreateBox(file,
header) as IsoUserDataBox;
}
else if (header.BoxType == BoxType.Mdat)
{
mdat_start = position;
mdat_end = position + header.TotalBoxSize;
}
if (header.TotalBoxSize == 0)
{
break;
}
}
}
/// <summary>
/// Parses boxes for a specified range, looking for tags and
/// properties.
/// </summary>
/// <param name="start">
/// A <see cref="long" /> value specifying the seek position
/// at which to start reading.
/// </param>
/// <param name="end">
/// A <see cref="long" /> value specifying the seek position
/// at which to stop reading.
/// </param>
/// <param name="handler">
/// A <see cref="IsoHandlerBox" /> object that applied to the
/// range being searched.
/// </param>
private void ParseTagAndProperties (long start, long end,
IsoHandlerBox handler)
{
BoxHeader header;
for (long position = start; position < end;
position += header.TotalBoxSize) {
header = new BoxHeader (file, position);
ByteVector type = header.BoxType;
if (type == BoxType.Moov ||
type == BoxType.Mdia ||
type == BoxType.Minf ||
type == BoxType.Stbl ||
type == BoxType.Trak) {
ParseTagAndProperties (
header.HeaderSize + position,
header.TotalBoxSize + position,
handler);
} else if (type == BoxType.Stsd) {
stsd_boxes.Add (BoxFactory.CreateBox (
file, header, handler));
} else if (type == BoxType.Hdlr) {
handler = BoxFactory.CreateBox (file,
header, handler) as
IsoHandlerBox;
} else if (mvhd_box == null &&
type == BoxType.Mvhd) {
mvhd_box = BoxFactory.CreateBox (file,
header, handler) as
IsoMovieHeaderBox;
} else if (udta_box == null &&
type == BoxType.Udta) {
udta_box = BoxFactory.CreateBox (file,
header, handler) as
IsoUserDataBox;
} else if (type == BoxType.Mdat) {
mdat_start = position;
mdat_end = position + header.TotalBoxSize;
}
if (header.TotalBoxSize == 0)
break;
}
}
/// <summary>
/// Resets all internal fields.
/// </summary>
private void ResetFields ()
{
mvhd_box = null;
udta_box = null;
moov_tree = null;
udta_tree = null;
stco_boxes.Clear ();
stsd_boxes.Clear ();
mdat_start = -1;
mdat_end = -1;
}
/// <summary>
/// Parses boxes for a specified range, looking for tags.
/// </summary>
/// <param name="start">
/// A <see cref="long" /> value specifying the seek position
/// at which to start reading.
/// </param>
/// <param name="end">
/// A <see cref="long" /> value specifying the seek position
/// at which to stop reading.
/// </param>
private void ParseTag (long start, long end)
{
BoxHeader header;
for (long position = start; position < end;
position += header.TotalBoxSize) {
header = new BoxHeader (file, position);
if (header.BoxType == BoxType.Moov ||
header.BoxType == BoxType.Mdia ||
header.BoxType == BoxType.Minf ||
header.BoxType == BoxType.Stbl ||
header.BoxType == BoxType.Trak) {
ParseTag (header.HeaderSize + position,
header.TotalBoxSize + position);
} else if (udta_box == null &&
header.BoxType == BoxType.Udta) {
udta_box = BoxFactory.CreateBox (file,
header) as IsoUserDataBox;
} else if (header.BoxType == BoxType.Mdat) {
mdat_start = position;
mdat_end = position + header.TotalBoxSize;
}
if (header.TotalBoxSize == 0)
break;
}
}
/// <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;
}
}
/// <summary>
/// Saves the changes made in the current instance to the
/// file it represents.
/// </summary>
public override void Save ()
{
if (udta_box == null)
udta_box = new IsoUserDataBox ();
// Try to get into write mode.
Mode = File.AccessMode.Write;
try {
FileParser parser = new FileParser (this);
parser.ParseBoxHeaders ();
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
long size_change = 0;
long write_position = 0;
ByteVector tag_data = udta_box.Render ();
// If we don't have a "udta" box to overwrite...
if (parser.UdtaTree == null ||
parser.UdtaTree.Length == 0 ||
parser.UdtaTree [parser.UdtaTree.Length - 1
].BoxType != BoxType.Udta) {
// Stick the box at the end of the moov box.
BoxHeader moov_header = parser.MoovTree [
parser.MoovTree.Length - 1];
size_change = tag_data.Count;
write_position = moov_header.Position +
moov_header.TotalBoxSize;
Insert (tag_data, write_position, 0);
// Overwrite the parent box sizes.
for (int i = parser.MoovTree.Length - 1; i >= 0;
i --)
size_change = parser.MoovTree [i
].Overwrite (this, size_change);
} else {
// Overwrite the old box.
BoxHeader udta_header = parser.UdtaTree [
parser.UdtaTree.Length - 1];
size_change = tag_data.Count -
udta_header.TotalBoxSize;
write_position = udta_header.Position;
Insert (tag_data, write_position,
udta_header.TotalBoxSize);
// Overwrite the parent box sizes.
for (int i = parser.UdtaTree.Length - 2; i >= 0;
i --)
size_change = parser.UdtaTree [i
].Overwrite (this, size_change);
}
// If we've had a size change, we may need to adjust
// chunk offsets.
if (size_change != 0) {
// We may have moved the offset boxes, so we
// need to reread.
parser.ParseChunkOffsets ();
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
foreach (Box box in parser.ChunkOffsetBoxes) {
IsoChunkLargeOffsetBox co64 =
box as IsoChunkLargeOffsetBox;
if (co64 != null) {
co64.Overwrite (this,
size_change,
write_position);
continue;
}
IsoChunkOffsetBox stco =
box as IsoChunkOffsetBox;
if (stco != null) {
stco.Overwrite (this,
size_change,
write_position);
continue;
}
}
}
TagTypesOnDisk = TagTypes;
} finally {
Mode = File.AccessMode.Closed;
}
}
/// <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;
}
}
/// <summary>
/// Saves the changes made in the current instance to the
/// file it represents.
/// </summary>
public override void Save()
{
if (udta_box == null)
{
udta_box = new IsoUserDataBox();
}
// Try to get into write mode.
Mode = File.AccessMode.Write;
try {
FileParser parser = new FileParser(this);
parser.ParseBoxHeaders();
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
long size_change = 0;
long write_position = 0;
ByteVector tag_data = udta_box.Render();
// If we don't have a "udta" box to overwrite...
if (parser.UdtaTree == null ||
parser.UdtaTree.Length == 0 ||
parser.UdtaTree [parser.UdtaTree.Length - 1
].BoxType != BoxType.Udta)
{
// Stick the box at the end of the moov box.
BoxHeader moov_header = parser.MoovTree [
parser.MoovTree.Length - 1];
size_change = tag_data.Count;
write_position = moov_header.Position +
moov_header.TotalBoxSize;
Insert(tag_data, write_position, 0);
// Overwrite the parent box sizes.
for (int i = parser.MoovTree.Length - 1; i >= 0;
i--)
{
size_change = parser.MoovTree [i
].Overwrite(this, size_change);
}
}
else
{
// Overwrite the old box.
BoxHeader udta_header = parser.UdtaTree [
parser.UdtaTree.Length - 1];
size_change = tag_data.Count -
udta_header.TotalBoxSize;
write_position = udta_header.Position;
Insert(tag_data, write_position,
udta_header.TotalBoxSize);
// Overwrite the parent box sizes.
for (int i = parser.UdtaTree.Length - 2; i >= 0;
i--)
{
size_change = parser.UdtaTree [i
].Overwrite(this, size_change);
}
}
// If we've had a size change, we may need to adjust
// chunk offsets.
if (size_change != 0)
{
// We may have moved the offset boxes, so we
// need to reread.
parser.ParseChunkOffsets();
InvariantStartPosition = parser.MdatStartPosition;
InvariantEndPosition = parser.MdatEndPosition;
foreach (Box box in parser.ChunkOffsetBoxes)
{
IsoChunkLargeOffsetBox co64 =
box as IsoChunkLargeOffsetBox;
if (co64 != null)
{
co64.Overwrite(this,
size_change,
write_position);
continue;
}
IsoChunkOffsetBox stco =
box as IsoChunkOffsetBox;
if (stco != null)
{
stco.Overwrite(this,
size_change,
write_position);
continue;
}
}
}
TagTypesOnDisk = TagTypes;
} finally {
Mode = File.AccessMode.Closed;
}
}