diff options
Diffstat (limited to 'isoparser/src/main/java/com/coremedia/iso/boxes/EditListBox.java')
-rw-r--r-- | isoparser/src/main/java/com/coremedia/iso/boxes/EditListBox.java | 248 |
1 files changed, 248 insertions, 0 deletions
diff --git a/isoparser/src/main/java/com/coremedia/iso/boxes/EditListBox.java b/isoparser/src/main/java/com/coremedia/iso/boxes/EditListBox.java new file mode 100644 index 0000000..231f8be --- /dev/null +++ b/isoparser/src/main/java/com/coremedia/iso/boxes/EditListBox.java @@ -0,0 +1,248 @@ +/* + * Copyright 2008 CoreMedia AG, Hamburg + * + * Licensed under the Apache License, Version 2.0 (the License); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.coremedia.iso.boxes; + + +import com.coremedia.iso.IsoTypeReader; +import com.coremedia.iso.IsoTypeWriter; +import com.googlecode.mp4parser.AbstractFullBox; + +import java.io.IOException; +import java.nio.ByteBuffer; +import java.util.LinkedList; +import java.util.List; + +import static com.googlecode.mp4parser.util.CastUtils.l2i; + +/** + * <code> + * Box Type : 'elst'<br> + * Container: {@link EditBox}('edts')<br> + * Mandatory: No<br> + * Quantity : Zero or one</code><br><br> + * This box contains an explicit timeline map. Each entry defines part of the track time-line: by mapping part of + * the media time-line, or by indicating 'empty' time, or by defining a 'dwell', where a single time-point in the + * media is held for a period.<br> + * Note that edits are not restricted to fall on sample times. This means that when entering an edit, it can be + * necessary to (a) back up to a sync point, and pre-roll from there and then (b) be careful about the duration of + * the first sample - it might have been truncated if the edit enters it during its normal duration. If this is audio, + * that frame might need to be decoded, and then the final slicing done. Likewise, the duration of the last sample + * in an edit might need slicing. <br> + * Starting offsets for tracks (streams) are represented by an initial empty edit. For example, to play a track from + * its start for 30 seconds, but at 10 seconds into the presentation, we have the following edit list:<br> + * <p/> + * <li>Entry-count = 2</li> + * <li>Segment-duration = 10 seconds</li> + * <li>Media-Time = -1</li> + * <li>Media-Rate = 1</li> + * <li>Segment-duration = 30 seconds (could be the length of the whole track)</li> + * <li>Media-Time = 0 seconds</li> + * <li>Media-Rate = 1</li> + */ +public class EditListBox extends AbstractFullBox { + private List<Entry> entries = new LinkedList<Entry>(); + public static final String TYPE = "elst"; + + public EditListBox() { + super(TYPE); + } + + + public List<Entry> getEntries() { + return entries; + } + + public void setEntries(List<Entry> entries) { + this.entries = entries; + } + + protected long getContentSize() { + long contentSize = 8; + if (getVersion() == 1) { + contentSize += entries.size() * 20; + } else { + contentSize += entries.size() * 12; + } + + return contentSize; + } + + @Override + public void _parseDetails(ByteBuffer content) { + parseVersionAndFlags(content); + int entryCount = l2i(IsoTypeReader.readUInt32(content)); + entries = new LinkedList<Entry>(); + for (int i = 0; i < entryCount; i++) { + entries.add(new Entry(this, content)); + + } + } + + @Override + protected void getContent(ByteBuffer byteBuffer) { + writeVersionAndFlags(byteBuffer); + IsoTypeWriter.writeUInt32(byteBuffer, entries.size()); + for (Entry entry : entries) { + entry.getContent(byteBuffer); + } + } + + @Override + public String toString() { + return "EditListBox{" + + "entries=" + entries + + '}'; + } + + public static class Entry { + private long segmentDuration; + private long mediaTime; + private double mediaRate; + EditListBox editListBox; + + /** + * Creates a new <code>Entry</code> with all values set. + * + * @param segmentDuration duration in movie timescale + * @param mediaTime starting time + * @param mediaRate relative play rate + */ + public Entry(EditListBox editListBox, long segmentDuration, long mediaTime, double mediaRate) { + this.segmentDuration = segmentDuration; + this.mediaTime = mediaTime; + this.mediaRate = mediaRate; + this.editListBox = editListBox; + } + + public Entry(EditListBox editListBox, ByteBuffer bb) { + if (editListBox.getVersion() == 1) { + segmentDuration = IsoTypeReader.readUInt64(bb); + mediaTime = IsoTypeReader.readUInt64(bb); + mediaRate = IsoTypeReader.readFixedPoint1616(bb); + } else { + segmentDuration = IsoTypeReader.readUInt32(bb); + mediaTime = IsoTypeReader.readUInt32(bb); + mediaRate = IsoTypeReader.readFixedPoint1616(bb); + } + this.editListBox = editListBox; + } + + /** + * The segment duration is an integer that specifies the duration + * of this edit segment in units of the timescale in the Movie + * Header Box + * + * @return segment duration in movie timescale + */ + public long getSegmentDuration() { + return segmentDuration; + } + + /** + * The segment duration is an integer that specifies the duration + * of this edit segment in units of the timescale in the Movie + * Header Box + * + * @param segmentDuration new segment duration in movie timescale + */ + public void setSegmentDuration(long segmentDuration) { + this.segmentDuration = segmentDuration; + } + + /** + * The media time is an integer containing the starting time + * within the media of a specific edit segment(in media time + * scale units, in composition time) + * + * @return starting time + */ + public long getMediaTime() { + return mediaTime; + } + + /** + * The media time is an integer containing the starting time + * within the media of a specific edit segment(in media time + * scale units, in composition time) + * + * @param mediaTime starting time + */ + public void setMediaTime(long mediaTime) { + this.mediaTime = mediaTime; + } + + /** + * The media rate specifies the relative rate at which to play the + * media corresponding to a specific edit segment. + * + * @return relative play rate + */ + public double getMediaRate() { + return mediaRate; + } + + /** + * The media rate specifies the relative rate at which to play the + * media corresponding to a specific edit segment. + * + * @param mediaRate new relative play rate + */ + public void setMediaRate(double mediaRate) { + this.mediaRate = mediaRate; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + + Entry entry = (Entry) o; + + if (mediaTime != entry.mediaTime) return false; + if (segmentDuration != entry.segmentDuration) return false; + + return true; + } + + @Override + public int hashCode() { + int result = (int) (segmentDuration ^ (segmentDuration >>> 32)); + result = 31 * result + (int) (mediaTime ^ (mediaTime >>> 32)); + return result; + } + + public void getContent(ByteBuffer bb) { + if (editListBox.getVersion() == 1) { + IsoTypeWriter.writeUInt64(bb, segmentDuration); + IsoTypeWriter.writeUInt64(bb, mediaTime); + } else { + IsoTypeWriter.writeUInt32(bb, l2i(segmentDuration)); + bb.putInt(l2i(mediaTime)); + } + IsoTypeWriter.writeFixedPont1616(bb, mediaRate); + } + + @Override + public String toString() { + return "Entry{" + + "segmentDuration=" + segmentDuration + + ", mediaTime=" + mediaTime + + ", mediaRate=" + mediaRate + + '}'; + } + } +} |