XGRIDS文档
  • 简体中文
  • English
  • 繁體中文
  • 日本語
  • Deutsch
  • Español
  • Italiano
  • Français
  • Русский
  • 简体中文
  • English
  • 繁體中文
  • 日本語
  • Deutsch
  • Español
  • Italiano
  • Français
  • Русский
  • 灵视 P1

    • 产品概述
    • 设备基本操作
    • 使用 LCC Scan App
    • 维护及保养
    • 常见问题
  • 灵光 K 系列

    • 灵光 K1

      • 产品概述
      • 设备基本操作
      • 设备激活与连接
      • 设备采集
      • 获取绝对坐标点云数据
      • 地图融合
      • 典型场景路线规划建议
      • 注意事项
      • 常见问题
    • 灵光 K2

      • 产品概述
      • 设备基本操作
      • 设备激活与连接
      • 设备采集
      • 获取绝对坐标点云数据
      • 地图融合
      • 典型场景路线规划建议
      • 注意事项
      • 常见问题
  • 灵光 L 系列

    • 灵光 L2 Pro

      • 产品概述
      • 设备基本操作
      • 设备激活与连接
      • 设备采集
      • 获取绝对坐标点云数据
      • 实时测量功能
      • 附录
      • 常见问题
  • Lixel Studio

    • 版权
    • 安装与激活
    • 界面说明
    • 文件
    • 工程处理
    • 工具
    • 平面绘制
    • 行业应用
    • 设置
    • 设备感知
  • Lixel CyberColor

    • LCC Studio

      • 入门
      • 版本与更新
      • 下载与安装
      • 界面概览与导航
      • 重建前工作
      • 模型重建
      • 单模型重建
      • 地图融合
      • 空地融合
      • 航拍重建
      • 我的模型
      • 其他功能
      • 设置与账号
      • 转换工具
      • 视频重建
      • 常见问题 / FAQ
    • LCC Scene Editor

      • 版本与更新
      • 账号与登录
      • 产品概览与主页
      • 编辑器界面介绍
      • 三种场景漫游快捷操作
      • 文件
      • 设置
      • 编辑操作
      • 窗口
      • 视图工具栏
      • 资产与属性
      • 左侧工具栏
      • 视点
      • 跳转点
      • 天空盒
      • 标注
      • 测量
      • 场景漫游
      • 场景报告
      • 智能户型图(3D Layout)
      • 小地图
      • 预览模式(Viewer)
      • 帮助
      • 常见问题 / FAQ
      • 出生点
    • LCC Model Editor

      • 版本与更新
      • 新手指引
      • 概览与界面
      • 文件操作
      • 选择器
      • 编辑操作
      • 测量
      • 调色
      • 资产管理
      • 设置与帮助
      • 常见问题 / FAQ
    • 采集指南

      • 概述
      • 采集设备总览
      • 通用采集原则
      • 室内场景采集
      • 室外场景采集
      • 大场景采集(地图融合)
      • 空地融合采集
      • 物体采集
      • 人物采集
      • 视频重建采集
      • 高清补拍
      • 控制点(灵视 P1)
      • 常见问题与排查
    • 历史版本
  • Plugin & SDK

    • Unreal

      • 介绍
      • 快速入门 - Windows
      • 快速入门 - Linux
      • 快速入门 - Quest3
      • 版本与授权
      • 渲染
      • 画面调节
      • 法线与光照
      • 场景编辑
      • 性能参数说明
      • 性能优化指南
      • 第三方与引擎插件集成
      • 代理网格
      • 加载动画
      • 碰撞
      • 寻路系统支持
      • 单层水支持
      • 本地化
      • 常见问题
      • 故障排查
      • 日志与诊断
      • 联系我们
      • API 参考

        • ALCCActorBase
        • ULCCComponentBase
        • ULCCComponent
        • ULCC2Component
        • SOG / SPZ / PLY Actors
        • ALCC2ProxyMesh
        • ALCCClippingVolume
        • ALCCSectionPlane
        • ULCCUtilLibrary
        • Enums
        • Structs
      • 更新日志

        • v3.3.1
        • v3.0.0
        • v2.2.1
        • v1.0.0
        • v0.9.0
        • v0.8.0
        • v0.7.1
        • v0.6.1
        • v0.5.2
        • v0.4.1
        • v0.4.0
        • v0.3.0
        • v0.0.5
        • v0.0.4
        • v0.0.3
        • v0.0.2
        • v0.0.1
    • X-Brain 系列

      • 产品概述
      • 快速开始
      • 核心概念
      • 集成指南
      • API 参考
      • 数据类型
      • ROS2 桥接
      • 示例程序
      • 部署与网络
      • 排障与 FAQ
      • 版本与发布

3DGS 画面参数调节

本篇分为三部分:通用参数在两条管线上均可用;随后分别列出各管线独有的参数,这些参数在另一条管线的 Details 面板中不显示。

通用参数

渲染模式

3D Gaussian Splatting(默认)

以 2D 高斯椭圆渲染,具有完整的颜色和透明度。

LCCComponent->SetRenderMode(ERenderMode::Splatting);

点云

将每个 Splat 渲染为单个彩色点,适合概览或性能受限场景。

LCCComponent->SetRenderMode(ERenderMode::PointCloud);
3DGS 与点云渲染模式切换

在 3DGS 与点云渲染模式之间切换

点云模式支持高程着色:

  • ElevationColorBottom — 最低高程颜色
  • ElevationColorTop — 最高高程颜色
点云模式高程着色效果

点云模式的高程着色效果

加载模式

数据分为主体和环境两部分,通过 LoadMode 控制渲染哪一部分:

模式说明
Both渲染主体和环境(默认)
OnlyMain仅渲染主体
OnlyEnvironment仅渲染环境
None不渲染,数据保持加载
LoadMode 主体与环境渲染模式切换

切换 LoadMode 的主体与环境渲染范围

注:None 只停止渲染,数据仍占用显存。要释放资源需调用 UnLoad()。

光照模式

Unlit(不受光,默认)

仅使用高斯自身的颜色,不与场景光源交互。

Lit(受光)

启用延迟光照,3DGS 场景可被方向光、点光等影响。需要深度和法线信息。

LCCComponent->SetLightMode(ELightMode::Lit);
Unlit 与 Lit 光照模式切换

在 Unlit 与 Lit 光照模式之间切换

Mip Filter

启用后使用 2D 低通滤波器配合不透明度补偿,减少不同缩放下的闪烁。

默认值按数据格式区分:

格式默认值
.lcc2 / .lcc开启
.ply / .spz / .sog关闭

单文件格式默认关闭,是为了保留数据原始的锐利外观。出现闪烁时手动开启:

LCCComponent->SetUseMipFilter(true);

球谐系数(SH)

提供视角相关的颜色变化,提升光照保真度。

LCCComponent->SetUseShcoef(true);

要求:

  • 渲染模式为 3DGS
  • 数据本身包含 SH 系数

数据是否包含 SH 系数按格式区分:

格式判定方式
.lcc2 / .lcc由数据的文件类型决定,Quality 类型包含 SH,Portable 类型不包含
.ply / .spz / .sog无文件类型标识,取决于文件中是否实际写入了 SH 系数

数据不包含 SH 系数时,该开关在 Details 面板中不可用。

SplatScale

控制每个 Splat 四边形的大小,取值 0.001 ~ 1.0。

调小会减少单个 Splat 的屏幕覆盖面积,半透明叠加随之减少,像素填充成本下降;降得过多会让表面出现孔洞或明显变薄。它同时是性能调优的手段之一,详见性能优化指南。

LCCComponent->SetSplatScale(1.0f);
SplatScale 与 GlobalAlpha 设置

设置 Splat 缩放与 3DGS 全局透明度

全局透明度

两种渲染模式各有独立的全局透明度属性,取值均为 0.0 ~ 1.0:

属性适用模式
GlobalAlpha3DGS
GlobalAlpha_PointCloud点云
LCCComponent->SetGlobalAlpha(1.0f);
LCCComponent->SetGlobalAlpha_PointCloud(1.0f);
点云模式透明度设置

设置点云模式的全局透明度

颜色调整

LCC 颜色调整参数

配置 LCC 的饱和度、对比度与色调参数

支持运行时修改:

属性范围说明
Saturation0.0~2.0通道饱和度
Contrast0.0~2.0通道对比度
Gamma0.0~2.0通道 Gamma 校正
Offset-1.0~1.0加性颜色偏移
ColorTintLinearColor乘性色调
LCCComponent->SetSaturation(FVector4(1.2, 1.2, 1.2, 1.0));
LCCComponent->SetColorTint(FLinearColor::White);
颜色调整动态效果

动态调整颜色参数后的画面效果

抗锯齿

启用 bAffectAntiAliasingMethod 后,插件自动管理抗锯齿方法:

配置默认方法
LCC1 SplatFXAA
LCC2 SplatTSR
LCC1 Point CloudMSAA
LCC2 Point CloudTSR

可在 ProjectSettings > Plugins > LCC4Unreal 中修改默认值。

注:抗锯齿方法是视图级别的全局设置。场景中同时存在 LCC 管线与 LCC2 管线的 Actor 时,两者会分别按各自的配置设置抗锯齿方法,最终生效的取决于执行先后顺序,结果不确定。此类场景需在设置中将两条管线的抗锯齿方法手动配置为一致。

LCC4Unreal 抗锯齿设置

配置不同 LCC 管线的默认抗锯齿方法

后处理

LCC4Unreal 后处理设置

配置 LCC4Unreal 后处理与色调映射选项

设置默认值说明
Enable Post Process开启LCC 像素是否参与引擎后处理管线
Apply Tonemap Inverse关闭在色彩空间转换时应用 FilmToneMapInverse,使引擎色调映射后仍还原数据原本的外观

这些是全局配置,位于 ProjectSettings > Plugins > LCC4Unreal > Rendering,对两条管线均生效。场景中所有 LCC 组件共用同一模式,无法按 Actor 单独设置。

Enable Post Process 关闭后的效果

两种状态的处理方式不同:

状态处理方式结果
开启对 LCC 像素应用 InverseACES,使其进入引擎后处理管线3DGS 与场景中的常规物体一同接受色调映射、Bloom、曝光、色彩分级等后处理
关闭色调映射前保存一份快照,色调映射完成后按 Alpha 混合回画面3DGS 保持原始色彩,不受色调映射及其之后的后处理环节影响

关闭适用于需要严格还原数据原始色彩的场合,例如色彩校验、与参考图比对。代价是 3DGS 与场景中常规物体的观感不再统一,画面整体的后处理效果(如 Bloom、曝光)不会作用于 3DGS 部分。

注:关闭 Enable Post Process 需要引擎开启 Alpha 通道输出,否则合成结果不正确。在 ProjectSettings > Engine > Rendering 中启用 Alpha Output(UE 5.4 及更早版本对应「Enable alpha channel support in post processing」,需设为 Linear color space only 并重启编辑器)。插件在检测到该项未开启时会弹出提示。

Apply Tonemap Inverse 的作用

3DGS 数据的颜色是采集时已完成色调映射的成品色。这类颜色再次经过引擎的色调映射后会被二次压缩,通常表现为对比度下降、高光偏灰。

开启该项后,插件在色彩空间转换阶段对 LCC 颜色应用 FilmToneMapInverse,预先抵消引擎后续的色调映射,使最终画面还原数据原本的外观。

状态适用场景
关闭(默认)3DGS 与场景中常规物体走同一套色调映射,整体观感统一
开启需要 3DGS 呈现数据原本的色彩与对比度

该项对两条管线均生效,且仅在 Enable Post Process 开启时有意义——关闭后 3DGS 本就不参与色调映射,无需抵消。

LCC2 管线专有参数

深度阈值

AlphaThreshold 决定 3DGS 向深度缓冲写入哪一层的深度。3DGS 由多层半透明 splat 叠加而成,插件按由近及远累积不透明度,累积值达到该阈值时,将当前深度记录为该像素的代表深度。

项目值
取值范围0.01 ~ 0.99
默认值0.5

调低使深度偏向相机,调高使深度偏离相机。该深度参与光照、遮挡判断以及依赖深度的后处理,因此 Lit 模式下的表面响应、与常规网格的相互遮挡都会随之变化。

LCC2Component->AlphaThreshold = 0.5f;

需要调低的典型情况:数据中存在透明度很低的薄结构,例如昆虫或鸟类的翅膀、纱网、树叶边缘。这类区域的 splat 累积不透明度始终达不到默认的 0.5,因而不会写入深度。若场景中同时存在天空盒、雾等非纯黑背景,这些区域会因缺少深度而被背景色混合进来,表现为结构变淡、细节丢失。将阈值调低可让这类区域尽早写入深度,恢复细节。

调整时逐步下调并观察,过低会使深度整体贴近相机,影响遮挡关系与依赖深度的后处理。

注:该属性位于 Details 面板的 Advanced 折叠区,默认值适用于多数场景。

LCC 管线专有参数

阴影接收

LCCComponent->bReceiveShadows = true;

注:需渲染模式为 3DGS。开启后对性能影响较大。

3DGS 接收阴影效果

启用阴影接收后的 3DGS 渲染效果

接缝裁切

bEnableSeamCutting 用于裁切分块渲染在节点交界处产生的接缝。LCC 数据版本 5.0 及以上会自动启用,低版本数据出现可见接缝时手动开启。

LCCComponent->bEnableSeamCutting = true;

注:该属性位于 Details 面板的 Advanced 折叠区。

多 Actor 半透排序

LCC 管线不输出深度,多个 LCC Actor 之间无法通过深度测试得到正确的相互遮挡,只能依靠半透绘制顺序近似。bEnableMultipleLCCActorAutoSort(默认开启)会按 Actor 到相机的距离自动设置 TranslucentSortPriority,让较近的 Actor 后绘制,从而在多数情况下得到合理的叠加结果。

该排序的粒度是 Actor 级别:每个 Actor 整体参与排序,不细分到 splat。因此存在固有限制:

  • 两个 LCC Actor 的包围盒在空间上相互交叉、穿插时,无法用一个整体顺序表达正确的前后关系,交叉区域的遮挡会出错
  • 单个 Actor 内部跨越很大深度范围时,按 Actor 中心距离排序的结果可能与实际前后关系不符

需要多个 3DGS 正确相互遮挡时,改用 LCC2 管线。需要手动指定叠加顺序时关闭该项,改为自行设置各 Actor 的 TranslucentSortPriority。

LCC2 管线不提供该属性,其数据汇总到统一 Buffer 后按 splat 全局排序,并输出深度参与遮挡判断,无需干预。

上一页
渲染
下一页
法线与光照