Camera3D

public CameraAttributes Attributes { get; set; }

CameraAttributes для использования с этой камерой.

public Compositor Compositor { get; set; }

Compositor, который будет использоваться для этой камеры.

public uint CullMask { get; set; }

Маска отбраковки, описывающая, какие VisualInstance3D.Layers визуализируются этой камерой. По умолчанию визуализируются все 20 видимых пользователю слоев. Примечание: Поскольку Camera3D.CullMask позволяет хранить в общей сложности 32 слоя, есть еще 12 слоев, которые используются только внутренне движком и не отображаются в редакторе. Установка Camera3D.CullMask с помощью скрипта позволяет переключать эти зарезервированные слои, что может быть полезно для плагинов редактора. Чтобы упростить настройку Camera3D.CullMask с помощью скрипта, используйте Camera3D.GetCullMaskValue и Camera3D.SetCullMaskValue. Примечание: VoxelGI, SDFGI и LightmapGI всегда будут учитывать все слои, чтобы определить, что влияет на глобальное освещение. Если это проблема, установите GeometryInstance3D.GIMode на GeometryInstance3D.GIModeEnum.Disabled для сеток и Light3D.LightBakeMode на Light3D.BakeMode.Disabled для источников света, чтобы исключить их из глобального освещения.

public bool Current { get; set; }

Если true, предок Viewport в данный момент использует эту камеру. Если в сцене несколько камер, одна из них всегда будет текущей. Например, если в сцене присутствуют два узла Camera3D и только один из них является текущим, установка Camera3D.Current одной камеры на false приведет к тому, что другая камера станет текущей.

public Camera3D.DopplerTrackingEnum DopplerTracking { get; set; }

Если не задано Camera3D.DopplerTrackingEnum.Disabled, эта камера будет имитировать эффект Доплера для объектов, изменённых с помощью определённых методов _process. Примечание: Эффект Доплера будет слышен на AudioStreamPlayer3D только в том случае, если AudioStreamPlayer3D.DopplerTracking не задано как AudioStreamPlayer3D.DopplerTrackingEnum.Disabled.

public Environment Environment { get; set; }

Локальное переопределение окружения этой камеры с приоритетом над WorldEnvironment. null снимает override и возвращает выбор окружения мира. Если изменения WorldEnvironment не видны, сначала проверьте это свойство активной камеры.

public float Far { get; set; }

Расстояние до дальней плоскости отсечения камеры. Не используйте raw_depth*Far как универсальную формулу расстояния: перспективная глубина нелинейна и в текущем рендере использует reverse-Z. В примере расстояние восстанавливается обратной матрицей проекции с делением на W.

public float Fov { get; set; }

Поле обзора камеры (также известное как FOV) в качестве угла в градусах. Применяется только в режиме зрения. Camera3D.KeepAspect Заблокировать одну ось, это значение устанавливает поле обзора на другую ось. Для ссылки - угол по умолчанию для вертикального FOV (75.0) эквивалентно горизонтальному FOV:

• ~91,31 градуса в 4:3 просмотра
• ~101,67 градуса в 16:10
• ~107,51 градуса в 16:9 смотровой порт
• ~121,63 градуса в 21:9 просмотра

public Vector2 FrustumOffset { get; set; }

Смещение фрустума (frustum) камеры. Его можно изменить со значения по умолчанию, чтобы создать эффекты «наклонного фрустума», такие как Y-shearing. Примечание: Действует только если Camera3D.Projection равна Camera3D.ProjectionType.Frustum.

public float HOffset { get; set; }

Горизонтальное (X) смещение области просмотра камеры.

public Camera3D.KeepAspectEnum KeepAspect { get; set; }

Ось для блокировки во время настроек Camera3D.Fov/Camera3D.Size. Может быть либо Camera3D.KeepAspectEnum.Width, либо Camera3D.KeepAspectEnum.Height.

public float Near { get; set; }

Расстояние до ближней плоскости отсечения камеры в единицах мира. Это не исходное значение depth_texture. В проверенном spatial-примере INV_PROJECTION_MATRIX восстанавливает расстояния поверхностей после изменения Near вместе с Far; raw depth при этом меняется.

public Camera3D.ProjectionType Projection { get; set; }

Тип проекции камеры. Perspective использует перспективную проекцию с Fov; Orthogonal — ортографическую с Size; Frustum задаёт смещённый фрустум. Проверенный пример реконструирует глубину в Perspective и Orthogonal через актуальную INV_PROJECTION_MATRIX. Frustum не включён в эту проверку.

public float Size { get; set; }

Размер области Orthogonal/Frustum-проекции в единицах мира; соответствующая ширина или высота зависит от KeepAspect. Это не расстояние до поверхности. Контрольные плоскости в ортографическом примере сохраняют восстановленную глубину при изменении Size и соответствующем пересчёте их положения в кадре.

public float VOffset { get; set; }

Вертикальное (Y) смещение области просмотра камеры.

public void ClearCurrent(bool enableNext = true);

Если это текущая камера, удалить ее из списка текущих. Если enable_next равен true, запросить сделать текущей следующую камеру, если таковая имеется.

public Projection GetCameraProjection();

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

public Rid GetCameraRid();

Возвращает RID камеры из RenderingServer.

public Transform3D GetCameraTransform();

Возвращает преобразование камеры плюс вертикальное (Camera3D.VOffset) и горизонтальное (Camera3D.HOffset) смещения; и любые другие корректировки, внесенные в положение и ориентацию камеры подклассами камер, такими как XRCamera3D.

public bool GetCullMaskValue(int layerNumber);

Возвращает, включен ли указанный слой Camera3D.CullMask, учитывая layer_number от 1 до 20.

public Reckfell.Collections.Array<Plane> GetFrustum();

Возвращает плоскости усеченной пирамиды камеры в единицах мирового пространства как массив Plane в следующем порядке: ближний, дальний, левый, верхний, правый, нижний. Не путать с Camera3D.FrustumOffset.

public Rid GetPyramidShapeRid();

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

public bool IsPositionBehind(Vector3 worldPoint);

Проверяет, меньше ли глубина мировой точки вдоль направления камеры значения Near. Поэтому учитываются и точки между началом камеры и ближней плоскостью, а не только точки позади начала камеры. Это проверка глубины, без полного теста фрустума и перекрытия другими объектами.

public bool IsPositionInFrustum(Vector3 worldPoint);

Проверяет мировую точку по плоскостям фрустума камеры. Используйте камеру в дереве с настроенным viewport. Попадание во фрустум не доказывает видимость: метод не проверяет перекрытие геометрией, покрытие пикселями или слои отсечения объектов.

public void MakeCurrent();

Делает эту камеру текущей камерой для Viewport (см. описание класса). Если узел камеры находится вне дерева сцены, он попытается стать текущим после добавления.

public Vector3 ProjectLocalRayNormal(Vector2 screenPoint);

Возвращает нормальный вектор из точки экрана, направленный вдоль камеры. Ортогональные камеры нормализуются. Перспективные камеры учитывают перспективу, ширину/высоту экрана и т. д.

public Vector3 ProjectPosition(Vector2 screenPoint, float zDepth);

Возвращает трехмерную точку в мировом пространстве, которая сопоставляется с заданной двухмерной координатой в прямоугольнике Viewport на плоскости, которая находится на заданном расстоянии z_depth от камеры вглубь сцены.

public Vector3 ProjectRayNormal(Vector2 screenPoint);

Возвращает вектор нормали в мировом пространстве, который является результатом проецирования точки на прямоугольник Viewport обратной проекцией камеры. Это полезно для отбрасывания лучей в форме (origin, normal) для пересечения или выбора объектов.

public Vector3 ProjectRayOrigin(Vector2 screenPoint);

Возвращает 3D-позицию в мировом пространстве, которая является результатом проецирования точки на прямоугольник Viewport обратной проекцией камеры. Это полезно для отбрасывания лучей в форме (origin, normal) для пересечения или выбора объектов.

public void SetCullMaskValue(int layerNumber, bool value);

На основе value включает или отключает указанный слой в Camera3D.CullMask при заданном layer_number от 1 до 20.

public void SetFrustum(float size, Vector2 offset, float zNear, float zFar);

Устанавливает проекцию камеры в режим усеченного конуса (см. Camera3D.ProjectionType.Frustum), указывая Camera3D.Size, offset и плоскости отсечения z_near и z_far в единицах мирового пространства. Параметр Camera3D.Size представляет размер ближней плоскости, либо ее ширину, либо высоту в зависимости от значения Camera3D.KeepAspect. См. также Camera3D.FrustumOffset.

public void SetOrthogonal(float size, float zNear, float zFar);

Устанавливает проекцию камеры в ортогональный режим (см. Camera3D.ProjectionType.Orthogonal), указывая Camera3D.Size и плоскости отсечения z_near и z_far в единицах мирового пространства. Кстати, в 3D-играх, которые выглядят как 2D, часто используется эта проекция, где Camera3D.Size указывается в пикселях.

public void SetPerspective(float fov, float zNear, float zFar);

Устанавливает проекцию камеры в режим перспективы (см. Camera3D.ProjectionType.Perspective), указывая угол Camera3D.Fov (поле зрения) в градусах, а также плоскости отсечения z_near и z_far в единицах мирового пространства.

public Vector2 UnprojectPosition(Vector3 worldPoint);

Возвращает 2D-координату в прямоугольнике Viewport, которая сопоставляется с заданной 3D-точкой в мировом пространстве. Примечание: При использовании этого для позиционирования элементов GUI в 3D-окне просмотра используйте Camera3D.IsPositionBehind, чтобы предотвратить их появление, если 3D-точка находится за камерой: