Config Files (Magyar)

Bevezetés

Ha egy conf.lua nevű fájl jelen van a játék mappájában (vagy a .love fájlban), az a LÖVE modulok lefutása elött betöltődik. Ezt arra használhatja, hogy a love.conf funkciót felülírja, amit később a LÖVE 'boot' szkript hív meg. A love.conf funkcióval módosíthat egypár konfigurációs beállítást, mint például az alapértelmezett ablakméretet, hogy mely modulok töltődjenek be, és egyebeket.

love.conf

A love.conf funkció egy paramétert kér: egy tábla az összes alapértékkel, amiket tetszés szerint felülírhat. Például ha az alapértelmezett ablakméretet szeretné megváltoztatni, akkor:

function love.conf(t)
    t.window.width = 1024 -- t.screen.width a 0.8.0 és korábbi verziókban
    t.window.height = 768 -- t.screen.height a 0.8.0 és korábbi verziókban
end

Ha nincs szüksége a fizika modulra vagy a joystick modulra, akkor:

function love.conf(t)
    t.modules.joystick = false
    t.modules.physics = false
end

Javasolt a nem használt modulokat hamisra állítani a játékok kiadásánál, mert valamennyire felgyorsítja a betöltési időt (főleg ha a joystick modul van kikapcsolva) és a memóriahasználatot is (enyhén) csökkenti.

Itt a teljes lista a LÖVE 0.9.x verzióban levő opciókról és az alapértelmezett értékeikről:

function love.conf(t)
    t.identity = nil                   -- A mentés-mappa neve (string)
    t.version = "0.9.0"                -- Az a LÖVE verzió, amihez eme játékot készítették(string)
    t.console = false                  -- Konzolablak hozzácsatolása (boolean, csak Windows-on)
 
    t.window.title = "Untitled"        -- Az ablak címe (string)
    t.window.icon = nil                -- Elérési út egy képhez, ami az ablak ikonja lesz (string)
    t.window.width = 800               -- Az ablak szélessége (number)
    t.window.height = 600              -- Az ablak magassága (number)
    t.window.borderless = false        -- Az ablakkeret eltávolítása (boolean)
    t.window.resizable = false         -- Az ablak átméretezhető-e (boolean)
    t.window.minwidth = 1              -- Minimum ablakszélesség ha átméretezhető (number)
    t.window.minheight = 1             -- Minimum ablakmagasság ha átméretezhető (number)
    t.window.fullscreen = false        -- Teljes képernyős mód engedélyezése (boolean)
    t.window.fullscreentype = "normal" -- Általános vagy asztali teljes képernyős mód (string)
    t.window.vsync = true              -- Függőleges képszinkron engedélyezése (boolean)
    t.window.fsaa = 0                  -- A többmintás élsimításnál (MSAA) használt minták száma (number)
    t.window.display = 1               -- A monitor sorszáma, amin az ablak megjelenik (number)
    t.window.highdpi = false           -- Magas pont-per-hüvelyk mód engedélyezése az ablaknak Retina kijelzőkön. (boolean). 0.9.1-től
    t.window.srgb = false              -- sRGB gamma korrekció engedélyezése képernyőre rajzolásnál (boolean). 0.9.1-től
 
    t.modules.audio = true             -- Az audio modul engedélyezése (boolean)
    t.modules.event = true             -- Az esemény(kezelő) modul engedélyezése (boolean)
    t.modules.graphics = true          -- A grafika modul engedélyezése (boolean)
    t.modules.image = true             -- A kép modul engedélyezése (boolean)
    t.modules.joystick = true          -- A joystick modul engedélyezése (boolean)
    t.modules.keyboard = true          -- A billentyűzet modul engedélyezése (boolean)
    t.modules.math = true              -- A matematika modul engedélyezése (boolean)
    t.modules.mouse = true             -- Az egér modul engedélyezése (boolean)
    t.modules.physics = true           -- A fizika modul engedélyezése (boolean)
    t.modules.sound = true             -- A hang modul engedélyezése (boolean)
    t.modules.system = true            -- A rendszer modul engedélyezése (boolean)
    t.modules.timer = true             -- Az időzítő modul engedélyezése (boolean)
    t.modules.window = true            -- Az ablak modul engedélyezése (boolean)
end

Megfigyelhető, hogy a love.filesystem modult nem lehet letiltani; ez kötelező. Ugyanez vonatkozik magára a love modulra is. A love.graphicsnak szüksége van a love.windowra, hogy engedélyezni lehessen.

highdpi

Available since LÖVE 0.9.1
This flag is not supported in earlier versions.

Lásd: love.window.getPixelScale. Ajánlott eme opció tiltása, ha nem tudja tesztelni a játékát egy Mac rendszeren, amihez lenne egy Retina kijelző, mert a kódját módosítania kell, hogy minden biztosan helyesen nézzen ki.

srgb

Available since LÖVE 0.9.1
This flag is not supported in earlier versions.

Ennek az engedélyezésével minden a főképernyőre kirajzolt dolog színe át lesz konvertálva a lineáris RGB színtérből az sRGB színtérbe - az ablak felülete gamma-teres sRGB-ként lesz kezelve. Ez csak egy komponense a gamma-korrekt megjelenítésnek, ami egy haladó téma amit könnyen el lehet rontani, így javasolt, hogy eme opciót hagyjuk tiltva, ha nem lennénk tisztában az implikációival.

Window

Available since LÖVE 0.9.0
These flags are not supported in earlier versions.

Lehetséges az ablak készítés elhalasztása egészen a kódban levő első love.window.setMode parancsig. Ehhez a love.conf-ban be kell állítani a következőt: t.window = nil (vagy t.screen = nil régebbi verziókban.) Ha ez megvan, LÖVE lefagyhat, ha bármely love.graphics-beni funkció meg lenne hívva az első love.window.setMode parancsig a kódjában.

A t.window tábla t.screen néven volt jelen a 0.9.0-nál korábbi verziókban. A t.screen tábla nem létezik a 0.9.0-ás love.conf-ban, és a t.window tábla nem létezik a 0.8.0-ás love.conf-ban. Ez azt jelenti, hogy love.conf nem fog lefutni (ezáltal alapértékekre fog visszaállni) ha nem figyelünk oda, hogy a használt LÖVE verzióhoz a korrekt táblát használjuk-e vagy sem.

A következő kód lehetővé teszi a kompatibilitást a 0.9.0 és korábbi verziók közt.

function love.conf(t)
    t.window = t.window or t.screen
 
    -- Itt állítsa be az ablak/képernyő flag-eket.
    t.window.width = 1024
    t.window.height = 768
 
    t.screen = t.screen or t.window
end

Version

Available since LÖVE 0.8.0
This flag is not supported in earlier versions.

A t.version egy string, ami azt a LÖVE verziószámot tartalmazza, amihez a játéka írva volt. "X.Y.Z" formátumban kellene megadni, ahol X a major (fő) kiadási szám, Y a minor, és Z a patch szám. Ez lehetővé teszi, hogy a LÖVE kiírjon egy figyelmeztetést, ha a játék nem lenne kompatibilis. Az alapértelmezett értéke a futó LÖVE verziója.


Régebbi verziók

Itt a teljes lista a LÖVE 0.8.0 verzióban levő opciókról és az alapértelmezett értékeikről:

function love.conf(t)
    t.title = "Untitled"        -- Az ablak címe (string)
    t.author = "Unnamed"        -- A játék készítője (string)
    t.url = nil                 -- A játék weboldala (string)
    t.identity = nil            -- A mentés-mappa neve (string)
    t.version = "0.8.0"         -- Az a LÖVE verzió, amihez eme játékot készítették(string)
    t.console = false           -- Konzolablak hozzácsatolása (boolean, csak Windows-on)
    t.release = false           -- Kiadási mód engedélyezése (boolean)
    t.screen.width = 800        -- Az ablak szélessége (number)
    t.screen.height = 600       -- Az ablak magassága (number)
    t.screen.fullscreen = false -- Teljes képernyős mód engedélyezése (boolean)
    t.screen.vsync = true       -- Függőleges képszinkron engedélyezése (boolean)
    t.screen.fsaa = 0           -- Az FSAA-pufferek száma (number)
    t.modules.joystick = true   -- A joystick modul engedélyezése (boolean)
    t.modules.audio = true      -- Az audio modul engedélyezése (boolean)
    t.modules.keyboard = true   -- A billentyűzet modul engedélyezése (boolean)
    t.modules.event = true      -- Az esemény(kezelő) modul engedélyezése (boolean)
    t.modules.image = true      -- A kép modul engedélyezése (boolean)
    t.modules.graphics = true   -- A grafika modul engedélyezése (boolean)
    t.modules.timer = true      -- Az időzítő modul engedélyezése (boolean)
    t.modules.mouse = true      -- Az egér modul engedélyezése (boolean)
    t.modules.sound = true      -- A hang modul engedélyezése (boolean)
    t.modules.physics = true    -- A fizika modul engedélyezése (boolean)
end

Release Mode

Hozzáadva a 0.8.0-ban, és eltávolítva a 0.9.0-ban.

Ha a t.release engedélyezve van, LÖVE a kiadási hibakezelőt fogja használni (love.releaseerrhand), ami alapból gyér az információval, és természetesen felülírható.

Az alap kiadási hibakezelő a játékosnak kiad egy üzenetet is, ami felszólítja őket, hogy lépjenek kapcsolatba a készítővel, felhasználva a title, author és url mezőket, ahogy azok meg voltak adva a conf.lua-ban.

Ha egy összeolvasztott játék kiadási módban van futtatva, nem a love mentési mappába fog írni, hanem egy sajátba; habár korábban ez a mappa az %APPDATA%\\LOVE\\játék volt Windowson, most már %APPDATA%\\játék. Ez a koncepció igaz a többi platformra is.


Itt a teljes lista a LÖVE 0.7.2 és korábbi verzióban levő opciókról és az alapértelmezett értékeikről:

function love.conf(t)
    t.title = "Untitled"        -- Az ablak címe (string)
    t.author = "Unnamed"        -- A játék készítője (string)
    t.identity = nil            -- A mentés-mappa neve (string)
    t.version = 0               -- Az a LÖVE verzió, amihez eme játékot készítették(string)
    t.console = false           -- Konzolablak hozzácsatolása (boolean, csak Windows-on)
    t.screen.width = 800        -- Az ablak szélessége (number)
    t.screen.height = 600       -- Az ablak magassága (number)
    t.screen.fullscreen = false -- Teljes képernyős mód engedélyezése (boolean)
    t.screen.vsync = true       -- Függőleges képszinkron engedélyezése (boolean)
    t.screen.fsaa = 0           -- Az FSAA-pufferek száma (number)
    t.modules.joystick = true   -- A joystick modul engedélyezése (boolean)
    t.modules.audio = true      -- Az audio modul engedélyezése (boolean)
    t.modules.keyboard = true   -- A billentyűzet modul engedélyezése (boolean)
    t.modules.event = true      -- Az esemény(kezelő) modul engedélyezése (boolean)
    t.modules.image = true      -- A kép modul engedélyezése (boolean)
    t.modules.graphics = true   -- A grafika modul engedélyezése (boolean)
    t.modules.timer = true      -- Az időzítő modul engedélyezése (boolean)
    t.modules.mouse = true      -- Az egér modul engedélyezése (boolean)
    t.modules.sound = true      -- A hang modul engedélyezése (boolean)
    t.modules.physics = true    -- A fizika modul engedélyezése (boolean)
end

Lásd még

Más nyelvek