org.mp4parser.boxes.iso14496.part12.EditListBox Maven / Gradle / Ivy
/*
* 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 org.mp4parser.boxes.iso14496.part12;
import org.mp4parser.support.AbstractFullBox;
import org.mp4parser.tools.CastUtils;
import org.mp4parser.tools.IsoTypeReader;
import org.mp4parser.tools.IsoTypeWriter;
import java.nio.ByteBuffer;
import java.util.LinkedList;
import java.util.List;
/**
* 4cc = "{@value #TYPE}"
*
* Box Type : 'elst'
* Container: {@link EditBox}('edts')
* Mandatory: No
* Quantity : Zero or one
* 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.
* 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.
* 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:
*
* - Entry-count = 2
* - Segment-duration = 10 seconds
* - Media-Time = -1
* - Media-Rate = 1
* - Segment-duration = 30 seconds (could be the length of the whole track)
* - Media-Time = 0 seconds
* - Media-Rate = 1
*
*/
public class EditListBox extends AbstractFullBox {
public static final String TYPE = "elst";
private List entries = new LinkedList();
public EditListBox() {
super(TYPE);
}
public List getEntries() {
return entries;
}
public void setEntries(List 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 = CastUtils.l2i(IsoTypeReader.readUInt32(content));
entries = new LinkedList();
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 {
EditListBox editListBox;
private long segmentDuration;
private long mediaTime;
private double mediaRate;
/**
* Creates a new Entry with all values set.
*
* @param editListBox parent EditListBox
* @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 = bb.getLong();
mediaRate = IsoTypeReader.readFixedPoint1616(bb);
} else {
segmentDuration = IsoTypeReader.readUInt32(bb);
mediaTime = bb.getInt();
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);
bb.putLong(mediaTime);
} else {
IsoTypeWriter.writeUInt32(bb, CastUtils.l2i(segmentDuration));
bb.putInt(CastUtils.l2i(mediaTime));
}
IsoTypeWriter.writeFixedPoint1616(bb, mediaRate);
}
@Override
public String toString() {
return "Entry{" +
"segmentDuration=" + segmentDuration +
", mediaTime=" + mediaTime +
", mediaRate=" + mediaRate +
'}';
}
}
}