ncca-ngl 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

ncca/ngl/widgets/vec4widget.py

@@ -0,0 +1,178 @@
+from PySide6.QtCore import Property, QSignalBlocker, Signal
+from PySide6.QtWidgets import QDoubleSpinBox, QFrame, QHBoxLayout, QLabel, QWidget
+
+from ncca.ngl import Vec4
+
+
+class Vec4Widget(QFrame):
+    """A widget for displaying and editing a Vec4 object."""
+
+    valueChanged = Signal(Vec4)
+    xValueChanged = Signal(float)
+    yValueChanged = Signal(float)
+    zValueChanged = Signal(float)
+    wValueChanged = Signal(float)
+
+    def __init__(self, parent: QWidget | None = None, name: str = "", value: Vec4 = Vec4(0.0, 0.0, 0.0, 1.0)) -> None:
+        """
+        Args:
+            name: The name of the widget.
+            value: The initial value of the widget.
+            parent: The parent widget.
+        """
+        super().__init__(parent)
+        self.setFrameShape(QFrame.Shape.StyledPanel)
+        self._value = value
+        self._name = name
+        layout = QHBoxLayout()
+
+        self.x_spinbox = self._create_spinbox(self._value.x)
+        self.y_spinbox = self._create_spinbox(self._value.y)
+        self.z_spinbox = self._create_spinbox(self._value.z)
+        self.w_spinbox = self._create_spinbox(self._value.w)
+
+        self._label = QLabel(self._name)
+        layout.addWidget(self._label)
+        layout.addWidget(self.x_spinbox)
+        layout.addWidget(self.y_spinbox)
+        layout.addWidget(self.z_spinbox)
+        layout.addWidget(self.w_spinbox)
+        self.setLayout(layout)
+
+    def _create_spinbox(self, value: float) -> QDoubleSpinBox:
+        """Helper method to create and configure a QDoubleSpinBox.
+
+        Args:
+            value: The initial value of the spinbox.
+
+        Returns:
+            A configured QDoubleSpinBox.
+        """
+        spinbox = QDoubleSpinBox()
+        spinbox.setValue(value)
+        spinbox.setRange(-5.0, 5.0)
+        spinbox.setSingleStep(0.01)
+        spinbox.valueChanged.connect(self._on_value_changed)
+        return spinbox
+
+    def get_value(self) -> Vec4:
+        """
+        Returns:
+            The current value of the widget.
+        """
+        return self._value
+
+    def _on_value_changed(self, value: float) -> None:
+        """This slot is called when the value of a spinbox changes.
+
+        Args:
+            value: The new value of the spinbox.
+        """
+        sender = self.sender()
+        if sender == self.x_spinbox:
+            self._value.x = value
+            self.xValueChanged.emit(value)
+        elif sender == self.y_spinbox:
+            self._value.y = value
+            self.yValueChanged.emit(value)
+        elif sender == self.z_spinbox:
+            self._value.z = value
+            self.zValueChanged.emit(value)
+        elif sender == self.w_spinbox:
+            self._value.w = value
+            self.wValueChanged.emit(value)
+        # emit the Vec4 value changed signal
+        self.valueChanged.emit(self._value)
+
+    def set_value(self, value: Vec4) -> None:
+        """Sets the value of the widget.
+
+        Args:
+            value: The new value of the widget.
+        """
+        with (
+            QSignalBlocker(self.x_spinbox),
+            QSignalBlocker(self.y_spinbox),
+            QSignalBlocker(self.z_spinbox),
+            QSignalBlocker(self.w_spinbox),
+        ):
+            self.x_spinbox.setValue(value.x)
+            self.y_spinbox.setValue(value.y)
+            self.z_spinbox.setValue(value.z)
+            self.w_spinbox.setValue(value.w)
+        self._value = value
+        self.valueChanged.emit(self._value)
+
+    def get_name(self) -> str:
+        """
+        Returns:
+            The name of the widget.
+        """
+        return self._name
+
+    def set_range(self, min_val: float, max_val: float) -> None:
+        """Sets the range for all spinboxes.
+
+        Args:
+            min_val: The minimum value.
+            max_val: The maximum value.
+        """
+        for spinbox in (self.x_spinbox, self.y_spinbox, self.z_spinbox, self.w_spinbox):
+            spinbox.setRange(min_val, max_val)
+
+    def set_x_range(self, min_val: float, max_val: float) -> None:
+        """Sets the range for the x spinbox.
+
+        Args:
+            min_val: The minimum value.
+            max_val: The maximum value.
+        """
+        self.x_spinbox.setRange(min_val, max_val)
+
+    def set_y_range(self, min_val: float, max_val: float) -> None:
+        """Sets the range for the y spinbox.
+
+        Args:
+            min_val: The minimum value.
+            max_val: The maximum value.
+        """
+        self.y_spinbox.setRange(min_val, max_val)
+
+    def set_z_range(self, min_val: float, max_val: float) -> None:
+        """Sets the range for the z spinbox.
+
+        Args:
+            min_val: The minimum value.
+            max_val: The maximum value.
+        """
+        self.z_spinbox.setRange(min_val, max_val)
+
+    def set_w_range(self, min_val: float, max_val: float) -> None:
+        """Sets the range for the w spinbox.
+
+        Args:
+            min_val: The minimum value.
+            max_val: The maximum value.
+        """
+        self.w_spinbox.setRange(min_val, max_val)
+
+    def set_single_step(self, step: float) -> None:
+        """Sets the single step for all spinboxes.
+
+        Args:
+            step: The single step value.
+        """
+        for spinbox in (self.x_spinbox, self.y_spinbox, self.z_spinbox, self.w_spinbox):
+            spinbox.setSingleStep(step)
+
+    def set_name(self, name: str) -> None:
+        """Sets the name of the widget.
+
+        Args:
+            name: The new name of the widget.
+        """
+        self._name = name
+        self._label.setText(name)
+
+    value = Property(Vec4, get_value, set_value)
+    name = Property(str, get_name, set_name)

{ncca_ngl-0.3.0.dist-info → ncca_ngl-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ncca-ngl
-Version: 0.3.0
+Version: 0.3.2
 Summary: A Python version of the NGL graphics library.
 Author: Jon Macey
 Author-email: Jon Macey <jmacey@bournemouth.ac.uk>

{ncca_ngl-0.3.0.dist-info → ncca_ngl-0.3.2.dist-info}/RECORD

@@ -61,6 +61,22 @@ ncca/ngl/vec3.py,sha256=N_-LvP0nB0CQrZWG7TJntUl6QDHzIVLP-J1w8wPZTM0,12275
 ncca/ngl/vec3_array.py,sha256=fLRC8k0TwcaU7CnR2GmJ0prud4dcvvUX0JTbQH_2W3Y,3535
 ncca/ngl/vec4.py,sha256=mLl23D-3yAxh7GsP44ilRto-PMqIDxJjcZpNl2MyqGQ,6751
 ncca/ngl/vec4_array.py,sha256=PSJXfG0g2AT4oQCLHiVAP6EC5n7vMXRQy0N1rGvv1iw,3426
-ncca_ngl-0.3.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-ncca_ngl-0.3.0.dist-info/METADATA,sha256=2ZYRgZJeE3S3Qhlm-9BJQsPof91hJBfq-dgFb9FHyLk,1596
-ncca_ngl-0.3.0.dist-info/RECORD,,
+ncca/ngl/widgets/NGLDebug.log,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ncca/ngl/widgets/__init__.py,sha256=KBrwCwgDLIl-eAp0Q5HQcmNkfZ9q6waPC_4A8-g9PG0,413
+ncca/ngl/widgets/__main__.py,sha256=EetuulVqYJV7zxxFXunb12XA6boza7vm5Raayj3UeMI,2729
+ncca/ngl/widgets/glsl/phong.frag,sha256=iP-4cx0Qh7CS4tDbQmSdDX4huW3_XqleQaXdRBAiZ3A,853
+ncca/ngl/widgets/glsl/phong.vert,sha256=3v1dZba9FTS0ly-3rtEYMTiKPGIzfezDjhu-4m4SwDY,333
+ncca/ngl/widgets/glsl/picking.frag,sha256=372ZzBC1KME9i6lmO7yvUnio9YHp7u6wqiV2cGesTxs,100
+ncca/ngl/widgets/glsl/picking.vert,sha256=Bbn2vZ-lk3nD8qfXfIIaxan2V85XkpWUipYRWCMXobw,128
+ncca/ngl/widgets/lookatwidget.py,sha256=2o1tFE5d9UgWTtBesnhX8bC84ccGcl5nTXxjKOCiM30,3088
+ncca/ngl/widgets/mat4widget.py,sha256=7vXs5h2EtA6zy3rTpXd8dtlOg2CFeQHlrg4a4F1RMak,202
+ncca/ngl/widgets/rgbacolourwidget.py,sha256=dA_Ph7kTtd6ZqSvINt4qCbksMOWrsnT4TeuPfvaw4IQ,5411
+ncca/ngl/widgets/rgbcolourwidget.py,sha256=Z5t_JNUggbCDIpT3kmBtOWXtxrMNJZJxZCBGBOjBFlI,4741
+ncca/ngl/widgets/transformation_widget.py,sha256=qeEYXKEwUVdWBKz3oXiW6kbTm-MyXghoh0rfU7J3yAE,10568
+ncca/ngl/widgets/transformwidget.py,sha256=5Nwo1dVTVVhxTK2tNScyZc4s3nsfePvRh8dbV8Akl60,3487
+ncca/ngl/widgets/vec2widget.py,sha256=w4GqwuiNewc2UI5PrSn6ZZYEaB_cxkpxGgrpMQ82WsM,4330
+ncca/ngl/widgets/vec3widget.py,sha256=PnmqdQ1j77v0PQC-p4lT3mTQd_Qi2Iwv9XzSP1Mpa7M,4934
+ncca/ngl/widgets/vec4widget.py,sha256=mT7c5paDaRxn-vSv7lbffg7isyD8T-6sUxOUMqJXBZs,5631
+ncca_ngl-0.3.2.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+ncca_ngl-0.3.2.dist-info/METADATA,sha256=qie_EczaljTi9nHFBUpcOLdcs4H-tUKKRHTu5opRegM,1596
+ncca_ngl-0.3.2.dist-info/RECORD,,