PySide6-Examples 6.7.0__cp39-abi3-win_amd64.whl

PySide6/examples/graphs/3d/widgetgallery/variantbardatamapping.py

@@ -0,0 +1,67 @@
+# Copyright (C) 2023 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+from PySide6.QtCore import QObject, Signal
+
+
+class VariantBarDataMapping(QObject):
+
+    rowIndexChanged = Signal()
+    columnIndexChanged = Signal()
+    valueIndexChanged = Signal()
+    rowCategoriesChanged = Signal()
+    columnCategoriesChanged = Signal()
+    mappingChanged = Signal()
+
+    def __init__(self, rowIndex, columnIndex, valueIndex,
+                 rowCategories=[], columnCategories=[]):
+        super().__init__(None)
+        self._rowIndex = rowIndex
+        self._columnIndex = columnIndex
+        self._valueIndex = valueIndex
+        self._rowCategories = rowCategories
+        self._columnCategories = columnCategories
+
+    def setRowIndex(self, index):
+        self._rowIndex = index
+        self.mappingChanged.emit()
+
+    def rowIndex(self):
+        return self._rowIndex
+
+    def setColumnIndex(self, index):
+        self._columnIndex = index
+        self.mappingChanged.emit()
+
+    def columnIndex(self):
+        return self._columnIndex
+
+    def setValueIndex(self, index):
+        self._valueIndex = index
+        self.mappingChanged.emit()
+
+    def valueIndex(self):
+        return self._valueIndex
+
+    def setRowCategories(self, categories):
+        self._rowCategories = categories
+        self.mappingChanged.emit()
+
+    def rowCategories(self):
+        return self._rowCategories
+
+    def setColumnCategories(self, categories):
+        self._columnCategories = categories
+        self.mappingChanged.emit()
+
+    def columnCategories(self):
+        return self._columnCategories
+
+    def remap(self, rowIndex, columnIndex, valueIndex,
+              rowCategories=[], columnCategories=[]):
+        self._rowIndex = rowIndex
+        self._columnIndex = columnIndex
+        self._valueIndex = valueIndex
+        self._rowCategories = rowCategories
+        self._columnCategories = columnCategories
+        self.mappingChanged.emit()

PySide6/examples/graphs/3d/widgetgallery/variantbardataproxy.py

@@ -0,0 +1,100 @@
+# Copyright (C) 2023 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+from PySide6.QtCore import Slot
+from PySide6.QtGraphs import QBarDataProxy, QBarDataItem
+
+
+class VariantBarDataProxy(QBarDataProxy):
+
+    def __init__(self):
+        super().__init__()
+        self._dataSet = None
+        self._mapping = None
+
+    def setDataSet(self, newSet):
+        if self._dataSet:
+            self._dataSet.itemsAdded.disconnect(self.handleItemsAdded)
+            self._dataSet.dataCleared.disconnect(self.handleDataCleared)
+
+        self._dataSet = newSet
+
+        if self._dataSet:
+            self._dataSet.itemsAdded.connect(self.handleItemsAdded)
+            self._dataSet.dataCleared.connect(self.handleDataCleared)
+        self.resolveDataSet()
+
+    def dataSet(self):
+        return self._dataSet.data()
+
+    # Map key (row, column, value) to value index in data item (VariantItem).
+    # Doesn't gain ownership of mapping, but does connect to it to listen for
+    # mapping changes. Modifying mapping that is set to proxy will trigger
+    # dataset re-resolving.
+    def setMapping(self, mapping):
+        if self._mapping:
+            self._mapping.mappingChanged.disconnect(self.handleMappingChanged)
+
+        self._mapping = mapping
+
+        if self._mapping:
+            self._mapping.mappingChanged.connect(self.handleMappingChanged)
+
+        self.resolveDataSet()
+
+    def mapping(self):
+        return self._mapping.data()
+
+    @Slot(int, int)
+    def handleItemsAdded(self, index, count):
+        # Resolve new items
+        self.resolveDataSet()
+
+    @Slot()
+    def handleDataCleared(self):
+        # Data cleared, reset array
+        self.resetArray(None)
+
+    @Slot()
+    def handleMappingChanged(self):
+        self.resolveDataSet()
+
+    # Resolve entire dataset into QBarDataArray.
+    def resolveDataSet(self):
+        # If we have no data or mapping, or the categories are not defined,
+        # simply clear the array
+        if (not self._dataSet or not self._mapping
+                or not self._mapping.rowCategories()
+                or not self._mapping.columnCategories()):
+            self.resetArray()
+            return
+
+        itemList = self._dataSet.itemList()
+
+        rowIndex = self._mapping.rowIndex()
+        columnIndex = self._mapping.columnIndex()
+        valueIndex = self._mapping.valueIndex()
+        rowList = self._mapping.rowCategories()
+        columnList = self._mapping.columnCategories()
+
+        # Sort values into rows and columns
+        itemValueMap = {}
+        for item in itemList:
+            key = str(item[rowIndex])
+            v = itemValueMap.get(key)
+            if not v:
+                v = {}
+                itemValueMap[key] = v
+            v[str(item[columnIndex])] = float(item[valueIndex])
+
+        # Create a new data array in format the parent class understands
+        newProxyArray = []
+        for rowKey in rowList:
+            newProxyRow = []
+            for i in range(0, len(columnList)):
+                item = QBarDataItem(itemValueMap[rowKey][columnList[i]])
+                newProxyRow.append(item)
+            newProxyArray.append(newProxyRow)
+
+        # Finally, reset the data array in the parent class
+        self.resetArray(newProxyArray)

PySide6/examples/graphs/3d/widgetgallery/variantdataset.py

@@ -0,0 +1,39 @@
+# Copyright (C) 2023 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+from PySide6.QtCore import QObject, Signal
+
+
+class VariantDataSet(QObject):
+
+    itemsAdded = Signal(int, int)
+    dataCleared = Signal()
+
+    def __init__(self):
+        super().__init__()
+        self._variantData = []
+
+    def clear(self):
+        for item in self._variantData:
+            item.clear()
+            del item
+
+        self._variantData.clear()
+        self.dataCleared.emit()
+
+    def addItem(self, item):
+        self._variantData.append(item)
+        addIndex = len(self._variantData)
+
+        self.itemsAdded.emit(addIndex, 1)
+        return addIndex
+
+    def addItems(self, itemList):
+        newCount = len(itemList)
+        addIndex = len(self._variantData)
+        self._variantData.extend(itemList)
+        self.itemsAdded.emit(addIndex, newCount)
+        return addIndex
+
+    def itemList(self):
+        return self._variantData

PySide6/examples/graphs/3d/widgetgallery/widgetgallery.pyproject

@@ -0,0 +1,29 @@
+{
+    "files": ["main.py",
+              "axesinputhandler.py",
+              "bargraph.py",
+              "custominputhandler.py",
+              "graphmodifier.py",
+              "highlightseries.py",
+              "rainfalldata.py",
+              "scatterdatamodifier.py",
+              "scattergraph.py",
+              "surfacegraph.py",
+              "surfacegraphmodifier.py",
+              "topographicseries.py",
+              "variantbardatamapping.py",
+              "variantbardataproxy.py",
+              "variantdataset.py",
+              "data/layer_1.png",
+              "data/layer_2.png",
+              "data/layer_3.png",
+              "data/license.txt",
+              "data/maptexture.jpg",
+              "data/narrowarrow.mesh",
+              "data/oilrig.mesh",
+              "data/pipe.mesh",
+              "data/raindata.txt",
+              "data/refinery.mesh",
+              "data/topography.png"
+]
+}

PySide6/examples/gui/analogclock/analogclock.pyproject

@@ -0,0 +1,3 @@
+{
+    "files": ["main.py"]
+}

PySide6/examples/gui/analogclock/doc/analogclock.rst

@@ -0,0 +1,8 @@
+Analog Clock Window Example
+===========================
+
+The Analog Clock Window example shows how to draw the contents of
+a custom window.
+
+This example demonstrates how the transformation and scaling
+features of QPainter can be used to make drawing easier.

PySide6/examples/gui/analogclock/main.py

@@ -0,0 +1,92 @@
+# Copyright (C) 2022 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+import sys
+
+from PySide6.QtCore import QPoint, QTimer, QTime, Qt
+from PySide6.QtGui import QGuiApplication, QPainter, QPalette, QPolygon, QRasterWindow
+
+"""Simplified PySide6 port of the gui/analogclock example from Qt v6.x"""
+
+
+class AnalogClockWindow(QRasterWindow):
+
+    def __init__(self):
+        super().__init__()
+        self.setTitle("Analog Clock")
+        self.resize(200, 200)
+
+        self._timer = QTimer(self)
+        self._timer.timeout.connect(self.update)
+        self._timer.start(1000)
+
+        self._hour_hand = QPolygon([QPoint(5, 14), QPoint(-5, 14),
+                                    QPoint(-4, -71), QPoint(4, -71)])
+        self._minute_hand = QPolygon([QPoint(4, 14), QPoint(-4, 14),
+                                      QPoint(-3, -89), QPoint(3, -89)])
+        self._seconds_hand = QPolygon([QPoint(1, 14), QPoint(-1, 14),
+                                       QPoint(-1, -89), QPoint(1, -89)])
+
+        palette = qApp.palette()  # noqa: F821
+        self._background_color = palette.color(QPalette.Window)
+        self._hour_color = palette.color(QPalette.Text)
+        self._minute_color = palette.color(QPalette.Text)
+        self._seconds_color = palette.color(QPalette.Accent)
+
+    def paintEvent(self, e):
+        with QPainter(self) as painter:
+            self.render(painter)
+
+    def render(self, painter):
+        width = self.width()
+        height = self.height()
+
+        side = min(width, height)
+
+        painter.fillRect(0, 0, width, height, self._background_color)
+        painter.setRenderHint(QPainter.Antialiasing)
+        painter.translate(width / 2, height / 2)
+        painter.scale(side / 200.0, side / 200.0)
+
+        time = QTime.currentTime()
+
+        painter.setPen(Qt.NoPen)
+        painter.setBrush(self._hour_color)
+
+        painter.save()
+        painter.rotate(30.0 * ((time.hour() + time.minute() / 60.0)))
+        painter.drawConvexPolygon(self._hour_hand)
+        painter.restore()
+
+        for _ in range(0, 12):
+            painter.drawRect(73, -3, 16, 6)
+            painter.rotate(30.0)
+
+        painter.setBrush(self._minute_color)
+
+        painter.save()
+        painter.rotate(6.0 * time.minute())
+        painter.drawConvexPolygon(self._minute_hand)
+        painter.restore()
+
+        painter.setBrush(self._seconds_color)
+
+        painter.save()
+        painter.rotate(6.0 * time.second())
+        painter.drawConvexPolygon(self._seconds_hand)
+        painter.drawEllipse(-3, -3, 6, 6)
+        painter.drawEllipse(-5, -68, 10, 10)
+        painter.restore()
+
+        painter.setPen(self._minute_color)
+
+        for _ in range(0, 60):
+            painter.drawLine(92, 0, 96, 0)
+            painter.rotate(6.0)
+
+
+if __name__ == "__main__":
+    app = QGuiApplication(sys.argv)
+    clock = AnalogClockWindow()
+    clock.show()
+    sys.exit(app.exec())

PySide6/examples/gui/rhiwindow/doc/rhiwindow.rst

@@ -0,0 +1,49 @@
+.. _rhi-window-example:
+
+RHI Window Example
+==================
+
+This example shows how to create a minimal ``QWindow``-based
+application using ``QRhi``.
+
+Qt 6.6 starts offering its accelerated 3D API and shader abstraction layer for
+application use as well. Applications can now use the same 3D graphics classes
+Qt itself uses to implement the ``Qt Quick`` scenegraph or the ``Qt Quick`` 3D
+engine. In earlier Qt versions ``QRhi`` and the related classes were all
+private APIs. From 6.6 on these classes are in a similar category as QPA family
+of classes: neither fully public nor private, but something in-between, with a
+more limited compatibility promise compared to public APIs. On the other hand,
+``QRhi`` and the related classes now come with full documentation similarly to
+public APIs.
+
+There are multiple ways to use ``QRhi``, the example here shows the most
+low-level approach: targeting a ``QWindow``, while not using ``Qt Quick``, ``Qt
+Quick 3D``, or Widgets in any form, and setting up all the rendering and
+windowing infrastructure in the application.
+
+In contrast, when writing a QML application with ``Qt Quick`` or ``Qt Quick
+3D``, and wanting to add ``QRhi``-based rendering to it, such an application is
+going to rely on the window and rendering infrastructure ``Qt Quick`` has
+already initialized, and it is likely going to query an existing ``QRhi``
+instance from the ``QQuickWindow``. There dealing with ``QRhi::create()``,
+platform/API specifics or correctly handling ``QExposeEvent`` and resize events
+for the window are all managed by Qt Quick. Whereas in this example, all that
+is managed and taken care of by the application itself.
+
+.. note:: For ``QWidget``-based applications, see the :ref:`rhi-widget-example`.
+
+Shaders
+-------
+
+Due to being a Qt GUI/Python module example, this example cannot have a
+dependency on the ``Qt Shader Tools`` module. This means that ``CMake`` helper
+functions such as ``qt_add_shaders`` are not available for use. Therefore, the
+example has the pre-processed ``.qsb`` files included in the
+``shaders/prebuilt`` folder, and they are simply included within the executable
+via a resource file}. This approach is not generally recommended for
+applications.
+
+
+.. image:: rhiwindow.webp
+   :width: 800
+   :alt: RHI Window Example

PySide6/examples/gui/rhiwindow/main.py

@@ -0,0 +1,80 @@
+# Copyright (C) 2023 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+
+from argparse import ArgumentParser, RawDescriptionHelpFormatter
+import sys
+
+from PySide6.QtCore import QCoreApplication
+from PySide6.QtGui import QGuiApplication, QRhi, QSurfaceFormat
+
+from rhiwindow import HelloWindow
+import rc_rhiwindow  # noqa: F401
+
+if __name__ == "__main__":
+    app = QGuiApplication(sys.argv)
+
+    # Use platform-specific defaults when no command-line arguments given.
+    graphicsApi = QRhi.OpenGLES2
+    if sys.platform == "win32":
+        graphicsApi = QRhi.D3D11
+    elif sys.platform == "darwin":
+        graphicsApi = QRhi.Metal
+
+    parser = ArgumentParser(formatter_class=RawDescriptionHelpFormatter,
+                            description="QRhi render example")
+    parser.add_argument("--null", "-n", action="store_true", help="Null")
+    parser.add_argument("--opengl", "-g", action="store_true", help="OpenGL")
+    parser.add_argument("--d3d11", "-d", action="store_true",
+                        help="Direct3D 11")
+    parser.add_argument("--d3d12", "-D", action="store_true",
+                        help="Direct3D 12")
+    parser.add_argument("--metal", "-m", action="store_true",
+                        help="Metal")
+    args = parser.parse_args()
+    if args.null:
+        graphicsApi = QRhi.Null
+    elif args.opengl:
+        graphicsApi = QRhi.OpenGLES2
+    elif args.d3d11:
+        graphicsApi = QRhi.D3D11
+    elif args.d3d12:
+        graphicsApi = QRhi.D3D12
+    elif args.metal:
+        graphicsApi = QRhi.Metal
+
+    # graphicsApi = QRhi.Vulkan?  detect? needs QVulkanInstance
+
+    # For OpenGL, to ensure there is a depth/stencil buffer for the window.
+    # With other APIs this is under the application's control
+    # (QRhiRenderBuffer etc.) and so no special setup is needed for those.
+    fmt = QSurfaceFormat()
+    fmt.setDepthBufferSize(24)
+    fmt.setStencilBufferSize(8)
+    # Special case macOS to allow using OpenGL there.
+    # (the default Metal is the recommended approach, though)
+    # gl_VertexID is a GLSL 130 feature, and so the default OpenGL 2.1 context
+    # we get on macOS is not sufficient.
+    if sys.platform == "darwin":
+        fmt.setVersion(4, 1)
+        fmt.setProfile(QSurfaceFormat.CoreProfile)
+    QSurfaceFormat.setDefaultFormat(fmt)
+
+    window = HelloWindow(graphicsApi)
+
+    window.resize(1280, 720)
+    title = QCoreApplication.applicationName() + " - " + window.graphicsApiName()
+    window.setTitle(title)
+    window.show()
+
+    ret = app.exec()
+
+    # RhiWindow::event() will not get invoked when the
+    # PlatformSurfaceAboutToBeDestroyed event is sent during the QWindow
+    # destruction. That happens only when exiting via app::quit() instead of
+    # the more common QWindow::close(). Take care of it: if the QPlatformWindow
+    # is still around (there was no close() yet), get rid of the swapchain
+    # while it's not too late.
+    if window.isVisible():
+        window.releaseSwapChain()
+
+    sys.exit(ret)