Skip to content

Latest commit

 

History

History
87 lines (55 loc) · 4.26 KB

README.md

File metadata and controls

87 lines (55 loc) · 4.26 KB

ifc.js | 문서 | 데모 | 디스코드 | 사용법 예제 | npm 패키지 | 기여(공헌)하기

web-ifc

Build npm opencollective

web-ifc는 네이티브 속도로 ifc 파일을 읽고 쓰기 위한 JavaScript 라이브러리입니다. web-ifcifc.js 프로젝트의 일부로서 개방형 BIM 응용을 개발하기 위한 임계치를 낮추는 것을 목표로 합니다.

상태

web-ifc가 이미 상당히 안정적이고 빠르다 할지라도 충분한 ifc 지원까지는 pre-alpha 상태입니다. 현재 지원되는 ifc 요소 리스트나 서로 다른 ifc 타입들에 대한 지원 수준은 진행 중이며 문서화되지 않은 작업입니다.

당신의 모델에 따라 web-ifc는 빠르고 정확할 수도 있고 느리고 고장날 수도 있습니다. 문제가 있는 모델은 제가 볼 수 있도록 공유 부탁 드립니다 :)

설치

npm install web-ifc

빠른 설정

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

// API 초기화
const ifcApi = new WebIFC.IfcAPI();

// 라이브러리 초기화
await ifcApi.Init();

// 데이터로부터 모델 열기
let modelID = ifcApi.OpenModel(/* string 또는 UInt8Array 형태의 IFC 데이터 */, /* 선택적인 설정 오브젝트 */, );

// 이제 모델이 로드되었습니다! 지오메트리 또는 프로퍼티를 가져오기 위해 modelID를 사용하십시오.
// IFC를 읽고 쓰는 방법을 더 자세히 알기 위해서는 예제/사용법을 확인하십시오.

// 모델을 닫습니다. 모든 메모리가 해제됩니다.
ifcApi.CloseModel(modelID);

web-ifc를 사용하는 방법을 더 자세히 알려면 예제를 보십시오.

WASM 모듈 빌드하기

emscripten 설정하기

WASM 라이브러리는 emscripten을 통해 빌드됩니다. emscripten 설정에 대한 정보는 emscripten 설치 가이드를 보십시오. 그 후에는 당신의 경로 안에 emsdk_env가 있어야합니다.

WASM 라이브러리

모든 디펜던시(dependencies)를 설치하려면 npm install을 실행하십시오.

새로운 터미널을 열 때마다 npm run setup-env를 실행하십시오. 이렇게 하면 코드를 컴파일하기 위한 필수 emscripten 환경 변수들을 설정하게 됩니다.

wasm 바이너리와 web-ifc API의 릴리즈 버전을 빌드하기 위해 npm run build-release-all을 실행하십시오. 결과물은 ./dist에 배치될 것입니다.

만약 WASM을 디버깅 활성화 상태로 빌드하고 싶으면 npm run build-debug를 실행하면 됩니다. 이렇게 하면 web-ifc를 실행할 때 디버깅 정보를 더 잘 검사할 수 있게 됩니다.

기본 ifc 파일 뷰어와 함께 개발 서버를 실행하려면 npm run dev를 실행하십시오.

독립형 C++

이 라이브러리는 기본적으로 browser/nodejs에서 WebAssembly를 통해 사용되기는 하지만, 이 프로젝트는 C++ 라이브러리 또는 실행파일로서 독립적으로 사용할 수도 있습니다. 시작하기 위한 간단한 엔트리 포인트에 대해서는 여기를 보십시오.

기여(공헌)하기

도와주고 싶습니까? 훌륭해요!

저희의 기여 의견을 확인해 주십시오.