love.graphics.newCubeImage

Доступно начиная с LÖVE 11.0
Эта функция не поддерживается в более ранних версиях.

Создаёт новый кубическую карту Изображение.

Эта функция может быть медленной, если вызывается многократно, например, из love.update или love.draw. Если вам нужно часто использовать определённый ресурс, создайте его один раз и сохраните в месте, где он может быть повторно использован!

Изображения кубической карты имеют 6 граней (сторон), которые представляют куб. Их нельзя отображать напрямую, они могут быть использованы только в коде шейдера (и отправлены в шейдер через Shader:send).

Чтобы использовать изображение кубической карты в шейдере, оно должно быть объявлено как CubeImage или samplerCube тип (вместо Image или sampler2D). Функция шейдера Texel(CubeImage image, vec3 direction) должна использоваться для получения цветовых значений пикселей из кубической карты. Аргумент vec3 представляет собой нормализованное направление от центра куба, а не явные текстурные координаты.

Каждая грань на изображении кубической карты должна иметь квадратные размеры.

Для вариантов этой функции, которые принимают одно изображение, содержащее несколько граней кубической карты, они должны быть расположены в одном из следующих форматов в изображении:

   +y
+z +x -z
   -y
   -x

или:

   +y
-x +z +x -z
   -y

или:

+x
-x
+y
-y
+z
-z

или:

+x -x +y -y +z -z

Функция

Создаёт изображение кубической карты на основе одного файла изображения, содержащего несколько граней куба.

Синопсис

image = love.graphics.newCubeImage( filename, settings )

Аргументы

string filename

Путь к файлу изображения кубической карты (или Файл, FileData или ImageData).

table settings (nil)

Необязательная таблица настроек для конфигурации изображения кубической карты, содержащая следующие поля:

boolean mipmaps (false)

Истинно, чтобы изображение использовало mip-уровни, ложно, чтобы отключить их. Mip-уровни будут автоматически сгенерированы, если формат изображения не является сжатой текстурой.

boolean linear (false)

Истинно, чтобы обрабатывать пиксели изображения как линейные, а не sRGB, когда включено гамма-корректное отображение. Большинство изображений создаются в формате sRGB.

Возвращает

Image image

Объект изображения кубической карты.

Функция

Создаёт изображение кубической карты на основе разных файлов изображений для каждой грани куба.

Синопсис

image = love.graphics.newCubeImage( faces, settings )

Аргументы

table faces

Таблица, содержащая 6 путей к файлам изображений (или Файл, FileData, ImageData или CompressedImageData объекты), в массиве. Каждое изображение грани должно иметь одинаковые размеры. Также может быть задана таблица таблиц, где каждая подтаблица содержит все mip-уровни для индекса грани куба в этой подтаблице.

table settings (nil)

Необязательная таблица настроек для конфигурации изображения кубической карты, содержащая следующие поля:

boolean mipmaps (false)

Истинно, чтобы изображение использовало mip-уровни, ложно, чтобы отключить их. Mip-уровни будут автоматически сгенерированы, если формат изображения не является сжатой текстурой формата.

boolean linear (false)

Истинно, чтобы обрабатывать пиксели изображения как линейные, а не sRGB, когда включено гамма-корректное отображение. Большинство изображений создаются в формате sRGB.

Возвращает

Image image

Объект изображения кубической карты.

См. также

• love.graphics
• Изображение
• Тип текстуры