Merge branch 'main' into feat/customization-api

Author: AlejandroFernandezLuces

doc/changelog.d/464.miscellaneous.md

@@ -0,0 +1 @@
+Feat: Add parallel projection button

src/ansys/tools/visualization_interface/backends/pyvista/pyvista.py

@@ -47,6 +47,7 @@
 from ansys.tools.visualization_interface.backends.pyvista.widgets.mesh_slider import (
     MeshSliderWidget,
 )
+from ansys.tools.visualization_interface.backends.pyvista.widgets.parallel_projection import ParallelProjectionButton
 from ansys.tools.visualization_interface.backends.pyvista.widgets.pick_rotation_center import PickRotCenterButton
 from ansys.tools.visualization_interface.backends.pyvista.widgets.ruler import Ruler
 from ansys.tools.visualization_interface.backends.pyvista.widgets.screenshot import ScreenshotButton
@@ -220,6 +221,7 @@ def enable_widgets(self, dark_mode: bool = False) -> None:
             self._widgets.append(HideButton(self, dark_mode))
             self._widgets.append(PickRotCenterButton(self, dark_mode))
             self._widgets.append(DarkModeButton(self, dark_mode))
+            self._widgets.append(ParallelProjectionButton(self, dark_mode))
             # Add dynamic tree menu widget (always available)
             tree_menu = DynamicTreeMenuWidget(self, dark_mode=dark_mode)
             self._widgets.append(tree_menu)

src/ansys/tools/visualization_interface/backends/pyvista/pyvista_interface.py

@@ -157,6 +157,14 @@ def view_zy(self) -> None:
         """View the scene from the ZY plane."""
         self.scene.view_zy()
 
+    def enable_parallel_projection(self) -> None:
+        """Enable parallel projection for the camera."""
+        self.scene.camera.enable_parallel_projection()
+
+    def disable_parallel_projection(self) -> None:
+        """Disable parallel projection for the camera."""
+        self.scene.camera.disable_parallel_projection()
+
     def clip(
         self, mesh: Union[pv.PolyData, pv.MultiBlock, pv.UnstructuredGrid], plane: ClipPlane
     ) -> Union[pv.PolyData, pv.MultiBlock]:

src/ansys/tools/visualization_interface/backends/pyvista/trame_local.py

@@ -59,6 +59,7 @@ def __init__(self) -> None:
         self.state.measure_active = False
         self.state.mesh_slider_active = False
         self.state.ruler_active = False
+        self.state.parallel_projection = False
 
         # Store reference to plotter for controller methods
         self.plotter = None
@@ -197,6 +198,19 @@ def toggle_dark_mode():
             except Exception as e:
                 print(f"Error toggling dark mode: {e}")
 
+        @self.ctrl.set("toggle_parallel_projection")
+        def toggle_parallel_projection():
+            """Toggle parallel projection for camera."""
+            try:
+                self.state.parallel_projection = not self.state.parallel_projection
+                if self.state.parallel_projection:
+                    self.plotter.scene.camera.enable_parallel_projection()
+                else:
+                    self.plotter.scene.camera.disable_parallel_projection()
+                self.ctrl.view_update()
+            except Exception as e:
+                print(f"Error toggling parallel projection: {e}")
+
         @self.ctrl.set("displace_camera_x_up")
         def displace_camera_x_up():
             """Move camera in X+ direction."""
@@ -495,6 +509,12 @@ def view_isometric():
                             with vue.VListItemContent():
                                 vue.VListItemTitle("Dark Mode")
 
+                        with vue.VListItem(click=self.ctrl.toggle_parallel_projection):
+                            with vue.VListItemIcon():
+                                vue.VIcon("mdi-projector")
+                            with vue.VListItemContent():
+                                vue.VListItemTitle("Parallel Projection")
+
             # Hide footer with trame watermark
             layout.footer.hide()
 

src/ansys/tools/visualization_interface/backends/pyvista/widgets/_images/parallel_projection.png

@@ -0,0 +1,91 @@
+# Copyright (C) 2024 - 2026 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""Provides the parallel projection button widget."""
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from vtk import vtkActor, vtkButtonWidget, vtkPNGReader
+
+from ansys.tools.visualization_interface.backends.pyvista.widgets.widget import PlotterWidget
+
+if TYPE_CHECKING:
+    from ansys.tools.visualization_interface.backends.pyvista.pyvista import Plotter
+
+
+class ParallelProjectionButton(PlotterWidget):
+    """Toggle parallel projection for the camera.
+
+    Parameters
+    ----------
+    plotter : Plotter
+        Plotter to add the widget to.
+    dark_mode : bool, optional
+        Whether dark mode is active.
+
+    """
+
+    def __init__(self, plotter: "Plotter", dark_mode: bool = False) -> None:
+        """Initialize the button."""
+        super().__init__(plotter._pl.scene)
+        self._dark_mode = dark_mode
+        self._actor: vtkActor = None
+        self._plotter = plotter
+        self._button: vtkButtonWidget = self._plotter._pl.scene.add_checkbox_button_widget(
+            self.callback, position=(5, 50), size=30, border_size=3
+        )
+        self.update()
+
+    def callback(self, state: bool) -> None:
+        """Toggle parallel projection.
+
+        Parameters
+        ----------
+        state : bool
+            Button state from PyVista.
+
+        """
+        if state:
+            self._plotter.scene.camera.enable_parallel_projection()
+        else:
+            self._plotter.scene.camera.disable_parallel_projection()
+
+    def update(self) -> None:
+        """Update the button appearance."""
+        if self._dark_mode:
+            is_inv = "_inv"
+        else:
+            is_inv = ""
+
+        show_vr = self._button.GetRepresentation()
+        icon_file = Path(Path(__file__).parent / "_images" / f"parallel_projection{is_inv}.png")
+        show_r_on = vtkPNGReader()
+        show_r_on.SetFileName(icon_file)
+        show_r_on.Update()
+        image_on = show_r_on.GetOutput()
+
+        show_r_off = vtkPNGReader()
+        show_r_off.SetFileName(icon_file)
+        show_r_off.Update()
+        image_off = show_r_off.GetOutput()
+
+        show_vr.SetButtonTexture(0, image_off)
+        show_vr.SetButtonTexture(1, image_on)