# Управление камерой в редакторе

## Режим свободной камеры

Консольная команда [g\_cheatkeys \[ 1 | 0 \]](#user-content-fn-1)[^1] позволяет включить или выключить возможность использовать читы в редакторе. 

В [режиме Симуляции](/documentation/gem-rts-v1-ru/redaktor/redaktor-kart.md#knopka-upravleniya-rezhimom-simulyacii) и при включенном режиме  `g_cheatkeys 1`, комбинация клавиш `Ctrl+Shift+T` включает, а повторное нажатие комбинации выключает режим свободной камеры.

## Вид камеры от первого лица

В режиме Симуляции с помощью комбинации клавиш `Shift+F` можно переключить камеру на вид от первого лица выделенного юнита при наличии у юнита активного визора. \
Повторное нажатие комбинации клавиш выключает режим вида из глаз.

## Управление камерой с использованием мыши

Режим удобен, так как не зависит от расстояния до камеры или угла наклона камеры. Перемещает камеру по карте относительно зафиксированной точки на карте.

**Алгоритм действий**

1. Зафиксировать точку карты, зажав клавишу `Пробел`
2. Двигать мышью с зажатой `ЛКМ`, не отпуская `Пробел`

## Панель управления камерой в редакторе

Флажок `Clip camera position` на панели [Редактора карт](/documentation/gem-rts-v1-ru/redaktor/redaktor-kart.md) включает ограничение движения камеры.\
Эту же функцию выполняет консольная команда `cam_clip 1`.

<figure><img src="https://lh7-us.googleusercontent.com/ZT0-d6wgcHJgVfOZoK4M9yJDpW_hWbv7gzTEIcc7Dbq8h9S_XOKh6cMT0rJ5g-GY8-k12vdYFkYQtvrkY-_D9NiDPQKDfdGJQrIHrJOMpuicTV0deMpExmdxrKkTjcpJD9VBP_FpctjLMunR36uRht0" alt=""><figcaption></figcaption></figure>

Панель настройки параметров камеры находится в [боковом меню Редактора миссий](/documentation/gem-rts-v1-ru/redaktor/redaktor-missii.md#bokovoe-menyu) на вкладке режима Симуляции.

<figure><img src="https://lh7-us.googleusercontent.com/jXurh-jyXXxvhFvMtSPZ4VC2zOoq4Vs0IwlsyKCJIkEvTApEMzjDcAaTzf029sBT7AaUVGhO0kDFMJL2BKJeGfSK0rzWftLmYj2Fx18hDsL8Wp62RkSLjEC5lD3eB18SUOqax6C9eD4LuZfxGotj5LM" alt=""><figcaption><p>Панель управления камерой</p></figcaption></figure>

<table><thead><tr><th width="138">Кнопка</th><th>Описание</th></tr></thead><tbody><tr><td>Alt</td><td>Высота поднятия камеры над землей</td></tr><tr><td>а</td><td>Тангаж [pitch] - наклон камеры</td></tr><tr><td>Y</td><td>Рыскание [yaw] - угол поворота камеры</td></tr><tr><td>R</td><td>Крен [roll] - угол поворота камеры вокруг оси взгляда</td></tr><tr><td>F</td><td>FOV - угол раскрытия камеры</td></tr></tbody></table>

{% hint style="info" %}
Изменять значения с шагом x10 можно с помощью зажатия кнопки Ctrl
{% endhint %}

{% hint style="warning" %}
Большое значение крена (R) может привести к некорректному отображению теней
{% endhint %}

## Консольные команды для камеры

{% hint style="info" %}
Общий принцип работы консольных команд описан в статье [Консольные команды](/documentation/gem-rts-v1-ru/redaktor/rezhimy-otladki/konsolnye-komandy.md#princip-raboty-konsolnykh-komand)
{% endhint %}

### Общие параметры камеры

<table><thead><tr><th width="227">Команда</th><th width="100">Значение</th><th>Описание</th></tr></thead><tbody><tr><td><a data-footnote-ref href="#user-content-fn-2">cam_follow  </a></td><td><a data-footnote-ref href="#user-content-fn-3">0 | 1</a></td><td>Выключает | включает следование камеры за выделенным юнитом в прямом управлении.<br><strong>В текущей версии движка команда не поддерживается</strong></td></tr><tr><td>cam_followPosition</td><td>0,6</td><td>Отступ камеры при следовании за юнитом в прямом управлени.<br><strong>В текущей версии движка команда не поддерживается</strong></td></tr><tr><td>cam_allowMouseScroll</td><td>0 | 1</td><td>Выключает | включает скроллинг при приближении мыши к краю экрана</td></tr><tr><td>cam_scaleBias</td><td>0 | 1</td><td>Выключает | включает смещения z буфера для расчёта теней</td></tr><tr><td>cam_zNear1</td><td>30</td><td>Устанавливает плоскость z_near (в единицах расстояния) при близком к горизонтальному наклону камеры</td></tr><tr><td>cam_zFar</td><td>5000</td><td>Запас по отдалению плоскости z_far (в единицах расстояния)</td></tr></tbody></table>

### Настройки камеры при контакте с поверхностью земли

Настройка параметров для предотвращения погружения камеры в землю

<table><thead><tr><th width="266">Параметр</th><th width="117">Значение</th><th>Описание</th></tr></thead><tbody><tr><td>cam_liftAuto</td><td>0 | 1</td><td>Выключено | включено поднятие камеры вверх, если она ушла под землю</td></tr><tr><td>cam_liftRadius</td><td>1.5</td><td>Радиус точек, которыми оценивается уход камеры в землю, в метрах</td></tr><tr><td>v_camAutoLiftingVolume</td><td> 0 | 1</td><td>Выключено | включено отображение точек, по которым оценивается погружение камеры в землю.<br>Чтобы увидеть точки нужно остановить рендер, нажав комбинацию клавиш  <code>Alt+Pause</code>, и отодвинуть камеру в сторону</td></tr><tr><td>cam_liftSteadyUpMin</td><td>-2.0</td><td>Нижний предел отклонения от рассчитанного значения параметра <code>autolift</code> при максимальном приближении, в метрах</td></tr><tr><td>cam_liftSteadyUpMax</td><td>-2.0</td><td>Нижний предел отклонения от рассчитанного значения параметра <code>autolift</code> при максимальном отдалении, в метрах</td></tr><tr><td>cam_liftSteadyDownMin</td><td>2.0</td><td>Верхний предел отклонения от рассчитанного значения параметра <code>autolift</code> при максимальном приближении, в метрах</td></tr><tr><td>cam_liftSteadyDownMax</td><td>2.0</td><td>Верхний предел отклонения от рассчитанного значения параметра <code>autolift</code> при максимальном отдалении, в метрах</td></tr><tr><td>cam_liftSteadyBlendStart</td><td>0.0<br>[0.0 .. 0.9]</td><td>Начало работы лимитов, относительно ограничений <code>distance</code> в клипе</td></tr><tr><td>cam_liftSteadyBlendEnd</td><td>1.0<br>[0 .. 1]</td><td>Конец работы лимитов, относительно ограничений <code>distance</code> в клипе</td></tr></tbody></table>

### Дрожание камеры от взрывов

| Параметр        | Значение       | Описание                                         |
| --------------- | -------------- | ------------------------------------------------ |
| cam\_shake      | 0 \| 1         | Выключено \| включено дрожание камеры от взрывов |
| cam\_shakeScale | 1.0 \[0 .. 10] | Масштабирование интенсивности дрожания           |

### Лимиты камеры

Параметры настройки лимитов камеры и рекомендуемые значения

<table><thead><tr><th width="246">Параметр</th><th width="121">Значение</th><th>Описание</th></tr></thead><tbody><tr><td>cam_clip</td><td>0 | 1</td><td>Выключено | включено ограничение камеры по лимитам или нет</td></tr><tr><td>cam_viewAngleFree</td><td>true | false</td><td>Если ввод в консоль команды <code>cam_viewAngleFree</code>  возвращает 1, это означает, что для distance или viewAngle (pitch) берётся более широкий диапазон значений из clipper и set.<br>Eсли 0 - берётся более узкий диапазон.</td></tr><tr><td>cam_viewAngleMin</td><td>5</td><td>Установленное ограничение минимального значение угла наклона камеры (при 0 - горизонтально, параллельно земле)</td></tr><tr><td>cam_viewAngleMax</td><td>85</td><td>Установленное ограничение максимального значения угла наклона камеры (при 90 - вертикально, сверху вниз)</td></tr><tr><td>cam_viewAngleDistanceK</td><td>0.5</td><td>Коэффициент фиксации угла камеры при приближении к земле</td></tr><tr><td>cam_distanceMin</td><td>100</td><td>Минимальное расстояние от земли до камеры</td></tr><tr><td>cam_distanceMax</td><td>660</td><td>Максимальное расстояние от земли до камеры</td></tr><tr><td>cam_viewFovMin</td><td>0.0</td><td>Если этот параметр больше 0, то меняют FoV камеры в зависимости от расстояния от камеры до земли</td></tr><tr><td>cam_viewFovMax</td><td>0.0</td><td>Если этот параметр больше 0, то меняют FoV камеры в зависимости от расстояния от камеры до земли</td></tr></tbody></table>

### Камера с видом от третьего лица

В таблице представлены параметры настройки и рекомендуемые значения параметров для камеры с видом от третьего лица

<table><thead><tr><th>Параметр</th><th width="120">Значение</th><th>Описание</th></tr></thead><tbody><tr><td>cam_tpsFollowDistanceV</td><td>2</td><td>Расстояние следования камеры в вертикальном зуме (метры)</td></tr><tr><td>cam_tpsFollowDistanceH</td><td>2</td><td>Расстояние следования камеры в горизонтальном зуме (метры)</td></tr><tr><td>cam_tpsFollowOffsetUpV</td><td>2</td><td>Вертикальное смещение камеры при вертикальном зуме (метры)</td></tr><tr><td>cam_tpsFollowOffsetUpH</td><td>2</td><td>Вертикальное смещение камеры при горизонтальном зуме (метры)</td></tr><tr><td>cam_tpsFollowOffsetSideV</td><td>0</td><td>Стороннее смещение камеры при вертикальном зуме (метры)</td></tr><tr><td>cam_tpsFollowOffsetSideH</td><td>0</td><td>Стороннее смещение камеры при горизонтальном зуме (метры)</td></tr><tr><td>cam_tpsFollowOffsetForwardV</td><td>0</td><td>Смещение камеры вперед при вертикальном зуме (метры)</td></tr><tr><td>cam_tpsFollowOffsetForwardH</td><td>0</td><td>Смещение камеры вперед при горизонтальном зуме (метры)</td></tr><tr><td>cam_tpsFollowPitchMin</td><td>45</td><td>Минимальный наклон движущейся камеры (градусы)</td></tr><tr><td>cam_tpsFollowPitchMax</td><td>85</td><td>Максимальный наклон движущейся камеры (градусы)</td></tr><tr><td>cam_tpsFollowFOV</td><td>65</td><td>Раскрытие движущейся камеры (градусы)</td></tr><tr><td>cam_tpsFollowSpeedH</td><td>2</td><td>Скорость следования камеры за движениями мыши для позиции зума H (градусы)</td></tr><tr><td>cam_tpsFollowSpeedV</td><td>1</td><td>Скорость следования камеры за движениями мыши для позиции зума V (градусы)</td></tr><tr><td>cam_tpsDefaultFOV</td><td>60.0</td><td>Раскрытие камеры по умолчанию (градусы)</td></tr><tr><td>cam_tpsCameraBone</td><td>camera</td><td>Название кости, по имени которой работает камера</td></tr></tbody></table>

[^1]: Запись вида `name [ 0 | 1` ] означает, что ввод в консоль `name` без значения, вернет в консоль текущее значение параметра.\
    Возможные значения для команды -  0 и 1.\
    Команда работает как переключатель состояния: выключено | включено.

[^2]: Запись вида command \[ 0 | 1 ] означает, что команда работает по принципу переключаетля состояния соответствующего режима или команды в движке. \
    [Консольные команды](/documentation/gem-rts-v1-ru/redaktor/rezhimy-otladki/konsolnye-komandy.md#princip-raboty-konsolnykh-komand)

[^3]: Запись вида `name [ 0 | 1` ] означает, что ввод в консоль `name` без значения, вернет в консоль текущее значение параметра.\
    Возможные значения для команды -  0 и 1.\
    Команда работает как переключатель состояния: выключено | включено. \
    [Консольные команды](/documentation/gem-rts-v1-ru/redaktor/rezhimy-otladki/konsolnye-komandy.md#princip-raboty-konsolnykh-komand)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bestway-1.gitbook.io/documentation/gem-rts-v1-ru/redaktor/upravlenie-kameroi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.