Blender add-on to export your Blender project to Webots.
- Export your Blender project to Webots
- Define conversion rules in a JSON file
- Support collision export (either generated from the AABB boxes or manually defined)
- Support joint export (linear or rotational with custom parameters including axis, limits, etc.)
- Support the export of any Webots Solid (or derived) node with custom fields (
Camera.width,name, etc.). - Basic support of materials (colors and the base color map) to Webots PBR appearance.
- Blender 2.79b
- Webots R2019a.rev1 or later
Let say $BLENDER_ADD_ON_PATH is the Blender add-on user directory:
- on macOS:
export BLENDER_ADD_ON_PATH=$HOME/Library/Application\ Support/Blender/2.79/scripts/addons - on Linux:
export BLENDER_ADD_ON_PATH=$HOME/.config/blender/2.79/scripts/addons - on Windows:
- go to
Blender / Preferences / File / Scriptsand pasteC:\Users\username\AppData\Roaming\Blender Foundation\Blender\2.79\scripts. (replace username) - for the following steps, use the pasted address as
$BLENDER_ADD_ON_PATH.
- go to
Install the add-on by applying the following commands:
mkdir -p $BLENDER_ADD_ON_PATH/export_webots
cp __init__.py "$BLENDER_ADD_ON_PATH/export_webots"
cp export_webots.py "$BLENDER_ADD_ON_PATH/export_webots"
Enable the "Webots exporter" add-on in Blender / Preferences / Add-ons / Community.
The JSON conversion file specifies how to convert the Blender nodes to Webots ones.
If not specified in the parameters, the JSON conversion file is searched in the same path as the .blend file.
It is basically a JSON Object (i.e. key-value associative array) containing a conversion rule for each node. During the exportation, when a key of this JSON Object matches with the slugified Blender node name, then its value (a JSON Object) is used for the conversion.
The conversion JSON Object could contain the following conversion rules:
| Key | Flags | Value |
|---|---|---|
target node |
required | JSON String defining to which Webots node the Blender node should be converted. For example, it could be Solid, Robot, Camera, HingeJoint, SliderJoint or a custom Webots appearance node (like BrushedAluminium). |
fields |
optional | JSON Object which can contain any Webots node fields. The conversion tool will add these fields as-is. It is convenient to add device specific fields, like Camera.width, Emitter.name, etc. |
The following conversion rules are only available in the case of a Solid node (or derived):
| Key | Flags | Value |
|---|---|---|
physics |
optional | JSON Object which can contain the Webots Physics node fields (like mass, density and centerOfMass). If this key is not defined, then no Physics node is generated (the Solid can be pinned to the static environment, or controlled using kinematics rules.) |
boundingObject |
optional | JSON Object which can contain either a JSON String called custom to define the content of the Webots Solid.boundingObject field fields. If custom is not defined, then the AABB box of the Blender object is used to create the boundingObject. If this key is not defined, then no collision object is generated. |
The following conversion rules are only available in the case of a Joint node:
| Key | Flags | Value |
|---|---|---|
jointParameters |
optional | JSON Object which can contain the Webots (Hinge)JointParameters node fields (like axis, spring/dampingConstant and suspension*). |
motor |
optional | JSON Object which can contain the Webots LinearMotor or RotationalMotor node fields (like name, maxTorque, maxPosition or maxVelocity) |
positionSensor |
optional | JSON Object which can contain the Webots PositionSensor node fields (like name) |
Examples:
https://github.com/cyberbotics/blender-webots-exporter/tree/master/examples
This script has been inspired by the Blender X3D exporter of Campbell Barton, Bart, Bastien Montagne, Seva Alekseyev.