The JavaTM Media Framework (JMF) is an application programming interface (API) for incorporating media data such as audio and video into Java applications and applets. It is specifically designed to take advantage of Java platform features.
The JMF 1.0 API (the Java Media Player API) enables programmers to develop Java programs for playback of time-based media. The JMF 2.0 API extends the framework by providing support for capturing and storing media data, controlling the type of processing that is performed during playback, and performing custom processing on media data streams. In addition, JMF 2.0 defines a plug-in API that enables advanced developers and technology providers to more easily customize and extend JMF functionality.
The latest implemenation of this API from Sun is JMF 2.1, which added support for Sun Ray and Linux, along with RTP/RTSP upgrades to work with other open-standard video servers.
You can download all of the documentation for this release, including the setup information and sample code, from:
http://java.sun.com/products/java-media/jmf/2.1/documentation.html
JMF 2.1 was developed by Sun Microsystems, Inc. and IBM Corporation.
Here are some quick instructions for installing JMF 2.1. Complete instructions for setting up and running JMF are available from the JMF web site at:
http://java.sun.com/products/java-media/jmf/2.1/setup.html
The install package for Java clients is a zip file. Use a zip utility to extract the files and then set your class path to reference the JMF directory. For example:
On Solaris:
setenv JMFHOME /home/someuser/JMF2.1
setenv CLASSPATH $JMFHOME/lib/jmf.jar:.:${CLASSPATH}:On AIX:
setenv JMFHOME /usr/JMF2.1
setenv CLASSPATH $JMFHOME/lib/jmf.jar:.:${CLASSPATH}:On Windows:
set JMFHOME=C:\JMF2.1
set CLASSPATH=%JMFHOME%\lib\jmf.jar;.;%CLASSPATH%
The Solaris install package contains an exectuable installation program. Run the installation program to extract JMF and then set your class path to reference the JMF directory. For example:
setenv JMFHOME /home/someuser/JMF2.1
setenv CLASSPATH $JMFHOME/lib/jmf.jar:$JMFHOME/lib/sound.jar:.:${CLASSPATH}
You'll also need to set your LD_LIBRARY_PATH (shared libraries path) to point to the JMF libraries. For example:
setenv LD_LIBRARY_PATH $JMFHOME/lib:${LD_LIBRARY_PATH}
The Windows install package package contains an InstallShield installation program. Run the installation program to extract JMF and configure your environment variables.During installation, InstallShield should automatically set up your CLASSPATH and PATH:
set CLASSPATH=%JMFHOME%\lib\jmf.jar;%JMFHOME%\lib\sound.jar;.;%CLASSPATH%
set PATH=%WINDIR%\System32;%PATH% (on Windows NT)
set PATH=%WINDIR%\System;%PATH% (on Windows 95/98)
To verify that JMF is set up properly on your system, use the JMF Diagnostics applet at:
http://java.sun.com/products/java-media/jmf/2.1/jmfdiagnostics.html
This release contains the following directories:
Vendors must follow the terms of the JMF Binary Code License agreement, which includes these terms:
This Solaris and Windows version of the JMF comes with its own installer that simplifies the installation of JMF. Other versions of JMF are bundled in a zip file which needs to be unzipped to be installed.
Vendors have the option of delivering the Solaris, Windows, and/or zip install binaries with their software, and having the user run them separately, or to bundle JMF directly with the install procedures of thier software.
All the files and directories in the lib directory are required unless they are listed under Optional Files below or are removable using the JMF Customizer Tool. Likewise, this readme.html is a required file and must always be included with JMF 2.1.
The following files are optional:
The JMF Binary Code License can be found on the web at:
http://java.sun.com/products/java-media/jmf/2.1/license.html
A copy of the license also appears below.
READ THE TERMS OF THIS
AGREEMENT AND ANY PROVIDED
SUPPLEMENTAL LICENSE TERMS
(COLLECTIVELY "AGREEMENT") CAREFULLY BEFORE OPENING THE SOFTWARE MEDIA
PACKAGE. BY OPENING THE SOFTWARE MEDIA PACKAGE, YOU AGREE TO THE
TERMS OF THIS AGREEMENT. IF YOU ARE ACCESSING THE SOFTWARE
ELECTRONICALLY, INDICATE YOUR ACCEPTANCE OF THESE TERMS BY SELECTING
THE "ACCEPT" BUTTON AT THE END OF THIS AGREEMENT. IF YOU DO NOT AGREE
TO ALL THESE TERMS, PROMPTLY RETURN THE UNUSED SOFTWARE TO YOUR PLACE
OF PURCHASE FOR A REFUND OR, IF THE SOFTWARE IS ACCESSED
ELECTRONICALLY, SELECT THE "DECLINE" BUTTON AT THE END OF THIS
AGREEMENT.
For inquiries please contact: Sun Microsystems, Inc.
These supplemental license terms ("Supplemental Terms") add to or
modify the terms of the Binary Code License Agreement (collectively,
the "Agreement"). Capitalized terms not defined in these Supplemental
Terms shall have the same meanings ascribed to them in the Agreement.
These Supplemental Terms shall supersede any inconsistent or
conflicting terms in the Agreement, or in any license contained within
the Software.
This page was created on 22-Dec-99.
Sun Microsystems, Inc.
Binary Code License Agreement
901 San Antonio Road
Palo Alto, California 94303
JAVATM MEDIA FRAMEWORK VERSION 2.1
SUPPLEMENTAL LICENSE TERMS
Copyright 1995-1999, Sun Microsystems, Inc.
All Rights Reserved