LCCManager: основной менеджер

Основной менеджер LCC Unity SDK, отвечающий за управление всеми экземплярами Renderer, камерами, глобальным состоянием рендеринга, а также операциями редактирования (обрезка / подсветка / тон), проекцией декали, привязкой и запросами взаимодействия (рейкаст / коллизия). Во всей сцене должен быть только один экземпляр LCCManager.

LCCManager не имеет публичных свойств; весь функционал доступен через методы. Методы сгруппированы по назначению:

• Инициализация и конфигурация
• Управление рендерингом во время выполнения
• Освещение и тени
• Управление камерами
• Обрезка / подсветка / тон
• Проекция декали
• Привязка
• Рейкастинг и запросы коллизий
• Визуальные эффекты
• Запросы экземпляров

Инициализация и конфигурация

Следующие методы используются для выполнения предварительной настройки платформы, режима рендеринга, ёмкости и т.д. перед загрузкой данных. Большинство методов должны вызываться перед любым Renderer.Load().

SetPlatformType

public void SetPlatformType(PlatformType _type)

Задаёт целевую платформу выполнения SDK, что влияет на внутреннюю стратегию рендеринга и выделение ресурсов.

Примечания:

• Должен выполняться перед любым вызовом GetRender().

Пример:

lccManager.SetPlatformType(PlatformType.PC);

SwitchRenderPass

public void SwitchRenderPass(ActiveRenderMode _mode)

Задаёт глобальный режим архитектуры рендеринга. MultiRender использует общий буфер GPU и может одновременно рендерить до 255 Renderer; SingleRender позволяет SDK автоматически выбирать путь рендеринга на основе размера данных.

Примечания:

• Должен вызываться перед любым Renderer.Load().
• Действует только на платформах PC / Mac; платформы mobile / VR автоматически принимают адаптивную стратегию, а вызов этого метода отклоняется.
• Режим MultiRender не поддерживает источники данных HTTP; используйте SingleRender для данных HTTP.
• После того как любой Renderer завершит Load(), режим блокируется и не может быть переключён снова.

Пример:

lccManager.SwitchRenderPass(ActiveRenderMode.MultiRender);

GetRender (Перегрузка 1: привязка Transform)

// Возвращаемое значение: Renderer, null при ошибке
public Renderer GetRender(Transform _transform)

Создаёт новый экземпляр рендеринга и привязывает его к указанному Transform. После создания необходимо вызвать Renderer.Load() для загрузки данных.

Примечания:

• Сначала должны быть вызваны SetPlatformType() и SetMainCamera().
• В режиме MultiRender поддерживается до 255 Renderer.

Пример:

var go = new GameObject("LCCScene");
var renderer = lccManager.GetRender(go.transform);
renderer.Load(filePath, null, () => Debug.Log("Загружено"));

GetRender (Перегрузка 2: автоматическое создание GameObject)

// Возвращаемое значение: Renderer, null при ошибке
public Renderer GetRender(out GameObject gameObject)

Автоматически создаёт GameObject с именем LCCRenderer и привязывает экземпляр рендеринга к его Transform.

Пример:

var renderer = lccManager.GetRender(out GameObject go);
renderer.Load(filePath, null, () => Debug.Log("Загружено"));

SetMaxBufferSplat

public void SetMaxBufferSplat(int _count)

Задаёт максимальную ёмкость буфера GPU (количество Splat). Выделяется один раз и не может изменяться динамически.

Примечания:

• Должен вызываться перед любым Renderer.Load(), и сначала должен быть вызван SetPlatformType().
• Большая ёмкость означает более высокое использование видеопамяти; задавайте по мере необходимости.
• Ограничения платформ: PC / Mac / PCVR — 45 миллионов, Android / iOS — 6 миллионов, VR (Pico / Quest / PicoSwan / AVP / OpenXR) — 2 миллиона.
• По умолчанию: PC / Mac — 30 миллионов, Android / iOS — 3 миллиона, VR — 1 миллион.

Пример:

lccManager.SetMaxBufferSplat(3000); // 30 миллионов точек

SetFullRenderSplat

public void SetFullRenderSplat(int _count)

Задаёт верхний порог полного рендеринга для PC / Mac. Когда размер данных ниже этого значения, используется путь полного рендеринга; в противном случае используется путь чанкового рендеринга.

Примечания:

• Поддерживается только на платформах PC / Mac / PCVR.
• Должен вызываться перед любым Renderer.Load(), и сначала должен быть вызван SetPlatformType().

Пример:

lccManager.SetFullRenderSplat(2500); // 25 миллионов точек

SetMaxRenderSplats

public void SetMaxRenderSplats(int _count)

Задаёт максимальное количество Splat, рендерящихся за кадр во время выполнения. Может вызываться динамически после Load().

Примечания:

• Может динамически настраиваться во время выполнения.
• Не может превышать ёмкость, заданную SetMaxBufferSplat(); при превышении автоматически ограничивается.
• Не действует в режиме полного рендеринга.

Пример:

lccManager.SetMaxRenderSplats(2500); // 25 миллионов точек

GetLoadRatio

// Возвращаемое значение: float, [0,1] текущий прогресс загрузки данных
public float GetLoadRatio()

Запрашивает прогресс загрузки текущих данных сцены.

Примечания:

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

Пример:

float ratio = lccManager.GetLoadRatio();
progressBar.value = ratio;

SetSelectionMode

public void SetSelectionMode(SelectionMode mode)

Задаёт стратегию выбора узлов.

Примечания:

• Auto (по умолчанию): решается автоматически на основе общего ограничивающего параллелепипеда сцены; когда максимальный размер сцены превышает примерно 380 метров, автоматически повышается до Large.
• Normal: подходит для малых и средних сцен.
• Large: подходит для очень больших сцен (более 1000 метров).
• Вступает в силу сразу при переключении.

Пример:

lccManager.SetSelectionMode(SelectionMode.Auto);

Управление рендерингом во время выполнения

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

SetDetailLevel

public void SetDetailLevel(float sse)

Задаёт уровень точности рендеринга. Большее значение означает более тонкий рендеринг и более высокое потребление производительности.

Примечания:

• Использует логарифмическое отображение: изменения чувствительны в диапазоне низких значений и плавны в диапазоне высоких значений.
• Может динамически настраиваться во время выполнения.
• Действует только в режиме выбора Normal.

Пример:

lccManager.SetDetailLevel(50f); // Средняя точность

SetStartLod

public void SetStartLod(int lod)

Задаёт начальную точку развёртывания LOD (с отсчётом от 0). 0 — самый детальный, а большее число означает более грубый уровень.

Примечания:

• Фактический действующий верхний предел ограничен общим количеством уровней данных.

Пример:

lccManager.SetStartLod(0);

SetAutoFov

public void SetAutoFov(bool _auto)

Задаёт, автоматически ли управлять FOV рендеринга. При включении (по умолчанию) SDK фиксирует базовую линию пиксельного фокусного расстояния в первом кадре, затем каждый кадр инвертирует вертикальный FOV из текущей высоты вьюпорта и записывает его обратно в Camera.fieldOfView; при отключении fieldOfView управляется извне (SetFOV() или прямым изменением камеры).

Примечания:

• Включено по умолчанию.
• При включении непрерывно перезаписывает Camera.fieldOfView основной камеры, поэтому вызов SetFOV() игнорируется.
• При отключении SetFOV() должен вызываться вручную для установки параметров.

Пример:

lccManager.SetAutoFov(true);

SetFOV

public void SetFOV(int _width, int _height, float _verticalFov, float _aspect)

Вручную задаёт вертикальный FOV (в градусах). Напрямую перезаписывает Camera.fieldOfView основной камеры, чтобы FOV в Inspector соответствовал FOV, фактически используемому для рендеринга. _width / _height / _aspect — устаревшие параметры сигнатуры; фактическая проекция использует собственный вьюпорт основной камеры (используйте SetRecordMode() для внеэкранного вывода с другим размером / FOV).

Примечания:

• Сначала должен быть вызван SetAutoFov(false), иначе покадровая инверсия авто-FOV перезапишет ручное значение.
• Вертикальный FOV ограничен диапазоном [1, 179] градусов.
• Вызов на платформах VR / PCVR, во время записи или под ортографической камерой отклоняется (выводит предупреждение и возвращается).

Пример:

lccManager.SetFOV(1920, 1080, 60f, 1.778f);

SetRenderEnable

public void SetRenderEnable(Renderer _renderer, bool _isEnable)

Управляет переключателем рендеринга указанного Renderer во время выполнения. При отключении он не участвует в обходе и отрисовке.

Пример:

lccManager.SetRenderEnable(renderer, false); // Скрыть

SetEnvironment

public void SetEnvironment(Renderer _renderer, bool _isRender)

Управляет рендерингом данных окружения указанного Renderer. Данные окружения — это низкодетальное фоновое облако точек, используемое для заполнения дальних видов.

Примечания:

• Данные должны содержать узлы окружения.

Пример:

lccManager.SetEnvironment(renderer, true);

SetZDepth

public void SetZDepth(bool zwrite)

Переключает запись глубины Z и соответствующим образом настраивает очередь рендеринга.

Пример:

lccManager.SetZDepth(true);

SetAlpha

public void SetAlpha(float alpha)

Задаёт глобальную непрозрачность.

Пример:

lccManager.SetAlpha(0.8f);

SetLightIntensity

public void SetLightIntensity(float intensity)

Задаёт глобальную интенсивность света.

Пример:

lccManager.SetLightIntensity(0.7f);

SetLowPassFilter

public void SetLowPassFilter(float _filter)

Задаёт силу глобального фильтра нижних частот, используемого для подавления высокочастотного алиасинга / шума.

Пример:

lccManager.SetLowPassFilter(0.3f);

SetLockFPS

public void SetLockFPS(bool _isLock)

Переключает блокировку частоты кадров (переключение статической / динамической частоты кадров).

Пример:

lccManager.SetLockFPS(true);

SetRenderLayer

public void SetRenderLayer(int _layer)

Задаёт слой Unity, используемый рендерингом LCC, для управления видимостью через CullingMask камеры.

Примечания:

• Может динамически настраиваться во время выполнения.

Пример:

lccManager.SetRenderLayer(8); // Использовать слой 8

SetForceRefresh

public void SetForceRefresh()

Принудительно выполняет обновление рендеринга. Очищает внутренний кэш информации камеры, чтобы фрустум, LOD и другие параметры были пересчитаны на следующем кадре. Подходит для случаев, когда изменённые извне параметры камеры должны вступить в силу немедленно.

Пример:

lccManager.SetForceRefresh();

SetMipMode

public void SetMipMode(MipMode _mipMode)

Переключает режим рендеринга Mip. Режим Mip использует сэмплирование мипмапов (по умолчанию), а режим Non_Mip отключает мипмапы.

Примечания:

• Возвращается сразу, если текущий режим совпадает с переданным.
• Вступает в силу сразу при переключении.

Пример:

lccManager.SetMipMode(MipMode.Non_Mip);

SetGraphicsAPI

public void SetGraphicsAPI(GraphicsDeviceType type)

Задаёт тип графического API. В режиме DX11 включается HDR.

Пример:

lccManager.SetGraphicsAPI(GraphicsDeviceType.Direct3D11);

SetDebugMode

public void SetDebugMode(bool debug)

Переключает режим отладки.

Примечания:

• Поддерживается только на платформах PC / Mac.

Пример:

lccManager.SetDebugMode(true);

SetEditorMode

public void SetEditorMode(bool _isEditor)

Переключает режим редактора.

Примечания:

• Поддерживается только на платформах PC / Mac.

Пример:

lccManager.SetEditorMode(true);

SetAECMode

public void SetAECMode(bool _aec)

Переключает режим AEC (архитектура / инженерия / строительство).

Примечания:

• Поддерживается только на платформах PC / Mac.

Пример:

lccManager.SetAECMode(true);

SetSemantic

// Возвращаемое значение: bool, false=недопустимый параметр
public bool SetSemantic(bool enable, Vector4[] color = null)

Переключает режим семантического рендеринга. При включении можно передать массив цветов для определения цвета отображения каждой семантической категории.

Пример:

Vector4[] colors = new Vector4[100];
colors[0] = new Vector4(1, 0, 0, 1); // Категория 0 = красный
lccManager.SetSemantic(true, colors);

SwitchRenderMode

public void SwitchRenderMode(RenderMode mode, Texture2D tex = null)

Переключает между рендерингом облака точек и рендерингом 3DGS. В режиме облака точек можно предоставить текстуру градиента высоты.

Примечания:

• Поддерживается только на платформах PC / Mac.

Пример:

lccManager.SwitchRenderMode(RenderMode.PointCloud, elevationTex);

SetRecordMode

public void SetRecordMode(bool isRecord, Vector2 renderSize, float verticalFov)

Задаёт режим записи. В режиме записи для рендеринга используются фиксированное разрешение и FOV, что подходит для записи HD-видео.

Примечания:

• Поддерживается только на платформах PC / Mac.
• В режиме записи фокусное расстояние камеры фиксировано и не меняется вместе с компонентом Camera.
• После записи вызовите SetRecordMode(false, ...) для восстановления.

Пример:

lccManager.SetRecordMode(true, new Vector2(3840, 2160), 60f);

SetVRPerformance

public void SetVRPerformance(bool _enabled)

Задаёт высокопроизводительный режим сортировки VR. true использует поразрядную сортировку на GPU (GpuSorter), а false возвращается к CPU / BitonicSorter.

Примечания:

• Влияет только на путь сортировки VR-шлемов (Pico / Quest / PicoSwan / OpenXR); включено по умолчанию.
• При отсутствии вычислительного устройства (например, Mali) сортировка автоматически возвращается к CPU, независимо от этого переключателя.

Пример:

lccManager.SetVRPerformance(true);

Освещение и тени

Следующие методы управляют приёмом теней и пользовательскими точечными источниками света на поверхностях 3DGS. Методы, связанные с тенями, должны вызываться после завершения загрузки LCC-сцены.

SetShadowReceive

public void SetShadowReceive(bool enable)

Переключает приём теней облаком точек. При включении тени от объектов Mesh в сцене могут отбрасываться на поверхности облака точек 3DGS.

Примечания:

• Отключено по умолчанию.
• Требуются объекты Mesh, отбрасывающие тени, и Directional Light в сцене.

Пример:

lccManager.SetShadowReceive(true);

SetShadowColor

public void SetShadowColor(Color color)

Задаёт цвет области тени.

Примечания:

• По умолчанию (0.3, 0.3, 0.3, 1).
• Сначала должно быть включено SetShadowReceive(true).

Пример:

lccManager.SetShadowColor(new Color(0.3f, 0.3f, 0.3f, 1f));

SetShadowStrength

public void SetShadowStrength(float strength)

Задаёт силу тени. 0 — без тени, 1 — самая сильная тень.

Примечания:

• По умолчанию 1.0.
• Сначала должно быть включено SetShadowReceive(true).

Пример:

lccManager.SetShadowStrength(0.8f);

SetLights

// Возвращаемое значение: int, 0=успех, -1=превышен максимальный лимит количества
public int SetLights(List<PointLightData> lights)

Задаёт пользовательский список точечных источников света. Передача null или пустого списка отключает пользовательское освещение.

Примечания:

• PointLightData.lightType: 0 — точечный источник света (direction / spotAngle игнорируются), 1 — прожектор (требуются direction / spotAngle).
• Передача null или пустого списка отключает пользовательское освещение.

Пример:

using Unity.Mathematics; // float3

var lights = new List<PointLightData>();
lights.Add(new PointLightData {
    position = new float3(0, 5, 0),
    lightType = 0,              // 0=точечный источник, 1=прожектор
    color = new float3(1, 1, 1),
    intensity = 2f,
    range = 10f
});
lccManager.SetLights(lights);

Управление камерами

SetMainCamera

public void SetMainCamera(Camera _cam)

Задаёт основную камеру рендеринга. LCC использует эту камеру для отсечения по фрустуму, выбора LOD, сортировки и других операций.

Примечания:

• Должна задаваться перед Renderer.Load().
• Поддерживается только на платформах PC / Mac.

Пример:

lccManager.SetMainCamera(Camera.main);

AddCamera

public void AddCamera(Camera _cam)

Добавляет вторичную камеру. Вторичная камера участвует в рендеринге, но не влияет на выбор LOD.

Примечания:

• Поддерживается только на платформах PC / Mac.
• Основную камеру нельзя добавить в качестве вторичной.

Пример:

lccManager.AddCamera(secondCamera);

RemoveCamera

public void RemoveCamera(Camera _cam)

Удаляет добавленную вторичную камеру.

Примечания:

• Поддерживается только на платформах PC / Mac.

Пример:

lccManager.RemoveCamera(secondCamera);

Обрезка / подсветка / тон

Обрезка, подсветка и тон — это три вида операций редактирования, все они поддерживают определение затрагиваемой области через 2D-текстуру, 3D-геометрию или их смесь. См. Data2D, Data3D, DataMix и ToneMix.

SetClip (обрезка плоскостью)

// Возвращаемое значение: int, 0=успех
public int SetClip(Vector3 planePoint, Vector3 planeNormal, bool inside = true)

Вырезает облако точек бесконечной плоскостью, оставляя точки со стороны нормали или с противоположной стороны.

Примечания:

• Взаимно исключает другие режимы обрезки.

Пример:

lccManager.SetClip(Vector3.zero, Vector3.up, true); // Оставить над землёй

SetClip (обрезка 2D-текстурой)

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество
public int SetClip(List<Data2D> _2Ds)

Вырезает облако точек с помощью 2D-проецируемой текстуры маски.

Пример:

var clips = new List<Data2D>();
clips.Add(new Data2D {
    texture = maskTex,
    mv = modelViewMatrix,
    mvp = mvpMatrix,
    mode = SelectMode.normal
});
lccManager.SetClip(clips);

SetClip (обрезка 3D-геометрией)

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество, 3=ноль допустимой геометрии
public int SetClip(List<Data3D> _3Ds)

Вырезает облако точек 3D-геометрией, поддерживая булевы операции для комбинирования нескольких геометрий.

Примечания:

• Требуется хотя бы одна геометрия с operation == normal.

Пример:

var clips = new List<Data3D>();
clips.Add(new Data3D {
    type = ShapeType.box,
    invMat = boxInverseMatrix,
    operation = OperationMode.normal,
    mode = SelectMode.normal
});
lccManager.SetClip(clips);

SetClip (обрезка в смешанном режиме)

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество
public int SetClip(List<DataMix> mix)

Определяет область обрезки смесью 2D-текстур и 3D-геометрий. Каждая запись указывает свой тип через editType.

Пример:

var mix = new List<DataMix>();
mix.Add(new DataMix {
    editType = EditType.Edit3D,
    type = ShapeType.box,
    invMat = matrix,
    operation = OperationMode.normal,
    mode = SelectMode.normal
});
lccManager.SetClip(mix);

QuitClipMode

public void QuitClipMode()

Выходит из режима обрезки и восстанавливает полное отображение облака точек.

Пример:

lccManager.QuitClipMode();

SetHighlight (подсветка 2D-текстурой)

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество
public int SetHighlight(List<Data2D> _2Ds)

Подсвечивает облако точек с помощью 2D-проецируемой текстуры маски; облако точек вне подсвеченной области затемняется.

Примечания:

• Взаимно исключает 3D-подсветку и смешанную подсветку.

Пример:

var highlights = new List<Data2D>();
highlights.Add(new Data2D {
    texture = maskTex,
    mv = modelViewMatrix,
    mvp = mvpMatrix,
    mode = SelectMode.normal
});
lccManager.SetHighlight(highlights);

SetHighlight (подсветка 3D-геометрией)

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество, 3=ноль допустимой геометрии
public int SetHighlight(List<Data3D> _3Ds)

Определяет подсвеченную область 3D-геометрией, поддерживая булевы операции для комбинирования.

Примечания:

• Требуется хотя бы одна геометрия с operation == normal.

Пример:

var highlights = new List<Data3D>();
highlights.Add(new Data3D {
    type = ShapeType.box,
    invMat = boxInverseMatrix,
    operation = OperationMode.normal,
    mode = SelectMode.normal
});
lccManager.SetHighlight(highlights);

SetHighlight (подсветка в смешанном режиме)

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество
public int SetHighlight(List<DataMix> mix)

Определяет подсвеченную область смесью 2D-текстур и 3D-геометрий.

Пример:

var mix = new List<DataMix>();
mix.Add(new DataMix {
    editType = EditType.Edit3D,
    type = ShapeType.box,
    invMat = matrix,
    operation = OperationMode.normal,
    mode = SelectMode.normal
});
lccManager.SetHighlight(mix);

QuitHighlightMode

public void QuitHighlightMode()

Выходит из режима подсветки и восстанавливает обычное отображение облака точек.

Пример:

lccManager.QuitHighlightMode();

SetTone

// Возвращаемое значение: int, 0=успех, 1=пустой список, 2=превышено максимальное количество
public int SetTone(List<ToneMix> mix)

Применяет коррекцию тона к выбранной области, поддерживая яркость, насыщенность, контрастность и LUT-фильтры. Область тона может быть определена 2D-текстурой или 3D-геометрией.

Примечания:

• brightness / saturation / contrast по умолчанию равны 1.0.
• lutid — индекс LUT-фильтра; 0 означает не используется.

Пример:

var tones = new List<ToneMix>();
tones.Add(new ToneMix {
    editType = EditType.Edit3D,
    type = ShapeType.box,
    invMat = boxMatrix,
    operation = OperationMode.normal,
    mode = SelectMode.normal,
    brightness = 1.2f,
    saturation = 1.0f,
    contrast = 1.1f,
    lutid = 0
});
lccManager.SetTone(tones);

QuitToneMode

public void QuitToneMode()

Выходит из режима тона и восстанавливает исходный цвет облака точек.

Пример:

lccManager.QuitToneMode();

Проекция декали

Проекция декали проецирует текстуру на поверхности 3DGS вдоль направления проектора. Декаль — это зафиксированное в мире глобальное состояние, согласованное для всех камер. Типичный рабочий процесс: включить декаль → задать текстуру → задать позу проектора. Следующие методы поддерживаются только на платформах PC / Mac.

SetDecalEnabled

public void SetDecalEnabled(bool enable)

Переключает проекцию декали. SetDecalTexture() и SetDecalProjection() должны вызываться отдельно для задания содержимого и позы проектора.

Примечания:

• Отключение не очищает кэшированную текстуру / параметры.

Пример:

lccManager.SetDecalEnabled(true);
lccManager.SetDecalTexture(decalTex);
lccManager.SetDecalProjection(projectorPos, projectorRot, 60f, 1.778f, 0.1f, 20f);

SetDecalTexture

public void SetDecalTexture(Texture2D tex)

Задаёт текстуру декали. RGB — цвет, а A — собственная маска декали, которая перемножается с глобальной непрозрачностью и растушёвкой краёв.

Пример:

lccManager.SetDecalTexture(logoTex);

SetDecalProjection

public void SetDecalProjection(Vector3 pos, Quaternion rot, float fov, float aspect, float near, float far)

Задаёт позу и параметры перспективы проектора декали. Проектор проецирует вдоль своего переднего (+Z) направления, и точки внутри фрустума покрываются декалью.

Пример:

lccManager.SetDecalProjection(new Vector3(0, 10, 0), Quaternion.Euler(90, 0, 0), 60f, 1.778f, 0.1f, 20f);

SetDecalOpacity

public void SetDecalOpacity(float opacity)

Задаёт общую непрозрачность декали.

Пример:

lccManager.SetDecalOpacity(0.8f);

SetDecalEdgeFade

public void SetDecalEdgeFade(float edgeFade)

Задаёт ширину растушёвки краёв декали. 0 — жёсткий край, а большее значение делает переход края мягче.

Пример:

lccManager.SetDecalEdgeFade(0.1f);

SetDecalOcclusion

public void SetDecalOcclusion(bool enable)

Переключает отсечение окклюзией декали (на основе карты глубины проектора). При включении окклюдированные поверхности не покрываются декалью.

Примечания:

• Только платформа PC / Mac и только конвейер URP.
• Перед включением должен быть вызван SetDecalProjection() для настройки проектора.
• Зависит от параметров качества, настроенных через SetDecalOcclusionSettings().

Пример:

lccManager.SetDecalOcclusion(true);

SetDecalOcclusionSettings

public void SetDecalOcclusionSettings(DecalOcclusionSettings settings)

Задаёт все параметры качества отсечения окклюзией декали сразу. См. DecalOcclusionSettings.

Примечания:

• Можно настраивать в любое время; параметры вступают в силу немедленно.

Пример:

lccManager.SetDecalOcclusionSettings(DecalOcclusionSettings.Default);
lccManager.SetDecalOcclusionSettings(new DecalOcclusionSettings {
    opacityCutoff = 0.1f,
    depthBias = 0.05f,
    footprintMaxPx = 2,
    resolution = 1024
});

Привязка

Функция привязки автоматически ищет ближайшие рёбра / углы для выравнивания при рейкастинге и обычно используется для точного взаимодействия, такого как измерение и аннотирование. Следующие методы поддерживаются только на платформах PC / Mac.

SetSnapEnabled

public void SetSnapEnabled(bool enable)

Переключает функцию привязки. При включении RaycastWithSnap() автоматически ищет ближайшие рёбра / углы для привязки.

Примечания:

• Отключено по умолчанию.
• Не действует на mobile / VR, и выводится предупреждение.

Пример:

lccManager.SetSnapEnabled(true);

SetSnapRadius

public void SetSnapRadius(float pixels)

Задаёт радиус поиска привязки. Ищет ближайшее ребро / угол в пределах этого пиксельного диапазона.

Примечания:

• По умолчанию 20 пикселей.
• Большее значение означает более широкий диапазон поиска, но может привязаться к нежелательным целям.

Пример:

lccManager.SetSnapRadius(30f);

SetEdgeThreshold

public void SetEdgeThreshold(float threshold)

Задаёт порог обнаружения рёбер. Меньшее значение обнаруживает больше рёбер.

Примечания:

• По умолчанию 0.3.
• Слишком малое значение даёт много шумных рёбер.

Пример:

lccManager.SetEdgeThreshold(0.2f);

SetSnapPreviewEnabled

public void SetSnapPreviewEnabled(bool enable)

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

Примечания:

• Сначала должен быть вызван SetSnapEnabled(true).
• Предпросмотр непрерывно потребляет ресурсы GPU (обнаружение каждый кадр).

Пример:

lccManager.SetSnapPreviewEnabled(true);

UpdateSnapPreview

public void UpdateSnapPreview(Vector2 mousePos, Camera cam)

Обновляет состояние предпросмотра привязки. Вызывается при движении мыши для обновления позиции индикатора предпросмотра.

Примечания:

• Сначала должен быть вызван SetSnapPreviewEnabled(true).
• Рекомендуется вызывать непрерывно в Update.

Пример:

void Update()
{
    lccManager.UpdateSnapPreview(Input.mousePosition, Camera.main);
}

GetSnapPreviewState

// Возвращаемое значение: SnapPreviewState
public SnapPreviewState GetSnapPreviewState()

Получает текущее состояние предпросмотра привязки, включая наличие цели привязки, тип цели, экранную позицию цели и пиксельное расстояние до мыши. См. SnapPreviewState.

Примечания:

• Сначала должны быть вызваны SetSnapPreviewEnabled(true) и UpdateSnapPreview().
• Возвращает default(SnapPreviewState) при отсутствии цели.
• screenPos — в экранных координатах, а не в мировых; используйте RaycastWithSnap() для получения HitResult.hitPos в мировых координатах.

Пример:

var state = lccManager.GetSnapPreviewState();
if (state.hasTarget)
{
    // state.snapType: угол / ребро
    // state.screenPos: экранные координаты цели привязки
    // state.distanceToMouse: расстояние в пикселях
}

Рейкастинг и запросы коллизий

Рейкастинг используется для выбора точек на поверхностях 3DGS, а запросы коллизий — для физического взаимодействия между персонажами / объектами и облаком точек. Результат попадания возвращается через HitResult.

Примечание:

Поле мировых координат точки попадания в HitResult называется hitPos (а не position).

Raycast (экранные координаты)

// Возвращаемое значение: bool, true=попадание
public bool Raycast(Vector3 mousePos, out HitResult _finalResult)

Испускает луч из экранных координат для обнаружения попаданий в облако точек. Луч генерируется с использованием основной камеры, заданной через SetMainCamera().

Примечания:

• Сначала должен быть вызван SetMainCamera() для установки основной камеры.
• Возвращает точку попадания, ближайшую к камере.
• Точность зависит от SetRaycastDelta(), а максимальное расстояние управляется SetMaxRaycastDistance().

Пример:

if (lccManager.Raycast(Input.mousePosition, out HitResult hit))
{
    Debug.Log(hit.hitPos);
}

Raycast (Ray)

// Возвращаемое значение: bool, true=попадание
public bool Raycast(Ray _ray, out HitResult _finalResult)

Выполняет рейкастинг с пользовательским Ray, перебирая все активные Renderer и возвращая ближайшее попадание.

Пример:

Ray ray = new Ray(origin, direction);
if (lccManager.Raycast(ray, out HitResult hit))
{
    Debug.Log(hit.hitPos);
}

RaycastMesh (экранные координаты)

// Возвращаемое значение: bool, true=попадание
public bool RaycastMesh(Vector3 mousePos, out HitResult _finalResult, float _distance = 70.0f)

Испускает луч из экранных координат для обнаружения попаданий в коллизионный меш облака точек. Использует данные Collider для обнаружения, что быстрее, чем Raycast(), но менее точно.

Примечания:

• Данные должны содержать узлы Collider, и сначала должен быть вызван Renderer.SetColliderEnable(true).

Пример:

if (lccManager.RaycastMesh(Input.mousePosition, out HitResult hit))
{
    Debug.Log(hit.hitPos);
}

RaycastMesh (Ray + Bounds)

// Возвращаемое значение: bool, true=попадание
public bool RaycastMesh(Ray ray, out HitResult result, out Bounds hitBounds, float maxDist = 70.0f)

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

Примечания:

• Данные должны содержать узлы Collider.

Пример:

Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
if (lccManager.RaycastMesh(ray, out HitResult hit, out Bounds bounds))
{
    Debug.Log(bounds.center);
}

RaycastWithSnap

// Возвращаемое значение: bool, true=попадание
public bool RaycastWithSnap(Vector2 screenPos, Camera cam, out HitResult result)

Рейкастинг с привязкой. Сначала выполняет обычный рейкаст, затем ищет рёбра / углы рядом с точкой попадания для привязки.

Примечания:

• Сначала должен быть вызван SetSnapEnabled(true).
• Только платформы PC / Mac; недоступно на mobile / VR.
• Приоритет привязки: угол > ребро > нет.
• HitResult.snapType — тип привязки, HitResult.hitPos — мировая координата после привязки, а HitResult.originalHitPos — исходная точка попадания до привязки.

Пример:

if (lccManager.RaycastWithSnap(mousePos, cam, out HitResult hit))
{
    // hit.snapType: угол / ребро / нет
    // hit.hitPos: мировая координата после привязки
    // hit.originalHitPos: исходная точка попадания до привязки
}

SetRaycastDelta

public void SetRaycastDelta(float delta)

Задаёт параметр точности рейкастинга. Меньшее значение означает более высокую точность, но более высокое потребление производительности.

Примечания:

• По умолчанию 0.1.
• Влияет на точность обнаружения всех методов Raycast().

Пример:

lccManager.SetRaycastDelta(0.5f);

SetMaxRaycastDistance

public void SetMaxRaycastDistance(float _distance)

Задаёт максимальное расстояние обнаружения методов Raycast().

Примечания:

• Влияет на перегрузки Raycast(Vector3) / Raycast(Ray); не влияет на RaycastMesh() (у которого есть собственный параметр расстояния).

Пример:

lccManager.SetMaxRaycastDistance(500f);

IntersectsSphere

// Возвращаемое значение: bool, true=пересекается
public bool IntersectsSphere(Sphere sphere)

// Возвращаемое значение: bool, true=пересекается
public bool IntersectsSphere(Sphere sphere, out Vector3 delta)

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

Примечания:

• Данные должны содержать узлы Collider, и сначала должен быть вызван Renderer.SetColliderEnable(true).
• Перебирает все активные Renderer.

Пример:

var sphere = new Sphere(transform.position, 0.5f);
if (lccManager.IntersectsSphere(sphere, out Vector3 delta))
{
    transform.position += delta;
}

IntersectsCapsule

// Возвращаемое значение: bool, true=пересекается
public bool IntersectsCapsule(Capsule capsule)

// Возвращаемое значение: bool, true=пересекается
public bool IntersectsCapsule(Capsule capsule, out Vector3 delta)

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

Примечания:

• Данные должны содержать узлы Collider, и сначала должен быть вызван Renderer.SetColliderEnable(true).

Пример:

var capsule = new Capsule(footPos, headPos, 0.3f);
if (lccManager.IntersectsCapsule(capsule, out Vector3 delta))
{
    characterController.Move(delta);
}

Визуальные эффекты

TriggerVFX

public void TriggerVFX(Vector3 vfxOriginW, int vfxid = 0)

Запускает визуальный эффект в указанной мировой координате, распространяющийся наружу от этой координаты.

Примечания:

• Должен вызываться после завершения загрузки LCC-сцены.

Пример:

lccManager.TriggerVFX(hitPoint, 0);

Запросы экземпляров

GetAllRenderers

// Возвращаемое значение: List<Renderer>, копия всех зарегистрированных экземпляров Renderer
public List<Renderer> GetAllRenderers()

Получает список всех текущих зарегистрированных экземпляров Renderer (возвращает копию).

Пример:

var renderers = lccManager.GetAllRenderers();
foreach (var r in renderers) { /* ... */ }