3DRepoBouncer is essentially the refactored 3DRepoCore and (parts of) 3DRepoGUI. It is a C++ library providing 3D Repo Scene Graph definition, repository management and manipulation logic as well as direct MongoDB databse access.

We always recommend using the Latest stable release. However, to access cutting-edge development versions, check out the tags.

This project is Copyright of 3D Repo Ltd, a company registered in England and Wales No. 09014101, and is released under the open source GNU Affero General Public License v3. Should you require a commercial license, please contact [email protected]. All contributors are required to sign either the 3D Repo Individual or the 3D Repo Entity Contributor License Agreement (CLA).

We very much encourage contributions to the 3D Repo project. Firstly, fork the desired repository and commit your modifications there. Once happy with the changes, you can generate a pull request and our team will integrate it upstream after a review.

Your pull requests should:

1. Follow the style of the existing code
2. One commit should just do one thing, and one thing only
3. Work in a branch assigned to a specific issue number, e.g. branch called "ISSUE_138"
4. Each commit message should be prefixed with the issue number, e.g. "#138 Fixing bug xyz..."
5. Rebase your branch against upstream's master so that we don't pull redundant commits
6. Sign our 3D Repo Individual CLA or if you are representing a legal entity, sign the 3D Repo Entity CLA

Doxygen documentation can be found here

3DRepoBouncer relies on the following libraries:

• Boost Library v1.55.0 - v1.58.0
  See also pre-built binaries for Windows and modular Boost on GitHub
• Mongo CXX Driver Legacy v1.0+ See 3D Repo guide for compiling MongoDB
• 3D Repo ASSIMP library fork See 3D Repo guide for compiling ASSIMP
• 3D Repo IFCOpenShell Fork This relies on 3D Repo's fork of OCCT. See 3D Repo guide for compiling IFCOpenShell
• AWS SDK for C++

To compile and install the library, the following are used:

• Python v2.x
• [CMAKE v2.8] (http://www.cmake.org/)
• A C++ compiler (GNU GCC v4.9+, Visual Studio 12+)

See instructions at 3drepo#9 (comment)

Ensure Mongo CXX Driver, Boost and ASSIMP libraries are installed.

The following instruction is for compiling a 64bit library using Visual Studio 12's tools. Change the pathing/cmake option appropriately if you are using another version of Visual Studio or compiling with a different compiler.

In command line prompt: set the following environmental variables to the directories of your installations:

• $env:BOOST_ROOT = path_to_boost
• $env:BOOST_LIBRARYDIR = path_to_boost_libraries (i.e path_to_boost\lib64-msvc-12.0) (NOT REQUIRED if libraries are in $BOOST_ROOT/lib)
• $env:MONGO_ROOT = path_to_mongo_cxx_driver
• $env:ASSIMP_ROOT = path_to_assimp

1. Clone the repository: git clone https://github.com/3drepo/3drepobouncer.git
2. Change directory: cd 3drepobouncer
3. Update CMake files: python updateSources.py
4. Create off-source build directory: mkdir build
5. Change directory: cd build
6. Configure build with CMAKE: cmake -G "Visual Studio 12 Win64" ../
7. Build the library: msbuild 3drepobouncer.vcxproj

Ensure Mongo CXX Driver, Boost and ASSIMP libraries are installed.

If the libraries are not installed in /usr, /usr/local, /opt/local, set the following environmental variables:

• export BOOST_ROOT = path_to_boost
• export MONGO_ROOT = path_to_mongo_cxx_driver
• export ASSIMP_ROOT = path_to_assimp

1. Clone the repository: git clone https://github.com/3drepo/3drepobouncer.git
2. Change directory: cd 3drepobouncer
3. Update CMake files: python updateSources.py
4. Create off-source build directory: mkdir build
5. Change directory: cd build
6. Configure build with CMAKE: cmake ../
7. Build the library: make

Apart from the CMakeLists.txt at root level, every other cmake file is automatically generated. If you have moved/created any source/header files, please run python updateSources.py to update the CMakeLists.txt files within the subdirectories before compiling.

Do NOT modify any CMakeLists.txt files within src folder as any changes will be overwritten when updateSources.py is executed!

If you need any help or want to contribute please contact: [email protected] We look forward to hearing from you.