-
Notifications
You must be signed in to change notification settings - Fork 41
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Tutorial loading physics plugin #115
Tutorial loading physics plugin #115
Conversation
Signed-off-by: anindex <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM in genera with some minor commentsl!
tutorials/05_plugin_loading.md
Outdated
be used in our code. After the `std` C++ libraries are the `Loader.hh` and | ||
`PluginPtr.hh`, which provides main functionalities for loading physics plugins | ||
and plugin pointers. Next includes from \ref ignition::physics are the tools for | ||
retrieving "Features" and "Entities" from physics plugins. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Provide definitions for Features
and Entities
, FeaureLists
, linking to content in this section https://github.com/ignitionrobotics/ign-physics/blame/main/tutorials/03_physics_plugins.md#L16
tutorials/05_plugin_loading.md
Outdated
|
||
Assuming the correct path, our loader will instantiate all plugins that are | ||
available in the path using @ref ignition::plugin::Loader::Instantiate member function. Then for each instantiated plugin, it will request an engine | ||
using @ref ignition::physics::RequestEngine3d<Features>::From function. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
worth explaining/linking to the definition of FeaturePolicy
https://github.com/ignitionrobotics/ign-physics/blame/main/tutorials/03_physics_plugins.md#L36 here, since features can be 2d
or 3d
or any custom dimensions
tutorials/05_plugin_loading.md
Outdated
} | ||
``` | ||
|
||
### Example setup CMakeLists.txt file for Dome release |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could add a link to CMake
tutorials https://cmake.org/cmake/help/latest/guide/tutorial/index.html to provide extra clarity and resource
tutorials/05_plugin_loading.md
Outdated
|
||
### Load existing plugins | ||
|
||
For example, if you have the Ignition Physics plugin for DART compiled, find |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
DART
can point to either the repo or a documentation related to the physics engine just so user can have more context
tutorials/05_plugin_loading.md
Outdated
### Load existing plugins | ||
|
||
For example, if you have the Ignition Physics plugin for DART compiled, find | ||
where it is installed with (you may need sudo right): |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
where it is installed with (you may need sudo right): | |
where it is installed with (you may need administrative rights: `sudo` on Linux platform): |
tutorials/05_plugin_loading.md
Outdated
engine name: dartsim-6.10.0 | ||
``` | ||
|
||
At the time of writing, Ignition Physics is shipped with `DART` and `TPE` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
again, links to each physics engine repo/documentation
Signed-off-by: anindex <[email protected]>
…ndex/ign-physics into tutorials-hello-world-loader
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
* Initial draft for loading plugin tutorial Signed-off-by: anindex <[email protected]> * Resolve comments Signed-off-by: anindex <[email protected]> Co-authored-by: anindex <[email protected]> Co-authored-by: Louise Poubel <[email protected]> Co-authored-by: Claire Wang <[email protected]>
* Initial draft for loading plugin tutorial Signed-off-by: anindex <[email protected]> * Resolve comments Signed-off-by: anindex <[email protected]> Co-authored-by: anindex <[email protected]> Co-authored-by: Louise Poubel <[email protected]> Co-authored-by: Claire Wang <[email protected]>
* Initial draft for loading plugin tutorial Signed-off-by: anindex <[email protected]> * Resolve comments Signed-off-by: anindex <[email protected]> Co-authored-by: anindex <[email protected]> Co-authored-by: Louise Poubel <[email protected]> Co-authored-by: Claire Wang <[email protected]>
Signed-off-by: anindex [email protected]