Package 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:

java.io.Closeable, java.lang.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	Description
protected java.util.Map<StreamingTrack,java.util.Queue<org.mp4parser.streaming.output.mp4.StandardMp4Writer.ChunkContainer>>	chunkBuffers	Buffers segements until it's time for a segment to be written.
protected java.util.Map<StreamingTrack,java.lang.Long>	chunkNumbers
protected java.util.Map<StreamingTrack,java.util.concurrent.CountDownLatch>	congestionControl
protected java.util.Date	creationTime
protected java.util.Map<StreamingTrack,java.lang.Long>	nextChunkCreateStartTime	Contains the start time of the next segment in line that will be created.
protected java.util.Map<StreamingTrack,java.lang.Long>	nextChunkWriteStartTime	Contains the start time of the next segment in line that will be written.
protected java.util.Map<StreamingTrack,java.lang.Long>	nextSampleStartTime	Contains the next sample's start time.
static java.lang.Object	OBJ
protected java.util.Map<StreamingTrack,java.util.List<StreamingSample>>	sampleBuffers	Buffers the samples per track until there are enough samples to form a Segment.
protected java.util.Map<StreamingTrack,java.lang.Long>	sampleNumbers
protected java.nio.channels.WritableByteChannel	sink
protected java.util.List<StreamingTrack>	source
protected java.util.Map<StreamingTrack,org.mp4parser.boxes.iso14496.part12.TrackBox>	trackBoxes

Constructor Summary

Constructors

Constructor	Description
StandardMp4Writer(java.util.List<StreamingTrack> source, java.nio.channels.WritableByteChannel sink)

Method Summary

Modifier and Type	Method	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 org.mp4parser.Box	createMdhd(StreamingTrack streamingTrack)
protected org.mp4parser.Box	createMoov()
protected org.mp4parser.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(java.nio.channels.WritableByteChannel out, org.mp4parser.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 java.lang.Object OBJ

sink

protected final java.nio.channels.WritableByteChannel sink

source

protected java.util.List<StreamingTrack> source

creationTime

protected java.util.Date creationTime

congestionControl

protected java.util.Map<StreamingTrack,java.util.concurrent.CountDownLatch> congestionControl

nextChunkCreateStartTime

protected java.util.Map<StreamingTrack,java.lang.Long> nextChunkCreateStartTime

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

nextChunkWriteStartTime

protected java.util.Map<StreamingTrack,java.lang.Long> nextChunkWriteStartTime

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

nextSampleStartTime

protected java.util.Map<StreamingTrack,java.lang.Long> nextSampleStartTime

Contains the next sample's start time.

sampleBuffers

protected java.util.Map<StreamingTrack,java.util.List<StreamingSample>> sampleBuffers

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

trackBoxes

protected java.util.Map<StreamingTrack,org.mp4parser.boxes.iso14496.part12.TrackBox> trackBoxes

chunkBuffers

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

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

chunkNumbers

protected java.util.Map<StreamingTrack,java.lang.Long> chunkNumbers

sampleNumbers

protected java.util.Map<StreamingTrack,java.lang.Long> sampleNumbers

Constructor Detail

StandardMp4Writer

public StandardMp4Writer(java.util.List<StreamingTrack> source,
                         java.nio.channels.WritableByteChannel sink)

Method Detail

close

public void close()
           throws java.io.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 java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface SampleSink

Throws:

java.io.IOException - if closing fails

createMoov

protected org.mp4parser.Box createMoov()

createMvhd

protected org.mp4parser.Box createMvhd()

Specified by:

createMvhd in class DefaultBoxes

write

protected void write(java.nio.channels.WritableByteChannel out,
                     org.mp4parser.Box... boxes)
              throws java.io.IOException

Throws:

java.io.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 java.io.IOException

Throws:

java.io.IOException

acceptSample

public void acceptSample(StreamingSample streamingSample,
                         StreamingTrack streamingTrack)
                  throws java.io.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:

java.io.IOException - if writing (or reading) fails.

createMdhd

protected org.mp4parser.Box createMdhd(StreamingTrack streamingTrack)

Specified by:

createMdhd in class DefaultBoxes