com.abercap.mediainfo.api.MediaInfoLibrary Maven / Gradle / Ivy


package com.abercap.mediainfo.api;


import static java.util.Collections.singletonMap;

import java.lang.reflect.Method;

import com.sun.jna.FunctionMapper;
import com.sun.jna.Library;
import com.sun.jna.Native;
import com.sun.jna.NativeLibrary;
import com.sun.jna.Pointer;
import com.sun.jna.WString;


interface MediaInfoLibrary extends Library {
	
	MediaInfoLibrary INSTANCE = (MediaInfoLibrary) Native.loadLibrary("mediainfo", MediaInfoLibrary.class, singletonMap(OPTION_FUNCTION_MAPPER, new FunctionMapper() {
		
		public String getFunctionName(NativeLibrary lib, Method method) {
			// MediaInfo_New(), MediaInfo_Open() ...
			return "MediaInfo_" + method.getName();
		}
	}));
	
	
	/**
	 * Create a new handle.
	 * 
	 * @return handle
	 */
	Pointer New();
	

	/**
	 * Open a file and collect information about it (technical information and tags).
	 * 
	 * @param handle
	 * @param file full name of the file to open
	 * @return 1 if file was opened, 0 if file was not not opened
	 */
	int Open(Pointer handle, WString file);
	

	/**
	 * Configure or get information about MediaInfo.
	 * 
	 * @param handle
	 * @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
	 */
	WString Option(Pointer handle, WString option, WString value);
	

	/**
	 * Get all details about a file.
	 * 
	 * @param handle
	 * @return All details about a file in one string
	 */
	WString Inform(Pointer handle);
	

	/**
	 * Get a piece of information about a file (parameter is a string).
	 * 
	 * @param handle
	 * @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
	 */
	WString Get(Pointer handle, int streamKind, int streamNumber, WString parameter, int infoKind, int searchKind);
	

	/**
	 * Get a piece of information about a file (parameter is an integer).
	 * 
	 * @param handle
	 * @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
	 */
	WString GetI(Pointer handle, int streamKind, int streamNumber, int parameterIndex, int infoKind);
	

	/**
	 * Count of streams of a stream kind (StreamNumber not filled), or count of piece of
	 * information in this stream.
	 * 
	 * @param handle
	 * @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
	 */
	int Count_Get(Pointer handle, int streamKind, int streamNumber);
	

	/**
	 * Close a file opened before with Open().
	 * 
	 * @param handle
	 */
	void Close(Pointer handle);
	

	/**
	 * Dispose of a handle created with New().
	 * 
	 * @param handle
	 */
	void Delete(Pointer handle);
	
}