org.jcodec.movtool

Class InplaceMP4Editor

java.lang.Object

org.jcodec.movtool.InplaceMP4Editor

public class InplaceMP4Editor
extends Object

This class is part of JCodec ( www.jcodec.org ) This software is distributed under FreeBSD License Parses MP4 header and allows custom MP4Editor to modify it, then tries to put the resulting header into the same place relatively to a file. This might not work out, for example if the resulting header is bigger then the original. Use this class to make blazing fast changes to MP4 files when you know your are not adding anything new to the header, perhaps only patching some values or removing stuff from the header.

Author:

The JCodec project

Constructor Summary

Constructors

Constructor and Description
InplaceMP4Editor()

Method Summary

Modifier and Type	Method and Description
boolean	copy(File src, File dst, MP4Edit edit) Tries to modify movie header in place according to what's implemented in the edit.
boolean	modify(File file, MP4Edit edit) Tries to modify movie header in place according to what's implemented in the edit, the file gets pysically modified if the operation is successful.
boolean	replace(File src, MP4Edit edit) Tries to modify movie header in place according to what's implemented in the edit.

Methods inherited from class java.lang.Object

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

Constructor Detail

InplaceMP4Editor

public InplaceMP4Editor()

Method Detail

modify

public boolean modify(File file,
                      MP4Edit edit)
               throws IOException

Tries to modify movie header in place according to what's implemented in the edit, the file gets pysically modified if the operation is successful. No temporary file is created.

Parameters:

file - A file to be modified

edit - An edit to be carried out on a movie header

Returns:

Whether or not edit was successful, i.e. was there enough place to put the new header

Throws:

IOException

Exception

copy

public boolean copy(File src,
                    File dst,
                    MP4Edit edit)
             throws IOException

Tries to modify movie header in place according to what's implemented in the edit. Copies modified contents to a new file. Note: The header is still edited in-place, so the new file will have all-the-same sample offsets. Note: Still subject to the same limitations as 'modify', i.e. the new header must 'fit' into an old place. This method is useful when you can't write to the original file, for ex. you don't have permission.

Parameters:

src - An original file

dst - A file to store the modified copy

edit - An edit logic to apply

Returns:

Throws:

IOException

replace

public boolean replace(File src,
                       MP4Edit edit)
                throws IOException

Tries to modify movie header in place according to what's implemented in the edit. Copies modified contents to a new file with the same name erasing the original file if successful. This is a shortcut for 'copy' when you want the new file to have the same name but for some reason can not modify the original file in place. Maybe modifications of files are expensive or not supported on your filesystem.

Parameters:

src - A source and destination file

edit - An edit to be applied

Returns:

Throws:

IOException