org.mp4parser.Container Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of isoparser Show documentation

A generic parser and writer for all ISO 14496 based files (MP4, Quicktime, DCF, PDCF, ...)

The newest version!

package org.mp4parser;

import java.io.IOException;
import java.nio.channels.WritableByteChannel;
import java.util.List;

/**
 * Interface for all ISO boxes that may contain other boxes.
 */
public interface Container {

    /**
     * Gets all child boxes. May not return null.
     *
     * @return an array of boxes, empty array in case of no children.
     */
    List getBoxes();

    /**
     * Sets all boxes and removes all previous child boxes.
     *
     * @param boxes the new list of children
     */
    void setBoxes(List boxes);

    /**
     * Gets all child boxes of the given type. May not return null.
     *
     * @param clazz child box's type
     * @param    type of boxes to get
     * @return an array of boxes, empty array in case of no children.
     */
     List getBoxes(Class clazz);

    /**
     * Gets all child boxes of the given type. May not return null.
     *
     * @param clazz     child box's type
     * @param recursive step down the tree
     * @param        type of boxes to get
     * @return an array of boxes, empty array in case of no children.
     */
     List getBoxes(Class clazz, boolean recursive);

    void writeContainer(WritableByteChannel bb) throws IOException;
}