Package org.opensourcephysics.media.xuggle

Class DiagnosticsForXuggle

java.lang.Object

org.opensourcephysics.tools.Diagnostics

org.opensourcephysics.media.xuggle.DiagnosticsForXuggle

public class DiagnosticsForXuggle
extends Diagnostics

Checks to see if Xuggle is installed and working.

Version:

1.0

Author:

Wolfgang Christian, Douglas Brown

Field Summary

Fields

Modifier and Type	Field	Description
static final String	REQUEST_TRACKER

Fields inherited from class org.opensourcephysics.tools.Diagnostics

dialogOwner, TRACKER_INSTALLER_URL

Method Summary

Modifier and Type	Method	Description
static void	aboutXuggle()	Displays the About Xuggle dialog.
static void	aboutXuggle(String request)	Displays the About Xuggle dialog for Tracker or other requester.
static String[]	getDiagnosticMessage(int status, String requester)	Gets a diagnostic message when Xuggle is not working.
static int	getStatusCode()	Gets a status code that identifies the current state of the Xuggle video engine.
static File	getXuggleJar()	Gets the xuggle jar from the xuggleHome directory, if it exists.
static File[]	getXuggleJarFiles(String dir)	Gets the xuggle jar files (named in xuggleJarNames) found in a given directory.
static String	getXuggleVersion()	Gets the Xuggle version as a String.
static void	main(String[] args)	Tests this class.

Methods inherited from class org.opensourcephysics.tools.Diagnostics

aboutJava, aboutJava3D, aboutJOGL, aboutLaunchJar, aboutOS, getDialogOwner, getJarFile, setDialogOwner

Methods inherited from class java.lang.Object

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

Field Details

REQUEST_TRACKER

public static final String REQUEST_TRACKER

See Also:

• Constant Field Values

Method Details

aboutXuggle

public static void aboutXuggle()

Displays the About Xuggle dialog. If working correctly, shows version, etc. If not working, shows a diagnostic message.

aboutXuggle

public static void aboutXuggle(String request)

Displays the About Xuggle dialog for Tracker or other requester.

Parameters:

request - currently only "Tracker" is supported

getXuggleJarFiles

public static File[] getXuggleJarFiles(String dir)

Gets the xuggle jar files (named in xuggleJarNames) found in a given directory. Always returns the array, but individual elements may be null.

Parameters:

dir - the directory

Returns:

the array of jar files found

getStatusCode

public static int getStatusCode()

Gets a status code that identifies the current state of the Xuggle video engine. Codes are: 0 working correctly 1 not installed (XUGGLE_HOME==null, no xuggle jar in code base) 2 can't find xuggle home (XUGGLE_HOME==null but xuggle jar found in code base) 3 XUGGLE_HOME incomplete: missing xuggle jar in XUGGLE_HOME 4 unused. was XUGGLE_HOME OK, but incorrect "PATH", "DYLD_LIBRARY_PATH", or "LD_LIBRARY_PATH" 5 XUGGLE_HOME OK, but no xuggle jars in code base 6 XUGGLE_HOME OK, but mismatched xuggle versions in code base 7 XUGGLE_HOME OK, but wrong Java VM bitness -1 none of the above

Returns:

status code

getDiagnosticMessage

public static String[] getDiagnosticMessage(int status,
 String requester)

Gets a diagnostic message when Xuggle is not working.

Parameters:

status - the status code from getStatusCode() method

requester - --currently only "Tracker" is supported

Returns:

an array strings containing the message lines

getXuggleVersion

public static String getXuggleVersion()

Gets the Xuggle version as a String. Returns "Unknown' if Xuggle is missing or unidentified.

Returns:

Xuggle version

getXuggleJar

public static File getXuggleJar()

Gets the xuggle jar from the xuggleHome directory, if it exists.

Returns:

the xuggle jar file

main

public static void main(String[] args)

Tests this class.

Parameters:

args - ignored