Camera2D

Ортографическая камера Scene2D: какая часть 2D-мира на экране, насколько она приближена и как переводить точки между экраном и миром. Каждая сцена владеет одной камерой — scene.camera; сам Camera2D ты никогда не конструируешь. 3D-камера — Camera.

  • вести камеру за игроком
  • приблизить вид для пиксель-арта, сдвинуть или повернуть его
  • перевести точку экрана (тап, перетаскивание) в точку 2D-мира
  • найти, где точка мира находится на экране

Платформы: iOS, Android, десктоп, веб (Web Lite), веб-плеер, приложение-вьюер le.codes. В headless-тестах screenToWorld / worldToScreen считают от вида 1×1 и возвращают неверные точки.

Обзор

TypeScript
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

TypeScript
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) (поздняя фаза, после физики) плавно подтягивает камеру к узлу. Аспект уходит вместе с узлом; освобождать нечего.

TypeScript
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-мира и обратно.

TypeScript
camera.screenToWorld(screenX, screenY): Vec2   // логические px → мировые единицы
camera.worldToScreen(worldX, worldY): Vec2     // мировые единицы → логические px

screenToWorld переводит точку тапа или перетаскивания (clientX / clientY) в мир: передай её в scene.pick() или Physics2D.overlapPoint(). Собственные click / touchstart сцены уже несут ev.worldX / ev.worldY. Экранный Y смотрит вниз, мировой — вверх; преобразование учитывает этот переворот.

Note

оба метода используют размер вида, в котором рисуется сцена, поэтому имеют смысл, когда сцена уже на экране — до её первого кадра они считают от вида 1×1.

Смотрите также