/*
- * Copyright (c) 2007, Arnaud Giersch <arnaud.giersch@iut-bm.univ-fcomte.fr>
+ * Copyright (c) 2007
-2010, Arnaud Giersch <arnaud.giersch@iut-bm.univ-fcomte.fr>
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* \brief Fenêtre de dessin.
*
* \author Arnaud Giersch <arnaud.giersch@iut-bm.univ-fcomte.fr>
- * \date novembre 2007
+ * \date 2007-2010
*
* Cette classe décrit un widget Qt permettant d'écrire des
* applications graphiques simples. Pour cela, il faut définir une
* La fonction devra ensuite être passée en paramètre pour les
* constructeurs de la classe, ainsi que les dimension requises pour
* la fenêtre graphique. Le programme est ensuite compilé comme
- * n'importe programme Qt.
+ * n'importe quel programme Qt.
*
* Concrètement, la fonction sera exécutée dans un nouveau thread,
* tandis que le thread principal s'occupera de la gestion des
- * évènements et du rendu.
+ * évènements et du rendu dans la fenêtre.
+ *
+ * <b>NB.</b> Pour toutes les méthodes de dessin, le coin en haut à gauche
+ * de la fenêtre a les coordonnées (0, 0). Le coin en bas à droite de
+ * la fenêtre a les coordonnées (largeur - 1, hauteur - 1), si la
+ * fenêtre est de dimension largeur × hauteur.
+ *
+ * Un appui sur la touche <Esc> provoque la fermeture de la fenêtre.
+ * Comme pour la plupart des applications, il est également possible
+ * de fermer la fenêtre via le gestionnaire de fenêtres.
+ *
+ * Il est possible, dans une application, d'ouvrir plusieurs fenêtres,
+ * avec des fonctions de dessin éventuellement différentes.
+ * L'application se terminera normalement lorsque la dernière fenêtre
+ * sera fermée.
*/
/*! \example hello.cpp
*
* <b>4. Exécuter le programme avec la commande :</b>
*
- * \verbatim ./exemple \endverbatim
+ * \verbatim ./hello \endverbatim
*
* <b>Code source de l'exemple</b>
*/
return image->pixel(x, y);
}
+//! Attend l'appui sur un des boutons de la souris.
+/*!
+ * Attend l'appui sur un des boutons de la souris. Retourne le bouton
+ * qui a été pressé et les coordonnées du pointeur de souris à ce
+ * moment-là.
+ *
+ * \param x, y coordonnées du pointeur de souris
+ * \param button numéro du bouton qui a été pressé
+ * (1: gauche, 2: droit, 3: milieu, 0 sinon)
+ * \param time durée maximale de l'attente
+ * \return true si un bouton a été pressé
+ *
+ * \bug expérimental
+ */
+bool DrawingWindow::waitMousePress(int &x, int &y, int &button,
+ unsigned long time)
+{
+ bool pressed;
+ safeLock(mouseMutex);
+ if (terminateThread) {
+ pressed = false;
+ } else {
+ pressed = mouseCondition.wait(&mouseMutex, time);
+ if (pressed) {
+ x = mousePos.x();
+ y = mousePos.y();
+ if (mouseButton & Qt::LeftButton)
+ button = 1;
+ else if (mouseButton & Qt::RightButton)
+ button = 2;
+ else if (mouseButton & Qt::MidButton)
+ button = 3;
+ else
+ button = 0;
+ }
+ }
+ safeUnlock(mouseMutex);
+ return pressed;
+}
+
//! Synchronise le contenu de la fenêtre.
/*!
* Pour des raisons d'efficacités, le résultat des fonctions de dessin
timer.stop();
thread->terminate();
syncMutex.lock();
+ mouseMutex.lock();
terminateThread = true; // this flag is needed for the case
// where the following wakeAll() call
// occurs between the
// mutex lock in safeLock() called
// from sync()
syncCondition.wakeAll();
+ mouseCondition.wakeAll();
+ mouseMutex.unlock();
syncMutex.unlock();
QWidget::closeEvent(ev);
thread->wait();
}
}
+/*!
+ * \see QWidget
+ *
+ * \bug expérimental
+ */
+void DrawingWindow::mousePressEvent(QMouseEvent *ev)
+{
+ mouseMutex.lock();
+ mousePos = ev->pos();
+ mouseButton = ev->button();
+ ev->accept();
+ mouseCondition.wakeAll();
+ mouseMutex.unlock();
+}
+
/*!
* \see QWidget
*/
