Camera2D
Ортографическая камера Scene2D: какая часть 2D-мира на экране, насколько
она приближена и как переводить точки между экраном и миром. Каждая сцена владеет одной камерой —
scene.camera; сам Camera2D ты никогда не конструируешь. 3D-камера — Camera.
- вести камеру за игроком
- приблизить вид для пиксель-арта, сдвинуть или повернуть его
- перевести точку экрана (тап, перетаскивание) в точку 2D-мира
- найти, где точка мира находится на экране
Платформы: iOS, Android, десктоп, веб (Web Lite), веб-плеер, приложение-вьюер le.codes.
В headless-тестах screenToWorld / worldToScreen считают от вида 1×1 и возвращают неверные
точки.
Обзор
async function main() {
const scene = new Scene2D()
scene.camera.zoom = 2 // увеличение 2× — удобно для пиксель-арта
scene.camera.position = [0, 0] // точка мира в центре экрана
const tex = await Texture2D.load(asset('./hero.png'))
const hero = new Sprite({ texture: tex })
scene.add(hero)
// перетаскивание сообщает точки экрана; камера переводит их в точки мира
scene.addEventListener('touchstart', ev => {
ev.track({ onMove: p => { hero.position = scene.camera.screenToWorld(p.clientX, p.clientY) } })
})
scene.open()
}
main()Сдвиг, зум и поворот вида: position, zoom, rotation
camera.position = [x, y] // мировые единицы — точка в центре экрана
camera.zoom = 2 // увеличение; при 1 одна мировая единица = 1 логический px. По умолчанию 1
camera.rotation = 15 // градусы, против часовой. По умолчанию 0Геттеры возвращают свежие значения; прямая запись camera.position.x = 3 компилируется в запись
камеры, а сохранённая копия остаётся копией — см. соглашения.
rotation поворачивает камеру, поэтому мир на экране поворачивается в обратную сторону: при 90
мировая ось +X смотрит вниз по экрану.
Камера следует за игроком
follow() нет: вместо него — аспект на игроке, чей update(dt) (поздняя фаза, после физики)
плавно подтягивает камеру к узлу. Аспект уходит вместе с узлом; освобождать нечего.
class Follow extends Aspect<'follow', Node2D> {
camera!: Camera2D
update(dt: number) { // поздняя фаза: после физики, до отрисовки
this.camera.position = this.camera.position.lerp(this.node.worldPosition, 10 * dt)
}
}
async function main() {
const scene = new Scene2D()
scene.camera.zoom = 2
const tex = await Texture2D.load(asset('./hero.png'))
const hero = new Sprite({ texture: tex }).aspect(Follow, { camera: scene.camera })
scene.add(hero)
scene.open()
}
main()Встроенный CameraFollow делает то же самое и добавляет
привязку к пикселям: use(CameraFollow, …) в файле .scene2d.ts или hero.aspect(CameraFollow, { scene })
в коде.
Тап в точку мира: screenToWorld / worldToScreen
Перевод позиции тапа или перетаскивания на экране в точку 2D-мира и обратно.
camera.screenToWorld(screenX, screenY): Vec2 // логические px → мировые единицы
camera.worldToScreen(worldX, worldY): Vec2 // мировые единицы → логические pxscreenToWorld переводит точку тапа или перетаскивания (clientX / clientY) в мир: передай её в
scene.pick() или Physics2D.overlapPoint(). Собственные click /
touchstart сцены уже несут ev.worldX / ev.worldY. Экранный Y смотрит вниз, мировой — вверх;
преобразование учитывает этот переворот.
оба метода используют размер вида, в котором рисуется сцена, поэтому имеют смысл, когда сцена уже на экране — до её первого кадра они считают от вида 1×1.
Смотрите также
- Scene2D — сцена-владелец,
pick() - Файлы 2D-сцен —
CameraFollow, узлы камеры - 2D-физика —
overlapPoint,raycast - События указателя и жесты —
clientX/clientYв логических px