Текстура:setMipmapFilter

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

Устанавливает режим фильтрации mipmap для текстуры. До версии 11.0 этот метод работал только с Изображениями.

Mipmapping полезен при отрисовке текстуры в уменьшенном масштабе. Это может улучшить производительность и уменьшить проблемы с алиасингом.

В версии 0.10.0 и более поздних, текстура должна быть создана с включённым флагом mipmaps для того, чтобы фильтр mipmap имел какой-либо эффект. В версиях до 0.10.0 лучше всего вызвать этот метод сразу после создания изображения с помощью love.graphics.newImage, чтобы избежать ошибок в определённых графических драйверах.

Из-за ограничений аппаратного обеспечения и ошибок драйверов, в версиях до 0.10.0 изображения, которые не загружались из CompressedData, должны иметь размеры, являющиеся степенью двойки (64x64, 512x256 и т. д.), чтобы использовать mipmaps.

Функция

Синопсис

Texture:setMipmapFilter( filtermode, sharpness )

Аргументы

FilterMode filtermode

Режим фильтрации, используемый между уровнями mipmap. "nearest" часто обеспечивает лучшую производительность.

number sharpness (0)

Положительное значение sharpness заставляет текстуру использовать более детализированный уровень mipmap при отрисовке, ценой производительности. Отрицательное значение делает обратное.

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

Ничего.

Примечания

На мобильных устройствах (Android и iOS) параметр sharpness не поддерживается и не будет иметь никакого эффекта. Вместо этого можно использовать пользовательский Shader и указать резкость mipmap в необязательном третьем параметре функции Texel в шейдере (отрицательное значение заставляет текстуру использовать более детализированный уровень mipmap).

В версиях до 0.10.0 вызов этой функции автоматически создаёт mipmaps для Image, если они ещё не существуют. Если изображение сжато, и его CompressedData содержит данные mipmap, оно будет использовано.

Функция

Отключает фильтрацию mipmap.

Синопсис

Texture:setMipmapFilter( )

Аргументы

Нет.

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

Ничего.

См. также

• Текстура
• Текстура:getMipmapFilter
• love.graphics.newImage
• love.graphics.newCanvas
• РежимMipmap