JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 MediaTracker

java.lang.Object
  继承者 java.awt.MediaTracker
所有已实现的接口:
Serializable

public class MediaTracker
extends Object
implements Serializable

MediaTracker 类是一个跟踪多种媒体对象状态的实用工具类。媒体对象可以包括音频剪辑和图像,但目前仅支持图像。

要使用媒体跟踪器,需要创建一个 MediaTracker 实例,然后对每个要跟踪的图像调用其 addImage 方法。另外,还可以为每个图像分配一个惟一的标识符。此标识符可控制获取图像的优先级顺序。它还可用于标识可单独等待的惟一图像子集。具有较低 ID 的图像比具有较高 ID 的图像优先加载。

由于动画图像加载和绘制的多部分特性,跟踪动画图像可能不是始终可用的,但这一功能的确受支持。MediaTracker 在完成加载动画图像的第一帧之后就会认为动画图像已经加载完毕。这时,MediaTracker 会向所有等待者发出图像已完全加载的信号。如果在第一帧加载完之后没有 ImageObserver 查看此图像,则该图像可能会自我刷新来保存资源(请参见 Image.flush())。

下面是一个使用 MediaTracker 的示例:


 import java.applet.Applet;
 import java.awt.Color;
 import java.awt.Image;
 import java.awt.Graphics;
 import java.awt.MediaTracker;

 public class ImageBlaster extends Applet implements Runnable {
        MediaTracker tracker;
        Image bg;
        Image anim[] = new Image[5];
        int index;
        Thread animator;

        // Get the images for the background (id == 0) 
        // and the animation frames (id == 1) 
        // and add them to the MediaTracker
        public void init() {
            tracker = new MediaTracker(this);
            bg = getImage(getDocumentBase(), 
                  "images/background.gif");
            tracker.addImage(bg, 0);
            for (int i = 0; i < 5; i++) {
                anim[i] = getImage(getDocumentBase(), 
                      "images/anim"+i+".gif");
                tracker.addImage(anim[i], 1);
            }
        }

        // Start the animation thread.
        public void start() {
            animator = new Thread(this);
            animator.start();
        }

        // Stop the animation thread.
        public void stop() {
            animator = null;
        }

        // Run the animation thread.
        // First wait for the background image to fully load 
        // and paint.  Then wait for all of the animation 
        // frames to finish loading. Finally, loop and 
        // increment the animation frame index.
        public void run() {
            try {
                tracker.waitForID(0);
                tracker.waitForID(1);
            } catch (InterruptedException e) {
                return;
            }
            Thread me = Thread.currentThread();
            while (animator == me) {
                try {
                    Thread.sleep(100);
                } catch (InterruptedException e) {
                    break;
                }
                synchronized (this) {
                    index++;
                    if (index >= anim.length) {
                        index = 0;
                    }
                }
                repaint();
            }
        }

        // The background image fills the frame so we 
        // don't need to clear the applet on repaints. 
        // Just call the paint method.
        public void update(Graphics g) {
            paint(g);
        }

        // Paint a large red rectangle if there are any errors 
        // loading the images.  Otherwise always paint the 
        // background so that it appears incrementally as it 
        // is loading.  Finally, only paint the current animation 
        // frame if all of the frames (id == 1) are done loading,
        // so that we don't get partial animations.
        public void paint(Graphics g) {
            if ((tracker.statusAll(false) & MediaTracker.ERRORED) != 0) {
                g.setColor(Color.red);
                g.fillRect(0, 0, size().width, size().height);
                return;
            }
            g.drawImage(bg, 0, 0, this);
            if (tracker.statusID(1, false) == MediaTracker.COMPLETE) {
                g.drawImage(anim[index], 10, 10, this);
            }
        }
 }
 

从以下版本开始:
JDK1.0
另请参见:
序列化表格

字段摘要
static int ABORTED
          指示媒体下载已中止的标志。
static int COMPLETE
          指示媒体下载已成功完成的标志。
static int ERRORED
          指示媒体下载出错的标志。
static int LOADING
          指示当前正在加载媒体的标志。
 
构造方法摘要
MediaTracker(Component comp)
          创建媒体跟踪器以跟踪给定组件的图像。
 
方法摘要
 void addImage(Image image, int id)
          向此媒体跟踪器正在跟踪的图像列表添加一个图像。
 void addImage(Image image, int id, int w, int h)
          向此媒体跟踪器正在跟踪的图像列表添加一个经过缩放的图像。
 boolean checkAll()
          查看此媒体跟踪器正在跟踪的所有图像是否已完成加载。
 boolean checkAll(boolean load)
          检查此媒体跟踪器正在跟踪的所有图像是否都已完成加载。
 boolean checkID(int id)
          检查由此媒体跟踪器跟踪且使用指定标识符标记的所有图像是否已完成加载。
 boolean checkID(int id, boolean load)
          检查由此媒体跟踪器跟踪且使用指定标识符标记的所有图像是否已完成加载。
 Object[] getErrorsAny()
          返回所有出错媒体的列表。
 Object[] getErrorsID(int id)
          返回具有出错的指定 ID 的媒体列表。
 boolean isErrorAny()
          检查所有图像的错误状态。
 boolean isErrorID(int id)
          检查由此媒体跟踪器跟踪且具有指定标识符的所有图像的错误状态。
 void removeImage(Image image)
          从此媒体跟踪器移除指定的图像。
 void removeImage(Image image, int id)
          从此媒体跟踪器的指定跟踪 ID 中移除指定的图像。
 void removeImage(Image image, int id, int width, int height)
          从此媒体跟踪器移除具有指定宽度、高度和 ID 的指定图像。
 int statusAll(boolean load)
          计算并返回此媒体跟踪器跟踪的所有媒体状态的位逻辑
 int statusID(int id, boolean load)
          计算或返回由此媒体跟踪器跟踪且具有指定标识符的所有媒体状态的位逻辑
 void waitForAll()
          开始加载由此媒体跟踪器跟踪的所有图像。
 boolean waitForAll(long ms)
          开始加载由此媒体跟踪器跟踪的所有图像。
 void waitForID(int id)
          开始加载由此媒体跟踪器跟踪且具有指定标识符的所有图像。
 boolean waitForID(int id, long ms)
          开始加载由此媒体跟踪器跟踪且具有指定标识符的所有图像。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

LOADING

public static final int LOADING
指示当前正在加载媒体的标志。

另请参见:
statusAll(boolean), statusID(int, boolean), 常量字段值

ABORTED

public static final int ABORTED
指示媒体下载已中止的标志。

另请参见:
statusAll(boolean), statusID(int, boolean), 常量字段值

ERRORED

public static final int ERRORED
指示媒体下载出错的标志。

另请参见:
statusAll(boolean), statusID(int, boolean), 常量字段值

COMPLETE

public static final int COMPLETE
指示媒体下载已成功完成的标志。

另请参见:
statusAll(boolean), statusID(int, boolean), 常量字段值
构造方法详细信息

MediaTracker

public MediaTracker(Component comp)
创建媒体跟踪器以跟踪给定组件的图像。

参数:
comp - 最终将在其上绘制图像的组件。
方法详细信息

addImage

public void addImage(Image image,
                     int id)
向此媒体跟踪器正在跟踪的图像列表添加一个图像。该图像最终将以它默认的大小(未缩放)呈现。

参数:
image - 要跟踪的图像
id - 用于跟踪此图像的标识符

addImage

public void addImage(Image image,
                     int id,
                     int w,
                     int h)
向此媒体跟踪器正在跟踪的图像列表添加一个经过缩放的图像。该图像最终将以指示的宽度和高度呈现。

参数:
image - 要跟踪的图像
id - 一个可用于跟踪此图像的标识符
w - 用来呈现图像的宽度
h - 用来呈现图像的高度

checkAll

public boolean checkAll()
查看此媒体跟踪器正在跟踪的所有图像是否已完成加载。

如果图像尚未完成加载,则此方法不能开始加载图像。

如果在加载或缩放图像时出错,则该图像被视为已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

返回:
如果所有图像都已完成加载、发生中止或出错,则返回 true;否则返回 false
另请参见:
checkAll(boolean), checkID(int), isErrorAny(), isErrorID(int)

checkAll

public boolean checkAll(boolean load)
检查此媒体跟踪器正在跟踪的所有图像是否都已完成加载。

如果此 load 标志的值为 true,则此方法将开始加载任何尚未加载的图像。

如果在加载或缩放图像时出错,则该图像被视为已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

参数:
load - 如果为 true,则开始加载任何尚未加载的图像
返回:
如果所有图像都已完成加载、发生中止或出错,则返回 true;否则返回 false
另请参见:
checkID(int), checkAll(), isErrorAny(), isErrorID(int)

isErrorAny

public boolean isErrorAny()
检查所有图像的错误状态。

返回:
如果此媒体跟踪器跟踪的任何图像在加载期间出错,则返回 true;否则返回 false
另请参见:
isErrorID(int), getErrorsAny()

getErrorsAny

public Object[] getErrorsAny()
返回所有出错媒体的列表。

返回:
如果此媒体跟踪器在跟踪媒体对象时出错,则返回一个媒体对象数组;如果不出错,则返回 null
另请参见:
isErrorAny(), getErrorsID(int)

waitForAll

public void waitForAll()
                throws InterruptedException
开始加载由此媒体跟踪器跟踪的所有图像。在完成加载正在跟踪的全部图像之前,此方法一直等待。

如果在加载或缩放图像时出错,则该图像被视为已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

抛出:
InterruptedException - 如果另一个线程中断了此线程。
另请参见:
waitForID(int), waitForAll(long), isErrorAny(), isErrorID(int)

waitForAll

public boolean waitForAll(long ms)
                   throws InterruptedException
开始加载由此媒体跟踪器跟踪的所有图像。在完成加载正在跟踪的所有图像之前,或在 ms 参数以毫秒指定的时间到期之前,此方法将一直等待。

如果在加载或缩放图像时出错,则认为该图像已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

参数:
ms - 等待加载完成的毫秒数
返回:
如果所有图像都成功加载,则返回 true;否则返回 false
抛出:
InterruptedException - 如果另一个线程中断了此线程。
另请参见:
waitForID(int), waitForAll(long), isErrorAny(), isErrorID(int)

statusAll

public int statusAll(boolean load)
计算并返回此媒体跟踪器跟踪的所有媒体状态的位逻辑

MediaTracker 类定义的可能标志有 LOADINGABORTEDERROREDCOMPLETE。尚未开始加载的图像,其状态值为零。

如果 load 值为 true,则此方法开始加载任何尚未加载的图像。

参数:
load - 如果为 true,则开始加载任何尚未加载的图像
返回:
所有正在跟踪媒体状态的位逻辑
另请参见:
statusID(int, boolean), LOADING, ABORTED, ERRORED, COMPLETE

checkID

public boolean checkID(int id)
检查由此媒体跟踪器跟踪且使用指定标识符标记的所有图像是否已完成加载。

如果图像尚未完成加载,则此方法不能开始加载图像。

如果在加载或缩放图像时出错,则认为该图像已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

参数:
id - 要检查的图像标识符
返回:
如果所有图像都已完成加载、发生中止或出错,则返回 true;否则返回 false
另请参见:
checkID(int, boolean), checkAll(), isErrorAny(), isErrorID(int)

checkID

public boolean checkID(int id,
                       boolean load)
检查由此媒体跟踪器跟踪且使用指定标识符标记的所有图像是否已完成加载。

如果此 load 标志的值为 true,则此方法将开始加载任何尚未加载的图像。

如果在加载或缩放图像时出错,则该图像被视为已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

参数:
id - 要检查的图像标识符
load - 如果为 true,则开始加载任何尚未加载的图像。
返回:
如果所有图像都已完成加载、发生中止或出错,则返回 true;否则返回 false
另请参见:
checkID(int, boolean), checkAll(), isErrorAny(), isErrorID(int)

isErrorID

public boolean isErrorID(int id)
检查由此媒体跟踪器跟踪且具有指定标识符的所有图像的错误状态。

参数:
id - 要检查图像的标识符
返回:
如果具有指定标识符的任何图像在加载期间出错。则返回 true;否则返回 false
另请参见:
isErrorAny(), getErrorsID(int)

getErrorsID

public Object[] getErrorsID(int id)
返回具有出错的指定 ID 的媒体列表。

参数:
id - 要检查图像的标识符
返回:
如果指定的标识符出错,则返回此媒体跟踪器所跟踪媒体对象的数组;如果没有出错,则返回 null
另请参见:
isErrorID(int), isErrorAny(), getErrorsAny()

waitForID

public void waitForID(int id)
               throws InterruptedException
开始加载由此媒体跟踪器跟踪且具有指定标识符的所有图像。在完成加载具有指定标识符的全部图像之前,此方法一直等待。

如果在加载或缩放图像时出错,则该图像被视为已完成加载。使用 isErrorAnyisErrorID 方法检查错误。

参数:
id - 要检查图像的标识符
抛出:
InterruptedException - 如果另一个线程中止了此线程。
另请参见:
waitForAll(), isErrorAny(), isErrorID(int)

waitForID

public boolean waitForID(int id,
                         long ms)
                  throws InterruptedException
开始加载由此媒体跟踪器跟踪且具有指定标识符的所有图像。在完成加载具有指定标识符的全部图像之前,或在 ms 参数以毫秒指定的时间到期之前,此方法一直等待。

如果在加载或缩放图像时出错,则该图像被视为已完成加载。使用 statusIDisErrorIDisErrorAny 方法检查错误。

参数:
id - 要检查图像的标识符
ms - 等待加载完成的时间长度(毫秒)
抛出:
InterruptedException - 如果另一个线程中断了此线程。
另请参见:
waitForAll(), waitForID(int), statusID(int, boolean), isErrorAny(), isErrorID(int)

statusID

public int statusID(int id,
                    boolean load)
计算或返回由此媒体跟踪器跟踪且具有指定标识符的所有媒体状态的位逻辑

MediaTracker 类定义的可能标志有 LOADINGABORTEDERROREDCOMPLETE。尚未开始加载的图像,其状态值为零。

如果 load 值为 true,则此方法开始加载任何尚未加载的图像。

参数:
id - 要检查图像的标识符
load - 如果为 true,则开始加载任何尚未加载的图像
返回:
正在跟踪且具有指定标识符的所有媒体状态的位逻辑
另请参见:
statusAll(boolean), LOADING, ABORTED, ERRORED, COMPLETE

removeImage

public void removeImage(Image image)
从此媒体跟踪器移除指定的图像。不管缩放比例和 ID 如何,所有指定图像的实例都将被移除

参数:
image - 要移除的图像
从以下版本开始:
JDK1.1
另请参见:
removeImage(java.awt.Image, int), removeImage(java.awt.Image, int, int, int)

removeImage

public void removeImage(Image image,
                        int id)
从此媒体跟踪器的指定跟踪 ID 中移除指定的图像。不管缩放比例如何,指定 ID 下的所有正在跟踪的 Image 实例都将被移除。

参数:
image - 要移除的图像
id - 从其移除图像的跟踪 ID
从以下版本开始:
JDK1.1
另请参见:
removeImage(java.awt.Image), removeImage(java.awt.Image, int, int, int)

removeImage

public void removeImage(Image image,
                        int id,
                        int width,
                        int height)
从此媒体跟踪器移除具有指定宽度、高度和 ID 的指定图像。仅移除指定的实例(以及任何重复实例)。

参数:
image - 要移除的图像
id - 从其移除图像的跟踪 ID
width - 要移除的宽度(-1 为未缩放)
height - 要移除的高度(-1 为未缩放)
从以下版本开始:
JDK1.1
另请参见:
removeImage(java.awt.Image), removeImage(java.awt.Image, int)

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策