Is Fullscreen Mode Dirty
GameUserSettingsЧто это
Pure-функция класса GameUserSettings. Возвращает true, если настройки полноэкранного режима (FullscreenMode) были изменены, но ещё не применены через ApplySettings. Используется для проверки необходимости сохранения или применения настроек без вызова метода изменения. Не имеет exec-пинов (pure).
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- нет (self — экземпляр
GameUserSettings, передаётся через контекст вызова)
Выходы (данные):
- ReturnValue (bool) —
true, еслиFullscreenModeбыл изменён с момента последнего применения настроек
Когда используется
- Перед вызовом
ApplySettings, чтобы убедиться, что режим экрана действительно требует обновления (позволяет избежать лишних применений). - В логике настроек, где нужно проверить, изменился ли только полноэкранный режим (а не разрешение или VSync) — для выборочного применения.
Типичные проблемы
- Забывают вызвать
ApplySettings– функция вернётtrueдаже после изменения режима, если настройки не были применены. Это не ошибка самой функции, а логическая недоработка. - Путают с
IsDirty()–IsDirty()проверяет общую «грязность» всех настроек, аIsFullscreenModeDirtyтолько полноэкранного режима. Использование не той функции может привести к пропуску нужного обновления. - Проверяют до изменения значения – функция возвращает
false, если режим не менялся. Логика должна сначала установить новыйFullscreenMode, а потом проверять флаг.