v1.1.0

Author: Eric

README.md

@@ -5,7 +5,14 @@
  Search for this library in the Arduino Library Manager and download it or clone it yourself from Github.
 
  This library is built on TFT_eSPI. This works properly on all color displays supported by TFT_eSPI.
- 
+
+# Updates 
+
+ - v1.1.0
+    - Added the function to generate a random key
+    - Added switching to red color for one minute if it has a random key
+    - Added the example, DEMO_Generating_Random_Key
+
 # License
 
  This software is written by Eric Nam and is licensed under The MIT License. Check License.txt for more information.

examples/DEMO/DEMO.ino

@@ -15,5 +15,5 @@ void setup()
 
 void loop()
 {
-  digitalRainAnim.play();
+  digitalRainAnim.loop();
 }

examples/DEMO_Generating_Random_Key/DEMO_Generating_Random_Key.ino

@@ -0,0 +1,54 @@
+#include <TFT_eSPI.h>
+#include <SPI.h>
+#include <DigitalRainAnim.h>
+TFT_eSPI tft = TFT_eSPI();
+
+DigitalRainAnim digitalRainAnim = DigitalRainAnim(); 
+
+void setup()
+{
+  Serial.begin(115200);
+  Serial.println();
+  xTaskCreate(task_display,"task_display", 2048, NULL, 1, NULL);
+  xTaskCreate(task_input, "task_input", 1024, NULL, 1, NULL);
+}
+
+void task_display(void *pvParameter)
+{
+  tft.begin();
+  tft.setRotation(0);
+  tft.fillScreen(TFT_BLACK);
+  digitalRainAnim.init(&tft);
+
+  while(true)
+  {
+   digitalRainAnim.loop();
+   vTaskDelay(1);
+  }
+}
+
+void task_input(void *pvParameter)
+{
+  while(true){
+    while(Serial.available() > 0){
+      String str = Serial.readString();
+      if(str.indexOf("key?") > -1){
+        keyMode();
+        }else{
+        normalMode();
+      }
+    }
+   vTaskDelay(10);
+  }
+}
+
+void keyMode(){
+  String newKey = digitalRainAnim.getKey(0).c_str();
+  Serial.println(newKey);
+}
+
+void normalMode(){
+  digitalRainAnim.resetKey();
+}
+
+void loop() {}

examples/DEMOWithButton2/DEMOWithButton2.ino renamed to examples/DEMO_with_Button2/DEMO_with_Button2.ino

@@ -24,7 +24,7 @@ void setup()
 
 void loop()
 {
-  digitalRainAnim.play();
+  digitalRainAnim.loop();
   rButton.loop();
   lButton.loop();
 }

src/DigitalRainAnim.cpp

@@ -51,6 +51,7 @@ void DigitalRainAnim::prepareAnim()
   }
 
   isPlaying = true;
+  lastUpdatedKeyTime = millis() - timeFrame;
 }
 
 //updating each line with a new length, Y position, and speed.
@@ -61,21 +62,31 @@ void DigitalRainAnim::lineUpdate(int lineNum){
 }
 
 //while moving vertically, the color value changes and the character changes as well.
+//if a random key is generated, switch to red.
 void DigitalRainAnim::lineAnimation(int lineNum)
 {
   int startX = lineNum * LINE_WIDTH;
-  tft_DigitalRainAnim->fillRect(startX, 0, 10, 240,TFT_BLACK);
-
   int currentY = 0;
+  tft_DigitalRainAnim->fillRect(startX, 0, 10, height, TFT_BLACK);
+
+  bool isKeyMode = keyString.length() > 0; 
+
   for(int i=0; i<line_length[lineNum]; i++){
-    int greenVal = map(i, 0, line_length[lineNum], 25, 255);
-    tft_DigitalRainAnim->setTextColor(tft_DigitalRainAnim->color565(0, greenVal, 0), TFT_BLACK);      
+    int colorVal = map(i, 0, line_length[lineNum], 25, 255);
+    tft_DigitalRainAnim->setTextColor(isKeyMode ? tft_DigitalRainAnim->color565(colorVal, 0, 0) : tft_DigitalRainAnim->color565(0, colorVal, 0), TFT_BLACK);      
     tft_DigitalRainAnim->drawString(this->getASCIIChar(), startX, line_pos[lineNum] + currentY, FONT_SIZE);  
     currentY = (i * LETTER_HEIGHT);
   }  
 
   tft_DigitalRainAnim->setTextColor(TFT_WHITE, TFT_BLACK);
-  tft_DigitalRainAnim->drawString(this->getASCIIChar(), startX, line_pos[lineNum] +currentY, FONT_SIZE);
+  if(keyString.length() > lineNum){
+    char _char = keyString.at(lineNum);
+    const char *keyChar = &_char;
+    tft_DigitalRainAnim->drawString(keyChar, startX, line_pos[lineNum] + currentY, FONT_SIZE);    
+  }else{
+    tft_DigitalRainAnim->drawString(this->getASCIIChar(), startX, line_pos[lineNum] + currentY, FONT_SIZE);  
+  }
+
   line_pos[lineNum] += line_speed[lineNum];
 
   if (line_pos[lineNum] >= height){
@@ -84,8 +95,12 @@ void DigitalRainAnim::lineAnimation(int lineNum)
 }
 
 //a function where animation continues to run.
-void DigitalRainAnim::play(){
+void DigitalRainAnim::loop(){
   uint32_t currentTime = millis();
+   if (((currentTime - lastUpdatedKeyTime) > KEY_RESET_TIME)) {
+      this->resetKey();
+    }
+
   if (((currentTime - lastDrawTime) < timeFrame)) {
     return;
   }
@@ -110,6 +125,12 @@ String DigitalRainAnim::getASCIIChar()
   return String((char)(random(33, 127)));
 }
 
+//a function that gets only alphabets from ASCII code.
+String DigitalRainAnim::getAbcASCIIChar()
+{
+  return String((char)(random(0,2) == 0 ?random(65, 91) : random(97, 123)));
+}
+
 //move the position to start from out of the screen.
 int DigitalRainAnim::setYPos(int lineLen){
   return lineLen * -20;
@@ -118,4 +139,22 @@ int DigitalRainAnim::setYPos(int lineLen){
 //the function is to get the random number (including max)
 int DigitalRainAnim::getRandomNum(int min, int max){
   return random(min, max+1);
-}
+}
+
+//the function is to generate a random key with length with a length
+std::string DigitalRainAnim::getKey(int key_length){
+  this->resetKey();
+  int maxKeyLength =(key_length > 0 ? (key_length > numOfline ? numOfline : key_length) : numOfline);
+
+  for(int i = 0; i < maxKeyLength; i++){
+    keyString.append((this->getAbcASCIIChar()).c_str());
+  }
+
+  return keyString;
+}
+
+//the function is to remove the generated key
+void DigitalRainAnim::resetKey(){
+  keyString = "";
+  lastUpdatedKeyTime = millis();
+}

src/DigitalRainAnim.h

@@ -10,19 +10,22 @@
 #include <TFT_eSPI.h>
 #include <SPI.h>
 
-#define FONT_SIZE 2            //set font size 2
-#define LINE_WIDTH 10          //width for font size 2
-#define LETTER_HEIGHT 14       //height for font size 2
+#define FONT_SIZE 2              //set font size 2
+#define LINE_WIDTH 10            //width for font size 2
+#define LETTER_HEIGHT 14         //height for font size 2
+#define KEY_RESET_TIME 60 * 1000 //1 Min reset time
 
 class DigitalRainAnim
 {
   public:
     DigitalRainAnim();   
-    void init(TFT_eSPI* tft);   //initialization
+    void init(TFT_eSPI* tft);            //initialization
     void init(TFT_eSPI* tft, int new_line_len_min, int new_line_len_max, int new_line_speed_min, int new_line_speed_max, int new_timeFrame); //initialization with parameters
-    void play();                //play animation
-    void pause();               //pause animation 
-    void resume();              //resume animation
+    void loop();                         //loop animation
+    void pause();                        //pause animation 
+    void resume();                       //resume animation
+    std::string getKey(int key_length);  //generating new key
+    void resetKey();                     //make key empty
 
   private:
     TFT_eSPI* tft_DigitalRainAnim; //target display TFT_eSPI
@@ -35,15 +38,18 @@ class DigitalRainAnim
     bool isPlaying;                //boolean for play or pause
     int timeFrame;                 //time frame for drawing
     uint32_t lastDrawTime;         //checking last drawing time
+    uint32_t lastUpdatedKeyTime;   //checking last generating key time     
     std::vector<int> line_length;  //dynamic array for each line of vertical length
     std::vector<int> line_pos;     //dynamic array for eacg line Y position
     std::vector<int> line_speed;   //dynamic array for eacg line speed
+    std::string keyString;         //storing generated key
 
-    void prepareAnim();             //the function is to prepare all lines at the beginning
-    void lineUpdate(int lineNum);   //the function is to update each line after disappeared from the screen
-    void lineAnimation(int lineNum);//the function is to update each line
-    String getASCIIChar();          //the function is to get the random ASCII char 
-    int setYPos(int lineLen);       //the function is to update the position of line
+    void prepareAnim();                 //the function is to prepare all lines at the beginning
+    void lineUpdate(int lineNum);       //the function is to update each line after disappeared from the screen
+    void lineAnimation(int lineNum);    //the function is to update each line
+    String getASCIIChar();              //the function is to get the random ASCII char 
+    String getAbcASCIIChar();           //the function is to get only alphabet lowercase and uppercase
+    int setYPos(int lineLen);           //the function is to update the position of line
     int getRandomNum(int min, int max); //the function is to get the random number (including max)
 };