graphics_presets_util¶

Quelle: base/tealdef/gui/menu/graphics_presets_util.d.tl

Hinweise

Grafikvorgaben für PC und Konsole sowie Hilfsfunktionen, die eine Vorgabe in einer AppConfig erkennen oder dort einstellen.

GraphicsPresetsUtil¶

record global base/tealdef/gui/menu/graphics_presets_util.d.tl:3

global record GraphicsPresetsUtil

Laden: local graphics_presets_util = ug_require "::/gui/menu/graphics_presets_util.tl" as GraphicsPresetsUtil

Hinweise

Util-Tabelle von graphics_presets_util.tl.

Funktionen

getGraphicPreset(presets : {{string : {any, any}}}, config : AppConfig) : integer base/tealdef/gui/menu/graphics_presets_util.d.tl:4

Aufruf: graphics_presets_util.getGraphicPreset(…)

Hinweise

Gibt den Index der ersten Vorgabe zurück, deren Werte alle mit der übergebenen Konfiguration übereinstimmen.

Parameter	Typ	Beschreibung
`presets`	`{{string : {any, any}}}`	Vorgabenliste, z. B. aus `getDesktopPresets()` oder `getConsolePresets()`.
`config`	`AppConfig`	Konfiguration zum Vergleichen, meist `api.util.getAppConfig()`.

Rückgabe integer: Index der passenden Vorgabe oder #presets + 1 („benutzerdefiniert“), wenn keine passt. Zahlen werden mit einer Toleranz von 0,001 verglichen.

Im Basisspiel verwendet: 4-mal in 1 Datei

base/content/gui/gui/menu/settings_page.tl:801

local graphicPreset = graphics_presets_util.getGraphicPreset(desktopPresetSettings, appConfig)

setGraphicPreset(presets : {{string : {any, any}}}, config : AppConfig, option : integer, inGame : boolean) base/tealdef/gui/menu/graphics_presets_util.d.tl:5

Aufruf: graphics_presets_util.setGraphicPreset(…)

Hinweise

Schreibt die Werte einer Vorgabe in ein AppConfig-Objekt.

Parameter	Typ	Beschreibung
`presets`	`{{string : {any, any}}}`	Vorgabenliste, z. B. aus `getDesktopPresets()` oder `getConsolePresets()`.
`config`	`AppConfig`	Zu ändernde Konfiguration, z. B. `api.type.AppConfig.new(api.util.getAppConfig())`. Anwenden musst du sie danach noch mit `api.util.setAppConfig`.
`option`	`integer`	Index der Vorgabe. `#presets + 1` (benutzerdefiniert) bewirkt nichts.
`inGame`	`boolean`	Bei true werden Einträge übersprungen, deren zweites Element true ist.

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/gui/gui/menu/settings_page.tl:920

graphics_presets_util.setGraphicPreset(desktopPresetSettings, config, graphicsPresets, inGame)

getDesktopPresets() : {{string : {any, any}}} base/tealdef/gui/menu/graphics_presets_util.d.tl:7

Aufruf: graphics_presets_util.getDesktopPresets(…)

Hinweise

Gibt die vier PC-Vorgaben zurück, in der Reihenfolge niedrig, mittel, hoch, sehr hoch.

Rückgabe {{string : {any, any}}}: Vorgabenliste mit textureQuality, terrainTextureQuality, numMSAASamples, useSsao, ssrQuality, shadowQuality, geometryQuality, terrainQuality und grassQuality.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/menu/settings_page.tl:800

local desktopPresetSettings = graphics_presets_util.getDesktopPresets()

getConsolePresets() : {{string : {any, any}}} base/tealdef/gui/menu/graphics_presets_util.d.tl:8

Aufruf: graphics_presets_util.getConsolePresets(…)

Hinweise

Gibt die zwei Konsolenvorgaben zurück, Qualität (30 Hz) und Leistung (60 Hz), zusammengeführt mit den Grundeinstellungen der Konsolengeneration, die api.util.getPlaformDeviceSpec() meldet.

Rückgabe {{string : {any, any}}}: Vorgabenliste. Neben den Qualitätseinstellungen setzt sie auch refreshRate, resolutionScale, terrainTesselationQuality und useReflection.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/menu/settings_page.tl:1035

local consolePresetsSettings = graphics_presets_util.getConsolePresets()

getInitialGraphicsPresetDesktop(param : GraphicsPresetParam, appConfig : AppConfig) base/tealdef/gui/menu/graphics_presets_util.d.tl:10

Aufruf: graphics_presets_util.getInitialGraphicsPresetDesktop(…)

Hinweise

Schreibt die erste PC-Vorgabe in appConfig. Mit dedizierter Grafikkarte entscheidet vram, ab 7000 mittel, ab 11000 hoch, ab 15000 sehr hoch (darunter niedrig). Ohne dedizierte Grafikkarte gilt niedrig.

Parameter	Typ	Beschreibung
`param`	`GraphicsPresetParam`	Hardwaredaten aus `api.util.getGraphicsPresetParam()`.
`appConfig`	`AppConfig`	Zu ändernde Konfiguration, z. B. `api.type.AppConfig.new(api.util.getAppConfig())`. Anwenden musst du sie danach noch mit `api.util.setAppConfig`.

Details

Setzt außerdem resolutionScale nach der Bildschirmhöhe screenExtent[2]: 0,75 ab 2160 Pixeln, 0,8 ab 1800, 0,85 ab 1600, 0,9 ab 1440, sonst 1,0.

Das Hauptmenü ruft die Funktion beim Ereignis setInitialGraphicsPreset auf und wendet die Konfiguration dann an. Der Grafik-Tab der Einstellungen nutzt sie für „Auf Standard zurücksetzen“. Ist api.util.isConsoleMode() wahr, nehmen beide stattdessen getInitialGraphicsPresetConsole.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/menu/settings_page.tl:1545

graphics_presets_util.getInitialGraphicsPresetDesktop(api.util.getGraphicsPresetParam(), copy)

getInitialGraphicsPresetConsole(appConfig : AppConfig) base/tealdef/gui/menu/graphics_presets_util.d.tl:11

Aufruf: graphics_presets_util.getInitialGraphicsPresetConsole(…)

Hinweise

Schreibt die Konsolenvorgabe Qualität (den ersten Eintrag von getConsolePresets()) in appConfig, samt den Grundeinstellungen der Konsolengeneration.

Parameter	Typ	Beschreibung
`appConfig`	`AppConfig`	Zu ändernde Konfiguration. Anwenden musst du sie danach noch mit `api.util.setAppConfig`.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/menu/settings_page.tl:1543

graphics_presets_util.getInitialGraphicsPresetConsole(copy)