feat: adapt to new ansys-tools-visualization-interface v0.4.0 (#1338)

Co-authored-by: pyansys-ci-bot <[email protected]>

Author: RobPasMue

doc/changelog.d/1338.changed.md

@@ -0,0 +1 @@
+feat: adapt to new ansys-tools-visualization-interface v0.4.0

doc/source/_static/assets/multicolors.png

@@ -33,6 +33,7 @@
 #
 # Using env var instead
 os.environ["PYANSYS_VISUALIZER_DOC_MODE"] = "true"
+os.environ["PYANSYS_VISUALIZER_HTML_BACKEND"] = "true"
 
 LaTeXBuilder.supported_image_types = ["image/png", "image/pdf", "image/svg+xml"]
 

doc/source/conf.py

@@ -175,11 +175,37 @@ The Python visualizer is used by default. However, you can also use
 
 ```python
 
-plotter = GeometryPlotter
-(use_trame=True)
+plotter = GeometryPlotter(use_trame=True)
 plotter.show(plot_list)
 ```
 
+## Render in different colors
+
+You can render the objects in different colors automatically using PyVista's default
+color cycler. In order to do this, activate the ``multi_colors=True`` option when calling
+the ``plot()`` method.
+
+In the following cell we will create a new design and plot a prism and a cylinder in different colors.
+
+```python
+design = modeler.create_design("MultiColors")
+
+# Create a sketch of a box
+sketch_box = Sketch().box(Point2D([0, 0], unit=UNITS.m), width=30 * UNITS.m, height=40 * UNITS.m)
+
+# Create a sketch of a circle (overlapping the box slightly)
+sketch_circle = Sketch().circle(Point2D([20, 0], unit=UNITS.m), radius=3 * UNITS.m)
+
+# Extrude both sketches to get a prism and a cylinder
+design.extrude_sketch("Prism", sketch_box, 50 * UNITS.m)
+design.extrude_sketch("Cylinder", sketch_circle, 50 * UNITS.m)
+
+# Design plotting
+design.plot(multi_colors=True)
+```
+
+![](../../_static/assets/multicolors.png)
+
 ## Clip objects
 
 You can clip any object represented in the plotter by defining a ``Plane`` object that

doc/source/examples/01_getting_started/05_plotter_picker.mystnb

@@ -51,7 +51,7 @@ all = [
 tests = [
     "ansys-platform-instancemanagement==1.1.2",
     "ansys-tools-path==0.6.0",
-    "ansys-tools-visualization-interface==0.3.0",
+    "ansys-tools-visualization-interface==0.4.0",
     "beartype==0.18.5",
     "docker==7.1.0",
     "grpcio==1.65.1",
@@ -78,7 +78,7 @@ tests-minimal = [
 ]
 doc = [
     "ansys-sphinx-theme[autoapi]==0.16.6",
-    "ansys-tools-visualization-interface==0.3.0",
+    "ansys-tools-visualization-interface==0.4.0",
     "beartype==0.18.5",
     "docker==7.1.0",
     "ipyvtklink==0.2.3",