Isis 3 Programmer Reference
WorkOrder.h
1#ifndef WorkOrder_H
2#define WorkOrder_H
3
10/* SPDX-License-Identifier: CC0-1.0 */
11
12
13#include <QAction>
14#include <QDateTime>
15// This is needed for the QVariant macro
16#include <QMetaType>
17#include <QPointer>
18#include <QUndoCommand>
19#include <QXmlStreamReader>
20
21#include <QElapsedTimer>
22
23
24#include "CorrelationMatrix.h"
25#include "FileItem.h"
26#include "GuiCamera.h"
27#include "TargetBody.h"
28
29template<typename T> class QFutureWatcher;
30class QMutex;
31class QXmlStreamWriter;
32
33namespace Isis {
34 class Control;
35 class ControlList;
36 class Directory;
37 class ImageList;
38 class ProgressBar;
39 class Project;
40 class ProjectItem;
41 class ShapeList;
42 class Template;
43
311 class WorkOrder : public QAction, public QUndoCommand {
312 Q_OBJECT
313 public:
314
315
316
322 WorkOrderUnknownStatus = 0,
323 WorkOrderNotStarted,
324 WorkOrderRedoing,
325 WorkOrderRedone,
326 WorkOrderUndoing,
327 WorkOrderUndone,
332 WorkOrderLastStatus = WorkOrderFinished
333 };
334
339 enum Context {
340 NoContext,
341 ProjectContext
342 };
343
345 virtual ~WorkOrder();
346
347 virtual WorkOrder *clone() const = 0;
348
349 virtual bool isExecutable(Context);
350 virtual bool isExecutable(ImageList *images);
351 virtual bool isExecutable(ShapeList *shapes);
352 virtual bool isExecutable(ControlList *controls);
353 virtual bool isExecutable(CorrelationMatrix);
355 virtual bool isExecutable(Template *currentTemplate);
356 virtual bool isExecutable(GuiCameraQsp guiCamera);
357 virtual bool isExecutable(FileItemQsp fileItem);
358 virtual bool isExecutable(ProjectItem *item);
359
360 void save(QXmlStreamWriter &stream) const;
361
362 virtual void setData(Context);
363 virtual void setData(QString data);
364 virtual void setData(ImageList *images);
365 virtual void setData(ShapeList *shapes);
366 virtual void setData(ControlList *controls);
367 virtual void setData(Template *currentTemplate);
368 virtual void setData(CorrelationMatrix);
369 virtual void setData(TargetBodyQsp targetBody);
370 virtual void setData(GuiCameraQsp guiCamera);
371 virtual void setData(FileItemQsp fileItem);
372 virtual void setData(ProjectItem *item);
373
374
375
376 void setNext(WorkOrder *nextWorkOrder);
377 void setPrevious(WorkOrder *previousWorkOrder);
378
379 QString bestText() const;
380 bool isUndoable() const;
381 bool isSavedToHistory() const;
382 bool isSynchronous() const;
383 bool createsCleanState() const;
384 QDateTime executionTime() const;
385 bool isFinished() const;
386 bool isRedoing() const;
387 bool isRedone() const;
388 bool isUndoing() const;
389 bool isUndone() const;
390 bool modifiesDiskState() const;
391 WorkOrder *next() const;
392 WorkOrder *previous() const;
393 QString statusText() const;
394
396
397 static WorkOrderStatus fromStatusString(QString);
398 static QString toString(WorkOrderStatus);
399
400 signals:
401 void creatingProgress(WorkOrder *);
402 // This is necessary because QTreeWidget doesn't support us just deleting the progress bar..
403 // HistoryWidget relies on this signal.
404 void deletingProgress(WorkOrder *);
405 void finished(WorkOrder *);
406 void statusChanged(WorkOrder *);
407
408 public slots:
409 void enableWorkOrder();
410 void disableWorkOrder();
411
412 virtual bool setupExecution();
413
414 virtual void execute();
415
416 virtual void redo();
417 virtual void undo();
418
419 protected:
420 WorkOrder(const WorkOrder &other);
421
423 const ImageList *imageList() const;
424
426 const ShapeList *shapeList() const;
427
429
430 QPointer<ControlList> controlList();
431
433
435
437
439
440 virtual bool dependsOn(WorkOrder *other) const;
441
442 Directory *directory() const;
443 Project *project() const;
444
446 void setModifiesDiskState(bool changesProjectOnDisk);
447 void setInternalData(QStringList data);
448
449 int progressMin() const;
450 int progressMax() const;
451 int progressValue() const;
452 void setProgressRange(int, int);
453 void setProgressValue(int);
454
456 virtual void postExecution();
457 virtual void undoExecution();
458 virtual void postUndoExecution();
459
460 protected slots:
461 void addCloneToProject();
462
463 private:
464 bool isInStableState() const;
467 void resetProgressBar();
469
470 private slots:
471 void attemptQueuedAction();
472 void executionFinished();
473 void clearImageList();
474 void clearShapeList();
475 void updateProgress();
476 void startRedo();
477
478 private:
483 NoQueuedAction,
484 RedoQueuedAction,
485 UndoQueuedAction
486 };
487
488 protected:
498
505
512
513 WorkOrderStatus m_status;
514
515 private:
516 WorkOrder &operator=(const WorkOrder &rhs);
517
524
531
532 QueuedWorkOrderAction m_queuedAction;
533
546
547 Context m_context;
548 QString m_data;
549 QPointer<ImageList> m_imageList;
550 QPointer<ShapeList> m_shapeList;
551 QPointer<ControlList> m_controlList;
552 CorrelationMatrix m_correlationMatrix;
558
559
565
566
572
573
578
579
585
591
596
600 QPointer<WorkOrder> m_nextWorkOrder;
601
605 QPointer<WorkOrder> m_previousWorkOrder;
606
610 QPointer<Project> m_project;
611
617
622
628 QPointer< QFutureWatcher<void> > m_futureWatcher;
629
630
631
635 QPointer<ProgressBar> m_progressBar;
636
640 QPointer<QTimer> m_progressBarUpdateTimer;
641
646
647
651 QElapsedTimer *m_elapsedTimer;
652
657 };
658}
659
661Q_DECLARE_METATYPE(Isis::WorkOrder *);
662
663#endif
Maintains a list of Controls so that control nets can easily be copied from one Project to another,...
Definition ControlList.h:42
This is a container for the correlation matrix that comes from a bundle adjust.
Internalizes a list of images and allows for operations on the entire list.
Definition ImageList.h:53
The main project for ipce.
Definition Project.h:287
Represents an item of a ProjectItemModel in Qt's model-view framework.
Internalizes a list of shapes and allows for operations on the entire list.
Definition ShapeList.h:31
Provide Undo/redo abilities, serialization, and history for an operation.
Definition WorkOrder.h:311
void enableWorkOrder()
Enables the work order.
QPointer< QTimer > m_progressBarUpdateTimer
A pointer to the QTimer which updates the ProgressBar.
Definition WorkOrder.h:640
QStringList m_imageIds
A QStringList of unique image identifiers for all of the images this WorkOrder is dealing with.
Definition WorkOrder.h:584
void setNext(WorkOrder *nextWorkOrder)
Sets the next WorkOrder in the sequence.
void updateProgress()
Updates the progress bar.
ShapeList * shapeList()
@briefReturns a pointer to the ShapeList for this WorkOrder.
bool m_isSavedToHistory
Set the work order to be shown in the HistoryTreeWidget.
Definition WorkOrder.h:511
QueuedWorkOrderAction
This enum describes the current state of a Queued WorkOrder.
Definition WorkOrder.h:482
void setProgressRange(int, int)
Sets the progress range of the WorkOrder.
int progressMax() const
Gets the maximum value of the progress range of the WorkOrder.
QStringList m_shapeIds
A QStringList of unique shape identifiers for all of the shapes this WorkOrder is dealing with.
Definition WorkOrder.h:590
virtual void setData(Context)
Sets the context data for this WorkOrder.
WorkOrder * next() const
Gets the next WorkOrder.
bool modifiesDiskState() const
Returns the modified disk state.
bool m_isSynchronous
This is defaulted to true.
Definition WorkOrder.h:504
bool isUndoing() const
Returns the WorkOrderUndoing state.
void attemptQueuedAction()
Attempts to execute an action on the action queue.
virtual void undoExecution()
Execute the steps necessary to undo this workorder.
virtual void postUndoExecution()
Perform any steps necessary after an undo of a workorder.
Template * getTemplate()
WorkOrder::getTemplate.
Template * m_template
A QSharedPointer to the Template (A Template object but encapsulated within a Gui framework.
Definition WorkOrder.h:564
void save(QXmlStreamWriter &stream) const
: Saves a WorkOrder to a data stream.
void clearShapeList()
Clears the list of shapes.
bool isRedone() const
Returns the WorkOrder redone status.
void executionFinished()
Signals the Project that the WorkOrder is finished, deletes the update time for the Progress bar,...
virtual void redo()
Starts (or enqueues) a redo.
WorkOrderStatus
This enumeration is used by other functions to set and retrieve the current state of the WorkOrder.
Definition WorkOrder.h:321
@ WorkOrderFinished
This is used for work orders that will not undo or redo (See createsCleanState())
Definition WorkOrder.h:331
virtual void undo()
Starts (or enqueues) an undo.
int progressMin() const
Gets the minimum value of the progress range of the WorkOrder.
bool isUndoable() const
Returns true if this work order is undoable, otherwise false.
WorkOrder * previous() const
Gets the previous WorkOrder.
bool m_isUndoable
Set the workorder to be undoable/redoable This is defaulted to true - his will allow the workorder to...
Definition WorkOrder.h:497
void setProgressValue(int)
Sets the current progress value for the WorkOrder.
static QString toString(WorkOrderStatus)
Gets the current status of the WorkOrder.
bool isUndone() const
Returns the WorkOrder undo status.
virtual bool setupExecution()
This sets up the state for the work order.
void setProgressToFinalText()
Sets the ProgressBar to display the final status of the operation.
QDateTime m_executionTime
This is the date/time that setupExecution() was called.
Definition WorkOrder.h:621
bool m_createsCleanState
This is defaulted to false.
Definition WorkOrder.h:523
bool isSavedToHistory() const
Returns true if this work order is to be shown in History, otherwise false.
bool isInStableState() const
Determines if the WorkOrder is in a stable state, or if it's busy doing something.
GuiCameraQsp m_guiCamera
A QSharedPointer to the GuiCamera (the Camera object but encapsulated within a Gui framework.
Definition WorkOrder.h:557
QPointer< WorkOrder > m_previousWorkOrder
A pointer to the previous WorkOrder in the queue.
Definition WorkOrder.h:605
static WorkOrderStatus fromStatusString(QString)
Attempts to query the current status of the WorkOrder.
bool isRedoing() const
Returns the redoing status of this WorkOrder.
int m_progressRangeMaxValue
The maximum value of the Progess Bar.
Definition WorkOrder.h:541
QStringList internalData() const
Gets the internal data for this WorkOrder.
QPointer< ControlList > controlList()
Returns the Control List for this WorkOrder (a list of control networks).
Directory * directory() const
return the workorder project directory Returns the Directory object of the Project this WorkOrder is ...
int m_progressValue
The current value of the Progress Bar.
Definition WorkOrder.h:545
GuiCameraQsp guiCamera()
WorkOrder::guiCamera.
void setCreatesCleanState(bool createsCleanState)
Declare that this work order is saving the project.
QString statusText() const
WorkOrder::statusText.
QDateTime executionTime() const
Gets the execution time of this WorkOrder.
virtual void execute()
Execute the workorder.
void setModifiesDiskState(bool changesProjectOnDisk)
QPointer< ProgressBar > m_progressBar
A pointer to the ProgressBar.
Definition WorkOrder.h:635
void setPrevious(WorkOrder *previousWorkOrder)
Sets the previous WorkOrder in the sequence.
void listenForShapeDestruction()
Checks to see if we have lost any shapes in the ShapeList.
virtual bool isExecutable(Context)
Re-implement this method if your work order utilizes controls for data in order to operate.
void disableWorkOrder()
Disables the work order.
bool createsCleanState() const
Returns the CleanState status (whether the Project has been saved to disk or not).
TargetBodyQsp targetBody()
WorkOrder::targetBody.
double m_secondsElapsed
The seconds that have elapsed since the WorkOrder started executing.
Definition WorkOrder.h:656
void setInternalData(QStringList data)
Sets the internal data for this WorkOrder.
int m_progressRangeMinValue
The miniumum value of the Progess Bar.
Definition WorkOrder.h:537
virtual bool dependsOn(WorkOrder *other) const
Indicate workorder dependency This is a virtual function whose role in child classes is to determine ...
QElapsedTimer * m_elapsedTimer
A QElapsedTimer object holding the excecution time of the WorkOrder.
Definition WorkOrder.h:651
Project * project() const
Returns the Project this WorkOrder is attached to.
void clearImageList()
Clears the list of images.
QPointer< Project > m_project
A pointer to the Project this WorkOrder is attached to.
Definition WorkOrder.h:610
virtual ~WorkOrder()
The Destructor.
ProgressBar * progressBar()
Returns the ProgressBar.
QStringList m_internalData
A QStringList of internal properties for this WorkOrder.
Definition WorkOrder.h:595
bool m_modifiesDiskState
This is defaulted to false.
Definition WorkOrder.h:530
QMutex * m_transparentConstMutex
This is used to protect the integrity of data the WorkOrder is working on so that only one thread at ...
Definition WorkOrder.h:616
QPointer< WorkOrder > m_nextWorkOrder
A pointer to the next WorkOrder in the queue.
Definition WorkOrder.h:600
void addCloneToProject()
Runs a copy of the current WorkOrder and stores it in the project.
void startRedo()
WorkOrder::startRedo This function is currently empty.
void resetProgressBar()
Resets the ProgressBar.
FileItemQsp m_fileItem
A QSharedPointer to the FileItem.
Definition WorkOrder.h:577
ImageList * imageList()
Returns a pointer to the ImageList for this WorkOrder.
bool isSynchronous() const
Returns true if this work order is run synchronously, otherwise false.
Context
This enumeration is for recording the context of the current Workorder (whether it is part of a proje...
Definition WorkOrder.h:339
QString bestText() const
Generate unique action names We don't use action text anymore because Directory likes to rename our a...
int progressValue() const
Gets the current progress value of the WorkOrder.
bool isFinished() const
Returns the finished state of this WorkOrder.
virtual void postExecution()
Perform any necessary actions after execution of a workorder.
QPointer< QFutureWatcher< void > > m_futureWatcher
A pointer to a QFutureWatcher object which monitors a QFuture object using signals and slots.
Definition WorkOrder.h:628
CorrelationMatrix correlationMatrix()
Returns the CorrleationMatrix for this WorkOrder.
QPointer< QTimer > m_progressBarDeletionTimer
A pointer to the ProgressBar deletion timer.
Definition WorkOrder.h:645
void listenForImageDestruction()
Checks to see if we have lost any images in the ImageList.
FileItemQsp fileItem()
WorkOrder::fileItem.
WorkOrder(Project *project)
Create a work order that will work with the given project.
Definition WorkOrder.cpp:38
TargetBodyQsp m_targetBody
A QSharedPointer to the TargetBody (A Target object but encapsulated within a Gui framework.
Definition WorkOrder.h:571
This is free and unencumbered software released into the public domain.
This is free and unencumbered software released into the public domain.
Definition Apollo.h:16