Processing:Справочник языка Processing/requestImage()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


requestImage() [1]

Обозначение

requestImage()

Описание

Загружает изображение в отдельный поток, благодаря чему ваш скетч не зависает при загрузке изображений во время работы блока setup(). Пока изображение загружается, его ширина и высота будут «0». Если во время загрузки изображения выскочит ошибка, его ширина и высота будут иметь значения «-1». Вы поймете, когда изображение загрузится – в этот момент его ширина и высота будут иметь значение выше «0». Асинхронная загрузка изображений (особенно при загрузке с сервера) может значительно улучшить производительность скетча.

Второй параметр метода requestImage() – это extension. Он используется, чтобы задать тип изображения, когда у имени графического файла нет корректного расширения.

Синтаксис

requestImage(filename)
requestImage(filename, extension)

Параметры

filename   название файла, который нужно загрузить. Он может иметь формат *.gif, *.jpg, *.tga или какой-либо другой (зависит от вашей платформы). Тип данных  String
extension  формат загружаемого изображения (к примеру, png, gif или jpg). Тип данных  String

Возвращаемое значение

Тип данных  объект PImage.

Пример

PImage bigImage;
 
void setup() {
  bigImage = requestImage("something.jpg");
}
 
void draw() {
  if (bigImage.width == 0) {
    // изображение еще не загрузилось:
  } else if (bigImage.width == -1) {
    // это значит, что в процессе загрузки произошла ошибка:
  } else {
    // изображение готово, загружаем его:
    image(bigImage, 0, 0);
  }
}

См.также

Внешние ссылки