Engauge Digitizer  2
TutorialStateChecklistWizardAbstract.cpp
Go to the documentation of this file.
1 /******************************************************************************************************
2  * (C) 2014 markummitchell@github.com. This file is part of Engauge Digitizer, which is released *
3  * under GNU General Public License version 2 (GPLv2) or (at your option) any later version. See file *
4  * LICENSE or go to gnu.org/licenses for details. Distribution requires prior written permission. *
5  ******************************************************************************************************/
6 
7 #include "Logger.h"
8 #include <qdebug.h>
9 #include <QGraphicsPixmapItem>
10 #include <QGraphicsScene>
11 #include <QGraphicsView>
12 #include "TutorialButton.h"
13 #include "TutorialDlg.h"
15 #include "TutorialStateContext.h"
16 
18  TutorialStateAbstractBase (context),
19  m_title (nullptr),
20  m_background (nullptr),
21  m_text0 (nullptr),
22  m_text1 (nullptr),
23  m_text2 (nullptr),
24  m_text3 (nullptr),
25  m_previous (nullptr)
26 {
27 }
28 
30 {
31  LOG4CPP_INFO_S ((*mainCat)) << "TutorialStateChecklistWizardAbstract::begin ()";
32 
33  context().tutorialDlg().scene().clear ();
34 
35  m_title = createTitle (tr ("Checklist Wizard and Checklist Guide"));
36  m_background = createPixmapItem (":/engauge/img/panel_checklist.png",
37  QPoint (0, 30));
38  m_text0 = createTextItem (tr ("For new Engauge users, a Checklist Wizard\n"
39  "is available when importing an image file.\n"
40  "This wizard produces a helpful checklist of\n"
41  "steps to follow to digitize the image file."),
42  QPoint (260, 30));
43  m_text1 = createTextItem (tr ("Step 1 - Enable the menu option Help /\n"
44  "Checklist Guide Wizard."),
45  QPoint (285, 125));
46  m_text2 = createTextItem (tr ("Step 2 - Import the file using File /\n"
47  "Import. The Checklist Wizard will appear\n"
48  "and ask some simple questions to\n"
49  "determine how the image can be\n"
50  "digitized."),
51  QPoint (285, 175));
52  m_text3 = createTextItem (tr ("Additional options are available in\n"
53  "the various Settings menus.\n\n"
54  "This ends the tutorial. Good luck!"),
55  QPoint (285, 270));
56 
57  QSize backgroundSize = context().tutorialDlg().backgroundSize();
58 
59  m_previous = new TutorialButton (tr ("Previous"),
60  context().tutorialDlg().scene());
61  m_previous->setGeometry (QPoint (buttonMargin (),
62  backgroundSize.height () - buttonMargin() - m_previous->size().height()));
63 }
64 
66 {
67  LOG4CPP_INFO_S ((*mainCat)) << "TutorialStateChecklistWizardAbstract::end ()";
68 
69  // It is not safe to remove and deallocate items here since an active TutorialButton
70  // may be on the stack. So we clear the scene as the first step in the next begin()
71 }
72 
74 {
75  return m_previous;
76 }
One state manages one panel of the tutorial.
QSize size() const
Size of this button.
void setGeometry(const QPoint &pos)
Set the position. This is called after creation so screen extent is available for positioning calcula...
Show a button with text for clicking ion. The button is implemented using layering of two graphics it...
#define LOG4CPP_INFO_S(logger)
Definition: convenience.h:18
QGraphicsScene & scene()
Single scene the covers the entire tutorial dialog.
Definition: TutorialDlg.cpp:76
TutorialStateContext & context()
Context class for the tutorial state machine.
QGraphicsTextItem * createTextItem(const QString &text, const QPoint &pos)
Factory method for text items.
QGraphicsTextItem * createTitle(const QString &text)
Factory method for title items.
QGraphicsPixmapItem * createPixmapItem(const QString &resource, const QPoint &pos)
Factory method for pixmap items.
TutorialButton * previous()
Previous button for hooking up button to slot.
TutorialStateChecklistWizardAbstract(TutorialStateContext &context)
Single constructor.
QSize backgroundSize() const
Make geometry available for layout.
Definition: TutorialDlg.cpp:44
log4cpp::Category * mainCat
Definition: Logger.cpp:14
Context class for tutorial state machine.
int buttonMargin() const
Buttons are placed up against bottom side, and left or right side, separated by this margin.
TutorialDlg & tutorialDlg()
Access to tutorial dialogs and its scene.