vuer 0.0.7rc2__py3-none-any.whl → 0.0.9__py3-none-any.whl

vuer/base.py

@@ -55,10 +55,6 @@ class Server:
     cors = Proto(help="Enable CORS", default="*")
     port = Proto(env="PORT", default=8012)
 
-    # @abstractmethod
-    # def __init__(self):
-    #     self.__post_init__()
-
     def __post_init__(self):
         self.app = web.Application()
 
@@ -73,10 +69,10 @@ class Server:
         self.cors_context = aiohttp_cors.setup(self.app, defaults=cors_config)
 
     def _route(
-        self,
-        path: str,
-        handler: callable,
-        method: str = "GET",
+            self,
+            path: str,
+            handler: callable,
+            method: str = "GET",
     ):
         route = self.app.router.add_resource(path).add_route(method, handler)
         self.cors_context.add(route)

vuer/schemas.py

@@ -4,7 +4,7 @@ import numpy as np
 import PIL.Image as pil_image
 from numpy._typing import NDArray
 
-# from msgpack_numpy import pack, packb
+from vuer.serdes import IMAGE_FORMATS
 
 element_count = 0
 
@@ -33,6 +33,7 @@ class Element:
         Serialize the element to a dictionary for sending over the websocket.
         :return: Dictionary representing the element.
         """
+
         # note: only return the non-private attributes, allow bypass.
         output = {}
         for k, v in self.__dict__.items():
@@ -212,11 +213,17 @@ class Image(Element):
     def __init__(
         self,
         data: Union[str, np.ndarray, pil_image.Image] = None,
+        *,
         src: str = None,
+        format="png",
         **kwargs,
     ):
         if src is not None:
             assert data is None, "data and src can not be truful at the same time"
+        if data is None:
+            pass
+        elif isinstance(data, list) and len(data) == 0:
+            pass
         else:
             if isinstance(data, pil_image.Image):
                 data = data
@@ -224,31 +231,15 @@ class Image(Element):
                 # convert back to image first from base64
                 data = pil_image.open(data)
             elif isinstance(data, np.ndarray):
-                data = (data * 255).astype(np.uint8)
+                if data.dtype == np.uint8:
+                    pass
+                else:
+                    data = (data * 255).astype(np.uint8)
 
-            src = self.base64(data)
+            src = IMAGE_FORMATS[format](data)
 
         super().__init__(src=src, **kwargs)
 
-    @staticmethod
-    def base64(image_data):
-        # if self.data is not None:
-        from io import BytesIO
-        import numpy as np
-        import base64
-
-        with BytesIO() as buf:
-            # todo: specify PNG vs JPG
-            if isinstance(image_data, np.ndarray):
-                pil_image.fromarray(image_data).save(buf, "png")
-            else:
-                assert isinstance(image_data, pil_image.Image)
-                image_data.save(buf, "png")
-
-            return "data:image/png;base64," + base64.b64encode(buf.getvalue()).decode(
-                "utf-8"
-            )
-
 
 class ImageUpload(Element):
     """
@@ -301,12 +292,15 @@ class DefaultScene(Scene):
         show_helper=True,
         **kwargs,
     ):
-        super().__init__(
-            # Ambient Light does not have helper because it is ambient.
-            AmbientLight(intensity=0.5, key="default_ambient_light"),
+        rawChildren = [
+            AmbientLight(intensity=1.0, key="default_ambient_light"),
             DirectionalLight(
                 intensity=1, key="default_directional_light", helper=show_helper
             ),
+            *(rawChildren or []),
+        ]
+        super().__init__(
+            # Ambient Light does not have helper because it is ambient.
             *children,
             rawChildren=rawChildren,
             htmlChildren=htmlChildren,
@@ -474,6 +468,14 @@ class Wireframe(SceneElement):
     tag = "Wireframe"
 
 
+class Splat(SceneElement):
+    tag = "Splat"
+
+
+class LumaSplats(SceneElement):
+    tag = "Splats"
+
+
 class Pcd(SceneElement):
     tag = "Pcd"
 
@@ -482,6 +484,23 @@ class CameraView(SceneElement):
     tag = "CameraView"
 
 
+class SceneBackground(Image, SceneElement):
+    """Sets the background of the scene to a static image. Does not work well
+    with high frame rates. For displaying movies, use the ImageBackground element.
+    """
+
+    tag = "SceneBackground"
+
+
+class ImageBackground(Image, SceneElement):
+    """Sets the background of the scene to an image, Supports high frame rates.
+
+    We use a plane that is always facing the camera to display the image.
+    """
+
+    tag = "ImageBackground"
+
+
 class Gamepads(SceneElement):
     tag = "Gamepads"
 

vuer/serdes.py

@@ -1,5 +1,9 @@
+import base64
+from io import BytesIO
 from typing import Sequence
 
+from PIL import Image as pil_image
+
 
 def serializer(data):
     if hasattr(data, "serialize"):
@@ -35,3 +39,57 @@ def serializer(data):
     #
     # return data
     # # raise NotImplementedError(f"Cannot serialize {data}")
+
+
+def jpg(image, quality: int = 90):
+    """
+    base64 encode the image into a string, using JPEG encoding
+
+    Does not support transparency.
+    """
+    with BytesIO() as buff:
+        rgb_pil = pil_image.fromarray(image)
+        rgb_pil.save(buff, format="JPEG", quality=quality)
+        return buff.getbuffer().tobytes()
+
+
+def png(image):
+    """
+    base64 encode the image into a string, using PNG encoding
+    """
+    with BytesIO() as buff:
+        rgb_pil = pil_image.fromarray(image)
+        rgb_pil.save(buff, format="PNG")
+        return buff.getbuffer().tobytes()
+
+
+def b64jpg(image, quality: int = 90):
+    """
+    base64 encode the image into a string, using JPEG encoding
+
+    Does not support transparency.
+    """
+    buff = BytesIO()
+    rgb_pil = pil_image.fromarray(image)
+    rgb_pil.save(buff, format="JPEG", quality=quality)
+    img64 = base64.b64encode(buff.getbuffer().tobytes()).decode("utf-8")
+    return "data:image/jpeg;base64," + img64
+
+
+def b64png(image):
+    """
+    base64 encode the image into a string, using PNG encoding
+    """
+    with BytesIO() as buff:
+        rgb_pil = pil_image.fromarray(image)
+        rgb_pil.save(buff, format="PNG")
+        img64 = base64.b64encode(buff.getbuffer().tobytes()).decode("utf-8")
+        return "data:image/png;base64," + img64
+
+
+IMAGE_FORMATS = {
+    "jpg": jpg,
+    "png": png,
+    "b64jpg": b64jpg,
+    "b64png": b64png,
+}

vuer/server.py

@@ -49,12 +49,12 @@ class Vuer(PrefixProto, Server):
     name = "vuer"
     uri = "ws://localhost:8012"
     # change to vuer.dash.ml
-    domain = "https://dash.ml/vuer"
+    domain = "https://vuer.ai"
     port = 8012
     free_port = True
     static_root = "."
     queue_len = None
-    # cors = "https://dash.ml,http://localhost:8000,http://127.0.0.1:8000,*"
+    cors = "https://vuer.ai,https://dash.ml,http://localhost:8000,http://127.0.0.1:8000,*"
     queries = Proto({}, help="query parameters to pass")
 
     WEBSOCKET_MAX_SIZE = 2**28

vuer-0.0.9.dist-info/METADATA

@@ -0,0 +1,80 @@
+Metadata-Version: 2.1
+Name: vuer
+Version: 0.0.9
+Home-page: https://github.com/geyang/vuer
+Author: Ge Yang<ge.ike.yang@gmail.com>
+Author-email: ge.ike.yang@gmail.com
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Requires-Python: >=3.8.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: aiohttp-cors
+Requires-Dist: killport
+Requires-Dist: params-proto >=2.11.16
+Requires-Dist: pillow
+Requires-Dist: tqdm
+Requires-Dist: msgpack
+Requires-Dist: numpy
+Requires-Dist: termcolor
+Requires-Dist: trimesh
+Requires-Dist: websockets
+Provides-Extra: dev
+Requires-Dist: black ==22.3.0 ; extra == 'dev'
+Requires-Dist: pylint ==2.13.4 ; extra == 'dev'
+Requires-Dist: pytest ==7.1.2 ; extra == 'dev'
+
+# Vuer: A modern 3D Visualizer for Robotics and VR
+
+Vuer is a 3D visualization tool for robotics and VR applications.
+
+## Installation In A Fresh Conda Environment
+
+Setup the conda environment
+```bash
+conda create -n vuer python=3.8
+conda activate vuer
+```
+
+Install vuer
+```bash
+pip install vuer==0.0.9
+
+pip install numpy
+pip install trimesh
+pip install websockets
+pip install aiohttp-cors
+pip install pillow
+```
+
+Now, to run the examples, first download the example datasets. 
+
+Each subdirectory in the `assets` directory contains a `Makefile`. Run the `make` command in each subdirectory to download the datasets. For example:
+
+```bash
+cd assets/static_3d
+make
+```
+
+Then run the examples
+
+```bash
+cd vuer/examples/vuer
+python 01_trimesh.py
+```
+
+## To Develop
+
+### Setting up the Document Site
+
+https://www.docslikecode.com/learn/05-cd-for-docs/
+
+```bash
+cd docs
+pip install -r requirements.txt
+```
+
+
+

vuer-0.0.9.dist-info/RECORD

@@ -0,0 +1,29 @@
+vuer/__init__.py,sha256=x2ZqgbBIDHQr7UvdkKhVdtYToIZdhXw4XTRnfrQiBos,28
+vuer/base.py,sha256=ZpZJoOFXh73a0yiWep-S3SZHY4dgyuxLki4HT2A8k-o,2974
+vuer/events.py,sha256=sfl5m1J0Tc3kDnboLGHQwELfBAUokA-ME-84OfvzfOg,4962
+vuer/schemas.py,sha256=4ebQZWk02a3W-YNkj3wkifJTQZBoffTzJdZGPjYoW4g,13353
+vuer/serdes.py,sha256=_4q65iHmIW-Op5OCvNwgAy7Z4ofOcvuW3NfTbRfiuZo,2398
+vuer/server.py,sha256=JAJMUDKBAfmY9XQ2-KHYy7Ea_tWK3H5Bw186ZPT8fJM,10958
+vuer/types.py,sha256=4jVXsuLjaQwmnCrK9j9G6vSVbmb8cq72WhptZg3qOuU,681
+vuer/__pycache__/__init__.cpython-38.pyc,sha256=LI9NbVr-FxZraiRRd33pmOxNogkeiyVNjbZKLq-l93o,166
+vuer/__pycache__/base.cpython-38.pyc,sha256=Y6PEto5NzO42uoQGObSAJJ6SDN8UTsx4oLqvemV9MZU,3868
+vuer/__pycache__/events.cpython-38.pyc,sha256=P7yQWuaQWH8oQ6pgU8cfJDDzQXqkxtJChkpGwQxtnR0,6543
+vuer/__pycache__/schemas.cpython-38.pyc,sha256=dWtBo-NzIZse1Ld6AD_HzB_5ZTou56oD5a5kBhFDEHU,18716
+vuer/__pycache__/serdes.cpython-38.pyc,sha256=oT1A94H8ayRCxNnw0L-7Q5Dt3535MOwXZMkvyQQvB9M,2032
+vuer/__pycache__/server.cpython-38.pyc,sha256=LhABfyQZmiWM9akGKwvDqgKByUTYK11q-raUCpWQr_Y,10518
+vuer/__pycache__/types.cpython-38.pyc,sha256=c5flT-KV4D-N4Gz0v7FzLtAa9hiS9B5J_UeB2h5JiDY,1565
+vuer/addons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vuer/addons/nerf_vuer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vuer/addons/nerf_vuer/control_components.py,sha256=K4PU0nD572L4J7lLFfShWficWZQnH4t-x6WWMrAVw8g,290
+vuer/addons/nerf_vuer/mixins.py,sha256=fQuW3adf6X2xw_PSfS145TNfbQ9OoTKuv8mYEo6Pt6A,12966
+vuer/addons/nerf_vuer/nerf_vuer.py,sha256=R5vI7g_sObbW1LTZ2VnR7pci7aO8iUtkKIbNnbqHnRU,5183
+vuer/addons/nerf_vuer/render_components.py,sha256=XilHnJySJWVgmdUbPFNYyc_YWV8O5AcKkBEZOUFbnMI,3821
+vuer/addons/nerf_vuer/render_nodes.py,sha256=5TKqIbMPiOtBxfF4FQI6uB0w_9FTfGiwS8xRbhPa0_g,14441
+vuer/addons/nerfuer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vuer/addons/nerfuer/render_nodes.py,sha256=EJK5N3xne5n7abTaAoLPX7SRqQ_tEen9zNypvSnZTTw,4465
+vuer-0.0.9.dist-info/LICENSE,sha256=MGF-inVBUaGe2mEjqT0g6XsHIXwoNXgNHqD7Z1MzR0k,1063
+vuer-0.0.9.dist-info/METADATA,sha256=Hg8Dvos7jt9H11n3PJGlfioXEtdNjQ8FoHg-cM-v6Qs,1691
+vuer-0.0.9.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
+vuer-0.0.9.dist-info/entry_points.txt,sha256=J_NM6fbpipmD9oP7cdxd1UyBR8mVEQVx0xjlE_56yss,41
+vuer-0.0.9.dist-info/top_level.txt,sha256=ermmVkwvGFAK4gfSgDIwOmKpxwpqNt-oo7gVQQUSHok,5
+vuer-0.0.9.dist-info/RECORD,,

vuer-0.0.7rc2.dist-info/METADATA

@@ -1,34 +0,0 @@
-Metadata-Version: 2.1
-Name: vuer
-Version: 0.0.7rc2
-Home-page: https://github.com/geyang/vuer
-Author: Ge Yang<ge.ike.yang@gmail.com>
-Author-email: ge.ike.yang@gmail.com
-License: MIT
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python
-Requires-Python: >=3.8.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: tqdm
-Requires-Dist: termcolor
-Requires-Dist: params-proto
-Requires-Dist: killport
-Requires-Dist: msgpack
-Provides-Extra: dev
-Requires-Dist: black ==22.3.0 ; extra == 'dev'
-Requires-Dist: pylint ==2.13.4 ; extra == 'dev'
-Requires-Dist: pytest ==7.1.2 ; extra == 'dev'
-
-# Vuer: A modern 3D Visualizer for Robotics and VR
-
-Vuer is a 3D visualization tool for robotics and VR applications.
-
-## Installation
-
-```python
-pip install vuer
-```
-
-
-

vuer-0.0.7rc2.dist-info/RECORD

@@ -1,22 +0,0 @@
-vuer/__init__.py,sha256=x2ZqgbBIDHQr7UvdkKhVdtYToIZdhXw4XTRnfrQiBos,28
-vuer/base.py,sha256=qylAS25I-cBGB_GQd2CSLZMpmAk2dhpIGrTIhENX2nk,3038
-vuer/events.py,sha256=sfl5m1J0Tc3kDnboLGHQwELfBAUokA-ME-84OfvzfOg,4962
-vuer/schemas.py,sha256=lnipEPrD0GNaT6-yTbGIx657PuBIMB1eg8upJi1Jszc,13053
-vuer/serdes.py,sha256=MyTyc_qMlrlU9PLpX6VtIJz-XnmSyntj22bS_1SVzZE,921
-vuer/server.py,sha256=U0HjjcU1BxR2LPNSLCOXyrnivgHQvuMCxL-s0cXkRgI,10949
-vuer/types.py,sha256=4jVXsuLjaQwmnCrK9j9G6vSVbmb8cq72WhptZg3qOuU,681
-vuer/addons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vuer/addons/nerf_vuer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vuer/addons/nerf_vuer/control_components.py,sha256=K4PU0nD572L4J7lLFfShWficWZQnH4t-x6WWMrAVw8g,290
-vuer/addons/nerf_vuer/mixins.py,sha256=fQuW3adf6X2xw_PSfS145TNfbQ9OoTKuv8mYEo6Pt6A,12966
-vuer/addons/nerf_vuer/nerf_vuer.py,sha256=R5vI7g_sObbW1LTZ2VnR7pci7aO8iUtkKIbNnbqHnRU,5183
-vuer/addons/nerf_vuer/render_components.py,sha256=XilHnJySJWVgmdUbPFNYyc_YWV8O5AcKkBEZOUFbnMI,3821
-vuer/addons/nerf_vuer/render_nodes.py,sha256=5TKqIbMPiOtBxfF4FQI6uB0w_9FTfGiwS8xRbhPa0_g,14441
-vuer/addons/nerfuer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vuer/addons/nerfuer/render_nodes.py,sha256=EJK5N3xne5n7abTaAoLPX7SRqQ_tEen9zNypvSnZTTw,4465
-vuer-0.0.7rc2.dist-info/LICENSE,sha256=MGF-inVBUaGe2mEjqT0g6XsHIXwoNXgNHqD7Z1MzR0k,1063
-vuer-0.0.7rc2.dist-info/METADATA,sha256=-feg2vczencHFqX1rP1WjG2JwEjYUUWbsX3rDaCTf3E,808
-vuer-0.0.7rc2.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
-vuer-0.0.7rc2.dist-info/entry_points.txt,sha256=J_NM6fbpipmD9oP7cdxd1UyBR8mVEQVx0xjlE_56yss,41
-vuer-0.0.7rc2.dist-info/top_level.txt,sha256=ermmVkwvGFAK4gfSgDIwOmKpxwpqNt-oo7gVQQUSHok,5
-vuer-0.0.7rc2.dist-info/RECORD,,