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

    • 灵视 P1

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

    • 灵光 K1

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

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

    • 灵光 L2 Pro

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

      • 产品概述
      • 设备基本功能
      • 设备激活与连接
      • 设备采集
      • 获取绝对坐标点云数据操作流程
      • 附录
  • 配件

    • 补光灯

      • 安装指导
      • 基本操作
      • 常见问题
  • Lixel Studio

    • 版权
    • 安装与激活
    • 界面说明
    • 文件
    • 工程处理
    • 工具
    • 平面绘制
    • 行业应用
    • 设置
    • 设备感知
    • 常见问题
    • 使用技巧

      • 数据流全景图
      • 软件授权全景指南
      • 读懂扫描仪精度指标
  • Lixel CyberColor

    • LCC Studio

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

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

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

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

      • 产品概要说明
      • 基本架构说明书
      • 安装部署说明书
      • 容器启动参数说明书
      • CodeMeter离线授权部署说明书
      • API指令集说明书
      • 附录-开发者数据说明书
      • 附录-错误码列表
      • 单机多卡集群部署QuickStart
    • 使用技巧

      • 多个大型 3DGS 模型融合工作流
      • 空地融合操作方法
      • 数据流全景图
      • 软件授权全景指南
    • 历史版本
  • Plugin & SDK

    • Unreal

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

        • 用 LixelStudio 网格为 3DGS 重打光
        • 逐相机独立渲染
      • API 参考

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

        • v3.5.0
        • v3.4.0
        • 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
    • Unity

      • Unity SDK 简介
      • 技术特性
      • 开发环境要求
      • PC 快速开发入门指南
      • 工程设置优化指南
      • Pico 4 Ultra 开发指南
      • Pico 4 Ultra PC 串流指南
      • Quest 3 开发指南
      • Quest 3 PC 串流指南
      • OpenXR 开发指南
      • Pico 4 Ultra 企业串流指南
      • 术语表
      • 常见问题
      • 联系我们
      • 功能开发指南

        • 多场景混合渲染开发指南
        • 阴影接收开发指南
        • 实时光照开发指南
        • 多相机渲染开发指南
        • 高清图像渲染开发指南
        • LCC 与 LCC2 数据格式兼容开发指南
        • 加载特效开发指南
        • Mip 渲染模式切换开发指南
        • 边角点吸附开发指南
        • 投影贴花开发指南
        • 视频流投影开发指南
        • 高亮显示开发指南
        • 实时裁剪开发指南
        • 调色开发指南
        • 获取场景 Mesh 数据开发指南
        • 编辑器模式开发指南
        • 渲染性能参数设置指南
        • 应用与数据协同打包开发指南
        • 碰撞系统开发指南
        • macOS 开发权限问题操作指南
        • iOS 设备编译打包开发指南
      • API 参考

        • LCCManager
        • Renderer
        • 数据类型
      • 更新日志

        • v2.3.0
        • v2.2.10
        • v2.2.0
        • v2.1.19
        • v2.0.14
    • X-Brain

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

      • 介绍
      • 渲染性能优化指南
      • 显卡配置
      • webgpu开发指南
      • 常见开发问题
      • API参考

        • LCCObject::checkRenderNextFrame
        • LCCObject::clearRenderNextFrame
        • LCCObject::ecef2Prj
        • LCCObject::getBounds
        • LCCObject::getEnvInstancedMesh
        • LCCObject::getInstancedMesh
        • LCCObject::getLodInfos
        • LCCObject::getOriginPosition
        • LCCObject::getProjectionCoordinateSystemInfos
        • LCCObject::hasCollision
        • LCCObject::hasEnvironment
        • LCCObject::hasShcoef
        • LCCObject::intersectsCapsule
        • LCCObject::intersectsRayExt
        • LCCObject::intersectsRayFromOriginExt
        • LCCObject::intersectsSphere
        • LCCObject::lowerToBottom
        • LCCObject::prj2Ecef
        • LCCObject::raiseToTop
        • LCCObject::raycast
        • LCCObject::raycastFromOrigin
        • LCCObject::setAlpha
        • LCCObject::setClipBox
        • LCCObject::setClipPlane
        • LCCObject::setClipPrism
        • LCCObject::setEndLod
        • LCCObject::setLodAutoLevelUp
        • LCCObject::setMaxDistance
        • LCCObject::setMaxNodeSplats
        • LCCObject::setMaxSplats
        • LCCObject::setMipFilter
        • LCCObject::setOriginPosition
        • LCCObject::setPointsColor
        • LCCObject::setRenderState
        • LCCObject::setRotation
        • LCCObject::setScale
        • LCCObject::setSemantic
        • LCCObject::setSemanticColor
        • LCCObject::setSmooth
        • LCCObject::setStartLod
        • LCCObject::setTranslation
        • LCCObject::setVisible
        • LCCObject::togglePointsDisplayMode
        • LCCObject::useEnvironment
        • LCCObject::useShcoef
        • LCCRender::clearIndexDB
        • LCCRender::dispose
        • LCCRender::load
        • LCCRender::setCamera
        • LCCRender::unload
        • LCCRender::update
      • 更新日志

        • v0.6.4
        • v0.6.3
        • v0.6.2
        • v0.6.1
        • v0.6.0
        • v0.5.5
        • v0.5.4
        • v0.5.3
        • v0.5.2
        • v0.5.1
        • v0.5.0
        • v0.4.1
        • v0.4.0
        • v0.3.1
        • v0.3.0
        • v0.2.0
    • Lixel OpenAPI

      • 概述
      • 连接与鉴权
      • 消息模型与编解码
      • 接口清单
      • 实时数据
      • 项目文件访问
      • 错误码
      • Python

        • 快速开始
        • 客户端封装与工具
        • 常见问题
      • C++

        • 快速开始
        • 客户端与示例
        • 常见问题
  • API

    • 空间结构化建模

      • 接入指南
      • 建模流程
      • 接口说明
      • 临时上传凭证
      • 错误码

软件授权全景指南

面向对象:Lixel Studio / LCC Studio / LCC Linux 的付费用户、代理商、售后与售前工程师。 覆盖范围:激活码申请、SN 填写、加密狗使用、换机迁移、版本差异、常见激活失败排查。

授权方式总览

软件版本包获取方式授权方式授权时长绑定粒度数量规则换机迁移
Lixel Studio无区分官网免费版:无激活码无无不限换设备下载安装即可
激活码,在线激活1 个月 / 3 个月 / 6 个月 / 一年 / 永久单台电脑(机器码)一台设备 SN 配 3 个激活码权限迁移功能(需联网)
离线授权文件激活1 个月 / 3 个月 / 6 个月 / 一年 / 永久单台电脑(机器码)一台设备 SN 配 3 个激活码权限迁移功能(需联网)
LCC Studio在线包官网基础版:注册账号无账号(同时登录数)同时登录最多 2 台电脑换设备重登即可
在线包官网进阶/专业版:激活码 / 账号授权1 个月 / 3 个月 / 6 个月 / 一年 / 永久账号(同时登录数)同时登录最多 2 台电脑换电脑登录同一账号即可
离线包邮件 + 邮寄USB 加密狗(dongle)1 个月 / 3 个月 / 6 个月 / 一年 / 永久加密狗本身一狗对应一次授权拔狗插到新电脑即可
LCC Linux在线邮件 + 邮寄USB 加密狗(dongle)1 个月 / 3 个月 / 6 个月 / 一年 / 永久加密狗本身按采购容器数量拔狗插到主节点电脑即可
离线邮件 + 邮寄USB 加密狗(dongle)1 个月 / 3 个月 / 6 个月 / 一年 / 永久加密狗本身按采购容器数量拔狗插到主节点电脑即可

注:

  • 版本区分标准:在线与离线安装包不同。
  • 各软件均可申请试用激活码,最低期限为 7 天,请联系销售或经销商。
  • P1 设备无需使用 Lixel Studio 激活码,因此无法获取或申请。

核心概念辨析

SN 号、机器码与激活码

名词概念查询位置用途
SN 号(设备序列号)采集设备本身的唯一编号设备铭牌 / Lixel Go 连接设备后查看用来申请激活码
机器码安装 Lixel Studio / LCC Studio 那台电脑的硬件指纹软件「授权激活」页面激活码绑定到这个机器码上
激活码一串字符串授权凭证申请的邮箱、销售发放Lixel Studio:一码激活一台电脑(绑机器码);LCC Studio 在线永久版:一码绑账号,账号可同时登录多台电脑

关系:

  • Lixel Studio:一台采集设备 SN → 申请 3 个激活码 → 每个激活码激活一台电脑(绑机器码)。
  • LCC Studio 在线永久版:一个账号采集设备 → 申请 1 个激活码 → 激活码绑账号 → 账号同时登录最多 2 台电脑。

激活码与加密狗

激活码方式加密狗方式
授权载体一串字符一个 USB 硬件
是否需要联网首次激活需联网校验完全离线可用
绑定对象电脑机器码(Lixel Studio)/ 账号(LCC Studio 在线永久版)加密狗本身
换电脑Lixel Studio:走授权迁出;LCC Studio 在线永久:换电脑登录同一账号即可直接拔狗插到新电脑即用
适用场景常规办公电脑保密现场、内网机、频繁换机的工作站

免费版与永久版

  • 免费版(Lixel Studio 与 LCC Studio 均提供):注册 XGRIDS 账号后即可下载使用,功能受限,适用于入门试用与教学演示。
  • 永久版:功能完整,需付费购买激活码或加密狗。

功能差异明细以对应软件的产品页或官方手册为准,本文不逐项列出。

Lixel Studio 授权

免费版

  • 官网下载后注册 XGRIDS 账号,登录即可使用。
  • 功能范围:点云查看编辑、格式转换、平面绘制、导出等基础功能可用;工程处理和地图融合功能置灰。
  • 不消耗激活码。

永久版申请流程

  1. 购买采集设备(K1 / K2 / L2 Pro / L3),记录设备 SN 号。
  2. 在 Lixel Go 中查看完整 SN,以避免手工抄录出错。
  3. 在线提交表单申请永久激活码,或由销售提供。
  4. 收到激活码后,打开 Lixel Studio 官网最新版本,依次进入设置 → 授权激活,输入激活码完成激活。

注:每台采集设备 SN 号可申请 3 个永久激活码,可分配至最多 3 台电脑。软件激活后,卸载重装或更新版本均不影响授权,无需重新激活。

换电脑迁移

版本要求:Lixel Studio 支持权限迁移的版本及以上方可使用该功能。

迁出步骤(在原电脑上操作):

  1. 打开 Lixel Studio,依次进入设置 → 授权激活 → 权限迁出 → 生成 → 弹窗确认导出位置。
  2. 导出包含新激活码的文本文件(.txt),妥善保存。
  3. 完成后,原电脑上的授权自动失效,立即变为免费版。

迁入步骤(在新电脑上操作):

  1. 使用导出的新激活码在新电脑上完成激活。

注:权限迁移不限次数,且不改变授权原有的有效期。若软件系在较早版本激活,权限迁出时可能失败,此时需联系销售经理获取新激活码。

注:若在迁出前直接卸载软件、格式化磁盘或未完成「生成」路径保存步骤,原激活码将无法解绑或找回。此时需使用另一个可用激活码,或联系销售申请新的激活码。

SN 填写规则

  • 须使用已购买设备的 SN;借测设备或试用软件需联系销售(经销商或出借设备所有人)提供的试用激活码。
  • SN 大小写敏感,且不得包含空格。
  • 须区分字母 O 与数字 0、字母 I 与数字 1、字母 l 与数字 1。
  • 中国大陆区设备须使用中文版 Lixel Studio 激活,中国大陆境外国际区设备须使用英文版激活;版本不匹配将提示 SN 错误。

LCC Studio 授权

版本矩阵

版本授权方式适用场景
基础版XGRIDS 账号入门试用、教学、演示(单场景)
在线版(试用或永久的进阶版、专业版)XGRIDS 账号 / 激活码联网办公环境
离线版(试用或永久的进阶版、专业版)USB 加密狗保密现场、内网机、禁网办公室

基础版说明

  • 注册 XGRIDS 账号后即可下载登录使用。
  • 无需额外购买,无需激活码。

在线版

核心规则:

  • 采用账号 / 激活码按时长授权。
  • 激活码与账号绑定,同一账号可同时登录最多 2 台电脑。
  • 换电脑无需迁移,在新电脑上登录同一账号即可。
  • 需联网校验(含首次激活及日常登录)。

换电脑场景:

  • 登录设备在 2 台以内:直接在新电脑上使用同一账号登录,无需迁移操作。
  • 已登录 2 台,需在第 3 台使用:第 3 台登录后,会提示已超出最大设备数,请退出其他设备后重试。

注:LCC Studio 永久在线版采用 1 个激活码绑定账号;同一账号可同时登录最多 2 台电脑。换电脑无需迁移,在新电脑上登录同一账号即可。

离线版

核心规则:

  • 授权时长信息保存于加密狗(USB Dongle)自身,需要安装好 Codemeter 软件才能被软件识别。
  • 加密狗插入任一电脑,该电脑即可使用 LCC Studio,不绑定机器码、不绑定账号、无需联网。
  • 换电脑时,直接拔下加密狗插入新电脑即可,无需迁移操作。
  • 一台加密狗同一时间仅能激活一台电脑(即插入加密狗的电脑)。

适用场景:

  • 保密现场、内网机等无法联网的工作环境。
  • 需频繁更换作业电脑的场景。
  • 客户对授权绑定账号或绑定机器存在顾虑的情形。

补充说明:

  • 离线版功能与在线版一致,共用同一份手册。
  • 离线版软件包与手册不对外单独提供,需通过销售获取。
  • 免费版无需加密狗,仅永久版涉及加密狗。

注:LCC Studio 离线版通过 USB 加密狗授权,加密狗插入任一电脑即可在该电脑使用。换电脑无需迁移,拔下加密狗插入新电脑即可继续使用。同一时间仅能激活一台电脑(即插入加密狗的电脑)。

加密狗首次使用

基本步骤:

  1. 安装好 Codemeter,将加密狗插入电脑 USB 接口。
  2. 启动 LCC Studio(离线版)。
  3. 软件检测到加密狗后即完成授权,无需输入激活码。

未识别时的排查顺序:

  1. 更换 USB 接口(避免使用 USB Hub,优先使用主板直连接口)。
  2. 在设备管理器中确认加密狗是否被识别为 USB 设备。
  3. 以管理员身份运行 LCC Studio。
  4. 确认是否已安装对应型号加密狗所需的驱动。
  5. 若启动时提示「运行此软件需要许可 Codemeter」,需从 Wibu 官网下载并安装 Codemeter 后重试。
  6. 若仍无法识别,提交技术支持,并附加密狗型号照片与设备管理器截图。

LCC Linux 授权

LCC Linux 版本以 Docker 容器方式私有化部署,采用 CodeMeter 许可授权,授权模型与 Windows 桌面版不同。

授权机制

  • 在私有机房内选定一台机器作为授权服务器(支持 Windows 或 Linux)。
  • 授权服务器导入的许可点数即为可并发运行的重建容器数量:导入 N 个许可点,即支持 N 个 LCC 容器同时运行。
  • 各算力服务器上的容器在启动时向授权服务器申请许可,运行结束后自动归还,许可可被后续任务复用。
  • 授权载体分为两种:
    • USB 加密狗:由 XGRIDS 提供,插入授权服务器即可使用。
    • 软授权:无法使用加密狗时,由 XGRIDS 针对指定服务器的硬件特征生成并绑定。
  • 授权时长提供 1 月、3 月、6 月、1 年和永久多种,按采购的许可节点数量授权。用户授权过期可以继续申请采购,无需重新部署。

在线与离线授权的适用场景

注:离线授权面向无法连接外网的私有机房,通过机房内部的授权服务器完成授权分发,无需访问公网。

使用注意事项

  • 软授权与硬件绑定:软授权绑定授权服务器的硬件特征,不可迁移至其他机器。若部署于虚拟机,应保持所在物理机及其主要硬件(CPU、主板、网卡等)不变,否则授权将失效。
  • 妥善保存授权文件:每次交付的授权升级文件请妥善留存。若因重装系统等原因导致授权失效,需按交付顺序依次重新导入全部授权文件方可恢复。
  • 授权服务器唯一:仅在选定的授权服务器上部署授权服务,其余算力服务器不应安装 CodeMeter 运行环境,以免影响容器正常获取网络授权。
  • 网络连通:各算力服务器需能够访问授权服务器的授权服务端口;容器建议保持默认的桥接(Bridge)网络模式,以保证与授权服务器正常通信。
  • 许可释放:容器正常结束后许可将在数分钟内自动释放;若容器异常终止,许可将在设定的超时时间后释放,亦可在授权服务器端手动释放。

注:具体部署操作及环境配置请参考 LCC Linux 版本官方部署文档,或联系 XGRIDS 技术支持。

常见错误与排查

Lixel Studio 激活码在线申请提示「请输入正确的 SN」

排查顺序:

  1. 检查 SN 号码前后是否含多余空格。
  2. 检查是否混淆了字母 O 与数字 0、字母 I 与数字 1、字母 l 与数字 1。
  3. 确认设备是否为已购买设备(借测设备需使用试用激活码)。
  4. 确认中英文版本是否匹配(国内设备与国际设备须对应)。
  5. 若上述均正确仍失败,提交技术支持并附 SN 截图。

换电脑前未迁移,Lixel Studio 原激活码的处理

原激活码无法解绑,亦无法找回。处理方式有二:

  • 使用另一个未使用的激活码(每台设备共 3 个)。
  • 若 3 个激活码均已用完,联系销售申请新的激活码或补发方案。

加密狗未识别

排查顺序:

  1. 确认是否已安装加密狗驱动。
  2. 更换 USB 接口(避免使用 USB Hub,优先使用主板直连接口)。
  3. 在设备管理器中确认加密狗是否被识别。
  4. 以管理员身份运行软件。
  5. 若提示需要许可 Codemeter,从 Wibu 官网下载并安装 Codemeter 后重试。
  6. 若仍无法解决,提交技术支持。

中英文版本安装错误

  • 中国大陆区设备 SN 须使用中文版 Lixel Studio / LCC Studio。
  • 中国大陆境外的国际区设备 SN 须使用英文版。
  • 版本安装错误将提示 SN 错误,卸载后重装对应语言版本即可。

免费版功能置灰不可用

  • 授权失效、过期会变回免费版。
  • 部分功能为永久版专属,免费版不含。
  • 免费版功能范围以对应软件产品页公告为准。
  • 如需使用永久版功能,须购买永久激活码或加密狗。

需转人工处理的情形

以下情形需转技术支持人工处理:

  • 激活码全部用完且原因不明。
  • 加密狗损坏或丢失。
  • 客户购买记录与 SN 不匹配。
  • 提示「激活码已被使用」,但客户表示从未激活。
  • 需申请临时试用授权(借测、评估、演示)。
  • 出现系统级异常(黑屏、闪退、界面无响应)。

技术支持入口:https://www.xgrids.cn/technical-support

术语表

  • SN(Serial Number):设备序列号,采集设备的身份标识。
  • 机器码:电脑硬件指纹,软件据此绑定授权。
  • 激活码 / 注册码:软件授权凭证字符串。
  • 加密狗(Dongle):USB 硬件形式的软件授权载体。
  • 权限迁移:Lixel Studio 提供的将授权由原电脑转移至新电脑的官方流程。
  • Codemeter:加密狗(Dongle)授权所依赖的运行时组件,由 Wibu 提供。