Engauge Digitizer 2
Loading...
Searching...
No Matches
ChecklistGuideWizard Class Reference

Wizard for setting up the checklist guide. More...

#include <ChecklistGuideWizard.h>

Inheritance diagram for ChecklistGuideWizard:
Inheritance graph
Collaboration diagram for ChecklistGuideWizard:
Collaboration graph

Public Member Functions

 ChecklistGuideWizard (MainWindow &mainWindow, unsigned int numberCoordSystem)
 Single constructor.
QStringList curveNames (CoordSystemIndex coordSystemIndex) const
 Curve names to be placed into Document.
void populateCurvesGraphs (CoordSystemIndex coordSystemIndex, CurvesGraphs &curvesGraphs)
 Create entries in CurvesGraphs for each curve name that user provided.
QString templateHtml (CoordSystemIndex coordSystemIndex) const
 Template html comprising the checklist for display.

Detailed Description

Wizard for setting up the checklist guide.

Definition at line 23 of file ChecklistGuideWizard.h.

Constructor & Destructor Documentation

◆ ChecklistGuideWizard()

ChecklistGuideWizard::ChecklistGuideWizard ( MainWindow & mainWindow,
unsigned int numberCoordSystem )

Single constructor.

Definition at line 24 of file ChecklistGuideWizard.cpp.

25 :
26 QWizard (&mainWindow),
27 m_mainWindow (mainWindow),
28 m_dialogName (tr ("Checklist Guide"))
29{
30 // Note this window is positioned in showEvent
31
32 setWindowTitle (tr ("Checklist Guide Wizard"));
33 setModal (true);
34 QPixmap splash (":/engauge/img/SpreadsheetsForDoc.png");
35 setPixmap (QWizard::WatermarkPixmap, splash); // For ClassicStyle and ModernStyle
36 setPixmap (QWizard::BackgroundPixmap, splash); // For MacStyle
37
38 m_pageIntro = new ChecklistGuidePageIntro();
39 addPage(m_pageIntro);
40
41 for (CoordSystemIndex coordSystemIndex = 0; coordSystemIndex < numberCoordSystem; coordSystemIndex++) {
42 m_pageCurves.push_back (new ChecklistGuidePageCurves(pageCurvesTitle (coordSystemIndex, numberCoordSystem)));
43 addPage(m_pageCurves.last());
44 }
45
46 m_pageConclusion = new ChecklistGuidePageConclusion();
47 addPage(m_pageConclusion);
48}
unsigned int CoordSystemIndex
Zero-based index for identifying CoordSystem instantiations.

Member Function Documentation

◆ curveNames()

QStringList ChecklistGuideWizard::curveNames ( CoordSystemIndex coordSystemIndex) const

Curve names to be placed into Document.

Definition at line 50 of file ChecklistGuideWizard.cpp.

51{
52 return m_pageCurves [signed (coordSystemIndex)]->curveNames();
53}

◆ populateCurvesGraphs()

void ChecklistGuideWizard::populateCurvesGraphs ( CoordSystemIndex coordSystemIndex,
CurvesGraphs & curvesGraphs )

Create entries in CurvesGraphs for each curve name that user provided.

Definition at line 78 of file ChecklistGuideWizard.cpp.

80{
81 LOG4CPP_INFO_S ((*mainCat)) << "ChecklistGuideWizard::populateCurvesGraphs";
82
83 QStringList curveNames = m_pageCurves [signed (coordSystemIndex)]->curveNames();
84 QStringList::const_iterator itr;
85 for (itr = curveNames.begin(); itr != curveNames.end(); itr++) {
86
87 QString curveName = *itr;
88
89 curvesGraphs.addGraphCurveAtEnd(Curve (curveName,
91 CurveStyle (LineStyle::defaultGraphCurve (curvesGraphs.numCurves ()),
92 PointStyle::defaultGraphCurve (curvesGraphs.numCurves ()))));
93 }
94}
log4cpp::Category * mainCat
Definition Logger.cpp:14
QStringList curveNames(CoordSystemIndex coordSystemIndex) const
Curve names to be placed into Document.
static ColorFilterSettings defaultFilter()
Initial default for any Curve.
int numCurves() const
Current number of graphs curves.
void addGraphCurveAtEnd(const Curve &curve)
Append new graph Curve to end of Curve list.
static LineStyle defaultGraphCurve(int index)
Initial default for index'th graph curve.
Definition LineStyle.cpp:84
static PointStyle defaultGraphCurve(int index)
Initial default for index'th graph curve.
#define LOG4CPP_INFO_S(logger)
Definition convenience.h:18

◆ templateHtml()

QString ChecklistGuideWizard::templateHtml ( CoordSystemIndex coordSystemIndex) const

Template html comprising the checklist for display.

Definition at line 114 of file ChecklistGuideWizard.cpp.

115{
116 LOG4CPP_INFO_S ((*mainCat)) << "ChecklistGuideWizard::templateHtml";
117
118 QStringList curveNames = m_pageCurves [signed (coordSystemIndex)]->curveNames();
119 bool withLines = m_pageCurves [signed (coordSystemIndex)]->withLines();
120
121 QString html;
122 QTextStream str (&html);
123
124 // Insert additional space between successive list items, using stylesheet
125 str << "<style type='text/css'>li { margin-top: 10px 0; }</style>";
126
127 str << "<p>" << tr ("Follow this checklist of steps to digitize your image. Each step will show a check when it has been completed.");
128 str << "<p>" << tr ("The coordinates are defined by creating axis points") << ":</p>\n";
129 str << "<p>" << TAG_ANCHOR_AXIS_1 << "&nbsp;" << tr ("Add first of three axis points.") << " " << TAG_AHREF_AXIS_1 << "</p>\n";
131 str << "<ul>\n";
132 str << "<li>" << tr ("Click on") << " <img src="":/engauge/img/16-DigitAxis""> " << tr ("for Axis Points mode") << "</li>\n";
133 str << "<li>" << tr ("Click on an axis tick mark, or intersection of two grid lines, with labeled coordinates") << "</li>\n";
134 str << "<li>" << tr ("Enter the coordinates of the axis point") << "</li>\n";
135 str << "<li>" << tr ("Click on Ok") << "</li>\n";
136 str << "</ul>\n";
137 str << TAG_DIV_AXIS_END_1;
138 str << "<p>" << TAG_ANCHOR_AXIS_2 << "&nbsp;" << tr ("Add second of three axis points.") << " " << TAG_AHREF_AXIS_2 << "</p>\n";
140 str << "<ul>\n";
141 str << "<li>" << tr ("Click on") << " <img src="":/engauge/img/16-DigitAxis""> " << tr ("for Axis Points mode") << "</li>\n";
142 str << "<li>" << tr ("Click on an axis tick mark, or intersection of two grid lines, with labeled coordinates, away from the other axis point") << "</li>\n";
143 str << "<li>" << tr ("Enter the coordinates of the axis point") << "</li>\n";
144 str << "<li>" << tr ("Click on Ok") << "</li>\n";
145 str << "</ul>\n";
146 str << TAG_DIV_AXIS_END_2;
147 str << "<p>" << TAG_ANCHOR_AXIS_3 << "&nbsp;" << tr ("Add third of three axis points.") << " " << TAG_AHREF_AXIS_3 << "</p>\n";
149 str << "<ul>\n";
150 str << "<li>" << tr ("Click on") << " <img src="":/engauge/img/16-DigitAxis""> " << tr ("for Axis Points mode") << "</li>\n";
151 str << "<li>" << tr ("Click on an axis tick mark, or intersection of two grid lines, with labeled coordinates, away from the other axis points") << "</li>\n";
152 str << "<li>" << tr ("Enter the coordinates of the axis point") << "</li>\n";
153 str << "<li>" << tr ("Click on Ok") << "</li>\n";
154 str << "</ul>\n";
155 str << TAG_DIV_AXIS_END_3;
156
157 str << "<p>&nbsp;</p>\n";
158 str << "<p>" << tr ("Points are digitized along each curve") << ":</p>\n";
159 QStringList::const_iterator itr;
160 for (itr = curveNames.begin(); itr != curveNames.end(); itr++) {
161
162 QString curveName = *itr;
163
164 QString tagACurve = QString ("%1%2%3")
166 .arg (curveName)
168
169 str << "<p>" << TAG_ANCHOR_DELIMITER_START << curveName << TAG_ANCHOR_DELIMITER_END
170 << "&nbsp;" << tr ("Add points for curve") << " <b>" << curveName << "</b>. " << tagACurve << "</p>\n";
171 str << TAG_DIV_DELIMITER_START << curveName << TAG_DIV_DELIMITER_END;
172 str << "<ul>\n";
173
174 if (withLines) {
175
176 str << "<li>" << tr ("Click on") << " <img src="":/engauge/img/16-DigitSegment""> " << tr ("for Segment Fill mode") << "</li>\n";
177 str << "<li>" << tr ("Select curve") << " <b>" << curveName << "</b> " << tr ("in the drop-down list") << "</li>\n";
178 str << "<li>" << tr ("Move the cursor over the curve. If a line does not appear then adjust the Color Filter settings for this curve") << ":\n";
179 str << templateHtmlToAdjustColorFilterSettings () << "</li>\n";
180 str << "<li>" << tr ("Move the cursor over the curve again. When the Segment Fill line appears, click on it to generate points") << "</li>\n";
181 str << "</ul>\n";
182
183 } else {
184
185 str << "<li>" << tr ("Click on") << " <img src="":/engauge/img/16-DigitPointMatch""> " << tr ("for Point Match mode") << "</li>\n";
186 str << "<li>" << tr ("Select curve") << " <b>" << curveName << "</b> " << tr ("in the drop-down list") << "</li>\n";
187 str << "<li>" << tr ("Move the cursor over a typical point in the curve. If the cursor circle does not change color then adjust "
188 "the Color Filter settings for this curve") << ":\n";
189 str << templateHtmlToAdjustColorFilterSettings () << "</li>\n";
190 str << "<li>" << tr ("Move the cursor over a typical point in the curve again. Click on the point to start point matching") << "</li>\n";
191 str << "<li>" << tr ("Engauge will display a candidate point. To accept that candidate point, press the right arrow key") << "</li>\n";
192 str << "<li>" << tr ("The previous step repeats until you select a different mode") << "</li>\n";
193 str << "</ul>\n";
194 }
195
197 }
198
199 str << "<p>&nbsp;</p>\n";
200 str << "<p>" << tr ("The digitized points can be exported") << ":</p>\n";
201 str << "<p>" << TAG_ANCHOR_EXPORT << "&nbsp;" << tr ("Export the points to a file") << ". " << TAG_AHREF_EXPORT << "</p>\n";
203 str << "<ul>\n";
204 str << "<li>" << tr ("Select menu option File / Export") << "</li>\n";
205 str << "<li>" << tr ("Enter the file name") << "</li>\n";
206 str << "<li>" << tr ("Click on Ok") << "</li>\n";
207 str << "<li>" << tr ("Congratulations!") << "</li>\n";
208 str << "</ul>\n";
209 str << TAG_DIV_EXPORT_END;
210
211 str << "<p>&nbsp;</p>\n";
212 str << "<p>" << tr ("Hint - The background image can be switched between the original image and filtered image.") << " " << TAG_AHREF_BACKGROUND << "</p>\n";
214 str << "<ul>\n";
215 str << "<li>" << tr ("Select menu option View / Background / Show Original Image to see the original image") << "</li>\n";
216 str << "<li>" << tr ("Select menu option View / Background / Show Filtered Image to see the image from Color Filter") << "</li>\n";
217 str << "</ul>\n";
219
220 return html;
221}
const QString TAG_DIV_AXIS_END_3
const QString TAG_DIV_BACKGROUND_END
const QString TAG_ANCHOR_AXIS_2
const QString TAG_DIV_AXIS_START_3
const QString TAG_DIV_AXIS_END_1
const QString TAG_DIV_EXPORT_END
const QString TAG_DIV_BACKGROUND_START
const QString TAG_ANCHOR_EXPORT
const QString TAG_DIV_DELIMITER_END
const QString TAG_DIV_AXIS_START_1
const QString TAG_AHREF_BACKGROUND
const QString TAG_ANCHOR_AXIS_3
const QString TAG_AHREF_DELIMITER_END
const QString TAG_DIV_AXIS_START_2
const QString TAG_AHREF_EXPORT
const QString TAG_DIV_DELIMITER_START_SLASH
const QString TAG_AHREF_AXIS_1
const QString TAG_ANCHOR_AXIS_1
const QString TAG_ANCHOR_DELIMITER_END
const QString TAG_AHREF_DELIMITER_START
const QString TAG_AHREF_AXIS_3
const QString TAG_DIV_AXIS_END_2
const QString TAG_AHREF_AXIS_2
const QString TAG_DIV_DELIMITER_START
const QString TAG_ANCHOR_DELIMITER_START
const QString TAG_DIV_EXPORT_START

The documentation for this class was generated from the following files: