When I was getting started using FCL, I found these references helpful:
- the original FCL Paper documents many of the core concepts
- the API Documentation on the ROS wiki. Especially under the fcl Namespace, as many FCL capabilities are exposed as bare functions in the root
fcl
namespace. - the various
test_*.cpp
unit-test programs, which can be reviewed here
From the ROS side, you'll need to make sure fcl
is listed as a dependency in your package's manifest.xml
. Also, the CMakeLists.txt
should include a target_link_libraries(my_exe fcl)
line to link the library to your executable. As shown in the FCL test programs, you'll need to explicitly link individual header files for the specific FCL modules you want to use: #include "fcl/collision_node.h"
, etc.
To start, I'd try creating a small test program. You could construct a few primitives (spheres or cubes) of known geometry, at known distances, and call the FCL methods to check for collisions or distances. This is essentially what is done in the FCL unit-test programs. This test program will allow you to verify that you have your ROS environment set correctly (dependencies, includes, linking, etc.) and at least a basic working implementation of FCL. From there, you can expand the FCL portion to more directly implement what you're trying to do for your application.
Mostly, I had to stumble my way through getting started. But once I had some working code, the library was fairly easy to use and very powerful! We're doing distance checks between large meshes at a very acceptable rate. Other than the initial setup headaches, I've been very pleased.
I've also tried the standalone FCL package, and it builds fine, and it runs the included test fine, but there doesn't seem to be any examples or documentation to it, either.