README 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  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. = File Formats =
  18. See file-formats/index.html
  19. The dependencies are:
  20. igl_lib
  21. eigen3
  22. tetgen
  23. mosek
  24. = Igl lib =
  25. IGL_lib is our groups internal library. It will someday be publically
  26. available, but not yet. Thus I only include here a bare minimum to get this
  27. demo to work. The library functions as an inlined header library. All the
  28. source is located in ./igl_lib/include/igl
  29. = Eigen3 =
  30. The igl dependencies rely on a depracted version of the Sparse Matrix suite
  31. in eigen 3. Thus you need the correct version of eigen. To make this easier I
  32. have included the necessary version of eigen here: ./eigen3
  33. = Mosek =
  34. Mosek is free for academics and has its own installation instructions. Adjust
  35. your makefile accordingly.
  36. = Tetgen =
  37. Tetgen is also free and easy to install. Be sure to compile the library
  38. version, i.e.:
  39. make tetlib
  40. To make life a little easier I include a working version of tetgen in
  41. ./igl_lib/external/tetgen/. You can go there and compile libtet.a or download
  42. the tetgen source and do that on your own. Whatever.
  43. You can try to email Alec Jacobson (alecjacobson@gmail.com) with questions.
  44. Especially regarding the algorithm described in "Bounded biharmonic weights for
  45. real-time deformation" by [Jacobson et al. 2011]. However, 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. please
  62. please
  63. try to solve compilation troubles on your own. I didn't intend for this code to
  64. be machine independent or even necessarily easy to compile. This is a quick and
  65. dirty demo because so many people requested it.
  66. Sometime in the not too distant future I still plan to release a *nice* 3d, C++
  67. demo.
  68. Love,
  69. Alec