README 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. This is a small program that illustrates how to compute Bounded Biharmonic
  2. Weights (BBW) for a given surface mesh and skeleton description. This only
  3. supports point handles and skeleton trees (bones). Cages are not supported.
  4. This program only computes and outputs the weight function values. You should
  5. be able to load them into matlab or maya or whatever.
  6. = COMPILE =
  7. First install the dependencies (e.g. mosek). If your on a mac, and why
  8. wouldn't you be, then you *should* with any luck and by the grace of God be
  9. able to compile with:
  10. make
  11. = RUN =
  12. Then run an example with (e.g.):
  13. ./bbw_demo examples/brick.obj examples/brick.tgf
  14. This will produce at least 2 files:
  15. examples/brick-volume.mesh Tetrahedral mesh over which weights were computed
  16. examples/brick-volume.dmat Coefficients of weights defined over .mesh
  17. The dependencies are:
  18. igl_lib
  19. eigen3
  20. tetgen
  21. mosek
  22. = Igl lib =
  23. IGL_lib is our groups internal library. It will someday be publically
  24. available, but not yet. Thus I only include here a bare minimum to get this
  25. demo to work. The library functions as an inlined header library. All the
  26. source is located in ./igl_lib/include/igl
  27. = Eigen3 =
  28. The igl dependencies rely on a depracted version of the Sparse Matrix suite
  29. in eigen 3. Thus you need the correct version of eigen. To make this easier I
  30. have included the necessary version of eigen here: ./eigen3
  31. = Mosek =
  32. Mosek is free for academics and has its own installation instructions. Adjust
  33. your makefile accordingly.
  34. = Tetgen =
  35. Tetgen is also free and easy to install. Be sure to compile the library
  36. version, i.e.:
  37. make tetlib
  38. To make life a little easier I include a working version of tetgen in
  39. ./igl_lib/external/tetgen/. You can go there and compile libtet.a or download
  40. the tetgen source and do that on your own. Whatever.
  41. You can try to email Alec Jacobson (alecjacobson@gmail.com) with questions.
  42. Especially regarding the algorithm described in "Bounded biharmonic weights for
  43. real-time deformation" by [Jacobson et al. 2011]. However, please
  44. please
  45. please
  46. please
  47. please
  48. please
  49. please
  50. please
  51. please
  52. please
  53. please
  54. please
  55. please
  56. please
  57. please
  58. please
  59. please
  60. please
  61. try to solve compilation troubles on your own. I didn't intend for this code to
  62. be machine independent or even necessarily easy to compile. This is a quick and
  63. dirty demo because so many people requested it.
  64. Sometime in the not too distant future I still plan to release a *nice* 3d, C++
  65. demo.
  66. Love,
  67. Alec