chore: create examples for scene commands

Author: mwfarb

content/python/basic/color.md renamed to content/python/attributes/color.md

@@ -1,15 +1,17 @@
 ---
 title: Color
 layout: default
-parent: Basic
+parent: Attributes
 grand_parent: Python Library
 ---
 
 # Color
 
 Change only the color of the already-drawn box.
 
-The following source code was mirrored from the `arena-py` [color.py](https://github.com/arenaxr/arena-py/blob/master/examples/basic/color.py) example.
+Additional Python properties are available in the [Color API Reference](/content/python-api/attributes/color).
+
+The following source code was mirrored from the `arena-py` [color.py](https://github.com/arenaxr/arena-py/blob/master/examples/attributes/color.py) example.
 
 ```python
 from arena import *

content/python/basic/parent.md renamed to content/python/attributes/parent.md

@@ -1,7 +1,7 @@
 ---
 title: Parent
 layout: default
-parent: Basic
+parent: Attributes
 grand_parent: Python Library
 ---
 
@@ -11,7 +11,9 @@ Child objects inherit attributes of their parent, for example scale. Scale the p
 
 There is support to attach a child to an already-existing parent scene objects. When creating a child object, set the `"parent": "parent_object_id"` value in the JSON data. For example if parent object is gltf-model_Earth and child object is gltf-model_Moon, the commands would look like:
 
-The following source code was mirrored from the `arena-py` [parent.py](https://github.com/arenaxr/arena-py/blob/master/examples/basic/parent.py) example.
+Additional Python properties are available in the [Parent API Reference](/content/python-api/attributes/parent).
+
+The following source code was mirrored from the `arena-py` [parent.py](https://github.com/arenaxr/arena-py/blob/master/examples/attributes/parent.py) example.
 
 ```python
 from arena import *

content/python/basic/object_id.md

@@ -0,0 +1,31 @@
+---
+title: ObjectId
+layout: default
+parent: Basic
+grand_parent: Python Library
+---
+
+# Object Naming
+
+
+The following source code was mirrored from the `arena-py` [object_id.py](https://github.com/arenaxr/arena-py/blob/master/examples/basic/object_id.py) example.
+
+```python
+from arena import *
+
+scene = Scene(host="arenaxr.org", scene="example")
+
+@scene.run_once
+def make_timed_sphere():
+    # create a box with a uuid generated name
+    box_named_id = Box()
+    scene.add_object(box_named_id)
+
+    # create a box with the name "box1"
+    box_named_uuid = Box(
+        object_id="box1",
+    )
+    scene.add_object(box_named_uuid)
+
+scene.run_tasks()
+```

content/python/simple/anim-test.md renamed to content/python/scenes/anim-test.md

@@ -1,13 +1,13 @@
 ---
 title: AnimTest
 layout: default
-parent: Simple
+parent: Scenes
 grand_parent: Python Library
 ---
 
 # Animation Test
 
-The following source code was mirrored from the `arena-py` [anim-test.py](https://github.com/arenaxr/arena-py/blob/master/examples/simple/anim-test.py) example.
+The following source code was mirrored from the `arena-py` [anim-test.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/anim-test.py) example.
 
 ```python
 from arena import *

content/python/simple/device-scene.md renamed to content/python/scenes/device-scene.md

@@ -1,15 +1,15 @@
 ---
 title: DeviceScene
 layout: default
-parent: Simple
+parent: Scenes
 grand_parent: Python Library
 ---
 
 # Device Scene
 
 Demonstrate starting two connections, for a scene and a device, and communicating between them.
 
-The following source code was mirrored from the `arena-py` [device-scene.py](https://github.com/arenaxr/arena-py/blob/master/examples/simple/device-scene.py) example.
+The following source code was mirrored from the `arena-py` [device-scene.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/device-scene.py) example.
 
 ```python
 import json

content/python/simple/device-sensor.md renamed to content/python/scenes/device-sensor.md

@@ -1,13 +1,13 @@
 ---
 title: DeviceSensor
 layout: default
-parent: Simple
+parent: Scenes
 grand_parent: Python Library
 ---
 
 # Device Sensor
 
-The following source code was mirrored from the `arena-py` [device-sensor.py](https://github.com/arenaxr/arena-py/blob/master/examples/simple/device-sensor.py) example.
+The following source code was mirrored from the `arena-py` [device-sensor.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/device-sensor.py) example.
 
 ```python
 import json

content/python/scenes/get-persisted-objs.md

@@ -0,0 +1,27 @@
+---
+title: GetPersistedObjs
+layout: default
+parent: Scenes
+grand_parent: Python Library
+---
+
+# Get Persisted Objects
+
+Tests scene `get_persisted_objs`.
+
+The following source code was mirrored from the `arena-py` [get-persisted-objs.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/get-persisted-objs.py) example.
+
+```python
+from arena import *
+
+scene = Scene(host="arenaxr.org", scene="test")
+
+@scene.run_once
+def main():
+    object_id = "the_box"
+    for obj_id,obj in scene.get_persisted_objs().items():
+        print(obj)
+        print()
+
+scene.run_tasks()
+```

content/python/scenes.md renamed to content/python/scenes/index.md

@@ -1,7 +1,8 @@
 ---
 title: Scenes
-nav_order: 1
+nav_order: 1.1
 layout: default
+has_children: true
 parent: Python Library
 ---
 
@@ -90,19 +91,19 @@ This is a list of the most common options available in this mode, (`python3 prog
 ```
 -h, --help            show this help message and exit
 -mh HOST, --host HOST
-                        ARENA webserver main host to connect to
+                    ARENA webserver main host to connect to
 -n NAMESPACE, --namespace NAMESPACE
-                        Namespace of scene
+                    Namespace of scene
 -s SCENE, --scene SCENE
-                        Scene to publish and listen to
+                    Scene to publish and listen to
 -d DEVICE, --device DEVICE
-                        Device to publish and listen to
+                    Device to publish and listen to
 -p POSITION POSITION POSITION, --position POSITION POSITION POSITION
-                        App position as cartesian.x cartesian.y cartesian.z
+                    App position as 'x y z'
 -r ROTATION ROTATION ROTATION, --rotation ROTATION ROTATION ROTATION
-                        App rotation as euler.x euler.y euler.z
+                    App rotation as 'x y z'
 -c SCALE SCALE SCALE, --scale SCALE SCALE SCALE
-                        App scale as cartesian.x cartesian.y cartesian.z
+                    App scale as 'x y z'
 -D, --debug           Debug mode.
 ```
 

content/python/scenes/move-camera.md

@@ -0,0 +1,45 @@
+---
+title: MoveCamera
+layout: default
+parent: Scenes
+grand_parent: Python Library
+---
+
+# Move Camera
+
+Move cameras to a random location.
+
+The following source code was mirrored from the `arena-py` [move-camera.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/move-camera.py) example.
+
+```python
+import random
+
+from arena import *
+
+def rando():
+    return float(random.randint(-100000, 100000)) / 1000
+
+def user_join_callback(camera):
+    print(f"User found: {camera.displayName} [object_id={camera.object_id}]")
+
+scene = Scene(host="arenaxr.org", scene="test")
+scene.user_join_callback = user_join_callback
+
+# box = Box(object_id="box")
+# scene.add_object(box)
+
+@scene.run_forever(interval_ms=500)
+def move_cams():
+    for c in scene.users:
+        scene.manipulate_camera(
+            c,
+            position=(rando(),1.6,rando()),
+            rotation=(0,0,0,1)
+        )
+        scene.look_at(
+            c,
+            target=(0,0,0)
+        )
+
+scene.run_tasks()
+```

content/python/simple/private-objs.md renamed to content/python/scenes/private-objs.md

@@ -1,7 +1,7 @@
 ---
 title: PrivateObjs
 layout: default
-parent: Simple
+parent: Scenes
 grand_parent: Python Library
 ---
 
@@ -18,7 +18,7 @@ to this program via private MQTT topics as well.
 We also print the global private objects dict to show how it is cleaned up when
 a user leaves the scene.
 
-The following source code was mirrored from the `arena-py` [private-objs.py](https://github.com/arenaxr/arena-py/blob/master/examples/simple/private-objs.py) example.
+The following source code was mirrored from the `arena-py` [private-objs.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/private-objs.py) example.
 
 ```python
 import random

content/python/scenes/rotate-camera.md

@@ -0,0 +1,58 @@
+---
+title: RotateCamera
+layout: default
+parent: Scenes
+grand_parent: Python Library
+---
+
+# Rotate Camera
+
+Rotate cameras around the origin.
+
+The following source code was mirrored from the `arena-py` [rotate-camera.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/rotate-camera.py) example.
+
+```python
+import math
+
+from arena import *
+
+radius = 10
+interval = 0
+sign = 1
+
+def user_join_callback(camera):
+    print(f"User found: {camera.displayName} [object_id={camera.object_id}]")
+
+scene = Scene(host="arenaxr.org", scene="test")
+scene.user_join_callback = user_join_callback
+
+@scene.run_forever(interval_ms=17)
+def move_cams():
+    global interval, sign
+    for c in scene.users:
+        xp = radius*math.cos(interval)
+        zp = radius*math.sin(interval)
+        scene.manipulate_camera(
+            c,
+            position=(
+                xp,
+                3,
+                zp,
+            ),
+            #rotation=Rotation(0,0,0)
+        )
+        scene.look_at(
+            c,
+            # target={"x": 0, "y": 0, "z": 0}
+            # target=(0, 0, 0)
+            target=(xp, 0, zp)
+        )
+    if interval > 3.14:
+        sign = -1
+    elif interval < 0:
+        sign = 1
+
+    interval = interval + (0.01*sign)
+
+scene.run_tasks()
+```

content/python/simple/upload-file.md renamed to content/python/scenes/upload-file.md

@@ -1,15 +1,15 @@
 ---
 title: UploadFile
 layout: default
-parent: Simple
+parent: Scenes
 grand_parent: Python Library
 ---
 
 # Uploading Files
 
 Upload some sample files to the ARENA filestore under the user's store folder and create objects to render them.
 
-The following source code was mirrored from the `arena-py` [upload-file.py](https://github.com/arenaxr/arena-py/blob/master/examples/simple/upload-file.py) example.
+The following source code was mirrored from the `arena-py` [upload-file.py](https://github.com/arenaxr/arena-py/blob/master/examples/scenes/upload-file.py) example.
 
 ```python
 from arena import *

content/python/simple/camera-print.md

@@ -5,7 +5,7 @@ parent: Simple
 grand_parent: Python Library
 ---
 
-# Camera Tracer
+# Camera Print
 
 Camera tracing program. Draws a path that follows the user.
 

content/python/simple/socket-client.md

@@ -7,7 +7,7 @@ grand_parent: Python Library
 
 # Socket Client
 
-Generate ARENA object json and send it to socket-server.py.
+Generate ARENA object json and send it to `socket-server.py`.
 
 The following source code was mirrored from the `arena-py` [socket-client.py](https://github.com/arenaxr/arena-py/blob/master/examples/simple/socket-client.py) example.
 

content/python/simple/ui.md

@@ -5,7 +5,7 @@ parent: Simple
 grand_parent: Python Library
 ---
 
-# ARENAUI
+# ARENA UI Panels
 
 Demonstrate a multi-path set of UI panels for a user to interact with.
 

content/python/tutorial/index.md

@@ -1,6 +1,6 @@
 ---
 title: Python Tutorial
-nav_order: 0
+nav_order: 1.0
 layout: default
 has_children: true
 parent: Python Library

scripts/pexample/make-py-examples.py

@@ -67,6 +67,7 @@ def create_python_markdown(folder, add_api=False):
 
 
 create_python_markdown("basic")
+create_python_markdown("scenes")
 create_python_markdown("callbacks")
 create_python_markdown("objects", add_api)
 create_python_markdown("attributes", add_api)