Cat hungry.png
Здравствуйте! Собираем деньги на перевод материалов по электронике(https://www.allaboutcircuits.com/education/). Реквизиты указаны здесь.

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

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


Перевод: Максим Кузьмин (Cubewriter)
Перевел 2686 статей для сайта.

Контакты:

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


Ambox content.png Черновик


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.

Пример

  1. PImage bigImage;
  2.  
  3. void setup() {
  4.   bigImage = requestImage("something.jpg");
  5. }
  6.  
  7. void draw() {
  8.   if (bigImage.width == 0) {
  9.     // изображение еще не загрузилось:
  10.   } else if (bigImage.width == -1) {
  11.     // это значит, что в процессе загрузки произошла ошибка:
  12.   } else {
  13.     // изображение готово, загружаем его:
  14.     image(bigImage, 0, 0);
  15.   }
  16. }

См.также

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

  1. processing.org - requestImage()