examples: directory structure

When generating the gallery automatically, the structure
of the examples was not the same for all the modules.

This reorganization was made under the following assumption:

An example requires:
- its own directory,
- a '.pyproject' file,
- one or more '.py' files,
- extra files (likes images, .rc, .ui, etc)

Even for cases when  subdirectories are made to depict categories, like
'widgets/state-machine/...', one directory is required per example.

There should not be '.pyproject' files for categories,
except for the general 'examples.pyproject' to open all of them.

Task-number: PYSIDE-1490
Pick-to: 6.0
Change-Id: Ie690773c816a248016dbebaad90fbb1d1c2aeea5
Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>

3 files changed, 193 insertions, 0 deletions

diff --git a/examples/multimedia/camera/camera.py b/examples/multimedia/camera/camera.py
new file mode 100644
index 000000000..e8e95b7ee
--- /dev/null
+++ b/examples/multimedia/camera/camera.py
@@ -0,0 +1,169 @@
+
+#############################################################################
+##
+## Copyright (C) 2017 The Qt Company Ltd.
+## Contact: http://www.qt.io/licensing/
+##
+## This file is part of the Qt for Python examples of the Qt Toolkit.
+##
+## $QT_BEGIN_LICENSE:BSD$
+## You may use this file under the terms of the BSD license as follows:
+##
+## "Redistribution and use in source and binary forms, with or without
+## modification, are permitted provided that the following conditions are
+## met:
+##   * Redistributions of source code must retain the above copyright
+##     notice, this list of conditions and the following disclaimer.
+##   * Redistributions in binary form must reproduce the above copyright
+##     notice, this list of conditions and the following disclaimer in
+##     the documentation and/or other materials provided with the
+##     distribution.
+##   * Neither the name of The Qt Company Ltd nor the names of its
+##     contributors may be used to endorse or promote products derived
+##     from this software without specific prior written permission.
+##
+##
+## THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+## "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+## LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+## A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+## OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+## DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+## THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+## (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+## OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+##
+## $QT_END_LICENSE$
+##
+#############################################################################
+
+"""PySide6 Multimedia Camera Example"""
+
+import os, sys
+from PySide6.QtCore import QDate, QDir, QStandardPaths, Qt, QUrl
+from PySide6.QtGui import QAction, QGuiApplication, QDesktopServices, QIcon
+from PySide6.QtGui import QImage, QPixmap
+from PySide6.QtWidgets import (QApplication, QHBoxLayout, QLabel,
+    QMainWindow, QPushButton, QTabWidget, QToolBar, QVBoxLayout, QWidget)
+from PySide6.QtMultimedia import QCamera, QCameraImageCapture, QCameraInfo
+from PySide6.QtMultimediaWidgets import QCameraViewfinder
+
+class ImageView(QWidget):
+    def __init__(self, previewImage, fileName):
+        super(ImageView, self).__init__()
+
+        self.fileName = fileName
+
+        mainLayout = QVBoxLayout(self)
+        self.imageLabel = QLabel()
+        self.imageLabel.setPixmap(QPixmap.fromImage(previewImage))
+        mainLayout.addWidget(self.imageLabel)
+
+        topLayout = QHBoxLayout()
+        self.fileNameLabel = QLabel(QDir.toNativeSeparators(fileName))
+        self.fileNameLabel.setTextInteractionFlags(Qt.TextBrowserInteraction)
+
+        topLayout.addWidget(self.fileNameLabel)
+        topLayout.addStretch()
+        copyButton = QPushButton("Copy")
+        copyButton.setToolTip("Copy file name to clipboard")
+        topLayout.addWidget(copyButton)
+        copyButton.clicked.connect(self.copy)
+        launchButton = QPushButton("Launch")
+        launchButton.setToolTip("Launch image viewer")
+        topLayout.addWidget(launchButton)
+        launchButton.clicked.connect(self.launch)
+        mainLayout.addLayout(topLayout)
+
+    def copy(self):
+        QGuiApplication.clipboard().setText(self.fileNameLabel.text())
+
+    def launch(self):
+        QDesktopServices.openUrl(QUrl.fromLocalFile(self.fileName))
+
+class MainWindow(QMainWindow):
+    def __init__(self):
+        super(MainWindow, self).__init__()
+
+        self.cameraInfo = QCameraInfo.defaultCamera()
+        self.camera = QCamera(self.cameraInfo)
+        self.camera.setCaptureMode(QCamera.CaptureStillImage)
+        self.imageCapture = QCameraImageCapture(self.camera)
+        self.imageCapture.imageCaptured.connect(self.imageCaptured)
+        self.imageCapture.imageSaved.connect(self.imageSaved)
+        self.currentPreview = QImage()
+
+        toolBar = QToolBar()
+        self.addToolBar(toolBar)
+
+        fileMenu = self.menuBar().addMenu("&File")
+        shutterIcon = QIcon(os.path.join(os.path.dirname(__file__),
+                            "shutter.svg"))
+        self.takePictureAction = QAction(shutterIcon, "&Take Picture", self,
+                                         shortcut="Ctrl+T",
+                                         triggered=self.takePicture)
+        self.takePictureAction.setToolTip("Take Picture")
+        fileMenu.addAction(self.takePictureAction)
+        toolBar.addAction(self.takePictureAction)
+
+        exitAction = QAction(QIcon.fromTheme("application-exit"), "E&xit",
+                             self, shortcut="Ctrl+Q", triggered=self.close)
+        fileMenu.addAction(exitAction)
+
+        aboutMenu = self.menuBar().addMenu("&About")
+        aboutQtAction = QAction("About &Qt", self, triggered=qApp.aboutQt)
+        aboutMenu.addAction(aboutQtAction)
+
+        self.tabWidget = QTabWidget()
+        self.setCentralWidget(self.tabWidget)
+
+        self.cameraViewfinder = QCameraViewfinder()
+        self.camera.setViewfinder(self.cameraViewfinder)
+        self.tabWidget.addTab(self.cameraViewfinder, "Viewfinder")
+
+        if self.camera.status() != QCamera.UnavailableStatus:
+            name = self.cameraInfo.description()
+            self.setWindowTitle("PySide6 Camera Example (" + name + ")")
+            self.statusBar().showMessage("Starting: '" + name + "'", 5000)
+            self.camera.start()
+        else:
+            self.setWindowTitle("PySide6 Camera Example")
+            self.takePictureAction.setEnabled(False)
+            self.statusBar().showMessage("Camera unavailable", 5000)
+
+    def nextImageFileName(self):
+        picturesLocation = QStandardPaths.writableLocation(QStandardPaths.PicturesLocation)
+        dateString = QDate.currentDate().toString("yyyyMMdd")
+        pattern = picturesLocation + "/pyside6_camera_" + dateString + "_{:03d}.jpg"
+        n = 1
+        while True:
+            result = pattern.format(n)
+            if not os.path.exists(result):
+                return result
+            n = n + 1
+        return None
+
+    def takePicture(self):
+        self.currentPreview = QImage()
+        self.camera.searchAndLock()
+        self.imageCapture.capture(self.nextImageFileName())
+        self.camera.unlock()
+
+    def imageCaptured(self, id, previewImage):
+        self.currentPreview = previewImage
+
+    def imageSaved(self, id, fileName):
+        index = self.tabWidget.count()
+        imageView = ImageView(self.currentPreview, fileName)
+        self.tabWidget.addTab(imageView, "Capture #{}".format(index))
+        self.tabWidget.setCurrentIndex(index)
+
+if __name__ == '__main__':
+    app = QApplication(sys.argv)
+    mainWin = MainWindow()
+    availableGeometry = app.desktop().availableGeometry(mainWin)
+    mainWin.resize(availableGeometry.width() / 3, availableGeometry.height() / 2)
+    mainWin.show()
+    sys.exit(app.exec_())
diff --git a/examples/multimedia/camera/camera.pyproject b/examples/multimedia/camera/camera.pyproject
new file mode 100644
index 000000000..ffc6a11ed
--- /dev/null
+++ b/examples/multimedia/camera/camera.pyproject
@@ -0,0 +1,3 @@
+{
+    "files": ["camera.py"]
+}
diff --git a/examples/multimedia/camera/shutter.svg b/examples/multimedia/camera/shutter.svg
new file mode 100644
index 000000000..18493361d
--- /dev/null
+++ b/examples/multimedia/camera/shutter.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 20.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 23.3 19.4" style="enable-background:new 0 0 23.3 19.4;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:none;}
+</style>
+<g>
+	<path class="st0" d="M6.2,4.8H2.4c-0.2,0-0.1-0.1-0.1,0.1V17c0,0.2-0.1,0.8,0.1,0.8h3.9V4.8z"/>
+	<circle class="st0" cx="14" cy="11" r="4.5"/>
+	<path class="st0" d="M20.9,4.8h-1.8c-0.3,0-0.6-0.4-0.8-0.6l-1.7-2.4h-5.3L9.7,4.2C9.5,4.4,9.2,4.8,8.9,4.8H7.2v13h13.7
+		c0.2,0,0.3-0.6,0.3-0.8V4.9C21.2,4.7,21.1,4.8,20.9,4.8z M14,16.4c-3,0-5.5-2.4-5.5-5.5c0-3,2.4-5.5,5.5-5.5c3,0,5.5,2.4,5.5,5.5
+		C19.5,14,17,16.4,14,16.4z"/>
+	<path d="M14,5.5C11,5.5,8.6,8,8.6,11c0,3,2.4,5.5,5.5,5.5c3,0,5.5-2.4,5.5-5.5C19.5,8,17,5.5,14,5.5z M14,15.4
+		c-2.5,0-4.5-2-4.5-4.5c0-2.5,2-4.5,4.5-4.5c2.5,0,4.5,2,4.5,4.5C18.5,13.4,16.5,15.4,14,15.4z"/>
+	<path d="M20.9,2.8h-1.3l-1.7-2.4c-0.2-0.2-0.5-0.6-0.8-0.6h-6.3c-0.3,0-0.6,0.4-0.8,0.6L8.4,2.8h-6c-1.3,0-2.1,0.8-2.1,2.1V17
+		c0,1.3,0.8,2.8,2.1,2.8h18.5c1.3,0,2.3-1.5,2.3-2.8V4.9C23.2,3.6,22.2,2.8,20.9,2.8z M2.2,17V4.9c0-0.2-0.1-0.1,0.1-0.1h3.9v13H2.4
+		C2.2,17.8,2.2,17.2,2.2,17z M21.2,17c0,0.2-0.1,0.8-0.3,0.8H7.2v-13h1.7c0.3,0,0.6-0.4,0.8-0.6l1.7-2.4h5.3l1.7,2.4
+		c0.2,0.2,0.5,0.6,0.8,0.6h1.8c0.2,0,0.3-0.1,0.3,0.1V17z"/>
+</g>
+</svg>