Diff: StateMachine/StandbyState.h

Branch:

Drift

Revision:

86:51048c1f132f

Parent:

80:c85cb93713b3

Child:

97:0ed9ede9a995

--- a/StateMachine/StandbyState.h	Tue Apr 18 22:27:14 2017 +0000
+++ b/StateMachine/StandbyState.h	Wed Apr 19 03:46:21 2017 +0000
@@ -1,3 +1,9 @@
+/**
+ * @file StandbyState.h
+ * @brief The header file for the StandbyState class.
+ * @author Jordan Brack <jabrack@mix.wvu.edu>, Haofan Zheng <hazheng@mix.wvu.edu>
+ * 
+ */
 #pragma once
 #ifndef STANDBY_STATE_H
 #define STANDBY_STATE_H
@@ -5,23 +11,58 @@
 #include <mbed.h>
 #include "States.h"
 
+/**
+ * @class StandbyState
+ * @brief The class for standby state. It is a child class of the States class.
+ * 
+ */
 class StandbyState : public States
 {
 public:
+    /**
+    * @brief This is the constructor for the StandbyState class
+    * 
+    */
     StandbyState();
+    /**
+    * @brief This is the destructor for the StandbyState class
+    * 
+    */
     ~StandbyState();
     
+    /**
+    * @brief Draw the user interface. This function is called only once, whenever the standby state becomes the current state.
+    * 
+    */
     virtual void DrawUserInterface();
     
+    /**
+    * @brief This functino will be called during every tick, only if the standby state is the current state. 
+    * @param deltaTime The time interval between last tick and current tick.
+    * 
+    */
     virtual void Update(float deltaTime);
     
+    /**
+    * @brief Return wether or not the standby state has a position callback function for the touch screen.
+    * @return 1 - yes. 
+    * 
+    */
     virtual uint8_t HasTouchPosFunction() const;
     
+    /**
+    * @brief Return wether or not the standby state has a interrupt callback function for the touch screen.
+    * @return 0 - yes. 
+    * 
+    */
     virtual uint8_t HasTouchIrqFunction() const;
     
+    /**
+    * @brief The position callback function for the touch screen. Based on the touch position, the corresponding functionality will be executed. 
+    * 
+    */
     virtual void TouchPosCallback(int16_t x, int16_t y);
     
-    virtual void TouchIrqCallback();
 };
 
 #endif //STANDBY_STATE_H
\ No newline at end of file