Espruino:Справочник по API/Класс Graphics/asImage(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...»)
 
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[ www.espruino.com - ]</ref>=
=Функция Graphics.asImage()<ref>[https://www.espruino.com/Reference#t_l_Graphics_asImage www.espruino.com - function Graphics.asImage]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
function Graphics.asImage(type)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


 
* '''type''' – тип изображения, которое надо вернуть. Чтобы вернуть объект изображения, задайте здесь object/undefined, а чтобы строку изображения – string


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


Изображение, которое затем можно будет использовать в функции [https://www.espruino.com/Reference#l_Graphics_drawImage Graphics.drawImage()].


==Описание==


==Описание==
Возвращает объект Graphics в виде изображения, которое затем можно использовать в Graphics.drawImage(). Более подробно об изображениях читайте в [http://www.espruino.com/Graphics#images-bitmaps этой статье].
Возвращает undefined, если невозможно выделить память под изображение.
 
Сами данные изображения не будут скопированы, и на них будет сделан указатель, если:
*  ...был запрошен объект изображения (не строка)
*  ...объект Graphics был создан с помощью [https://www.espruino.com/Reference#l_Graphics_createArrayBuffer Graphics.createArrayBuffer()]
*  ...в аргументе bpp было задано «8» ИЛИ была задана настройка {msb:true}
*  ...не было задано никаких других настроек (zigzag и пр.)


В противном случае данные будут скопированы, что потребует больше памяти и, возможно, сильно замедлит выполнение функции.


'''Примечание:''' Эта функция не доступна для устройств с маленькой flash-памятью.


== Примеры ==
== Примеры ==

Версия от 19:59, 3 января 2021

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


Функция Graphics.asImage()[1]

Синтаксис

function Graphics.asImage(type)

Параметры

  • type – тип изображения, которое надо вернуть. Чтобы вернуть объект изображения, задайте здесь object/undefined, а чтобы строку изображения – string

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

Изображение, которое затем можно будет использовать в функции Graphics.drawImage().

Описание

Возвращает объект Graphics в виде изображения, которое затем можно использовать в Graphics.drawImage(). Более подробно об изображениях читайте в этой статье. Возвращает undefined, если невозможно выделить память под изображение.

Сами данные изображения не будут скопированы, и на них будет сделан указатель, если:

  • ...был запрошен объект изображения (не строка)
  • ...объект Graphics был создан с помощью Graphics.createArrayBuffer()
  • ...в аргументе bpp было задано «8» ИЛИ была задана настройка {msb:true}
  • ...не было задано никаких других настроек (zigzag и пр.)

В противном случае данные будут скопированы, что потребует больше памяти и, возможно, сильно замедлит выполнение функции.

Примечание: Эта функция не доступна для устройств с маленькой flash-памятью.

Примеры

См.также

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