engine_web ifc

목차 | web-ifc 문서 | 플랫폼 문서 | 데모 | 커뮤니티 | npm 패키지

웹 IFC

web-ifc는 기본 속도로 ifc 파일을 읽고 쓸 수 있는 자바스크립트 라이브러리입니다. web-ifc는 개방형 BIM 애플리케이션 개발의 문턱을 낮추는 것을 목표로 하는 That Open Company 프로젝트의 일부입니다.

설치하다

npm install web-ifc

빠른 설정

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

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

// initialize the library
await ifcApi . Init ( ) ;

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

// the model is now loaded! use modelID to fetch geometry or properties
// checkout examples/usage for some details on how to read/write IFC

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

web-ifc 사용 방법에 대한 자세한 내용은 예시를 참조하세요.

현재 빌드

web-ifc의 현재 라이브 빌드는 여기에서 확인할 수 있습니다. 이를 사용하면 릴리스하기 전에 최신 수정 사항을 테스트할 수 있습니다. 이 버전을 사용하려면 zip 파일을 다운로드하고 dist 폴더의 내용을 node_modules/web-ifc 폴더에 수동으로 저장하세요. 즉, web-ifc-3을 사용하는 경우 node_modules/web-ifc-3/node_modules/web-ifc가 됩니다. 자바스크립트와 WASM을 교체해야 합니다.

요구사항

이는 web-ifc를 구축하는 데 필요한 요구 사항입니다(자체 버전을 구축하려는 경우에만 해당).

1. 노드 v16 이상
2. NPM v7 이상
3. EMSCRIPTEN v3.1.44 이상
4. CMAKE v3.18 이상

회귀 테스트

테스트/공용 폴더에 테스트 모델 라이브러리가 있습니다. 기여하고 싶은 모델이 있다면 PR을 열어주세요.

npm run regression 실행하여 이러한 모든 모델에 대해 회귀 테스트를 실행할 수 있습니다. 샘플 모델 형상이 변경되면 경고가 표시됩니다. 변경 사항이 올바른 경우 npm run regression-update 실행하여 회귀 테스트를 새로 고칠 수 있습니다.

WASM 모듈 구축

emscripten 및 빌드 시스템 설정

WASM 라이브러리는 emscripten을 통해 구축되었습니다. emscripten 설정 방법에 대한 정보는 emscripten 설치 가이드를 참조하세요. 그런 다음 emsdk_env 경로에 있어야 합니다.

WASM을 빌드하려면 CMAKE도 필요하며 (Windows의 경우) MINGW도 여기를 참조하세요. 일단 설치하고 경로에 있으면 npm run setup-mingw 실행하여 web-ifc 환경을 구성하세요.

WASM 라이브러리

모든 종속성을 설치하려면 npm install 실행하세요.

새 터미널을 열 때마다 npm run setup-env 실행하면 코드를 컴파일하는 데 필요한 emscripten 환경 변수가 설정됩니다.

npm run build-release 실행하여 wasm 바이너리의 릴리스 버전과 함께 제공되는 web-ifc API를 빌드하세요. ./dist 에 배치됩니다.

디버깅이 활성화된 WASM을 빌드하려면 npm run build-debug 실행할 수 있습니다. 이렇게 하면 web-ifc를 실행할 때 디버깅 정보를 더 잘 검사할 수 있습니다.

npm run dev 실행하여 기본 ifc 파일 뷰어로 개발 서버를 시작하세요.

파일 빌드

다음 파일의 빌드 프로세스 const 출력은 다음과 같습니다.

1. web-ifc.wasm - 브라우저에서 실행하기 위한 wasm(컴파일된 C++)
2. web-ifc-mt.wasm - 멀티스레딩이 지원되는 경우 브라우저에서 실행할 wasm(컴파일된 C++)입니다.
3. web-ifc-node.wasm - 노드에서 실행할 wasm(컴파일된 C++)
4. web-ifc-api-node.js - 노드에서 실행하기 위해 wasm용으로 컴파일된 자바스크립트 래퍼입니다.
5. web-ifc-api-node.d.ts - web-ifc API에 대한 Typescript 정의(노드용)
6. web-ifc-api.js - 브라우저에서 실행하기 위해 wasm용으로 컴파일된 자바스크립트 래퍼입니다.
7. web-ifc-api.d.ts - 기본 web-ifc API에 대한 Typescript 정의
8. ifc-schema.d.ts - IFC 스키마에 대한 Typescript 정의
9. helpers/properties.d.ts - web-ifc API의 속성 측면에 대한 Typescript 정의
10. helpers/log.d.ts - web-ifc API의 로거 측면에 대한 Typescript 정의
11. web-ifc-mt.worker.js - 브라우저에서 멀티스레딩을 활성화하는 Webworker 자바스크립트입니다.

독립형 C++

라이브러리의 주요 초점은 브라우저/nodejs의 WebAssembly를 통해 사용되는 것이지만 프로젝트는 C++ 라이브러리 또는 실행 파일로 독립 실행형으로 사용될 수 있습니다. 시작하기 위한 간단한 진입점은 여기를 참조하세요.