@@ -10,7 +10,7 @@ by default.
10
10
11
11
Downstream developers may also integrate other physics engines by creating new
12
12
Gazebo Physics engine plugins. See
13
- [ Gazebo Physics] ( https://gazebosim.org/api/physics/7 /tutorials.html ) 's
13
+ [ Gazebo Physics] ( https://gazebosim.org/api/physics/8 /tutorials.html ) 's
14
14
tutorials to learn how to integrate a new engine.
15
15
16
16
## How Gazebo finds engines
@@ -25,24 +25,32 @@ If you've created a custom engine plugin, you can tell Gazebo where to find it
25
25
by setting the ` GZ_SIM_PHYSICS_ENGINE_PATH ` environment variable to the
26
26
directory where the plugin's shared library can be found.
27
27
28
- For example, if you've created the following physics engine shared library on
29
- Linux:
28
+ For example, if you've created the following physics engine shared library:
30
29
31
30
```
31
+ # Linux
32
32
/home/physics_engines/libCustomEngine.so
33
+ # Windows
34
+ C:\Users\Robot\physics_engines\CustomEngine.dll
33
35
```
34
36
35
37
You should set the variable as follows:
36
38
37
39
```
40
+ # Linux
38
41
export GZ_SIM_PHYSICS_ENGINE_PATH=/home/physics_engines
42
+ # Windows
43
+ set GZ_SIM_PHYSICS_ENGINE_PATH=C:\Users\Robot\physics_engines
39
44
```
40
45
41
46
If you have several libraries installed in different paths, you can add more
42
47
paths, for example:
43
48
44
49
```
50
+ # Linux, separate with :
45
51
export GZ_SIM_PHYSICS_ENGINE_PATH=/home/physics_engines:/home/more_engines
52
+ # Windows, separate with ;
53
+ set GZ_SIM_PHYSICS_ENGINE_PATH=C:\Users\Robot\physics_engines;C:\MoreEngines
46
54
```
47
55
48
56
## Tell Gazebo what engine to load
@@ -52,6 +60,7 @@ There are a few different ways of telling Gazebo which engine to load.
52
60
For any method, you should provide the name of your plugin's shared library,
53
61
but the ` lib ` prefix and the file extension are optional. So in this example,
54
62
the file is ` libCustomEngine.so ` but it's enough to set ` CustomEngine ` .
63
+ That is also prefered to support multiple operating systems.
55
64
56
65
### From SDF
57
66
@@ -103,23 +112,23 @@ Gazebo supports the following physics engine configurations through SDF.
103
112
These options are available to all physics engines, but not all engines
104
113
may support them. The default physics engine, DART, supports all these options.
105
114
106
- * [ //physics/dart/collision_detector] ( http://sdformat.org/spec?ver=1.8 &elem=physics#dart_collision_detector )
115
+ * [ //physics/dart/collision_detector] ( http://sdformat.org/spec?ver=1.11 &elem=physics#dart_collision_detector )
107
116
* Options supported by DART: ` ode ` (default), ` bullet ` , ` fcl ` , ` dart ` .
108
117
109
- * [ //physics/dart/solver/solver_type] ( http://sdformat.org/spec?ver=1.8 &elem=physics#solver_solver_type )
118
+ * [ //physics/dart/solver/solver_type] ( http://sdformat.org/spec?ver=1.11 &elem=physics#solver_solver_type )
110
119
* Options supported by DART: ` dantzig ` (default), ` pgs `
111
120
112
121
## Troubleshooting
113
122
114
123
> Failed to find plugin [ libCustomEngine.so] . Have you checked the
115
124
> GZ_SIM_PHYSICS_ENGINE_PATH environment variable?
116
125
117
- Gazebo can't find out where ` libCustomEngine.so ` is located.
126
+ Gazebo can't find out where ` libCustomEngine.so ` or ` CustomEngine.dll ` is located.
118
127
119
128
If that's an engine you believe should be installed with Gazebo Physics,
120
129
check if the relevant plugin is installed.
121
130
122
- If that's a 3rd party engine, find where the ` .so ` file is installed and add
131
+ If that's a 3rd party engine, find where the ` .so ` or ` .dll ` file is installed and add
123
132
that path to the environment variable as described above.
124
133
125
134
> Unable to load the [ /home/physics_engines/libCustomEngine.so] library.
0 commit comments