diff options
author | Topi Reinio <topi.reinio@digia.com> | 2014-10-15 13:50:27 +0200 |
---|---|---|
committer | Topi Reiniƶ <topi.reinio@digia.com> | 2014-10-17 14:57:13 +0200 |
commit | cf8f369f8575dcb9ca4d5116f3afc7cff4a080af (patch) | |
tree | a685f393b50786a892fcd3ad638b4c01e9002894 /examples/ipc/sharedmemory | |
parent | 45485d9eb47d3129b8a74c2e9d854c07673161cd (diff) |
Move Qt Core examples under a common subdirectory
Qt Core examples were scattered into several subdirectories under
qtbase/examples. This caused an issue with the example manifest
file generated by QDoc; it expects to find all examples under a
common directory in order to produde correct paths to the example
.pro files. Qt Creator will not find the examples without a valid
manifest file.
This change moves the examples and edits the documentation files
accordingly.
Task-number: QTBUG-41963
Change-Id: I51d86782e0ba21c5c9bae5f15401ec774abe5cf8
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@digia.com>
Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@theqtcompany.com>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
Diffstat (limited to 'examples/ipc/sharedmemory')
-rw-r--r-- | examples/ipc/sharedmemory/dialog.cpp | 188 | ||||
-rw-r--r-- | examples/ipc/sharedmemory/dialog.h | 70 | ||||
-rw-r--r-- | examples/ipc/sharedmemory/dialog.ui | 47 | ||||
-rw-r--r-- | examples/ipc/sharedmemory/image.png | bin | 10199 -> 0 bytes | |||
-rw-r--r-- | examples/ipc/sharedmemory/main.cpp | 53 | ||||
-rw-r--r-- | examples/ipc/sharedmemory/qt.png | bin | 2383 -> 0 bytes | |||
-rw-r--r-- | examples/ipc/sharedmemory/sharedmemory.pro | 15 |
7 files changed, 0 insertions, 373 deletions
diff --git a/examples/ipc/sharedmemory/dialog.cpp b/examples/ipc/sharedmemory/dialog.cpp deleted file mode 100644 index c504f3a202..0000000000 --- a/examples/ipc/sharedmemory/dialog.cpp +++ /dev/null @@ -1,188 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/legal -** -** This file is part of the 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 Digia Plc and its Subsidiary(-ies) 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$ -** -****************************************************************************/ - -#include "dialog.h" -#include <QFileDialog> -#include <QBuffer> -#include <QtCore/QDebug> - -/*! - \class Dialog - - \brief This class is a simple example of how to use QSharedMemory. - - It is a simple dialog that presents a few buttons. To compile the - example, run make in qt/examples/ipc. Then run the executable twice - to create two processes running the dialog. In one of the processes, - press the button to load an image into a shared memory segment, and - then select an image file to load. Once the first process has loaded - and displayed the image, in the second process, press the button to - read the same image from shared memory. The second process displays - the same image loaded from its new loaction in shared memory. -*/ - -/*! - The class contains a data member \l {QSharedMemory} {sharedMemory}, - which is initialized with the key "QSharedMemoryExample" to force - all instances of Dialog to access the same shared memory segment. - The constructor also connects the clicked() signal from each of the - three dialog buttons to the slot function appropriate for handling - each button. -*/ -//! [0] -Dialog::Dialog(QWidget *parent) - : QDialog(parent), sharedMemory("QSharedMemoryExample") -{ - ui.setupUi(this); - connect(ui.loadFromFileButton, SIGNAL(clicked()), SLOT(loadFromFile())); - connect(ui.loadFromSharedMemoryButton, - SIGNAL(clicked()), - SLOT(loadFromMemory())); - setWindowTitle(tr("SharedMemory Example")); -} -//! [0] - -/*! - This slot function is called when the \tt {Load Image From File...} - button is pressed on the firs Dialog process. First, it tests - whether the process is already connected to a shared memory segment - and, if so, detaches from that segment. This ensures that we always - start the example from the beginning if we run it multiple times - with the same two Dialog processes. After detaching from an existing - shared memory segment, the user is prompted to select an image file. - The selected file is loaded into a QImage. The QImage is displayed - in the Dialog and streamed into a QBuffer with a QDataStream. - - Next, it gets a new shared memory segment from the system big enough - to hold the image data in the QBuffer, and it locks the segment to - prevent the second Dialog process from accessing it. Then it copies - the image from the QBuffer into the shared memory segment. Finally, - it unlocks the shared memory segment so the second Dialog process - can access it. - - After this function runs, the user is expected to press the \tt - {Load Image from Shared Memory} button on the second Dialog process. - - \sa loadFromMemory() - */ -//! [1] -void Dialog::loadFromFile() -{ - if (sharedMemory.isAttached()) - detach(); - - ui.label->setText(tr("Select an image file")); - QString fileName = QFileDialog::getOpenFileName(0, QString(), QString(), - tr("Images (*.png *.xpm *.jpg)")); - QImage image; - if (!image.load(fileName)) { - ui.label->setText(tr("Selected file is not an image, please select another.")); - return; - } - ui.label->setPixmap(QPixmap::fromImage(image)); -//! [1] //! [2] - - // load into shared memory - QBuffer buffer; - buffer.open(QBuffer::ReadWrite); - QDataStream out(&buffer); - out << image; - int size = buffer.size(); - - if (!sharedMemory.create(size)) { - ui.label->setText(tr("Unable to create shared memory segment.")); - return; - } - sharedMemory.lock(); - char *to = (char*)sharedMemory.data(); - const char *from = buffer.data().data(); - memcpy(to, from, qMin(sharedMemory.size(), size)); - sharedMemory.unlock(); -} -//! [2] - -/*! - This slot function is called in the second Dialog process, when the - user presses the \tt {Load Image from Shared Memory} button. First, - it attaches the process to the shared memory segment created by the - first Dialog process. Then it locks the segment for exclusive - access, copies the image data from the segment into a QBuffer, and - streams the QBuffer into a QImage. Then it unlocks the shared memory - segment, detaches from it, and finally displays the QImage in the - Dialog. - - \sa loadFromFile() - */ -//! [3] -void Dialog::loadFromMemory() -{ - if (!sharedMemory.attach()) { - ui.label->setText(tr("Unable to attach to shared memory segment.\n" \ - "Load an image first.")); - return; - } - - QBuffer buffer; - QDataStream in(&buffer); - QImage image; - - sharedMemory.lock(); - buffer.setData((char*)sharedMemory.constData(), sharedMemory.size()); - buffer.open(QBuffer::ReadOnly); - in >> image; - sharedMemory.unlock(); - - sharedMemory.detach(); - ui.label->setPixmap(QPixmap::fromImage(image)); -} -//! [3] - -/*! - This private function is called by the destructor to detach the - process from its shared memory segment. When the last process - detaches from a shared memory segment, the system releases the - shared memory. - */ -void Dialog::detach() -{ - if (!sharedMemory.detach()) - ui.label->setText(tr("Unable to detach from shared memory.")); -} - diff --git a/examples/ipc/sharedmemory/dialog.h b/examples/ipc/sharedmemory/dialog.h deleted file mode 100644 index fbc39ed4c0..0000000000 --- a/examples/ipc/sharedmemory/dialog.h +++ /dev/null @@ -1,70 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/legal -** -** This file is part of the 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 Digia Plc and its Subsidiary(-ies) 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$ -** -****************************************************************************/ - -#ifndef DIALOG_H -#define DIALOG_H - -#include <qdialog.h> -#include <qsharedmemory.h> -#include "ui_dialog.h" - -//! [0] -class Dialog : public QDialog -{ - Q_OBJECT - - public: - Dialog(QWidget *parent = 0); - - public slots: - void loadFromFile(); - void loadFromMemory(); - - private: - void detach(); - - private: - Ui::Dialog ui; - QSharedMemory sharedMemory; -}; -//! [0] - -#endif - diff --git a/examples/ipc/sharedmemory/dialog.ui b/examples/ipc/sharedmemory/dialog.ui deleted file mode 100644 index e99d6fb3c4..0000000000 --- a/examples/ipc/sharedmemory/dialog.ui +++ /dev/null @@ -1,47 +0,0 @@ -<ui version="4.0" > - <class>Dialog</class> - <widget class="QDialog" name="Dialog" > - <property name="geometry" > - <rect> - <x>0</x> - <y>0</y> - <width>451</width> - <height>322</height> - </rect> - </property> - <property name="windowTitle" > - <string>Dialog</string> - </property> - <layout class="QGridLayout" > - <item row="0" column="0" > - <widget class="QPushButton" name="loadFromFileButton" > - <property name="text" > - <string>Load Image From File...</string> - </property> - </widget> - </item> - <item row="1" column="0" > - <widget class="QLabel" name="label" > - <property name="text" > - <string>Launch two of these dialogs. In the first, press the top button and load an image from a file. In the second, press the bottom button and display the loaded image from shared memory.</string> - </property> - <property name="alignment" > - <set>Qt::AlignCenter</set> - </property> - <property name="wordWrap" > - <bool>true</bool> - </property> - </widget> - </item> - <item row="2" column="0" > - <widget class="QPushButton" name="loadFromSharedMemoryButton" > - <property name="text" > - <string>Display Image From Shared Memory</string> - </property> - </widget> - </item> - </layout> - </widget> - <resources/> - <connections/> -</ui> diff --git a/examples/ipc/sharedmemory/image.png b/examples/ipc/sharedmemory/image.png Binary files differdeleted file mode 100644 index dd93453063..0000000000 --- a/examples/ipc/sharedmemory/image.png +++ /dev/null diff --git a/examples/ipc/sharedmemory/main.cpp b/examples/ipc/sharedmemory/main.cpp deleted file mode 100644 index 0e9f84f3e3..0000000000 --- a/examples/ipc/sharedmemory/main.cpp +++ /dev/null @@ -1,53 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/legal -** -** This file is part of the 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 Digia Plc and its Subsidiary(-ies) 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$ -** -****************************************************************************/ - -#include <QApplication> -#include "dialog.h" - -//! [0] -int main(int argc, char *argv[]) -{ - QApplication application(argc, argv); - Dialog dialog; - dialog.show(); - return application.exec(); -} -//! [0] - diff --git a/examples/ipc/sharedmemory/qt.png b/examples/ipc/sharedmemory/qt.png Binary files differdeleted file mode 100644 index 60ef558efe..0000000000 --- a/examples/ipc/sharedmemory/qt.png +++ /dev/null diff --git a/examples/ipc/sharedmemory/sharedmemory.pro b/examples/ipc/sharedmemory/sharedmemory.pro deleted file mode 100644 index a392f9542d..0000000000 --- a/examples/ipc/sharedmemory/sharedmemory.pro +++ /dev/null @@ -1,15 +0,0 @@ -QT += widgets - -SOURCES += main.cpp \ - dialog.cpp - -HEADERS += dialog.h - -# Forms and resources -FORMS += dialog.ui - -EXAMPLE_FILES = *.png - -# install -target.path = $$[QT_INSTALL_EXAMPLES]/ipc/sharedmemory -INSTALLS += target |