MediaTracker (Платформа Java SE 7)

java.lang. Объект
- java.awt. MediaTracker

Все Реализованные Интерфейсы:

Сериализуемый
```
public class MediaTracker
extends Object
implements Serializable
```
MediaTracker класс является служебным классом, чтобы отследить состояние многих объектов носителей. Объекты носителей могли включать аудиоклипы так же как изображения, хотя в настоящий момент только изображения поддерживаются.
Чтобы использовать средство отслеживания носителей, создайте экземпляр MediaTracker и вызовите addImage метод для каждого изображения, которое будет прослежено. Кроме того, каждое изображение может быть присвоено уникальный идентификатор. Этот идентификатор управляет первоочередным заказом, в котором выбираются изображения. Это может также использоваться, чтобы идентифицировать уникальные подмножества изображений, на которых можно ожидать независимо. Изображения с более низким ID загружаются в предпочтении к тем с более высоким Идентификационным номером.
Отслеживание изображения с анимацией не могло бы всегда быть полезным из-за многослойной природы загрузки изображения с анимацией и рисования, но это поддерживается. MediaTracker обрабатывает изображение с анимацией как полностью загружено, когда первый фрейм полностью загружается. В той точке, MediaTracker сигналы любые официанты, что изображение полностью загружается. Если нет ImageObservers наблюдают изображение, когда первый фрейм закончил загружаться, изображение могло бы сбросить себя, чтобы сохранить ресурсы (см. 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`	`ПРЕРВАННЫЙ` Флаг, указывающий, что загрузка носителей была прервана.
`static int`	`ПОЛНЫЙ` Флаг, указывающий, что загрузка носителей была завершена успешно.
`static int`	`С ОШИБКАМ` Флаг, указывающий, что загрузка носителей, с которыми встречаются ошибка.
`static int`	`ЗАГРУЗКА` Флаг, указывающий, что носители в настоящий момент загружаются.

Сводка конструктора

Конструкторы
Конструктор и Описание
`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)` Проверки, чтобы видеть, закончили ли все изображения, прослеженные этим средством отслеживания носителей, которые тегируются с указанным идентификатором, загружаться.
`Объект[]`	`getErrorsAny()` Возвращает список всех носителей, которые встретились с ошибкой.
`Объект[]`	`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 унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - ЗАГРУЗКА
```
public static final int LOADING
```
    Флаг, указывающий, что носители в настоящий момент загружаются.
    
    См. Также:
    statusAll(boolean), statusID(int, boolean), Постоянные Значения полей
  - ПРЕРВАННЫЙ
```
public static final int ABORTED
```
    Флаг, указывающий, что загрузка носителей была прервана.
    
    См. Также:
    statusAll(boolean), statusID(int, boolean), Постоянные Значения полей
  - С ОШИБКАМ
```
public static final int ERRORED
```
    Флаг, указывающий, что загрузка носителей, с которыми встречаются ошибка.
    
    См. Также:
    statusAll(boolean), statusID(int, boolean), Постоянные Значения полей
  - ПОЛНЫЙ
```
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()
```
    Проверки, чтобы видеть, закончили ли все изображения, прослеживаемые этим средством отслеживания носителей, загружаться.
    Этот метод не начинает загружать изображения, если они уже не загружаются.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте isErrorAny или isErrorID методы, чтобы проверить на ошибки.
    
    Возвраты:
    true если все изображения закончили загружаться, были прерваны, или встретились с ошибкой; false иначе
    См. Также:
    checkAll(boolean), checkID(int), isErrorAny(), isErrorID(int)
  - checkAll
```
public boolean checkAll(boolean load)
```
    Проверки, чтобы видеть, закончили ли все изображения, прослеживаемые этим средством отслеживания носителей, загружаться.
    Если значение load флаг true, тогда этот метод начинает загружать любые изображения, которые еще не загружаются.
    Если есть ошибка, загружаясь или масштабируя изображение, то изображение, как полагают, закончило загружаться. Используйте isErrorAny и isErrorID методы, чтобы проверить на ошибки.
    
    Параметры:
    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
```
    Начинает загружать все изображения, прослеженные этим средством отслеживания носителей. Этот метод ожидает, пока все прослеживаемые изображения не закончили загружаться.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте isErrorAny или isErrorID методы, чтобы проверить на ошибки.
    
    Броски:
    
    InterruptedException - если какой-либо поток прервал этот поток
    См. Также:
    waitForID(int), waitForAll(long), isErrorAny(), isErrorID(int)
  - waitForAll
```
public boolean waitForAll(long ms)
                   throws InterruptedException
```
    Начинает загружать все изображения, прослеженные этим средством отслеживания носителей. Этот метод ожидает, пока все прослеживаемые изображения не закончили загружаться, или до отрезка времени, определенного в миллисекундах ms параметр передал.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте isErrorAny или isErrorID методы, чтобы проверить на ошибки.
    
    Параметры:
    ms - число миллисекунд, чтобы ожидать загрузки, чтобы завершиться
    
    Возвраты:
    true если все изображения были успешно загружены; false иначе
    
    Броски:
    
    InterruptedException - если какой-либо поток прервал этот поток.
    См. Также:
    waitForID(int), waitForAll(long), isErrorAny(), isErrorID(int)
  - statusAll
```
public int statusAll(boolean load)
```
    Вычисляет и возвращает поразрядное содержащее ИЛИ состояния всех носителей, которые прослеживаются этим средством отслеживания носителей.
    Возможные флаги, определенные MediaTracker класс LOADING, ABORTED, ERRORED, и COMPLETE. У изображения, которое не начало загружаться, есть нуль как его состояние.
    Если значение load true, тогда этот метод начинает загружать любые изображения, которые еще не загружаются.
    
    Параметры:
    load - если true, начните загружать любые изображения, которые еще не загружаются
    
    Возвраты:
    поразрядное содержащее ИЛИ состояния всех прослеживаемых носителей
    См. Также:
    statusID(int, boolean), LOADING, ABORTED, ERRORED, COMPLETE
  - checkID
```
public boolean checkID(int id)
```
    Проверки, чтобы видеть, закончили ли все изображения, прослеженные этим средством отслеживания носителей, которые тегируются с указанным идентификатором, загружаться.
    Этот метод не начинает загружать изображения, если они уже не загружаются.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте isErrorAny или isErrorID методы, чтобы проверить на ошибки.
    
    Параметры:
    id - идентификатор изображений, чтобы проверить
    
    Возвраты:
    true если все изображения закончили загружаться, были прерваны, или встретились с ошибкой; false иначе
    См. Также:
    checkID(int, boolean), checkAll(), isErrorAny(), isErrorID(int)
  - checkID
```
public boolean checkID(int id,
              boolean load)
```
    Проверки, чтобы видеть, закончили ли все изображения, прослеженные этим средством отслеживания носителей, которые тегируются с указанным идентификатором, загружаться.
    Если значение load флаг true, тогда этот метод начинает загружать любые изображения, которые еще не загружаются.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте isErrorAny или isErrorID методы, чтобы проверить на ошибки.
    
    Параметры:
    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
```
    Начинает загружать все изображения, прослеженные этим средством отслеживания носителей с указанным идентификатором. Этот метод ожидает, пока все изображения с указанным идентификатором не закончили загружаться.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте isErrorAny и isErrorID методы, чтобы проверить на ошибки.
    
    Параметры:
    id - идентификатор изображений, чтобы проверить
    
    Броски:
    
    InterruptedException - если какой-либо поток прервал этот поток.
    См. Также:
    waitForAll(), isErrorAny(), isErrorID(int)
  - waitForID
```
public boolean waitForID(int id,
                long ms)
                  throws InterruptedException
```
    Начинает загружать все изображения, прослеженные этим средством отслеживания носителей с указанным идентификатором. Этот метод ожидает, пока все изображения с указанным идентификатором не закончили загружаться, или до отрезка времени, определенного в миллисекундах ms параметр передал.
    Если есть ошибка, загружаясь или масштабируя изображение, то то изображение, как полагают, закончило загружаться. Используйте statusID, isErrorID, и isErrorAny методы, чтобы проверить на ошибки.
    
    Параметры:
    id - идентификатор изображений, чтобы проверить
    ms - отрезок времени, в миллисекундах, чтобы ожидать загрузки, чтобы завершиться
    
    Броски:
    
    InterruptedException - если какой-либо поток прервал этот поток.
    См. Также:
    waitForAll(), waitForID(int), statusID(int, boolean), isErrorAny(), isErrorID(int)
  - statusID
```
public int statusID(int id,
           boolean load)
```
    Вычисляет и возвращает поразрядное содержащее ИЛИ состояния всех носителей с указанным идентификатором, которые прослеживаются этим средством отслеживания носителей.
    Возможные флаги, определенные MediaTracker класс LOADING, ABORTED, ERRORED, и COMPLETE. У изображения, которое не начало загружаться, есть нуль как его состояние.
    Если значение 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 отслеживания этого средства отслеживания носителей. Все экземпляры Image быть прослеженным под указанным ID удаляется независимо от масштаба.
    
    Параметры:
    image - изображение, которое будет удалено
    id - ID отслеживания frrom, чтобы удалить изображение
    С тех пор:
    
    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)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс MediaTracker

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

ЗАГРУЗКА

ПРЕРВАННЫЙ

С ОШИБКАМ

ПОЛНЫЙ

Деталь конструктора

MediaTracker

Деталь метода

addImage

addImage

checkAll

checkAll

isErrorAny

getErrorsAny

waitForAll

waitForAll

statusAll

checkID

checkID

isErrorID

getErrorsID

waitForID

waitForID

statusID

removeImage

removeImage

removeImage