improve docs

Author: robertsulej

examples/1_basics/2_beziers.py

@@ -70,8 +70,6 @@ def main():
 
     rt.set_data("curve", pos=xyz, r=r, c=c, geom="Beziers")
 
-    rt.show()
-
     rt.setup_camera("cam1", # cam_type="DoF",
                     eye=[-6, 4, 5], target=[0, -0.6, 0],
                     glock=True
@@ -82,6 +80,8 @@ def main():
 
     rt.set_param(max_accumulation_frames=256)
 
+    rt.show()
+
     print("done")
 
 if __name__ == '__main__':

plotoptix/enums.py

@@ -302,7 +302,12 @@ class Geometry(Enum):
     Beziers = 16
     """Bezier curves with data points used as **control points** for each independent segment (OptiX native implementation).
 
-    Curve thickness and color can be provided for each data point (curve node).
+    Curve thickness and color can be provided for each data point (bezier control point).
+    Each segment is described with 4 control points: start, ctrl #1, ctrl #2, end. Multiple
+    segments are described with an array of control point 3D positions (colors, radii) of
+    successive segments, i.g. N segments will require an array ``(4*N,3)`` of positions,
+    an array ``(4*N,3)`` of colors and an array ``(N,)`` of radii, see also ``2_beziers.py``
+    in basic code examples.
     """
 
     Ribbon = 17