Files

T

sanspie 60b3ed5bc0 editor: refine art workspace and update documentation

2026-11-09 14:25:23 +03:00

19 KiB

Raw Permalink Blame History

id, title, group, group_title

id	title	group	group_title
camera	Камеры 2D	camera	Камеры 2D

Камеры 2D

«Камера 2D» рисует вид, а виртуальные камеры решают, куда она смотрит. Каждая «Виртуальная камера 2D» — возможная поза. Видом управляет включённая камера с наибольшим приоритетом, а переключение между камерами идёт плавным переходом. Слежение, тряска и зоны — компоненты на виртуальных камерах; скрипты их запускают.

Быстрый старт: Создать → Следящая камера даёт узел с «Камерой 2D», «Виртуальной камерой 2D» и «Слежением камеры 2D». Укажите игрока в поле «Цель» и нажмите Играть.

Компонент	Назначение
Виртуальная камера 2D	поза с приоритетом, масштабом, границами и переходом
Слежение камеры 2D	ведёт свою виртуальную камеру за целью
Тряска камеры 2D	настраивает тряску своей виртуальной камеры
Зона камеры 2D	поднимает камеру, пока цель внутри области
Выбор выхода камеры 2D	заставляет «Камеру 2D» показывать другой выход

Камеры работают во время игры и в aego run. В режиме редактирования панель «Сцена» показывает рамку камеры, мёртвую зону, границы и зоны.

id: camera/virtual title: Виртуальные камеры

Виртуальные камеры

Каждый кадр мозг выбирает по одной виртуальной камере на выход:

Включённая виртуальная камера с наибольшим Приоритетом. При равных приоритетах выбирается камера, созданная раньше.
«Зона камеры 2D», внутри которой находится цель, поднимает свою камеру до приоритета зоны. При равенстве зона побеждает обычную камеру, а зона, в которую вошли позже, — более раннюю.
camera.BlendTo и camera.Cut перекрывают всё до вызова camera.Release.

Поза берётся из узла виртуальной камеры: его интерполированная позиция и поворот, а также Масштаб; 0 оставляет масштаб «Камеры 2D». «Слежение камеры 2D» на том же узле заменяет позицию. Трансформация узла никогда не меняется; камера двигает только вид.

В «Попробовать» скрипт Director по очереди поднимает Close и Tilt, каждую на две секунды, и вид плавно переходит к ним и обратно. Измените у Close «Масштаб», «Время перехода» или «Кривую перехода» в Инспекторе и посмотрите на следующий переход; скрипт лежит под сценой.

Переходы

Когда активной становится другая камера, вид переходит от позы, которую показывает сейчас, к новой камере за её Время перехода по Кривой перехода. Переключение во время перехода начинается от текущего вида, а не от старой камеры. Масштаб меняется на экране равномерно. «Время перехода» 0 переключает сразу.

Границы

«Использовать границы» держит видимую область внутри Границ — прямоугольника в мире. Если по какой-то оси область меньше вида, вид центрируется на ней по этой оси.

id: camera/outputs title: Выходы

Выходы

Виртуальные камеры управляют главным выходом, если их Выход не называет другой. «Камера 2D» показывает главный выход; добавьте «Выбор выхода камеры 2D» с тем же выходом, чтобы она показывала другой, например мини-карту. У каждого выхода своя активная камера, свои переходы и своя тряска. «Камера 2D», у выхода которой нет виртуальных камер, остаётся как есть.

В «Попробовать» мини-карта в углу — вторая «Камера 2D» с маленькой «Областью вывода» и «Выбором выхода камеры 2D» с выходом map; её собственная виртуальная камера следит за мячом издалека.

id: camera/follow title: Слежение

Слежение

«Слежение камеры 2D» ведёт свою виртуальную камеру за Целью.

Внутри Мёртвой зоны — части вида — цель движется свободно; (0.4, 0.4, 0.2, 0.2) — пятая часть в центре. Снаружи камера догоняет цель со скоростью, которую задаёт Демпфирование; при 0 камера следует жёстко.

Упреждение сдвигает камеру вперёд движущейся цели на столько секунд её скорости. Макс. упреждение ограничивает этот сдвиг, а Сглаживание упреждения — скорость его изменения. Когда цель прыгает дальше Расстояния скачка, например после телепорта, камера перемещается сразу.

Все поля с единицами измерения перечислены на странице «Слежение камеры 2D».

Камера следует за интерполированной позой физического тела, поэтому движется плавно при любой частоте кадров. Демпфирование экспоненциальное: камера при 30, 60 и 144 кадрах в секунду приходит в одно и то же место. Когда цель телепортируется, вызовите Snap() у компонента или положитесь на «Расстояние скачка».

В «Попробовать» мяч катится по длинному склону. Поставьте «Демпфирование» в 0 для жёсткой камеры или расширьте «Мёртвую зону», чтобы мяч убегал вперёд.

id: camera/zones title: Зоны

Зоны

«Зона камеры 2D» меняет камеру, пока цель находится внутри её Области — прямоугольника в пространстве узла зоны. Внутри Камера получает Приоритет, Масштаб и Границы зоны; снаружи всё возвращается как было. Поля самой камеры никогда не меняются.

Пустая «Камера» берёт виртуальную камеру на узле зоны; дайте ей низкий приоритет, чтобы она показывалась только через зону.
Пустая «Цель» берёт цель слежения камеры зоны.
Зоны используют точную позицию цели, а не интерполированную, поэтому один и тот же ввод всегда входит в зону на одном и том же кадре.
Перекрывающиеся зоны: побеждает больший приоритет, затем зона, в которую вошли позже. Выход из одной зоны не влияет на другие.

В «Попробовать» фиолетовая область посреди склона — это зона: пока мяч катится через неё, вид переходит к более близкому неподвижному кадру, а после — обратно к следящей камере.

id: camera/shake title: Тряска

Тряска

В «Попробовать» ящик падает каждые две секунды, и при приземлении его скрипт вызывает camera.Shake(0.9). Увеличьте «Макс. угол» или уменьшите «Степень» и «Затухание» у камеры, чтобы почувствовать разницу.

Тряской управляет травма — значение от 0 до 1 на каждый выход. camera.Shake(0.4) добавляет травму, а она убывает на Затухание в секунду. Вид сдвигается не больше чем на Макс. смещение и поворачивается не больше чем на Макс. угол, с множителем «травма в Степени», поэтому слабые удары остаются едва заметными. Если на активной камере нет «Тряски камеры 2D», берутся значения по умолчанию.

Движение берётся из детерминированного шума, поэтому повтор трясётся так же. Тряска никогда не трогает трансформацию узла и случайные числа игры.

Травма складывается и убывает в реальном времени. При «Затухании» по умолчанию 1,5 удар силой 0,6 проходит за 0,4 секунды:

package demo

import (
    "aego/camera"
    "aego/log"
)

script Hits {
    var frames int

    func Ready() {
        camera.Shake(0.6)
        log.Info("hit, trauma " + string(camera.Trauma()))
    }

    func Update(dt float) {
        frames++
        if frames % 6 == 0 && frames <= 30 {
            log.Info("trauma " + string(camera.Trauma()))
        }
        if frames == 30 {
            camera.Shake(0.5)
            camera.Shake(0.8)
            log.Info("two hits, capped at " + string(camera.Trauma()))
        }
    }
}

Доступность

Настройки → Доступность → Тряска экрана масштабирует любую тряску; 0 выключает её. «Меньше движения» выключает тряску и убирает упреждение. Травма по-прежнему убывает, поэтому геймплей, который читает camera.Trauma(), не затронут.

id: camera/time title: Время и повторы

Время и повторы

«Шкала времени» решает, как переходы и тряска активной камеры считают время. unscaled, значение по умолчанию, использует реальное время: стоп-кадр при ударе с масштабом времени 0 не замораживает камеру. game следует за масштабом времени и паузой.

Слежение всегда использует игровое время: когда игра на паузе или идёт по шагам, неподвижная цель держит камеру неподвижной.

Перемотка и повтор сохраняют активную камеру, перекрытия, зоны и всё, что идёт в игровом времени. После перехода к другому моменту переход в реальном времени сразу завершается, а тряска в реальном времени сохраняет свою травму.

id: camera/scripting title: Скрипты

Скрипты

import "aego/camera"

func OnCollisionEnter(other NodeRef, c physics.Contact) {
  if c.Normal.Y < -0.5 && c.NormalImpulse > 8 {
    camera.Shake(0.35)
  }
}

func Boss() coroutine {
  yield camera.BlendTo(BossCam, 1.5)
  yield waitSeconds(3)
  camera.Release(0)
}

Функция
`Active() NodeRef`, `ActiveOn(output) NodeRef`	виртуальная камера, которая управляет выходом
`BlendTo(camera, seconds) Blend`	сделать камеру активной поверх приоритетов и плавно перейти к ней; 0 берёт её «Время перехода»
`Cut(camera)`	то же без перехода
`Release(seconds) Blend`	вернуть главный выход приоритетам
`Shake(trauma)`, `ShakeOn(output, trauma)`	добавить травму
`Trauma() float`	травма главного выхода
`LogicalPose() Pose`	поза без тряски и привязки к пикселям
`RenderPose() Pose`	поза, с которой нарисован главный выход
`ScreenToWorld(p)`, `WorldToScreen(p)`	пересчёт по последнему нарисованному виду, в пикселях выхода

У Blend есть Done(), Running(), Stop() и сигнал Completed(finished bool); yield ждёт его. Методы компонентов: VirtualCamera2D.IsActive(), CameraFollow2D.Snap() и CameraShake2D.Add(trauma).

Каждый выход хранит свою травму:

package demo

import (
    "aego/camera"
    "aego/log"
)

script Outputs {
    func Ready() {
        camera.Shake(0.3)
        camera.ShakeOn("map", 0.9)
        log.Info("main " + string(camera.Trauma()))
        log.Info("active camera is nil: " + string(camera.Active() == nil))
    }
}

id: camera/editor title: Инструменты редактора

Инструменты редактора

Редактор рисует рамки камер, мёртвые зоны и зоны, а во время игры показывает состояние активной камеры.

Маркеры и рамки

Выберите виртуальную камеру, чтобы перетаскивать её границы, или зону, чтобы перетаскивать её область. Следящая камера показывает свою рамку, мёртвую зону и линию к цели. Каждое перетаскивание — один шаг отмены.
Камера → Рамки камер включает и выключает рамки на панели «Сцена». Во время игры панель «Игра» тоже рисует мёртвую зону активной камеры, её границы и зоны.

Инспектор во время игры

Виртуальная камера показывает, активна ли она, свой приоритет, ход перехода и травму. Смотреть через камеру переносит панель «Сцена» в её позу. У «Слежения камеры 2D» есть Привязать к цели.

Профилирование и проблемы

Профилировщик → Камера перечисляет все выходы с их активной виртуальной камерой, масштабом и ходом перехода.
«Проблемы» показывают слежение и тряску без виртуальной камеры (CAM001), зоны без камеры (CAM002), пустые прямоугольники (CAM003) и слежение без цели (CAM004).

id: camera/go title: Go

Go

cams := sdk.CamerasOf(ctx)
cams.Shake("", 0.5)
if k, err := cams.BlendTo(bossCam, 1.5, false); err == nil {
  cams.OnBlendCompleted(k, func(finished bool) { ... })
}

У Service есть Active, BlendTo, Release, Shake, Trauma, Logical, Render, View и Snap; все они принимают имя выхода, "" — главный выход.

Модуль публикует контракт camera2d.adjust; render2d.cameras просит его подправить вид каждой «Камеры 2D». Система camera.update (PostUpdate, работает и на паузе) выбирает камеры, продвигает переходы и зоны и гасит травму. Слежение и итоговая поза вычисляются при построении вида, один раз на выход и кадр. Модуль может масштабировать тряску, предоставив camera2d.accessibility с идентификаторами своих настроек.

19 KiB Raw Permalink Blame History Unescape Escape