Processing:Справочник языка Processing/requestImage(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 8: Строка 8:
==Обозначение==
==Обозначение==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
requestImage()
requestImage()
</syntaxhighlight>
</syntaxhighlight>
Строка 20: Строка 20:
==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
requestImage(filename)
requestImage(filename)
requestImage(filename, extension)
requestImage(filename, extension)
Строка 27: Строка 27:
==Параметры==
==Параметры==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
filename  – название файла, который нужно загрузить. Он может иметь формат *.gif, *.jpg, *.tga или какой-либо другой (зависит от вашей платформы). Тип данных – String
filename  – название файла, который нужно загрузить. Он может иметь формат *.gif, *.jpg, *.tga или какой-либо другой (зависит от вашей платформы). Тип данных – String
extension – формат загружаемого изображения (к примеру, png, gif или jpg). Тип данных – String
extension – формат загружаемого изображения (к примеру, png, gif или jpg). Тип данных – String
Строка 34: Строка 34:
==Возвращаемое значение==
==Возвращаемое значение==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
Тип данных – объект PImage.
Тип данных – объект PImage.
</syntaxhighlight>
</syntaxhighlight>
Строка 40: Строка 40:
==Пример==
==Пример==


<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
PImage bigImage;
PImage bigImage;
   
   

Версия от 09:22, 23 февраля 2023


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


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

См.также

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