love.window.updateMode

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

Устанавливает режим и свойства отображения окна, без изменения не указанных свойств.

Если ширина или высота равны 0, updateMode будет использовать ширину и высоту рабочего стола.

Изменение режима отображения может иметь побочные эффекты: например, холсты будут очищены. Убедитесь, что вы сохранили содержимое холстов заранее или перерисовали их после, если вам это нужно.

Функция

Синопсис

success = love.window.updateMode( width, height, settings )

Аргументы

number width

Ширина окна.

number height

Высота окна.

table settings

Таблица настроек со следующими необязательными полями. Любое поле, которое не заполнено, будет использовать текущее значение, которое вернёт love.window.getMode.

boolean fullscreen

Полный экран (true), или окно (false).

FullscreenType fullscreentype

Тип полноэкранного режима.

boolean vsync

True, если LÖVE должен ожидать vsync, иначе false.

number msaa

Количество выборок антиалиасинга.

boolean resizable

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

boolean borderless

True, если окно должно быть без рамок в оконном режиме, иначе false.

boolean centered

True, если окно должно быть центрировано в оконном режиме, иначе false.

number display

Индекс монитора, на котором должно отображаться окно, если доступно несколько мониторов.

number minwidth

Минимальная ширина окна, если оно изменяемо по размеру. Не может быть меньше 1.

number minheight

Минимальная высота окна, если оно изменяемо по размеру. Не может быть меньше 1.

boolean highdpi

True, если режим высокой четкости должен использоваться на Retina-дисплеях в macOS и iOS. Не делает ничего на не-Retina-дисплеях.

number x

Координата x позиции окна на указанном дисплее.

number y

Координата y позиции окна на указанном дисплее.

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

boolean success

True, если успешно, иначе false.

Примечания

• Если включён полноэкранный режим, и ширина или высота не поддерживаются (см. love.window.getFullscreenModes), размер окна может быть изменён на ближайшее доступное разрешение, и будет сгенерировано событие resize.

• Если тип полноэкранного режима — «рабочий стол», то окно будет автоматически изменён на разрешение рабочего стола.

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

• Прозрачные фоны в настоящее время не поддерживаются.

См. также

• love.window
• love.window.setMode
• love.window.getMode
• love.window.getFullscreenModes
• love.resize