move3d » move4d

h1. Simple Usage

move4d main interface is through python bindings, also a GUI provide some functionalities, but currently we do not aim at making it a complete interface. Python binding are aimed at accessing all functionalities of move4d -- but that's a work in progress.

h2. Install everything

h2. Download some p3d files

You can find a lot here: @ git://redmine.laas.fr/laas/move3d/assets.git @

h2. Launch GUI from python console

start a python 3 console (we recommend using ipython3) and if your environment is properly set you should be able to do:

<pre><code class="python">

import move4dogre

from move4d import move4d

m4dapp=move4dogre.Move4d(["-f","path/to/a/p3d_file.p3d"]) # try with "path/to/assets/ADREAM/ADREAM_APPART.p3d"

m4dapp.start()

# this starts the GUI in another thread, you can still provide commands to the python prompt

</code></pre>

h2. Moving the camera

In the GUI, there is a 3D view of your environment (or several views).

To change the viewpoint, hold left mouse button and move the mouse around. This will rotate the camera around a virtual point.

You can zoom in and out with the mouse middle button (scroll) (or rather move the camera forward/backward); actual zooming is performed by holding CTRL while scrolling.

You can move the camera virtual target by holding the middle-button down while moving the mouse. The camera target is materialized by a white ball (in the center of the view, may be hidden by other objects).

h2. Moving the robots around

To move a robot in the environment, you can either right-click on it in the robot you want to move and click "move robot". You can now use the keyboard arrows to move it in X/Y directions, and page-up/page-down to move it in Z.

Or you can use the widget "Robot Form" widget and use the sliders to act on each degree of freedom. There you can save configurations by clicking "Save Curr." button, or "Save (as init)", "Save (as goal)". The init and goal configurations are used for motion planning requests.

h2. The python interface

The main interface with move4d is through Python 3 bindings. This allow access through interactive shell (see [[Simple Usage#Launch-GUI-from-python-console]]). It also allows to create script for the most commonly commands used. The file attachment:move4ddemo.py has an initialization function and another function (reset) to be called from the python console.

To use it, you can call from your shell:

<pre><code class="sh">

ipython3 -i ./move4ddemo.py -- -f /path/to/p3d_file.p3d

</code></pre>

This command will execute the main() function with the arguments found after "@--@" and give you back the hand in the python console.