web-ifc

web-ifc

Warning: this is pre-alpha software, an experimental backend for IFC.js

Web ifc is a WASM-based ifc parser & geometry generator. This repository contains the c++/typescript source code.

https://www.npmjs.com/package/web-ifc

Installing the library as an npm dependency

npm install web-ifc

Installing the library as a C++ dependency

The library is header only, the files in web-ifc-cpp can be trivially included in any project. The library depends on GLM and earcut, which it expects in a folder ./deps in the root of the project (pending change).

Using the library

See examples for different ways to use web-ifc.

For a short intro, this is how to use the library from javascript:

const WebIFCWasm = require("web-ifc/web-ifc.js");
const WebIFC = require("web-ifc/web-ifc-api.js");

// initialize the API
const ifcApi = new WebIFC.IfcAPI();

// load model data as a string
await ifcApi.InjectWasmModule(WebIFCWasm);

// open a model from data
let modelID = ifcApi.OpenModel(/* placeholder filename */, /* IFC data as a string or UInt8Array */);

// the model is now loaded! use modelID to fetch geometry

// close the model, all memory is freed
ifcApi.CloseModel(modelID);

Compiling the library

C++ executable

Compiling the library to a standalone executable requires use of CMAKE. For visual studio code, the easiest way is by installing cmake-tools.

WASM library

The WASM library is built through emscripten, please see the emscripten installation guide for information on how to set up emscripten. Afterwards the library can be built by using: .\wasm_setup_env.bat and .\wasm_compile.ps1.