Skip to content

bcf-js is a BIM Collaboration Format (BCF) reader & parser developed and maintained by Parametricos Ltd.

License

Notifications You must be signed in to change notification settings

Parametricos/BCF.js

Repository files navigation

BCF-js

Bcf-js is a BIM Collaboration Format (BCF) reader & parser.

This fork was made to read and write both BCF 2.1 and 3.0 versions.

Find it on npmjs.com https://www.npmjs.com/package/@parametricos/bcf-js

Getting Started

To install the library use: npm install @parametricos/bcf-js or yarn add @parametricos/bcf-js

Using the library

For BCF-XML 3.0:

import { BcfReader, BcfWriter } from '@parametricos/bcf-js';

For BCF-XML 2.1:

import { BcfReader, BcfWriter } from '@parametricos/bcf-js/2.1';

Reading a file:

  const file = "some_bcf_file.bcf"

  const reader = new BcfReader();
  
  await reader.read(file);

  const project = reader.project
  
  project.markups.forEach((markup) => {
    console.log(markup.topic);
  })

  // See ./test/BasicReadExample.js for more examples

Writing a project:

  const bcfProject: IProject = {
    ...
  }
  
  const savePath = "./test-data/bcf3.0/Writer/WriteTest.bcf"

  const writer = new BcfWriter();
  
  const content = await writer.write(bcfproject)
  fs.writeFile(savePath, content, (err) => {})

  // See ./test/BasicWriteExample.js for more examples

Contribution

There's a few ways to contribute to this project and improve it:

  1. Fork the project repository and make your first pull request
  2. Submit sample BCF and it's linked IFC files in the 'test' folder
  3. Test it and create Issues so that we can start working on them

License

BCF-js is licensed under the Mozilla Public License 2.0. Please read the LICENSE file in this repository for more details.

About

bcf-js is a BIM Collaboration Format (BCF) reader & parser developed and maintained by Parametricos Ltd.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published