Índice | documentação web-ifc | documentação da plataforma | demonstração | comunidade | pacote npm
web-ifc é uma biblioteca javascript para ler e escrever arquivos ifc, em velocidades nativas. O web-ifc faz parte do projeto That Open Company, que visa reduzir o limiar para o desenvolvimento de aplicações BIM abertas.
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 ) ;
Veja exemplos para obter mais detalhes sobre como usar o web-ifc.
A versão atual do web-ifc está disponível aqui. Usar isso permite que você teste as correções mais recentes antes de lançarmos. Se você deseja usar esta versão, baixe o arquivo zip e coloque o conteúdo da pasta dist manualmente em sua pasta node_modules/web-ifc. Ou seja, se você estiver usando web-ifc-três, será node_modules/web-ifc-três/node_modules/web-ifc. Observe que você deve substituir o javascript e o WASM.
Estes são os requisitos necessários para construir o web-ifc (apenas para aqueles que desejam construir a sua própria versão).
Temos uma biblioteca de modelos de teste na pasta testes/public. Se você tem um modelo com o qual gostaria de contribuir, abra um PR.
Você pode executar testes de regressão em todos esses modelos executando npm run regression
. Ele irá alertá-lo se alguma geometria do modelo de amostra for alterada. Se a alteração estiver correta, você poderá atualizar os testes de regressão executando npm run regression-update
.
A biblioteca WASM é construída através do emscripten, consulte o guia de instalação do emscripten para obter informações sobre como configurar o emscripten. Depois disso, emsdk_env
precisa estar no seu caminho.
Para construir o WASM você também precisa do CMAKE veja aqui e (no Windows) MINGW veja aqui - uma vez instalado (e no seu caminho) execute npm run setup-mingw
para configurar o ambiente para web-ifc.
Execute npm install
para instalar todas as dependências.
Execute npm run setup-env
sempre que abrir um novo terminal, isso configurará as variáveis de ambiente emscripten necessárias para compilar o código.
Execute npm run build-release
para construir uma versão de lançamento do binário wasm e a API web-ifc que o acompanha. Ele será colocado em ./dist
.
Se você deseja construir o WASM com depuração habilitada, você pode executar npm run build-debug
. Isso permitirá que você inspecione melhor as informações de depuração ao executar o web-ifc.
Execute npm run dev
para iniciar um servidor de desenvolvimento com um visualizador de arquivos ifc básico.
A saída do processo de construção consiste nos seguintes arquivos:
Embora o foco principal da biblioteca seja ser usado por meio do WebAssembly no navegador/nodejs, o projeto pode ser usado de forma independente como uma biblioteca C++ ou executável. Veja aqui um ponto de entrada simples para começar.