io.humble.video

Class MuxerFormat

java.lang.Object

io.humble.ferry.RefCounted

io.humble.video.ContainerFormat

io.humble.video.MuxerFormat

public class MuxerFormat
extends ContainerFormat

An object that describes Containers that HumbleVideo can write MediaPacket objects
to.

Nested Class Summary

Nested classes/interfaces inherited from class io.humble.video.ContainerFormat

ContainerFormat.Flag

Method Summary

Modifier and Type	Method and Description
MuxerFormat	copyReference() Create a new MuxerFormat object that is actually referring to the exact same underlying native object.
boolean	equals(Object obj) Compares two values, returning true if the underlying objects in native code are the same object.
long	getBestCodecTag(Codec.ID id) Get the 'best' codec tag for the given codec id for this container.
Codec.ID	getDefaultAudioCodecId() Get the default audio codec for this format.
Codec.ID	getDefaultSubtitleCodecId() Get the default subtitle coded for this format.
Codec.ID	getDefaultVideoCodecId() Get the default video codec for this format.
String	getExtensions() A comma-separated list of supported filename extensions
int	getFlags() Flags that tell you what capabilities this format supports.
static MuxerFormat	getFormat(int index) Return an object for the input format at the given index.
static Collection<MuxerFormat>	getFormats() Return a collection of all output formats installed on this system.
String	getLongName() Descriptive name for the format, meant to be more human-readable than name.
String	getMimeType() Get the mime type for this format.
String	getName() Name for format.
static int	getNumFormats() Get the number of input formats this install can demultiplex (read) from.
Codec.ID	guessCodec(String shortName, String filename, String mimeType, MediaDescriptor.Type type)
static MuxerFormat	guessFormat(String shortName, String filename, String mimeType) Return the sink format in the list of registered sink formats which best matches the provided parameters, or return NULL if there is no match.
int	hashCode() Get a hashable value for this object.
String	toString() info about this format object

Methods inherited from class io.humble.video.ContainerFormat

getFlag, getSupportedCodecs, getSupportedTags

Methods inherited from class io.humble.ferry.RefCounted

delete, getCurrentRefCount

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

copyReference

public MuxerFormat copyReference()

Create a new MuxerFormat object that is actually referring to the exact same underlying native object.

Overrides:

copyReference in class ContainerFormat

Returns:

the new Java object.

equals

public boolean equals(Object obj)

Compares two values, returning true if the underlying objects in native code are the same object. That means you can have two different Java objects, but when you do a comparison, you'll find out they are the EXACT same object.

Overrides:

equals in class ContainerFormat

Returns:

True if the underlying native object is the same. False otherwise.

hashCode

public int hashCode()

Get a hashable value for this object.

Overrides:

hashCode in class ContainerFormat

Returns:

the hashable value.

toString

public String toString()

Description copied from class: ContainerFormat

info about this format object

Overrides:

toString in class ContainerFormat

Returns:

information about this object

getFormats

public static Collection<MuxerFormat> getFormats()

Return a collection of all output formats installed on this system.

Returns:

the list.

getName

public String getName()

Name for format.

Overrides:

getName in class ContainerFormat

getLongName

public String getLongName()

Descriptive name for the format, meant to be more human-readable
than name.

Overrides:

getLongName in class ContainerFormat

getExtensions

public String getExtensions()

A comma-separated list of supported filename extensions

Overrides:

getExtensions in class ContainerFormat

getFlags

public int getFlags()

Flags that tell you what capabilities this format supports.

Overrides:

getFlags in class ContainerFormat

Returns:

a bitmask of Flags

getDefaultAudioCodecId

public Codec.ID getDefaultAudioCodecId()

Get the default audio codec for this format.

getDefaultVideoCodecId

public Codec.ID getDefaultVideoCodecId()

Get the default video codec for this format.

getDefaultSubtitleCodecId

public Codec.ID getDefaultSubtitleCodecId()

Get the default subtitle coded for this format.

getMimeType

public String getMimeType()

Get the mime type for this format.

guessFormat

public static MuxerFormat guessFormat(String shortName,
                                      String filename,
                                      String mimeType)

Return the sink format in the list of registered sink formats
which best matches the provided parameters, or return NULL if
there is no match.

Parameters:

shortName - if non-NULL checks if short_name matches with the
names of the registered formats

filename - if non-NULL checks if filename terminates with the
extensions of the registered formats

mimeType - if non-NULL checks if mime_type matches with the
MIME type of the registered formats

guessCodec

public Codec.ID guessCodec(String shortName,
                           String filename,
                           String mimeType,
                           MediaDescriptor.Type type)

getBestCodecTag

public long getBestCodecTag(Codec.ID id)

Get the 'best' codec tag for the given codec id for this container.

getNumFormats

public static int getNumFormats()

Get the number of input formats this install can demultiplex (read)
from.

Returns:

the number of formats

getFormat

public static MuxerFormat getFormat(int index)

Return an object for the input format at the given index.

Parameters:

index - an index for the input format list we maintain

Returns:

a format object for that input or null if
unknown, index < 0 or index >= #getNumInstalledInputFormats()