finalizing

Author: shensquared

demo.ipynb

@@ -157,7 +157,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "In addition to the usual geometries / objects, it is also possible to write 2d texts, either onto the scene:"
+    "MeshCat supports simple 2d texts rendering. For example, to write 2d texts onto a geometry or object:"
    ]
   },
   {
@@ -166,14 +166,14 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "vis.set_text('hello world')"
+    "vis.set_text('Hello, world!',g.Box([1, 1, 1]),font_size=20)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Or onto an object:"
+    "It is also possible to simple write 'floating' texts onto a scene without attached to an object (e.g., for scene discription):"
    ]
   },
   {
@@ -182,7 +182,25 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "vis.set_text('hello world',g.Box([0.2, 0.2, 0.2]))"
+    "vis.set_text('Hello, world!')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Under the hood, the 'floating' texts are written onto a `g.Plane()` geometry, so to change the texts size:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for i in np.linspace(10,2,20):\n",
+    "    vis.set_text('Hello, world!', plane_width=2*i,plane_height=i,font_size=200)\n",
+    "    time.sleep(0.05)"
    ]
   },
   {

src/meshcat/commands.py

@@ -36,16 +36,17 @@ def lower(self):
 class SetText:
     __slots__ = ["object", "path"]
 
-    def __init__(self, text, geometry_or_object, material=None, path=[]):
-        self.text_texture = TextTexture(text)
+    def __init__(self, text, geometry_or_object, plane_width=10,
+        plane_height=5, material=None, path=[], **kwargs):
+        self.text_texture = TextTexture(text, **kwargs)
         if isinstance(geometry_or_object, Object):
             if material is not None:
                 raise(ArgumentError(
                     "Please supply either an Object OR a Geometry and a Material"))
             self.object = geometry_or_object
         else:
             if geometry_or_object is None:
-                geometry_or_object = Plane(width=10, height=5)
+                geometry_or_object = Plane(width=plane_width, height=plane_height)
                 # if writing onto the scene, default material is transparent
                 material = MeshPhongMaterial(map=self.text_texture,
                                              needsUpdate=True, transparent=True)

src/meshcat/geometry.py

@@ -97,7 +97,8 @@ class Ring(Geometry):
     Optional thetaStart and thetaLength by default gives a full ring (2pi angle)
     """
 
-    def __init__(self, innerRadius, outerRadius, thetaStart=0, thetaLength=np.pi * 2):
+    def __init__(self, innerRadius, outerRadius, thetaStart=0,
+       thetaLength=np.pi * 2):
         super(Ring, self).__init__()
         self.innerRadius = innerRadius
         self.outerRadius = outerRadius
@@ -138,36 +139,6 @@ def lower(self, object_data):
             u"thetaLength": self.thetaLength
         }
 
-
-# class Text(Geometry):
-
-#     def __init__(self, text, font='helvetiker', size=100, height=50,
-#                  curveSegments=12, bevelEnabled=False, bevelThickness=10,
-#                  bevelSize=8, bevelSegments=3):
-#         super(Text, self).__init__()
-#         self.text = text
-#         self.font = font
-#         self.size = size
-#         self.curveSegments = curveSegments
-#         self.bevelEnabled = bevelEnabled
-#         self.bevelThickness = bevelThickness
-#         self.bevelSize = bevelSize
-#         self.bevelSegments = bevelSegments
-
-#      def lower(self, object_data):
-#         {
-#              u"uuid": self.uuid,
-#             u"type": u"_textgeometry",
-#             u"text": self.text,
-#             u"font": self.font,
-#             u"size": self.size,
-#              u"height": self.height,
-#             u"curveSegments": self.curveSegments
-#          }
-
-
-
-
 class Plane(Geometry):
 
     def __init__(self, width=1, height=1, widthSegments=1, heightSegments=1):
@@ -217,11 +188,10 @@ def lower(self, object_data):
         }
 
 
-
 class MeshMaterial(Material):
 
     def __init__(self, color=0xffffff, reflectivity=0.5, map=None,
-       transparent = False, **kwargs):
+                 transparent=False, **kwargs):
         super(MeshMaterial, self).__init__()
         self.color = color
         self.reflectivity = reflectivity
@@ -285,20 +255,18 @@ def __init__(self):
     def lower(self, object_data):
         return {
             u"uuid": self.uuid,
-            # hacky, needs a nominal "url" filed to get rid of JS side warning,
-            # so putting an empty one here
             u"url": ""
         }
 
 
 class TextTexture(Texture):
 
-    def __init__(self, text, font_size = 96, font_face='sans-serif',
-       width=200, height=100, position=[10, 10]):
+    def __init__(self, text, font_size=96, font_face='sans-serif',
+                 width=200, height=100, position=[10, 10]):
         super(TextTexture, self).__init__()
         self.text = text
-        # font_size will be passed to the JS side as is; however if the text
-        # width exceeds canvas width, font_size will be reduced.
+        # font_size will be passed to the JS side as is; however if the 
+        # text width exceeds canvas width, font_size will be reduced.
         self.font_size = font_size
         self.font_face = font_face
         self.width = width

src/meshcat/visualizer.py

@@ -21,9 +21,11 @@ def capture(pattern, s):
     else:
         return match.groups()[0]
 
+
 def match_zmq_url(line):
     return capture(r"^zmq_url=(.*)$", line)
 
+
 def match_web_url(line):
     return capture(r"^web_url=(.*)$", line)
 
@@ -54,12 +56,9 @@ def __init__(self, zmq_url, start_server):
             # callback in the server until we reconnect.
             self.connect_zmq()
 
-
         print("You can open the visualizer by visiting the following URL:")
         print(self.web_url)
 
-
-
     def connect_zmq(self):
         self.zmq_socket = self.context.socket(zmq.REQ)
         self.zmq_socket.connect(self.zmq_url)
@@ -137,9 +136,11 @@ def set_object(self, geometry, material=None):
     def set_transform(self, matrix=np.eye(4)):
         return self.window.send(SetTransform(matrix, self.path))
 
-    def set_text(self,text, geometry=None,material=None):
-        return self.window.send(SetText(text,geometry,material,self.path))
-        
+    def set_text(self, text, geometry=None, plane_width=10, plane_height=5,
+       material=None,**kwargs):
+        return self.window.send(SetText(text, geometry, plane_width=plane_width,
+            plane_height=plane_height, material=material, path=self.path, **kwargs))
+
     def set_animation(self, animation, play=True, repetitions=1):
         return self.window.send(SetAnimation(animation, play=play, repetitions=repetitions))
 
@@ -166,4 +167,3 @@ def __repr__(self):
 
     while True:
         time.sleep(100)
-