Chapter 6.4: Camera System

Home | << Previous: Weather | Cameras | Next: Post-Process Effects >>

---

Introdução

DayZ usa um sistema de câmeras em múltiplas camadas. A câmera do jogador e gerenciada pela engine através de subclasses de DayZPlayerCamera. Para modding e depuração, a FreeDebugCamera permite voo livre. A engine também fornece acessores globais para o estado atual da câmera. Este capítulo cobre os tipos de câmera, como acessar dados da câmera e como usar as ferramentas de câmera scriptadas.

---

Estado Atual da Câmera (Acessores Globais)

Estes métodos estão disponíveis em qualquer lugar e retornam o estado da câmera ativa independentemente do tipo de câmera:

// Posição mundial atual da câmera
proto native vector GetGame().GetCurrentCameraPosition();

// Direção frontal atual da câmera (vetor unitário)
proto native vector GetGame().GetCurrentCameraDirection();

// Converter posição mundial para coordenadas de tela
proto native vector GetGame().GetScreenPos(vector world_pos);
// Retorna: x = X da tela (pixels), y = Y da tela (pixels), z = profundidade (distância da câmera)

Exemplo --- verificar se uma posição está na tela:

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

    // z < 0 significa atrás da câmera
    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);
}

Exemplo --- obter distância da câmera até um ponto:

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

---

Sistema DayZPlayerCamera

As câmeras de jogador do DayZ são classes nativas gerenciadas pelo controlador de jogador da engine. Elas não são instanciadas diretamente do script --- ao invés disso, a engine seleciona a câmera apropriada baseada no estado do jogador (em pé, deitado, nadando, veículo, inconsciente, etc.).

Tipos de Câmera (Constantes DayZPlayerCameras)

Os IDs dos tipos de câmera são definidos como constantes:

Constante	Descrição
DayZPlayerCameras.DAYZCAMERA_1ST	Câmera em primeira pessoa
DayZPlayerCameras.DAYZCAMERA_3RD_ERC	Terceira pessoa em pé
DayZPlayerCameras.DAYZCAMERA_3RD_CRO	Terceira pessoa agachado
DayZPlayerCameras.DAYZCAMERA_3RD_PRO	Terceira pessoa deitado
DayZPlayerCameras.DAYZCAMERA_3RD_ERC_SPR	Terceira pessoa correndo
DayZPlayerCameras.DAYZCAMERA_3RD_ERC_RAISED	Terceira pessoa arma levantada
DayZPlayerCameras.DAYZCAMERA_3RD_CRO_RAISED	Terceira pessoa agachado arma levantada
DayZPlayerCameras.DAYZCAMERA_IRONSIGHTS	Mira de ferro
DayZPlayerCameras.DAYZCAMERA_OPTICS	Mira com luneta/scope
DayZPlayerCameras.DAYZCAMERA_3RD_VEHICLE	Terceira pessoa veículo
DayZPlayerCameras.DAYZCAMERA_1ST_VEHICLE	Primeira pessoa veículo
DayZPlayerCameras.DAYZCAMERA_3RD_SWIM	Terceira pessoa nadando
DayZPlayerCameras.DAYZCAMERA_3RD_UNCONSCIOUS	Terceira pessoa inconsciente
DayZPlayerCameras.DAYZCAMERA_1ST_UNCONSCIOUS	Primeira pessoa inconsciente
DayZPlayerCameras.DAYZCAMERA_3RD_CLIMB	Terceira pessoa escalando
DayZPlayerCameras.DAYZCAMERA_3RD_JUMP	Terceira pessoa pulando

Obtendo o Tipo de Câmera Atual

DayZPlayer player = GetGame().GetPlayer();
if (player)
{
    int cameraType = player.GetCurrentCameraType();
    if (cameraType == DayZPlayerCameras.DAYZCAMERA_1ST)
    {
        Print("Player is in first person");
    }
}

---

FreeDebugCamera

Arquivo: 5_Mission/gui/scriptconsole/freedebugcamera.c

A câmera de voo livre usada para depuração e trabalho cinematográfico. Disponível em builds diagnósticas ou quando habilitada por mods.

Acessando a Instância

FreeDebugCamera GetFreeDebugCamera();

Esta função global retorna a instância singleton da câmera livre (ou null se não existir).

Métodos Principais

// Habilitar/desabilitar a câmera livre
static void SetActive(bool active);
static bool GetActive();

// Posição e orientação
vector GetPosition();
void   SetPosition(vector pos);
vector GetOrientation();
void   SetOrientation(vector ori);   // yaw, pitch, roll

// Velocidade
void SetFlySpeed(float speed);
float GetFlySpeed();

// Direção da câmera
vector GetDirection();

Exemplo --- ativar câmera livre e teleportá-la:

void ActivateDebugCamera(vector pos)
{
    FreeDebugCamera.SetActive(true);

    FreeDebugCamera cam = GetFreeDebugCamera();
    if (cam)
    {
        cam.SetPosition(pos);
        cam.SetOrientation(Vector(0, -30, 0));  // Olhar levemente para baixo
        cam.SetFlySpeed(10.0);
    }
}

---

Campo de Visão (FOV)

A engine controla o FOV nativamente. Você pode ler e modificá-lo através do sistema de câmera do jogador:

Lendo o FOV

// Obter FOV atual da câmera
float fov = GetDayZGame().GetFieldOfView();

Sobrescrita de FOV em DayZPlayerCamera

Em classes de câmera personalizadas que estendem DayZPlayerCamera, você pode sobrescrever o FOV:

class MyCustomCamera extends DayZPlayerCamera1stPerson
{
    override float GetCurrentFOV()
    {
        return 0.7854;  // ~45 graus (radianos)
    }
}

---

Profundidade de Campo (DOF)

A profundidade de campo e controlada pelo sistema de Efeitos Pós-Processamento (veja o Capítulo 6.5). No entanto, o sistema de câmera funciona com DOF através destes mecanismos:

Definindo DOF via World

World world = GetGame().GetWorld();
if (world)
{
    // SetDOF(focus_distance, focus_length, focus_length_near, blur, focus_depth_offset)
    // Todos os valores em metros
    world.SetDOF(5.0, 100.0, 0.5, 0.3, 0.0);
}

Desabilitando DOF

World world = GetGame().GetWorld();
if (world)
{
    world.SetDOF(0, 0, 0, 0, 0);  // Todos zeros desabilita DOF
}

---

ScriptCamera (GameLib)

Arquivo: 2_GameLib/entities/scriptcamera.c

Uma entidade de câmera scriptada de nível mais baixo da camada GameLib. Esta é a base para implementações de câmera personalizadas.

Criando uma Câmera

ScriptCamera camera = ScriptCamera.Cast(
    GetGame().CreateObject("ScriptCamera", pos, true)  // apenas local
);

Métodos Principais

proto native void SetFOV(float fov);          // FOV em radianos
proto native void SetNearPlane(float nearPlane);
proto native void SetFarPlane(float farPlane);
proto native void SetFocus(float dist, float len);

Ativando uma Câmera

// Tornar esta câmera a câmera de renderização ativa
GetGame().SelectPlayer(null, null);   // Desanexar do jogador
GetGame().ObjectRelease(camera);      // Liberar para a engine

Nota: Trocar para longe da câmera do jogador requer cuidado no tratamento de input e HUD. A maioria dos mods usa a câmera de debug livre ou efeitos de overlay PPE ao invés de criar câmeras personalizadas.

---

Raycasting a partir da Câmera

Um padrão comum e fazer raycast da posição da câmera na direção da câmera para encontrar o que o jogador está olhando:

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;
}

---

Resumo

Conceito	Ponto-chave
Acessores globais	GetCurrentCameraPosition(), GetCurrentCameraDirection(), GetScreenPos()
Tipos de câmera	Constantes DayZPlayerCameras (1ST, 3RD_ERC, IRONSIGHTS, OPTICS, VEHICLE, etc.)
Tipo atual	player.GetCurrentCameraType()
Câmera livre	FreeDebugCamera.SetActive(true), depois GetFreeDebugCamera()
FOV	GetDayZGame().GetFieldOfView() para ler, sobrescrever GetCurrentFOV() na classe de câmera
DOF	GetGame().GetWorld().SetDOF(focus, length, near, blur, offset)
Conversão de tela	GetScreenPos(worldPos) retorna pixel XY + profundidade Z

---

<< Anterior: Clima | Câmeras | Próximo: Efeitos Pós-Processamento >>