##Intro
BCFier is an extendible and Open Source BCF client. Like IFC is the open standard for Building Information models, BCF is the open standard for Building Issues. BCFier is a set of plugins and standalone apps (modules) that handle BCF and integrate directly with BIM tools.
Currently BCFier is composed of the following modules:
- Autodesk Revit 2015 and 2016 addin
- Standalone Windows Viewer
Ready to start developing BCFier? Keep reading!
If you are looking for a Guide on how to use the installed version of BCFier instedad, refer to the UserGuide
##Disclaimer I have only recently started to document this project, please be comprehensive and help by pointing out what is not clear or missing.
##Getting Started
To get started fork the repo, if you are going to extend the Revit Project make sure the Autodesk dlls are referenced correctly, otherwise there are no other dependencies that need to be added.
###Structure
The core of BCFier is under Bcfier
, it contains all the logic and UI that is used by all the different integrations (modules). All modules will reference that project and extend it adding specific commands for the software they are integrating with.
The control Bcfier.UserControls.BcfierPanel
contains the logic and UI for the main panel, while Bcfier.UserControls.BcfReportPanel
for each BCF opened inside the TabControl.
All controls bind to ModelViews defined in Bcfier.Bcf
, it's not a perfect MVVM models since I use the same classes to serialize/deserialize BCFs, but it works great.
###Creating a new Module To create a new Module, for instance, an Achicad plugin, follow these steps:
- create a new project with the namespace
Bcfier.Archicad
- reference the
Bcfier
project - add the specific Archicad methods and structure to fire the plugin (like the Entry folder in the Revit plugin)
- create a main WPF window that contains the
Bcfier.UserControls.BcfierPanel
- create a command for adding a new view (
data:Commands.AddView
), this will have to generate a BCF ViewPoint (see Revit plugin for reference) - create a command for and opening a view (
data:Commands.OpenView
) - extend the installer to copy these new dlls where needed
###Settings
The settings file is stored in %localappdata%\BCFier\settings.config
so that it can be accessible by all modules, the Settingd Window UI will has different tabs for each module and ideally those will show up only if that specific module is installed.
The class that handles the settings file is under Bcfier.Data.Utils.UserSettings
, and stores the file as a ExeConfigurationFileMap
for easy management. The same class provides methods to automatically save/retrieve settings based on the UserControl name.
##Autodesk Revit Addin
The module for Autodesk Revit is in Bcfier.Revit
, the project builds fine for Revit 2015 and 2016 so for now the same dlls are used for both, in the future we'll need to differenciate.
##Installer The installer uses the free and awesome InnoSetup to generate .exe files, extending the .iss files is pretty straightforward.
##Backlog A more detailed list of things that need to be done can be found in the issues page, but to start:
New BCFier features
- support of the BCF REST API
- integration with issue tracking platforms (JIRA, redmine...)
New modules
- Archicad
- Navisworks
New Autodesk Revit module Features
- support for crop boxes
- a setting to apply vew templates to new view
###Contact You can contact Matteo Cominetti at: [email protected]
###License GNU General Public License v3 Extended This program uses the GNU General Public License v3, extended to support the use of BCFier as Plugin of the non-free main software Autodesk Revit. See http://www.gnu.org/licenses/gpl-faq.en.html#GPLPluginsInNF.
Copyright (c) 2013-2016 Matteo Cominetti
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/gpl.txt.