Skip to content
Double bubbles sans toil and trouble: discrete circulation-preserving vortex sheets for soap films and foams
C++ C Roff CMake Awk Makefile Other
Branch: master
Clone or download
Raymond Fei
Raymond Fei fix readme
Latest commit 152f687 Jun 23, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Apps refix for Mac Jun 23, 2018
LosTopos fix for windows Jun 23, 2018
assets add missing files & option to use Fang's patch May 17, 2018
bin repack the zip Jun 23, 2018
cmake fix for windows Jun 23, 2018
include add includes and windows binaries Jun 23, 2018
.gitignore add missing files & option to use Fang's patch May 17, 2018
CMakeLists.txt fix for windows Jun 23, 2018
license.txt first commit Sep 1, 2017
readme.md fix readme Jun 23, 2018

readme.md

Double bubbles sans toil and trouble: discrete circulation-preserving vortex sheets for soap films and foams

SoapFilm3D is an open source project for the physical simulation of soap films and bubbles. It is licensed under Clear BSD License for academic and non-commercial use (other licenses may be obtained by contacting the faculty of the Columbia Computer Graphics Group or a Columbia University licensing officer).

It is the test program accompanying Da, Fang, et al. "Double bubbles sans toil and trouble: discrete circulation-preserving vortex sheets for soap films and foams." ACM Transactions on Graphics (TOG) 34.4 (2015): 149. (http://www.cs.columbia.edu/cg/doublebubbles/), including the multimaterial mesh-based surface tracking library LosTopo.

This program is built by standard procedures using CMAKE (http://www.cmake.org).

Dependencies

The following external libraries are required:

On Mac OS X or Linux-based systems, most of the dependencies are either included, or can be easily installed with Homebrew (https://brew.sh) or the APT package handling utility.

On Windows you may need manually download and install some of them.

Compilation

SoapFilm3D has been tested with Clang (under Mac OS X), and GCC 4.8+ (under Linux). Currently the MSVC compiler is partially supported without the FMMTL module.

To compile SoapFilm3D, you'll need CMake on Mac OS X or Linux.

  1. make a directory, say, build, with mkdir build, enter the build directory, type cmake ..
  2. Optionally you can adjust the options with ccmake .
  3. type make to compile the code. For speeding up the compilation process you may use make -j.

On Windows:

  1. open CMake-GUI, enter the correct directory for source code and build. Then click Configure, choose your installed version of the Microsoft Visual Studio.
  2. after configuration you may find several libraries not found (with notifications of errors), check the Advanced box and specify those missing header path and libraries manually. For example, if Eigen is missing, then please specify the EIGEN3_INCLUDE_DIR to the path of directory we provided. For the ones we have not provided, you need to download and compile them, and then specify the missing directories to the path containing your headers or compiled libraries. Please make sure you have picked the libraries corresponding to the architecture you have selected (say, 32-bit libraries for x86, and 64-bit libraries for x64).
  3. click generate after fixing all missing variables to generate your Visual Studio solution.
  4. open the Visual Studio solution and compile the code.
  5. before running the demo, all the compiled dynamic linking libraries (DLLs) for your dependencies should be accessible from your PATH environment variable that can be changed in system settings, or you may simply copy them into your System32 (x64) or SysWOW64 (x86) directories.

Since collecting and compiling the dependencies could be tricky for Windows, we provided some compiled libraries and DLLs for your convenient. You may find them in the zip file under the bin folder, which also contains a compiled executable (under Visual Studio 2015 and Windows 10).

Run the Demo

Running the executables without command line arguments will display usage information. All the data files for testing are located in the assets folder. Since FMMTL is not supported, running on Windows can be slower than expected.

Please run the code using the project folder that containing everything (assets, code, etc.) as the working directory.

You can’t perform that action at this time.