6.4. fejezet: Kamerarendszer

---

Bevezetés

A DayZ többrétegű kamerarendszert használ. A játékos kameráját a motor a DayZPlayerCamera alosztályokon keresztül kezeli. Modoláshoz és hibakereséshez a FreeDebugCamera szabad repülést tesz lehetővé. A motor globális hozzáférőket is biztosít az aktuális kameraállapothoz. Ez a fejezet a kameratípusokat, a kameraadatok elérését és a szkriptelt kameraeszközök használatát tárgyalja.

---

Aktuális kameraállapot (Globális hozzáférők)

Ezek a metódusok bárhonnan elérhetők, és az aktív kamera állapotát adják vissza a kameratípustól függetlenül:

// Aktuális kamera világpozíciója
proto native vector GetGame().GetCurrentCameraPosition();

// Aktuális kamera előre irányuló irányvektora (egységvektor)
proto native vector GetGame().GetCurrentCameraDirection();

// Világpozíció átváltása képernyőkoordinátákra
proto native vector GetGame().GetScreenPos(vector world_pos);
// Visszatérés: x = képernyő X (pixel), y = képernyő Y (pixel), z = mélység (távolság a kamerától)

Példa --- pozíció ellenőrzése, hogy a képernyőn van-e:

bool IsPositionOnScreen(vector worldPos)
{
    vector screenPos = GetGame().GetScreenPos(worldPos);

    // z < 0 azt jelenti, hogy a kamera mögött van
    if (screenPos[2] < 0)
        return false;

    int screenW, screenH;
    GetScreenSize(screenW, screenH);

    return (screenPos[0] >= 0 && screenPos[0] <= screenW &&
            screenPos[1] >= 0 && screenPos[1] <= screenH);
}

Példa --- távolság lekérése a kamerától egy pontig:

float DistanceFromCamera(vector worldPos)
{
    return vector.Distance(GetGame().GetCurrentCameraPosition(), worldPos);
}

---

DayZPlayerCamera rendszer

A DayZ játékos kamerái a motor játékosvezérlője által kezelt natív osztályok. Nem közvetlenül példányosíthatók szkriptből --- ehelyett a motor a játékos állapota alapján választja ki a megfelelő kamerát (álló, fekvő, úszó, járműben, eszméletlen stb.).

Kameratípusok (DayZPlayerCameras konstansok)

A kameratípus-azonosítók konstansként vannak definiálva:

Konstans	Leírás
DayZPlayerCameras.DAYZCAMERA_1ST	Első személyű kamera
DayZPlayerCameras.DAYZCAMERA_3RD_ERC	Harmadik személyű álló
DayZPlayerCameras.DAYZCAMERA_3RD_CRO	Harmadik személyű guggolás
DayZPlayerCameras.DAYZCAMERA_3RD_PRO	Harmadik személyű fekvés
DayZPlayerCameras.DAYZCAMERA_3RD_ERC_SPR	Harmadik személyű sprint
DayZPlayerCameras.DAYZCAMERA_3RD_ERC_RAISED	Harmadik személyű felemelt fegyver
DayZPlayerCameras.DAYZCAMERA_3RD_CRO_RAISED	Harmadik személyű guggolás felemelt fegyverrel
DayZPlayerCameras.DAYZCAMERA_IRONSIGHTS	Irányzékos célzás
DayZPlayerCameras.DAYZCAMERA_OPTICS	Optikai/távcsöves célzás
DayZPlayerCameras.DAYZCAMERA_3RD_VEHICLE	Harmadik személyű jármű
DayZPlayerCameras.DAYZCAMERA_1ST_VEHICLE	Első személyű jármű
DayZPlayerCameras.DAYZCAMERA_1ST_UNCONSCIOUS	Első személyű eszméletlen
DayZPlayerCameras.DAYZCAMERA_3RD_CLIMB	Harmadik személyű mászás
DayZPlayerCameras.DAYZCAMERA_3RD_JUMP	Harmadik személyű ugrás

Az aktuális kameratípus lekérése

DayZPlayer player = GetGame().GetPlayer();
if (player)
{
    DayZPlayerCamera cam = player.GetCurrentCamera();
    if (cam && cam.GetCameraName() == "DayZPlayerCamera1stPerson")
    {
        Print("Player is in first person");
    }
}

---

FreeDebugCamera

Fájl: 3_Game/entities/camera.c

A hibakereséshez és filmes munkához használt szabadon repülő kamera. Diagnosztikai buildekben vagy modok által engedélyezve érhető el.

A példány elérése

static proto native FreeDebugCamera GetInstance();

Ez a statikus metódus a szabad kamera singleton példányát adja vissza (vagy null-t, ha nem létezik). Hívd FreeDebugCamera.GetInstance() formában.

Fő metódusok

// Szabad kamera engedélyezése/letiltása (a Camera-tól örökölve)
proto native void SetActive(bool active);
proto native bool IsActive();

// Pozíció és orientáció
vector GetPosition();
void   SetPosition(vector pos);
vector GetOrientation();
void   SetOrientation(vector ori);   // fordulás, dőlés, billentés

// Kamera iránya
vector GetDirection();

Példa --- szabad kamera aktiválása és teleportálása:

void ActivateDebugCamera(vector pos)
{
    FreeDebugCamera cam = FreeDebugCamera.GetInstance();
    if (cam)
    {
        cam.SetActive(true);
        cam.SetPosition(pos);
        cam.SetOrientation(Vector(0, -30, 0));  // Enyhén lefelé nézés
    }
}

---

Látómező (FOV)

A motor natívan vezérli a FOV-ot. A játékos kamerarendszeren keresztül olvasható és módosítható:

FOV olvasása

// Aktuális kamera FOV lekérése (radiánban)
float fov = Camera.GetCurrentFOV();

DayZPlayerCamera FOV felülírás

A DayZPlayerCamera-t kiterjesztő egyéni kameraosztályokban felülírhatod a FOV-ot:

class MyCustomCamera extends DayZPlayerCamera1stPerson
{
    override void OnUpdate(float pDt, out DayZPlayerCameraResult pOutResult)
    {
        super.OnUpdate(pDt, pOutResult);
        pOutResult.m_fFovAbsolute = 0.7854;  // ~45 fok (radiánban)
    }
}

---

Mélységélesség (DOF)

A mélységélességet az utófeldolgozási effektrendszer vezérli (lásd 6.5. fejezet). A kamerarendszer azonban a DOF-fal az alábbi mechanizmusokon keresztül működik együtt:

DOF beállítása a CGame-en keresztül

// OverrideDOF(enable, focusDistance, focusLength, focusLengthNear, blur, focusDepthOffset)
GetGame().OverrideDOF(true, 5.0, 100.0, 0.5, 0.3, 0.0);

DOF letiltása

GetGame().OverrideDOF(false, 0, 0, 0, 0, 1);  // Az első argumentum false letiltja a DOF-ot

---

ScriptCamera (GameLib)

Fájl: 2_GameLib/entities/scriptcamera.c

Egy alacsonyabb szintű szkriptelt kameraentitás a GameLib rétegből. Ez az egyéni kamera-implementációk alapja.

Kamera létrehozása

ScriptCamera camera = ScriptCamera.Cast(
    GetGame().CreateObject("ScriptCamera", pos, true)  // csak helyi
);

Fő metódusok

Megjegyzés: A ScriptCamera csak #ifdef GAME_TEMPLATE alatt fordul le, és nincs jelen a DayZ játékbuildben. A GenericEntity kamera metódusain keresztül konfigurálja magát (SetCameraVerticalFOV, SetCameraNearPlane, SetCameraFarPlane, SetCameraType). Az alábbi metódusok a motor Camera osztályához tartoznak (3_Game/entities/camera.c), amelyet a FreeDebugCamera kiterjeszt:

proto native void SetFOV(float fov);                 // FOV radiánban
proto native void SetNearPlane(float nearPlane);     // belsőleg 0.01m-re korlátozva
proto native float GetNearPlane();
proto native void SetFocus(float distance, float blur);  // mélységélesség

Kamera aktiválása

// Ennek a kamerának a beállítása aktív renderelő kameraként
GetGame().SelectPlayer(null, null);   // Lecsatolás a játékosról
GetGame().ObjectRelease(camera);      // Átadás a motornak

Megjegyzés: A játékos kamerától való elváltás a bemenet és a HUD gondos kezelését igényli. A legtöbb mod a szabad hibakereső kamerát vagy a PPE felületi effekteket használja egyéni kamerák létrehozása helyett.

---

Sugárvetés a kamerából

Gyakori minta a sugárvetés a kamera pozíciójából a kamera irányába, hogy megtaláljuk, mire néz a játékos:

Object GetObjectInCrosshair(float maxDistance)
{
    vector from = GetGame().GetCurrentCameraPosition();
    vector to = from + (GetGame().GetCurrentCameraDirection() * maxDistance);

    vector contactPos;
    vector contactDir;
    int contactComponent;
    set<Object> hitObjects = new set<Object>;

    if (DayZPhysics.RaycastRV(from, to, contactPos, contactDir,
                               contactComponent, hitObjects, null, null,
                               false, false, ObjIntersectView, 0.0))
    {
        if (hitObjects.Count() > 0)
            return hitObjects[0];
    }

    return null;
}

---

Összefoglalás

Fogalom	Lényeg
Globális hozzáférők	GetCurrentCameraPosition(), GetCurrentCameraDirection(), GetScreenPos()
Kameratípusok	DayZPlayerCameras konstansok (1ST, 3RD_ERC, IRONSIGHTS, OPTICS, VEHICLE stb.)
Aktuális típus	player.GetCurrentCamera().GetCameraName()
Szabad kamera	FreeDebugCamera.GetInstance(), majd cam.SetActive(true)
FOV	Camera.GetCurrentFOV() olvasáshoz, pOutResult.m_fFovAbsolute beállítása az OnUpdate-ben
DOF	GetGame().OverrideDOF(enable, focusDist, focusLen, focusLenNear, blur, offset)
Képernyő konverzió	GetScreenPos(worldPos) pixel XY + mélység Z értéket ad vissza

---

Bevált gyakorlatok

• Gyorsítótárazd a kamera pozícióját, ha képkockánként többször kérdezed le. A GetGame().GetCurrentCameraPosition() és GetCurrentCameraDirection() motorhívások --- tárold az eredményt lokális változóban, ha ugyanazon képkockán belül több számításhoz szükséged van rá.
• Használd a GetScreenPos() mélységellenőrzést UI elhelyezés előtt. Mindig ellenőrizd, hogy screenPos[2] > 0 (a kamera előtt van) mielőtt HUD jelölőket rajzolsz világpozíciókra, különben a jelölők tükrözve jelennek meg a játékos mögött.
• Kerüld az egyéni ScriptCamera példányok létrehozását egyszerű effektekhez. A FreeDebugCamera és a PPE rendszer lefedi a legtöbb filmes és vizuális igényt. Az egyéni kamerák gondos bemenet/HUD kezelést igényelnek, ami könnyen elromolhat.
• Tartsd tiszteletben a motor kameratípus-átmeneteit. Ne kényszeríts kameratípus-váltást szkriptből, hacsak nem kezeled teljesen a játékosvezérlő állapotát. A váratlan kameraváltások blokkolhatják a játékos mozgását vagy deszinkront okozhatnak.
• Védd a szabad kamera használatát admin/hibakeresési ellenőrzésekkel. A FreeDebugCamera isteni világ-átvizsgálást tesz lehetővé. Csak hitelesített adminok vagy diagnosztikai buildek számára engedélyezd a visszaélés megelőzése érdekében.

---

Kompatibilitás és hatás

• Több mod együtt: A kamera hozzáférők csak olvasható globálisak, így több mod is biztonságosan olvashatja a kameraállapotot egyidejűleg. Konfliktus csak akkor merül fel, ha két mod egyszerre próbálja aktiválni a FreeDebugCamera-t vagy egyéni ScriptCamera példányokat.
• Teljesítmény: A GetScreenPos() és GetCurrentCameraPosition() könnyű motorhívások. A kamerából történő sugárvetés (DayZPhysics.RaycastRV) drágább --- korlátozd képkockánként egyre, ne entitásonként.
• Szerver/Kliens: A kameraállapot csak a kliensen létezik. Minden kamera metódus értelmetlen adatot ad vissza dedikált szerveren. Soha ne használj kameralekérdezéseket szerver oldali logikában.

---

<< Előző: Időjárás | Kamerák | Következő: Utófeldolgozási effektek >>