org.mp4parser.streaming.output.mp4

Class StandardMp4Writer

java.lang.Object

org.mp4parser.streaming.output.mp4.DefaultBoxes

org.mp4parser.streaming.output.mp4.StandardMp4Writer

All Implemented Interfaces:

Closeable, AutoCloseable, SampleSink

public class StandardMp4Writer
extends DefaultBoxes
implements SampleSink

Creates an MP4 file with ftyp, mdat+, moov order. A very special property of this variant is that it written sequentially. You can start transferring the data while the sink receives it. (in contrast to typical implementations which need random access to write length fields at the beginning of the file)

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<StreamingTrack,Queue<org.mp4parser.streaming.output.mp4.StandardMp4Writer.ChunkContainer>>	chunkBuffers Buffers segements until it's time for a segment to be written.
protected Map<StreamingTrack,Long>	chunkNumbers
protected Map<StreamingTrack,CountDownLatch>	congestionControl
protected Date	creationTime
protected Map<StreamingTrack,Long>	nextChunkCreateStartTime Contains the start time of the next segment in line that will be created.
protected Map<StreamingTrack,Long>	nextChunkWriteStartTime Contains the start time of the next segment in line that will be written.
protected Map<StreamingTrack,Long>	nextSampleStartTime Contains the next sample's start time.
static Object	OBJ
protected Map<StreamingTrack,List<StreamingSample>>	sampleBuffers Buffers the samples per track until there are enough samples to form a Segment.
protected Map<StreamingTrack,Long>	sampleNumbers
protected WritableByteChannel	sink
protected List<StreamingTrack>	source
protected Map<StreamingTrack,TrackBox>	trackBoxes

Constructor Summary

Constructors

Constructor and Description
StandardMp4Writer(List<StreamingTrack> source, WritableByteChannel sink)

Method Summary

Modifier and Type	Method and Description
void	acceptSample(StreamingSample streamingSample, StreamingTrack streamingTrack) Adds a samples to the SampleSink.
void	close() Free all resources blocked and interrupts the process of writing the output.
protected Box	createMdhd(StreamingTrack streamingTrack)
protected Box	createMoov()
protected Box	createMvhd()
protected boolean	isChunkReady(StreamingTrack streamingTrack, StreamingSample next) Tests if the currently received samples for a given track are already a 'chunk' as we want to have it.
protected void	write(WritableByteChannel out, Box... boxes)
protected void	writeChunkContainer(org.mp4parser.streaming.output.mp4.StandardMp4Writer.ChunkContainer chunkContainer)

Methods inherited from class org.mp4parser.streaming.output.mp4.DefaultBoxes

createDinf, createFtyp, createMdia, createMdiaHdlr, createMinf, createStbl, createTkhd, createTrak

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OBJ

public static final Object OBJ

sink

protected final WritableByteChannel sink

source

protected List<StreamingTrack> source

creationTime

protected Date creationTime

congestionControl

protected Map<StreamingTrack,CountDownLatch> congestionControl

nextChunkCreateStartTime

protected Map<StreamingTrack,Long> nextChunkCreateStartTime

Contains the start time of the next segment in line that will be created.

nextChunkWriteStartTime

protected Map<StreamingTrack,Long> nextChunkWriteStartTime

Contains the start time of the next segment in line that will be written.

nextSampleStartTime

protected Map<StreamingTrack,Long> nextSampleStartTime

Contains the next sample's start time.

sampleBuffers

protected Map<StreamingTrack,List<StreamingSample>> sampleBuffers

Buffers the samples per track until there are enough samples to form a Segment.

trackBoxes

protected Map<StreamingTrack,TrackBox> trackBoxes

chunkBuffers

protected Map<StreamingTrack,Queue<org.mp4parser.streaming.output.mp4.StandardMp4Writer.ChunkContainer>> chunkBuffers

Buffers segements until it's time for a segment to be written.

chunkNumbers

protected Map<StreamingTrack,Long> chunkNumbers

sampleNumbers

protected Map<StreamingTrack,Long> sampleNumbers

Constructor Detail

StandardMp4Writer

public StandardMp4Writer(List<StreamingTrack> source,
                         WritableByteChannel sink)

Method Detail

close

public void close()
           throws IOException

Description copied from interface: SampleSink

Free all resources blocked and interrupts the process of writing the output. An implementation should flush all samples that have not yet been written and write the file footer - if exists - before actually freeing the resources.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SampleSink

Throws:

IOException - if closing fails

createMoov

protected Box createMoov()

createMvhd

protected Box createMvhd()

Specified by:

createMvhd in class DefaultBoxes

write

protected void write(WritableByteChannel out,
                     Box... boxes)
              throws IOException

Throws:

IOException

isChunkReady

protected boolean isChunkReady(StreamingTrack streamingTrack,
                               StreamingSample next)

Tests if the currently received samples for a given track are already a 'chunk' as we want to have it. The next sample will not be part of the chunk will be added to the fragment buffer later.

Parameters:

streamingTrack - track to test

next - the lastest samples

Returns:

true if a chunk is to b e created.

writeChunkContainer

protected void writeChunkContainer(org.mp4parser.streaming.output.mp4.StandardMp4Writer.ChunkContainer chunkContainer)
                            throws IOException

Throws:

IOException

acceptSample

public void acceptSample(StreamingSample streamingSample,
                         StreamingTrack streamingTrack)
                  throws IOException

Description copied from interface: SampleSink

Adds a samples to the SampleSink. This might or might not cause writing the sample any output stream or channel. Once this method is called the StreamingTrack must be ready and accept calls to any method.

Specified by:

acceptSample in interface SampleSink

Throws:

IOException - if writing (or reading) fails.

createMdhd

protected Box createMdhd(StreamingTrack streamingTrack)

Specified by:

createMdhd in class DefaultBoxes