Playground scene format should be documented

[MobsyaBot]

Issue by stephanemagnenat Wednesday May 11, 2016 at 10:31 GMT Originally opened as https://github.com/aseba-community/aseba/issues/511

---

Scene format should be documented, to allow third-parties to build scenes. This documentation should be translated.

[MobsyaBot]

Comment by ddoak Wednesday May 11, 2016 at 16:54 GMT

---

It could also be useful if the format specified a 'friendly' default camera position for the scene (this would also help with #510 as it would avoid the immediate need for the user to manipulate the camera when a scene loads) e.g. for the discovery playmat scenes - something like this:

[MobsyaBot]

Comment by stephanemagnenat Thursday May 12, 2016 at 07:02 GMT

---

Camera tag added in commit e9e04d8. I also changed the defaults in EnkiViewer to behave like in your screenshot.

Camera tag arguments are:

• x x-position of the camera
• y y-position of the camera
• altitude height of the camera
• yaw yaw rotation of the camera (0 == x-axis aligned, mathematical orientation when scene viewed from the top)
• pitch pitch rotation of the camera (0 == horizontal, positive is up, negative is down)

An example would be <camera x="50" y="10" altitude="50" yaw=" 1.57" pitch="-0.8" />

[mbonani]

partial documentation is done by HowToBuildAPlayground.playground