XGRIDSDocumentación
  • 简体中文
  • English
  • 繁體中文
  • 日本語
  • Deutsch
  • Español
  • Italiano
  • Français
  • Русский
  • 简体中文
  • English
  • 繁體中文
  • 日本語
  • Deutsch
  • Español
  • Italiano
  • Français
  • Русский
  • PortalCam

    • Descripción del producto
    • Operaciones básicas
    • Uso de la LCC Scan App
    • Mantenimiento y cuidado
    • FAQ
  • Serie Lixel K

    • Lixel K1

      • Descripción del producto
      • Operaciones básicas
      • Activación y conexión del dispositivo
      • Flujo de escaneo
      • Obtener nube de puntos con coordenadas absolutas
      • Fusión de mapas
      • Recomendaciones de planificación de rutas para escenas típicas
      • Precauciones
      • FAQ
    • Lixel K2

      • Descripción del producto
      • Operaciones básicas
      • Activación y conexión
      • Flujo de escaneo
      • Obtener nube de puntos con coordenadas absolutas
      • Fusión de mapas
      • Recomendaciones de planificación de rutas para escenas típicas
      • Precauciones
      • FAQ
  • Serie Lixel L

    • Lixel L2 Pro

      • Descripción del producto
      • Operaciones básicas
      • Activación y conexión del dispositivo
      • Flujo de escaneo
      • Obtener nube de puntos con coordenadas absolutas
      • Punto de medición
      • Apéndice
      • FAQ
  • Accesorios

    • Stick Light

      • Guía de instalación
      • Operaciones básicas
      • Preguntas frecuentes
  • Lixel Studio

    • Versión y derechos de autor
    • Instalación y activación
    • Interfaz del software
    • Operaciones de archivo
    • Procesamiento de proyectos
    • Herramientas
    • Dibujo 2D
    • Aplicaciones
    • Ajustes
    • Conexión de dispositivo
  • Lixel CyberColor

    • LCC Studio

      • Primeros pasos
      • Versión y actualizaciones
      • Descarga e instalación
      • Descripción general de la interfaz y navegación
      • Antes de la reconstrucción
      • Reconstrucción de modelos
      • Reconstrucción de modelo único
      • Fusión de mapas
      • Fusión aire-tierra
      • Reconstrucción aérea
      • Mis modelos
      • Otras funciones
      • Ajustes y cuenta
      • Converter
      • Reconstrucción por vídeo
      • Preguntas frecuentes
    • LCC Scene Editor

      • Versión y actualizaciones
      • Cuenta e inicio de sesión
      • Descripción general del producto y página de inicio
      • Interfaz del editor
      • Modos de navegación
      • Archivo
      • Configuración
      • Editar
      • Ventana
      • Barra de herramientas global
      • Activos y propiedades
      • Barra de herramientas izquierda
      • Puntos de vista
      • Portal
      • Skybox
      • Anotaciones
      • Medición
      • Flythrough
      • Informe de escena
      • 3D Layout
      • Minimapa
      • Modo Vista previa (Viewer)
      • Ayuda
      • Preguntas frecuentes (FAQ)
      • Punto de inicio
    • LCC Model Editor

      • Versión y actualizaciones
      • Guía del usuario
      • Visión general e interfaz
      • Operaciones de archivo
      • Selectores
      • Edición de modelos
      • Medición
      • Corrección de color
      • Gestión de activos
      • Configuración y ayuda
      • Preguntas frecuentes
    • Capture Guide

      • Descripción general
      • Descripción general de los dispositivos de captura
      • Principios generales de captura
      • Captura de escenas interiores
      • Captura de escenas exteriores
      • Captura a gran escala (Map Fusion)
      • Captura con aerial-ground map fusion
      • Captura de objetos
      • Captura de personas
      • Captura para reconstrucción a partir de vídeo
      • HD Enhancement
      • Puntos de control (Lixel P1)
      • Preguntas frecuentes y resolución de problemas
    • Historial de versiones
  • Plugins y SDK

    • Unreal

      • Introducción
      • Inicio rápido - Windows
      • Inicio rápido - Linux
      • Inicio rápido - Quest3
      • Ediciones y licencias
      • Renderizado
      • Ajustes visuales
      • Normales e iluminación
      • Edición de escenas
      • Parámetros de rendimiento
      • Guía de rendimiento
      • Integración con plugins de terceros y del motor
      • Proxy Mesh
      • Animación de carga
      • Colisión
      • Compatibilidad con Navigation System
      • Compatibilidad con Single Layer Water
      • Localización
      • Preguntas frecuentes
      • Resolución de problemas
      • Logs y diagnóstico
      • Contacto
      • Referencia de API

        • ALCCActorBase
        • ULCCComponentBase
        • ULCCComponent
        • ULCC2Component
        • Actors SOG / SPZ / PLY
        • ALCC2ProxyMesh
        • ALCCClippingVolume
        • ALCCSectionPlane
        • ULCCUtilLibrary
        • Enumeraciones
        • Structs
      • Registro de cambios

        • 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
    • Web

      • Introducción
      • Guía de optimización del rendimiento de renderizado
      • Configuración de gráficos
      • Preguntas frecuentes
      • Referencia de API

        • LCCRender::clearIndexDB
        • LCCRender::dispose
        • LCCRender::load
        • LCCRender::setCamera
        • LCCRender::unload
        • LCCRender::update
        • 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::setEndLod
        • LCCObject::setLodAutoLevelUp
        • LCCObject::setMaxDistance
        • LCCObject::setMaxNodeSplats
        • LCCObject::setMaxSplats
        • 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
      • Registro de cambios

        • 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

LCCRender::load

Carga datos LCC y devuelve un LCCObject.

El Web SDK soporta los motores Three.js y CesiumJS. Pase los parámetros del motor correspondiente para cargar un modelo LCC.

Requisito de versión

SDK v0.2.0+

Compatibilidad de motor

Three.js / CesiumJS

API

LCCRender::load(param: LoadOptions, successFunc: SuccessFunc, progressFunc: ProgressFunc, failureFunc: FailureFunc, preProcessFunc?: PreProcessFunc): LCCObject

Parámetros

param (Three.js)

ParámetroTipoObligatorioPredeterminadoDescripción
param.cameraTHREE.PerspectiveCamera / THREE.OrthographicCameraSí-Objeto de cámara de Three.js.
param.sceneTHREE.SceneSí-Objeto de escena de Three.js.
param.renderLibTHREESí-Referencia a la biblioteca Three.js, p. ej., import * as THREE from 'three'.
param.renderLibWebgputypeof import('three/webgpu')No-Referencia al módulo WebGPU de Three.js, p. ej., import * as THREE_WEBGPU from 'three/webgpu'.
param.renderLibTSLtypeof import('three/tsl')No-Referencia al módulo TSL de Three.js, p. ej., import * as TSL from 'three/tsl'.
param.rendererTHREE.WebGLRendererSí-Renderizador de Three.js.
param.dataPathString / ObjectSí-Ruta de datos LCC. Soporta ruta de cadena (.lcc / .lcc2 / meta.lcc con token) u objeto descriptor de ruta.
param.canvasHTMLCanvasElementSí-Elemento canvas para renderizado, disponible mediante renderer.domElement.
param.appKeyStringNo-AppKey para eliminar la marca de agua.
param.useEnvBooleanNo-Si se muestran los datos de entorno.
param.useIndexDBBooleanNotrueSi se habilita el almacenamiento en caché local de datos. SDK v0.5.0+
param.useLoadingEffectBooleanNofalseSi se habilitan los efectos de carga. SDK v0.5.1+
param.loadingEffectCenter{ x: number, y: number, z: number }No-Posición central del efecto de carga. SDK v0.5.1+
param.pointsColorStringNo'default'Estilo de visualización de nube de puntos: 'default' (color original) o 'rainbow' (color por elevación).
param.modelMatrixTHREE.Matrix4No-Matriz del modelo. SDK v0.5.2+
param.maxHostCacheSizenumberNo-Tamaño de caché del host. SDK v0.5.4+
param.maxGpuCacheSizenumberNo-Tamaño de caché de GPU. SDK v0.5.4+
param.usePrecisionRaycastBooleanNotrue (PC)Habilitar raycasting de alta precisión. Habilitado por defecto en PC; no soportado en móvil. SDK v0.6.3+

param (CesiumJS)

ParámetroTipoObligatorioPredeterminadoDescripción
param.cameraCesium.CameraSí-Objeto de cámara de Cesium.
param.sceneCesium.SceneSí-Objeto de escena de Cesium.
param.renderLibCesiumSí-Referencia a la biblioteca CesiumJS, p. ej., import * as Cesium from 'cesium'.
param.dataPathString / ObjectSí-Ruta de datos LCC. Soporta ruta de cadena (.lcc / .lcc2 / meta.lcc con token) u objeto descriptor de ruta.
param.canvasHTMLCanvasElementSí-Elemento canvas para renderizado, disponible mediante viewer.scene.canvas.
param.modelMatrixCesium.Matrix4No-Matriz de transformación del modelo. No requerida para datos georreferenciados con RTK.
param.appKeyStringNo-AppKey para eliminar la marca de agua.
param.useEnvBooleanNo-Si se muestran los datos de entorno.
param.useIndexDBBooleanNotrueSi se habilita el almacenamiento en caché local de datos. SDK v0.5.0+
param.useLoadingEffectBooleanNofalseSi se habilitan los efectos de carga. SDK v0.5.1+
param.loadingEffectCenter{ x: number, y: number, z: number }No-Posición central del efecto de carga. SDK v0.5.1+
param.pointsColorStringNo'default'Estilo de visualización de nube de puntos: 'default' (color original) o 'rainbow' (color por elevación).
param.maxHostCacheSizenumberNo-Tamaño de caché del host. SDK v0.5.4+
param.maxGpuCacheSizenumberNo-Tamaño de caché de GPU. SDK v0.5.4+
param.usePrecisionRaycastBooleanNotrue (PC)Habilitar raycasting de alta precisión. Habilitado por defecto en PC; no soportado en móvil. SDK v0.6.3+

Funciones de callback

ParámetroTipoObligatorioDescripción
successFunc(model: any) => voidSíCallback de éxito de carga del modelo. El parámetro es la malla construida.
progressFunc(progress: number) => voidSíCallback de progreso de carga del modelo. El parámetro es el porcentaje (0–1).
failureFunc() => voidSíCallback de fallo de carga del modelo.
preProcessFunc(buffer: ArrayBuffer, filename: string) => Promise<{ data: ArrayBuffer; rawData: ArrayBuffer }>NoCallback de preprocesamiento de datos para procesar datos antes del renderizado. SDK v0.5.0+

Formato de dataPath

dataPath soporta dos formatos:

Opción 1: Ruta de cadena (recomendado)

Pase una cadena directamente especificando la ruta de datos LCC:

  • Ruta completa de archivo .lcc, p. ej., http://example.com/data/xxxx.lcc. SDK v0.4.1+ (recomendado)
  • Ruta completa de archivo .lcc2, p. ej., http://example.com/data/xxxx.lcc2. SDK v0.6.0+ (recomendado)
  • Ruta de archivo meta.lcc con token y otros parámetros para escenarios de datos encriptados, p. ej., https://example.com/data/meta.lcc?token=xxx&other=xxx
  • Ruta de directorio que requiere un archivo meta.lcc en el directorio, p. ej., https://example.com/data (obsoleto)
const lccObject = LCCRender.load({
    // ...other params
    dataPath: 'http://example.com/data/xxxx.lcc',
}, successFunc, progressFunc, failureFunc);

Opción 2: Colección de descriptores de ruta (SDK v0.5.0+)

Use un objeto para personalizar todas las rutas de archivos con soporte de encriptación, aplicable al formato LCC.

Formato del descriptor de ruta de archivo:

{
    "fileName": {
        "url": "xxxxxxxxxxxx",
        "header": { "field1": "xxx", "field2": "yyy" }  // Optional, added to HTTP request headers
    }
}

Ejemplo:

const dataPath = {
    meta: { url: 'http://example.com/xxx/meta.lcc' },
    index: { url: 'http://example.com/xxx/index.bin' },
    data: { url: 'http://example.com/xxx/data.bin' },
    environment: { url: 'http://example.com/xxx/environment.bin' },
    collision: { url: 'http://example.com/xxx/collision.lci' },
    shcoef: { url: 'http://example.com/xxx/shcoef.bin' },
};

const lccObject = LCCRender.load({
    // ...other params
    dataPath: dataPath,
}, successFunc, progressFunc, failureFunc);

Valor de retorno

LCCObject — Objeto del modelo LCC con interfaces para raycasting, recorte, control de renderizado y más.

Notas

  • El motor Three.js requiere llamar a LCCRender.update() en el bucle de renderizado.
  • El parámetro param.useSH está obsoleto; use el método LCCObject.useShcoef() en su lugar.
  • El parámetro param.gpuAcceleration está obsoleto.
  • dataPath soporta formato .lcc (SDK v0.4.1+) y formato .lcc2 (SDK v0.6.0+).

APIs relacionadas

  • LCCRender::unload()
  • LCCRender::update()
  • LCCRender::dispose()
Anterior
LCCRender::dispose
Siguiente
LCCRender::setCamera