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

Содержание

Среда разработки Processing

Справочник языка Processing

Библиотеки

Примеры

Режимы программирования

Перевод: Максим Кузьмин

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

requestImage()

Обозначение

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);
  }
}