Глава 6.4: Система камер

Введение

DayZ использует многоуровневую систему камер. Камера игрока управляется движком через подклассы DayZPlayerCamera. Для моддинга и отладки доступна FreeDebugCamera, позволяющая свободный полёт. Движок также предоставляет глобальные аксессоры для получения текущего состояния камеры. В этой главе рассматриваются типы камер, способы доступа к данным камеры и использование инструментов скриптовых камер.

Текущее состояние камеры (глобальные аксессоры)

Эти методы доступны из любого места и возвращают состояние активной камеры независимо от её типа:

// Текущая мировая позиция камеры
proto native vector GetGame().GetCurrentCameraPosition();

// Текущее направление камеры (единичный вектор)
proto native vector GetGame().GetCurrentCameraDirection();

// Преобразование мировой позиции в экранные координаты
proto native vector GetGame().GetScreenPos(vector world_pos);
// Возвращает: x = экранный X (пиксели), y = экранный Y (пиксели), z = глубина (расстояние от камеры)

Пример --- проверка, находится ли позиция на экране:

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

    // z < 0 означает, что точка за камерой
    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);
}

Пример --- получение расстояния от камеры до точки:

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

Система DayZPlayerCamera

Камеры игрока в DayZ --- это нативные классы, управляемые контроллером игрока в движке. Они не создаются напрямую из скрипта --- вместо этого движок выбирает подходящую камеру на основе состояния игрока (стоя, лёжа, плавание, транспорт, без сознания и т.д.).

Типы камер (константы DayZPlayerCameras)

Идентификаторы типов камер определены как константы:

Константа	Описание
`DayZPlayerCameras.DAYZCAMERA_1ST`	Камера от первого лица
`DayZPlayerCameras.DAYZCAMERA_3RD_ERC`	Третье лицо стоя
`DayZPlayerCameras.DAYZCAMERA_3RD_CRO`	Третье лицо в приседе
`DayZPlayerCameras.DAYZCAMERA_3RD_PRO`	Третье лицо лёжа
`DayZPlayerCameras.DAYZCAMERA_3RD_ERC_SPR`	Третье лицо в спринте
`DayZPlayerCameras.DAYZCAMERA_3RD_ERC_RAISED`	Третье лицо с поднятым оружием
`DayZPlayerCameras.DAYZCAMERA_3RD_CRO_RAISED`	Третье лицо в приседе с поднятым оружием
`DayZPlayerCameras.DAYZCAMERA_IRONSIGHTS`	Прицеливание через мушку
`DayZPlayerCameras.DAYZCAMERA_OPTICS`	Прицеливание через оптику
`DayZPlayerCameras.DAYZCAMERA_3RD_VEHICLE`	Третье лицо в транспорте
`DayZPlayerCameras.DAYZCAMERA_1ST_VEHICLE`	Первое лицо в транспорте
`DayZPlayerCameras.DAYZCAMERA_1ST_UNCONSCIOUS`	Первое лицо без сознания
`DayZPlayerCameras.DAYZCAMERA_3RD_CLIMB`	Третье лицо при подъёме
`DayZPlayerCameras.DAYZCAMERA_3RD_JUMP`	Третье лицо в прыжке

Получение текущего типа камеры

DayZPlayer player = GetGame().GetPlayer();
if (player)
{
    DayZPlayerCamera cam = player.GetCurrentCamera();
    if (cam && cam.GetCameraName() == "DayZPlayerCamera1stPerson")
    {
        Print("Игрок в режиме от первого лица");
    }
}

FreeDebugCamera

Файл: 3_Game/entities/camera.c

Камера свободного полёта, используемая для отладки и создания кинематографических сцен. Доступна в диагностических сборках или при активации модами.

Доступ к экземпляру

static proto native FreeDebugCamera GetInstance();

Этот статический метод возвращает единственный экземпляр свободной камеры (или null, если он не существует). Вызывайте его как FreeDebugCamera.GetInstance().

Основные методы

// Включение/выключение свободной камеры (унаследовано от Camera)
proto native void SetActive(bool active);
proto native bool IsActive();

// Позиция и ориентация
vector GetPosition();
void   SetPosition(vector pos);
vector GetOrientation();
void   SetOrientation(vector ori);   // рыскание, тангаж, крен

// Направление камеры
vector GetDirection();

Пример --- активация свободной камеры и телепортация:

void ActivateDebugCamera(vector pos)
{
    FreeDebugCamera cam = FreeDebugCamera.GetInstance();
    if (cam)
    {
        cam.SetActive(true);
        cam.SetPosition(pos);
        cam.SetOrientation(Vector(0, -30, 0));  // Смотреть немного вниз
    }
}

Поле зрения (FOV)

Движок управляет FOV нативно. Вы можете читать и изменять его через систему камер игрока:

Чтение FOV

// Получение текущего FOV камеры (в радианах)
float fov = Camera.GetCurrentFOV();

Переопределение FOV в DayZPlayerCamera

В пользовательских классах камер, наследующих DayZPlayerCamera, можно переопределить FOV:

class MyCustomCamera extends DayZPlayerCamera1stPerson
{
    override void OnUpdate(float pDt, out DayZPlayerCameraResult pOutResult)
    {
        super.OnUpdate(pDt, pOutResult);
        pOutResult.m_fFovAbsolute = 0.7854;  // ~45 градусов (в радианах)
    }
}

Глубина резкости (DOF)

Глубина резкости контролируется через систему постобработки (см. Главу 6.5). Однако система камер работает с DOF через следующие механизмы:

Установка DOF через CGame

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

Отключение DOF

GetGame().OverrideDOF(false, 0, 0, 0, 0, 1);  // Первый аргумент false отключает DOF

ScriptCamera (GameLib)

Файл: 2_GameLib/entities/scriptcamera.c

Низкоуровневая скриптовая сущность камеры из слоя GameLib. Это базовый класс для пользовательских реализаций камер.

Создание камеры

ScriptCamera camera = ScriptCamera.Cast(
    GetGame().CreateObject("ScriptCamera", pos, true)  // только локально
);

Основные методы

Примечание: ScriptCamera компилируется только при #ifdef GAME_TEMPLATE и отсутствует в игровой сборке DayZ. Она настраивает себя через методы камеры GenericEntity (SetCameraVerticalFOV, SetCameraNearPlane, SetCameraFarPlane, SetCameraType). Методы ниже относятся к движковому классу Camera (3_Game/entities/camera.c), который наследует FreeDebugCamera:

proto native void SetFOV(float fov);                 // FOV в радианах
proto native void SetNearPlane(float nearPlane);     // внутренне ограничивается до 0.01 м
proto native float GetNearPlane();
proto native void SetFocus(float distance, float blur);  // глубина резкости

Активация камеры

// Сделать эту камеру активной камерой рендеринга
GetGame().SelectPlayer(null, null);   // Отсоединить от игрока
GetGame().ObjectRelease(camera);      // Передать движку

Примечание: Переключение с камеры игрока требует аккуратной обработки ввода и HUD. Большинство модов используют свободную отладочную камеру или эффекты постобработки вместо создания пользовательских камер.

Рейкастинг из камеры

Распространённый паттерн --- выполнение рейкаста из позиции камеры в направлении камеры для определения того, на что смотрит игрок:

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

Итоги

Концепция	Ключевой момент
Глобальные аксессоры	`GetCurrentCameraPosition()`, `GetCurrentCameraDirection()`, `GetScreenPos()`
Типы камер	Константы `DayZPlayerCameras` (1ST, 3RD_ERC, IRONSIGHTS, OPTICS, VEHICLE и т.д.)
Текущий тип	`player.GetCurrentCamera().GetCameraName()`
Свободная камера	`FreeDebugCamera.GetInstance()`, затем `cam.SetActive(true)`
FOV	`Camera.GetCurrentFOV()` для чтения, установка `pOutResult.m_fFovAbsolute` в `OnUpdate`
DOF	`GetGame().OverrideDOF(enable, focusDist, focusLen, focusLenNear, blur, offset)`
Экранные координаты	`GetScreenPos(worldPos)` возвращает пиксельные XY + глубину Z

Лучшие практики

Кэшируйте позицию камеры при множественных запросах в одном кадре. GetGame().GetCurrentCameraPosition() и GetCurrentCameraDirection() --- это вызовы движка. Сохраняйте результат в локальную переменную, если он нужен в нескольких вычислениях в одном кадре.
Используйте проверку глубины GetScreenPos() перед размещением UI. Всегда проверяйте screenPos[2] > 0 (перед камерой) перед отрисовкой HUD-маркеров в мировых позициях, иначе маркеры будут отображаться зеркально за игроком.
Избегайте создания пользовательских экземпляров ScriptCamera для простых эффектов. FreeDebugCamera и система PPE покрывают большинство кинематографических и визуальных потребностей. Пользовательские камеры требуют аккуратного управления вводом/HUD, что легко сломать.
Уважайте переходы типов камер в движке. Не переключайте тип камеры из скрипта принудительно, если вы полностью не обрабатываете состояние контроллера игрока. Неожиданные переключения камеры могут заблокировать движение игрока или вызвать рассинхронизацию.
Защищайте использование свободной камеры проверками администратора/отладки. FreeDebugCamera предоставляет возможность осмотра мира без ограничений. Включайте её только для авторизованных администраторов или диагностических сборок во избежание злоупотреблений.

Совместимость и влияние

Мультимод: Аксессоры камеры --- это глобальные функции только для чтения, поэтому несколько модов могут безопасно читать состояние камеры одновременно. Конфликты возникают только если два мода пытаются активировать FreeDebugCamera или пользовательские экземпляры ScriptCamera.
Производительность: GetScreenPos() и GetCurrentCameraPosition() --- лёгкие вызовы движка. Рейкастинг из камеры (DayZPhysics.RaycastRV) более затратен --- ограничивайте его одним разом за кадр, а не за каждую сущность.
Сервер/Клиент: Состояние камеры существует только на клиенте. Все методы камеры возвращают бессмысленные данные на выделенном сервере. Никогда не используйте запросы камеры в серверной логике.

<< Предыдущая: Погода | Камеры | Следующая: Постобработка >>

Глава 6.4: Система камер ​

Введение ​

Текущее состояние камеры (глобальные аксессоры) ​

Система DayZPlayerCamera ​

Типы камер (константы DayZPlayerCameras) ​

Получение текущего типа камеры ​

FreeDebugCamera ​

Доступ к экземпляру ​

Основные методы ​

Поле зрения (FOV) ​

Чтение FOV ​

Переопределение FOV в DayZPlayerCamera ​

Глубина резкости (DOF) ​

Установка DOF через CGame ​

Отключение DOF ​

ScriptCamera (GameLib) ​

Создание камеры ​

Основные методы ​

Активация камеры ​

Рейкастинг из камеры ​

Итоги ​

Лучшие практики ​

Совместимость и влияние ​

Глава 6.4: Система камер

Введение

Текущее состояние камеры (глобальные аксессоры)

Система DayZPlayerCamera

Типы камер (константы DayZPlayerCameras)

Получение текущего типа камеры

FreeDebugCamera

Доступ к экземпляру

Основные методы

Поле зрения (FOV)

Чтение FOV

Переопределение FOV в DayZPlayerCamera

Глубина резкости (DOF)

Установка DOF через CGame

Отключение DOF

ScriptCamera (GameLib)

Создание камеры

Основные методы

Активация камеры

Рейкастинг из камеры

Итоги

Лучшие практики

Совместимость и влияние