Software developer at xeolabs.com

Lindsay Kay

OSArch Community Meetup, July 3, 2021

xeokit

Open Source

an

for

Graphics

&

BIM

AEC

Web Programming Toolkit

Viewing BIM in the browser is tricky!

  • Loading models quickly over the Web
  • Control of tools and data
  • Fitting them in browser memory
  • Drawing them interactively
  • Accurately viewing double-precision geometry on single-precision HW

Some challenges:

Introducing xeokit

Background Info

Tech Overview

Loading Big Models Fast

xeokit Background Info

  • AGPL3 dual-licensed JavaScript SDK for developing browser-based 3D AEC model viewers
  • Based on lessons learned from xeogl, SceneJS and various client projects since 2009
  • Created in Feb 2019 by xeolabs
  • Mission: code AEC viewers easily, load big models quickly, navigate them smoothly, host own code and data
  • Creoox AG becomes xeokit's business partner in 2020: creoox.com

Introducing xeokit

xeokit Tech Overview

  • Views complex models at full-precision
  • Loads models quickly from native XKT format
  • Code, tools and models in your hands
const viewer = new Viewer({
   canvasId: "myCanvas"
});

viewer.camera.eye = [0,0,100];
viewer.camera.look = [0,0,0];
viewer.camera.up = [-0, 1, 0];

const xktLoader = 
      new XKTLoaderPlugin(viewer);

const model = xktLoader.load({
    src: "HolterTower.xkt"
});
  • Custom WebGL 3D graphics engine  with AEC-friendly programming API
  • JavaScript viewer with plugins library
  • Converters for IFC, CityJSON, 3DXML, LAZ glTF, DAE, STL, PCL ...

Introducing xeokit

Loading Big Models Fast

  • XKT - xeokit's native, compact binary model format
  • Quantized, tiled  RTC vertex coordinates - double precision for 48 bits per vertex!
  • Embedded metadata (eg. IFC structure)
  • Convert your models to XKT using open source tools 
  • Compresses bulky source formats (eg. IFC) for quick transport and efficient loading 

Introducing xeokit

Using xeokit

Converting a Model to XKT

Viewing an XKT Model with xeokit

Converting a Model to XKT

Use open source tools in a chain:

  • IfcConvert

  • COLLADA2GLTF

  • xeokit-metadata

  • gltf2xkt

Using xeokit

  • A fast, closed-source IFC converter is also available from Creoox: creoox.com

Converting a Model to XKT (2)


./IfcConvert -y --use-element-guids Duplex.ifc Duplex.dae 

./COLLADA2GLTF-bin --materialsCommon -v -i Duplex.dae -o Duplex.gltf

./xeokit-metadata Duplex.ifc Duplex.json

./gltf2xkt -s Duplex.gltf  -m Duplex.json -o Duplex.xkt

Using the open source CLI tools in Linux:

Using xeokit

Viewing an XKT model with xeokit

import {Viewer, XKTLoaderPlugin} 
	from "xeokit-sdk.es.js";

const viewer = new Viewer({
   canvasId: "myCanvas"
});

viewer.camera.eye = [1842022, 10, -5173301];
viewer.camera.look = [1842022, 10, -5173401];
viewer.camera.up = [-0.0, 1.0, 0.0];

const xktLoader = new XKTLoaderPlugin(viewer);

const model = xktLoader.load({
    src: "Schependomlaan.xkt"
});

IFC = 49.3 MB, XKT = 1.6M, loaded in 0.7 secs, 60 FPS

Using xeokit

A Look Inside xeokit

Minimizing Memory Footprint

Drawing Many Objects Interactively

Rounding Jitter on WebGL

Eliminating Rounding Jitter

Navigating Precisely

Minimizing Memory Footprint

  • Store geometry on GPU, not in browser
  • Quantized RTC vertex positions, oct-encoded (optional) normals
  • 48 bits per double-precision position, 16 bits per normal

A large plumbing model at BIMData.io

Inside xeokit

Drawing Many Objects Interactively

1. ANGLE_instanced_arrays

Two rendering techniques on WebGL:

2. Batched Geometry Arrays:

  • Combine single-use geometries into a single set of VBOs
  • Add an array of per-vertex flags, to hold object states
  • Vertex shader "discards" vertex when visible flag false
  • Update all vertex flags for an object to set its visibility

Inside xeokit

A Technical Hurdle - Rounding Jitter on WebGL

  • GPUs are usually only single-precision, however
  • Many BIM models use double-precision coordinates
  • Need to emulate double-precision rendering to eliminate rounding jitter

Model centered at (1842022, 10, -5173301), provided by BIMData.io

Inside xeokit

Solution - How we Eliminate Rounding Jitter

  • Coords are 32-bit offsets from their 64-bit tile centers, rendered using modified view matrix
  • Tiled, relative-to-center (RTC) coordinates

Read about RTC coordinates in virtualglobebook.com

  • Memory bonus: full-precision without the cost of storing double-precision values

Inside xeokit

How we Navigate Precisely

  • Distance-proportional rate of forward/backward movement
  • Ray-cast every n frames to find distance to nearest object, scale dolly and zoom rates accordingly

  • Move fast in open spaces, move slow in tighter spaces

Inside xeokit

Who's using xeokit?

  • View multiple models
  • Share issues via BCF
  • Slice, highlight, X-ray
  • Plan views

Who's using xeokit?

  • Great OSS community supporters - sponsors of many public xeokit features
  • xeolabs clients since 2019

Who's using xeokit?

  • Sponsors of several valuable open source xeokit features

Text

D-Studio

  • Can't show apps yet - still under development!
  • xeolabs client since 2019
  • Centralized BIM Data

  • Requirements Management

  • BIM Model Viewer

  • Rule-Based Quality Checks

  • Clash Detection

  • KPI Dashboard

  • Coordination & Reports

Who's using xeokit?

Text

  • Contributed IFC metadata tool and React integration boilerplate

  • xeolabs client since 2017
  • Originally used xeogl
  • Moved to xeokit in 2019

Who's using xeokit?

  • Supports xeokit with feature planning, bug fixes, and datasets for demos and testing
  • Upload IFC models
  • View in 3D
  • Slice, highlight, X-ray
  • Plan views
  • Share BCF
  • Model checker
  • etc

Who's using xeokit?

  • Using xeokit as the 3D front end for their Singular Qualifier IFC model checker tool

Who's using xeokit?

Who's using xeokit?

xeokit in Research: UMass Boston

Who's using xeokit?

What's in the works for xeokit 2.0

  • convert2xkt - Single-step multi-format XKT converter 
  • xeokit-bim-viewer-demo - BIM viewer boilerplate with batch model import, element property sets, BCF etc.
  • Point clouds, CityJSON, object attributes, localization and more
  • Performance test suite - measure conversion times, XKT sizes and load/render performance in all browsers
  • WebGPU!

Big thanks to our supporters:

D-Studio

Sponsor of many public xeokit features, including xeokit-bim-viewer

Sponsor of various public xeokit features

Help with feature design, QA and data sets for demos

Contributed MIT-licensed IFC metadata extractor tool and a React boilerplate

Collaborated on the XKT model format

xeokit's exclusive business partner

Thanks!

lindsay.kay@xeolabs.com

Copy of xeokit: A Web Programming Toolkit for BIM & Engineering Graphics

By xeolabs

Copy of xeokit: A Web Programming Toolkit for BIM & Engineering Graphics

A presentation for OSArch Meetup July 2021.

  • 1,810