package me.chenyi.mm.mediainfodll;
/**
* MediaInfoDLL - All info about media files, for DLL (JNA version)
*
* Copyright (C) 2009-2009 Jerome Martinez, Zen@MediaArea.net
*
* This library is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*
**/
// Note: the original stuff was well packaged with Java style,
// but I (the main developer) prefer to keep an easiest for me
// way to have all sources and example in the same place
// Removed stuff:
// "package net.sourceforge.mediainfo;"
// directory was /net/sourceforge/mediainfo
import java.lang.reflect.Method;
import com.sun.jna.*;
import static java.util.Collections.singletonMap;
public class MediaInfo
{
//Internal stuff
interface MediaInfoDLL_Internal extends Library
{
MediaInfoDLL_Internal INSTANCE = (MediaInfoDLL_Internal) Native.loadLibrary("mediainfo", MediaInfoDLL_Internal.class, singletonMap(OPTION_FUNCTION_MAPPER, new FunctionMapper()
{
public String getFunctionName(NativeLibrary lib, Method method)
{
// MediaInfo_New(), MediaInfo_Open() ...
return "MediaInfo_" + method.getName();
}
}
));
//Constructor/Destructor
Pointer New();
void Delete(Pointer Handle);
//File
int Open(Pointer Handle, WString file);
void Close(Pointer Handle);
//Infos
WString Inform(Pointer Handle);
WString Get(Pointer Handle, int StreamKind, int StreamNumber, WString parameter, int infoKind, int searchKind);
WString GetI(Pointer Handle, int StreamKind, int StreamNumber, int parameterIndex, int infoKind);
int Count_Get(Pointer Handle, int StreamKind, int StreamNumber);
//Options
WString Option(Pointer Handle, WString option, WString value);
}
private Pointer Handle;
public enum StreamKind {
General,
Video,
Audio,
Text,
Chapters,
Image,
Menu;
}
//Enums
public enum InfoKind {
/**
* Unique name of parameter.
*/
Name,
/**
* Value of parameter.
*/
Text,
/**
* Unique name of measure unit of parameter.
*/
Measure,
Options,
/**
* Translated name of parameter.
*/
Name_Text,
/**
* Translated name of measure unit.
*/
Measure_Text,
/**
* More information about the parameter.
*/
Info,
/**
* How this parameter is supported, could be N (No), B (Beta), R (Read only), W
* (Read/Write).
*/
HowTo,
/**
* Domain of this piece of information.
*/
Domain;
}
//Constructor/Destructor
public MediaInfo()
{
Handle = MediaInfoDLL_Internal.INSTANCE.New();
}
public void dispose()
{
if (Handle == null)
throw new IllegalStateException();
MediaInfoDLL_Internal.INSTANCE.Delete(Handle);
Handle = null;
}
@Override
protected void finalize() throws Throwable
{
if (Handle != null)
dispose();
}
//File
/**
* Open a file and collect information about it (technical information and tags).
*
* @param file full name of the file to open
* @return 1 if file was opened, 0 if file was not not opened
*/
public int Open(String File_Name)
{
return MediaInfoDLL_Internal.INSTANCE.Open(Handle, new WString(File_Name));
}
/**
* Close a file opened before with Open().
*
*/
public void Close()
{
MediaInfoDLL_Internal.INSTANCE.Close(Handle);
}
//Information
/**
* Get all details about a file.
*
* @return All details about a file in one string
*/
public String Inform()
{
return MediaInfoDLL_Internal.INSTANCE.Inform(Handle).toString();
}
/**
* Get a piece of information about a file (parameter is a string).
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @param StreamNumber Stream number in Kind of Stream (first, second...)
* @param parameter Parameter you are looking for in the Stream (Codec, width, bitrate...),
* in string format ("Codec", "Width"...)
* @return a string about information you search, an empty string if there is a problem
*/
public String Get(StreamKind StreamKind, int StreamNumber, String parameter)
{
return Get(StreamKind, StreamNumber, parameter, InfoKind.Text, InfoKind.Name);
}
/**
* Get a piece of information about a file (parameter is a string).
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @param StreamNumber Stream number in Kind of Stream (first, second...)
* @param parameter Parameter you are looking for in the Stream (Codec, width, bitrate...),
* in string format ("Codec", "Width"...)
* @param infoKind Kind of information you want about the parameter (the text, the measure,
* the help...)
* @param searchKind Where to look for the parameter
*/
public String Get(StreamKind StreamKind, int StreamNumber, String parameter, InfoKind infoKind)
{
return Get(StreamKind, StreamNumber, parameter, infoKind, InfoKind.Name);
}
/**
* Get a piece of information about a file (parameter is a string).
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @param StreamNumber Stream number in Kind of Stream (first, second...)
* @param parameter Parameter you are looking for in the Stream (Codec, width, bitrate...),
* in string format ("Codec", "Width"...)
* @param infoKind Kind of information you want about the parameter (the text, the measure,
* the help...)
* @param searchKind Where to look for the parameter
* @return a string about information you search, an empty string if there is a problem
*/
public String Get(StreamKind StreamKind, int StreamNumber, String parameter, InfoKind infoKind, InfoKind searchKind)
{
return MediaInfoDLL_Internal.INSTANCE.Get(Handle, StreamKind.ordinal(), StreamNumber, new WString(parameter), infoKind.ordinal(), searchKind.ordinal()).toString();
}
/**
* Get a piece of information about a file (parameter is an integer).
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @param StreamNumber Stream number in Kind of Stream (first, second...)
* @param parameter Parameter you are looking for in the Stream (Codec, width, bitrate...),
* in integer format (first parameter, second parameter...)
* @return a string about information you search, an empty string if there is a problem
*/
public String get(StreamKind StreamKind, int StreamNumber, int parameterIndex)
{
return Get(StreamKind, StreamNumber, parameterIndex, InfoKind.Text);
}
/**
* Get a piece of information about a file (parameter is an integer).
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @param StreamNumber Stream number in Kind of Stream (first, second...)
* @param parameter Parameter you are looking for in the Stream (Codec, width, bitrate...),
* in integer format (first parameter, second parameter...)
* @param infoKind Kind of information you want about the parameter (the text, the measure,
* the help...)
* @return a string about information you search, an empty string if there is a problem
*/
public String Get(StreamKind StreamKind, int StreamNumber, int parameterIndex, InfoKind infoKind)
{
return MediaInfoDLL_Internal.INSTANCE.GetI(Handle, StreamKind.ordinal(), StreamNumber, parameterIndex, infoKind.ordinal()).toString();
}
/**
* Count of Streams of a Stream kind (StreamNumber not filled), or count of piece of
* information in this Stream.
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @return number of Streams of the given Stream kind
*/
public int Count_Get(StreamKind StreamKind)
{
return MediaInfoDLL_Internal.INSTANCE.Count_Get(Handle, StreamKind.ordinal(), -1);
}
/**
* Count of Streams of a Stream kind (StreamNumber not filled), or count of piece of
* information in this Stream.
*
* @param StreamKind Kind of Stream (general, video, audio...)
* @param StreamNumber Stream number in this kind of Stream (first, second...)
* @return number of Streams of the given Stream kind
*/
public int Count_Get(StreamKind StreamKind, int StreamNumber)
{
return MediaInfoDLL_Internal.INSTANCE.Count_Get(Handle, StreamKind.ordinal(), StreamNumber);
}
//Options
/**
* Configure or get information about MediaInfo.
*
* @param Option The name of option
* @return Depends on the option: by default "" (nothing) means No, other means Yes
*/
public String Option(String Option)
{
return MediaInfoDLL_Internal.INSTANCE.Option(Handle, new WString(Option), new WString("")).toString();
}
/**
* Configure or get information about MediaInfo.
*
* @param Option The name of option
* @param Value The value of option
* @return Depends on the option: by default "" (nothing) means No, other means Yes
*/
public String Option(String Option, String Value)
{
return MediaInfoDLL_Internal.INSTANCE.Option(Handle, new WString(Option), new WString(Value)).toString();
}
/**
* Configure or get information about MediaInfo (Static version).
*
* @param Option The name of option
* @return Depends on the option: by default "" (nothing) means No, other means Yes
*/
public static String Option_Static(String Option)
{
return MediaInfoDLL_Internal.INSTANCE.Option(MediaInfoDLL_Internal.INSTANCE.New(), new WString(Option), new WString("")).toString();
}
/**
* Configure or get information about MediaInfo(Static version).
*
* @param Option The name of option
* @param Value The value of option
* @return Depends on the option: by default "" (nothing) means No, other means Yes
*/
public static String Option_Static(String Option, String Value)
{
return MediaInfoDLL_Internal.INSTANCE.Option(MediaInfoDLL_Internal.INSTANCE.New(), new WString(Option), new WString(Value)).toString();
}
}