Класс 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); } } }
- С:
- 1.0
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
ABORTED |
Флаг, указывающий на прерывание загрузки медиа. |
static final int |
COMPLETE |
Флаг, указывающий на успешное завершение загрузки медиа. |
static final int |
ERRORED |
Флаг, указывающий на ошибку при загрузке медиа. |
static final int |
LOADING |
Флаг, указывающий на текущую загрузку медиа. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
MediaTracker |
Создает отслеживатель медиа для отслеживания изображений для данного компонента. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addImage |
Добавляет изображение в список изображений, отслеживаемых этим отслеживателем медиа. |
void |
addImage |
Добавляет масштабируемое изображение в список изображений, отслеживаемых этим отслеживателем медиа. |
boolean |
checkAll() |
Проверяет, загрузились ли все отслеживаемые этим отслеживателем медиа изображения. |
boolean |
checkAll |
Проверяет, загрузились ли все отслеживаемые этим отслеживателем медиа изображения. |
boolean |
checkID |
Проверяет, загрузились ли все изображения, отслеживаемые этим отслеживателем медиа, помеченные указанным идентификатором. |
boolean |
checkID |
Проверяет, загрузились ли все изображения, отслеживаемые этим отслеживателем медиа, помеченные указанным идентификатором. |
Object[] |
getErrorsAny() |
Возвращает список всех медиа, которые столкнулись с ошибкой. |
Object[] |
getErrorsID |
Возвращает список медиа с указанным ID, которые столкнулись с ошибкой. |
boolean |
isErrorAny() |
Проверяет состояние ошибки всех изображений. |
boolean |
isErrorID |
Проверяет состояние ошибки всех изображений, отслеживаемых этим отслеживателем медиа, с указанным идентификатором. |
void |
removeImage |
Удаляет указанное изображение из этого отслеживателя медиа. |
void |
removeImage |
Удаляет указанное изображение из указанного идентификатора отслеживания этого отслеживателя медиа. |
void |
removeImage |
Удаляет указанное изображение с указанной шириной, высотой и ID из этого отслеживателя медиа. |
int |
statusAll |
Вычисляет и возвращает битовую сумму по модулю ИЛИ состояния всех медиа, отслеживаемых этим отслеживателем медиа. |
int |
statusID |
Вычисляет и возвращает битовую сумму по модулю ИЛИ состояния всех медиа с указанным идентификатором, отслеживаемых этим отслеживателем медиа. |
void |
waitForAll() |
Начинает загрузку всех изображений, отслеживаемых этим отслеживателем медиа. |
boolean |
waitForAll |
Начинает загрузку всех изображений, отслеживаемых этим отслеживателем медиа. |
void |
waitForID |
Начинает загрузку всех изображений, отслеживаемых этим отслеживателем медиа, с указанным идентификатором. |
boolean |
waitForID |
Начинает загрузку всех изображений, отслеживаемых этим отслеживателем медиа, с указанным идентификатором. |
Подробное описание полей
LOADING
public static final int LOADING
ABORTED
public static final int ABORTED
ERRORED
public static final int ERRORED
COMPLETE
public static final int COMPLETE
Подробное описание конструкторов
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
public boolean checkAll(boolean load)
Если значение флага load равно true, то этот метод запускает загрузку любых изображений, которые ещё не загружаются.
Если при загрузке или масштабировании изображения произошла ошибка, это изображение считается загруженным. Используйте методы isErrorAny и isErrorID для проверки ошибок.
- Параметры:
-
load- еслиtrue, начать загрузку любых изображений, которые ещё не загружаются - Возвращает:
-
trueесли все изображения загрузились, были прерваны или произошла ошибка;falseв противном случае - См. также:
isErrorAny
public boolean isErrorAny()
- Возвращает:
-
trueесли у любого из отслеживаемых изображений произошла ошибка во время загрузки;falseв противном случае - См. также:
getErrorsAny
public Object[] getErrorsAny()
- Возвращает:
- массив объектов медиа, отслеживаемых этим трекером медиа и у которых произошла ошибка, или
nullесли ошибок нет - См. также:
waitForAll
public void waitForAll() throws InterruptedException
Если при загрузке или масштабировании изображения произошла ошибка, то это изображение считается загруженным. Используйте методы isErrorAny или isErrorID для проверки ошибок.
- Выбрасывает:
-
InterruptedException- если какая-либо нить прервала эту нить - См. также:
waitForAll
public boolean waitForAll(long ms) throws InterruptedException
ms. Если при загрузке или масштабировании изображения произошла ошибка, то это изображение считается загруженным. Используйте методы isErrorAny или isErrorID для проверки ошибок.
- Параметры:
-
ms- количество миллисекунд ожидания завершения загрузки - Возвращает:
-
trueесли все изображения успешно загрузились;falseв противном случае - Выбрасывает:
-
InterruptedException- если какая-либо нить прервала эту нить. - См. также:
statusAll
public int statusAll(boolean load)
Возможные флаги, определённые классом MediaTracker, — это LOADING, ABORTED, ERRORED, и COMPLETE. Статус изображения, которое не начало загружаться, равен нулю.
Если значение load равно true, то этот метод запускает загрузку любых изображений, которые ещё не загружаются.
- Параметры:
-
load- еслиtrue, начать загрузку любых изображений, которые ещё не загружаются - Возвращает:
- побитовое включительно ИЛИ статуса всех отслеживаемых медиа
- См. также:
checkID
public boolean checkID(int id)
Этот метод не начинает загрузку изображений, если они ещё не загружаются.
Если при загрузке или масштабировании изображения возникла ошибка, то это изображение считается загруженным. Используйте методы isErrorAny или isErrorID, чтобы проверить наличие ошибок.
- Parameters:
-
id- идентификатор изображений для проверки - Returns:
-
trueесли все изображения загрузились, были прерваны или столкнулись с ошибкой;falseв противном случае - See Also:
checkID
public boolean checkID(int id, boolean load)
Если значение флага load равно true, то этот метод начинает загрузку любых изображений, которые ещё не загружаются.
Если при загрузке или масштабировании изображения возникла ошибка, то это изображение считается загруженным. Используйте методы isErrorAny или isErrorID для проверки ошибок.
- Parameters:
-
id- идентификатор изображений для проверки -
load- еслиtrue, начать загрузку любых изображений, которые ещё не загружаются - Returns:
-
trueесли все изображения загрузились, были прерваны или столкнулись с ошибкой;falseв противном случае - See Also:
isErrorID
public boolean isErrorID(int id)
- Parameters:
-
id- идентификатор изображений для проверки - Returns:
-
trueесли у любого из изображений с указанным идентификатором произошла ошибка во время загрузки;falseв противном случае - See Also:
getErrorsID
public Object[] getErrorsID(int id)
- Parameters:
-
id- идентификатор изображений для проверки - Returns:
- массив объектов медиа, отслеживаемых этим трекером медиа с указанным идентификатором, у которых произошла ошибка, или
nullесли таких нет - See Also:
waitForID
public void waitForID(int id) throws InterruptedException
Если при загрузке или масштабировании изображения возникла ошибка, то это изображение считается загруженным. Используйте методы isErrorAny и isErrorID для проверки ошибок.
- Parameters:
-
id- идентификатор изображений для проверки - Throws:
-
InterruptedException- если любой поток прервал этот поток. - See Also:
waitForID
public boolean waitForID(int id, long ms) throws InterruptedException
ms. Если при загрузке или масштабировании изображения возникла ошибка, то это изображение считается загруженным. Используйте методы statusID, isErrorID, и isErrorAny для проверки ошибок.
- Parameters:
-
id- идентификатор изображений для проверки -
ms- время ожидания завершения загрузки в миллисекундах - Returns:
-
trueесли загрузка завершилась вовремя; в противном случаеfalse - Throws:
-
InterruptedException- если любой поток прервал этот поток. - See Also:
statusID
public int statusID(int id, boolean load)
Возможные флаги, определенные классом MediaTracker, — LOADING, ABORTED, ERRORED, и COMPLETE. Статус изображения, которое не начало загружаться, равен нулю.
Если значение load равно true, этот метод начинает загрузку любых изображений, которые ещё не загружаются.
- Parameters:
-
id- идентификатор изображений для проверки -
load- еслиtrue, начать загрузку любых изображений, которые ещё не загружаются - Returns:
- побитовое включительно ИЛИ статуса всех медиа с указанным идентификатором, которые отслеживаются
- See Also:
removeImage
public void removeImage(Image image)
- Parameters:
-
image- изображение для удаления - Since:
- 1.1
- See Also:
removeImage
public void removeImage(Image image, int id)
Image , отслеживаемые по указанному ID, удаляются независимо от масштаба.- Parameters:
-
image- изображение для удаления -
id- идентификатор отслеживания, из которого нужно удалить изображение - Since:
- 1.1
- See Also:
removeImage
public void removeImage(Image image, int id, int width, int height)
- Parameters:
-
image- изображение для удаления -
id- идентификатор отслеживания, из которого нужно удалить изображение -
width- ширина для удаления (-1 для не измененного масштаба) -
height- высота для удаления (-1 для не измененного масштаба) - Since:
- 1.1
- See Also:
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/MediaTracker.html