love.graphics.newCanvas

Доступно начиная с LÖVE 0.8.0
Было переименовано из love.graphics.newFramebuffer.

Создаёт новый объект Canvas для рендеринга вне экрана.

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

Функция

Синопсис

canvas = love.graphics.newCanvas( )

Аргументы

Нет.

Возвращает

Canvas canvas

Новый Canvas с размерами, равными размеру окна в пикселях.

Функция

Синопсис

canvas = love.graphics.newCanvas( width, height )

Аргументы

number width

Желаемая ширина Canvas.

number height

Желаемая высота Canvas.

Возвращает

Canvas canvas

Новый Canvas с заданной шириной и высотой.

Функция

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

Создаёт Canvas типа 2D или кубической карты с заданными настройками.

Синопсис

canvas = love.graphics.newCanvas( width, height, settings )

Аргументы

number width

Желаемая ширина Canvas.

number height

Желаемая высота Canvas.

table settings

Таблица, содержащая следующие поля:

TextureType type ("2d")

Тип создаваемого Canvas.

PixelFormat format ("normal")

Формат Canvas.

boolean readable

Является ли Canvas читаемым (рисование и доступ в Shader). По умолчанию true для обычных форматов, false для форматов глубины/маски.

number msaa (0)

Желаемое количество образцов многократного антиалиасинга (MSAA) при отрисовке в Canvas.

number dpiscale (love.graphics.getDPIScale())

Масштаб DPI Canvas, используемый при отрисовке в Canvas и при отрисовке Canvas на экране.

MipmapMode mipmaps ("none")

Имеет ли Canvas mipmap и нужно ли автоматически их перегенерировать, если они есть.

Возвращает

Canvas canvas

Новый Canvas с заданной шириной и высотой.

Примечания

Некоторые форматы Canvas имеют более высокие системные требования, чем по умолчанию. Используйте love.graphics.getCanvasFormats для проверки поддержки.

Функция

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

Создаёт Canvas типа объёмной или массивно-текстурированной текстуры.

Синопсис

canvas = love.graphics.newCanvas( width, height, layers, settings )

Аргументы

number width

Желаемая ширина Canvas.

number height

Желаемая высота Canvas.

number layers

Количество слоёв массива (если Canvas является Array Texture) или глубина объёма (если Canvas является Volume Texture).

table settings

Таблица, содержащая следующие поля:

TextureType type ("array")

Тип создаваемого Canvas.

PixelFormat format ("normal")

Формат Canvas.

boolean readable

Является ли Canvas читаемым (рисование и доступ в Shader). По умолчанию true для обычных форматов, false для форматов глубины/маски.

number msaa (0)

Желаемое количество образцов многократного антиалиасинга (MSAA) при отрисовке в Canvas.

number dpiscale (love.graphics.getDPIScale())

Масштаб DPI Canvas, используемый при отрисовке в Canvas и при отрисовке Canvas на экране.

MipmapMode mipmaps ("none")

Имеет ли Canvas mipmap и нужно ли автоматически их перегенерировать, если они есть.

Возвращает

Canvas canvas

Новый Canvas с заданной шириной и высотой.

Примечания

Не все типы текстур поддерживаются всеми системами. love.graphics.getTextureTypes может проверить поддержку.

Функция

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

Синопсис

canvas = love.graphics.newCanvas( width, height, format )

Аргументы

number width (window_width)

Желаемая ширина Canvas.

number height (window_height)

Желаемая высота Canvas.

CanvasFormat format ("normal")

Желаемый формат текстуры Canvas.

Возвращает

Canvas canvas

Новый Canvas с заданной шириной и высотой.

Примечания

Некоторые форматы Canvas имеют более высокие системные требования, чем по умолчанию. Используйте love.graphics.getCanvasFormats для проверки поддержки.

Функция

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

Синопсис

canvas = love.graphics.newCanvas( width, height, format, msaa )

Аргументы

number width (window_width)

Желаемая ширина Canvas.

number height (window_height)

Желаемая высота Canvas.

CanvasFormat format ("normal")

Желаемый формат текстуры Canvas.

number msaa (0)

Желаемое количество образцов многократного антиалиасинга (MSAA) при отрисовке в Canvas.

Возвращает

Canvas canvas

Новый Canvas с заданной шириной и высотой.

Примечания

• Не все типы текстур поддерживаются всеми системами. love.graphics.getTextureTypes может проверить поддержку.
• Некоторые форматы Canvas имеют более высокие системные требования, чем по умолчанию. Используйте love.graphics.getCanvasFormats для проверки поддержки.
• Максимальное количество поддерживаемых образцов MSAA зависит от системы. Используйте love.graphics.getSystemLimits для проверки.
• Если указанное количество образцов MSAA больше максимального, поддерживаемого системой, Canvas всё равно будет создан, но будет использоваться только максимальное поддерживаемое значение (включая 0.)

См. также

• love.graphics
• Canvas
• love.graphics.setCanvas