update to 1.3.1 ver

examples/ex01_helloWorld/ex01_helloWorld.ino

@@ -157,8 +157,8 @@ void setup(){ //Arduino的setup函数. 这个函数在上电之后仅执行一
   //guy.setCursor(10,10);        //设置显示的坐标
   //guy.print("Hello Readguy!"); //使用这个函数也能显示出字符串, 但是需要提前使用setCursor确定显示坐标
 
-  guy.display(true); // 快速刷新. 将屏幕缓存内的内容显示到墨水屏幕上. 可简写为 guy.display(), 效果一样.
-  //guy.display(false); // 慢速刷新. 
+  guy.display(READGUY_FAST); // 快速刷新. 将屏幕缓存内的内容显示到墨水屏幕上. 可简写为 guy.display(), 效果一样.
+  //guy.display(READGUY_SLOW); // 慢速刷新. 
 
   //想知道更多内容, 欢迎移步到其他示例.
 }

examples/ex02_demo/ex02_demo.ino

@@ -11,6 +11,25 @@
  * @brief ReadGuy功能演示.
  * 将根目录下的data文件夹 上传到LittleFS之后运行效果更佳
  * 或者可以准备一张SD卡,并准备在卡的根目录下放置data文件夹内的文件.
+ * 就是SD卡内放data文件夹内的所有文件, 不能额外套文件夹.
+ * 如果你的SD卡插入电脑上显示为可移动磁盘, 那么双击SD卡目录就要看到这个文件夹里的文件
+ * 
+ * 默认的文件系统为SD卡. 当没有插入SD卡时, 会读取LittleFS文件系统.
+ * 没有条件准备SD卡的, 可以烧录LittleFS文件系统.
+ * 
+ * 对于ESP8266 Arduino 用户, 在项目草图文件夹内新建一个data文件夹, 并放入文件 (示例已提供data文件夹)
+ * 再在 arduinoIDE 的工具选项里选择 ESP8266 LittleFS Data Upload.
+ * 没有这个选项的需要参考以下文档安装ESP8266 Sketch upload tool
+ * https://randomnerdtutorials.com/install-esp8266-nodemcu-littlefs-arduino/
+ * 
+ * 对于ESP32 Arduino 用户, 也要在项目草图文件夹内放一个data文件夹, 并把文件放入其中 (示例已提供data文件夹)
+ * 再在 arduinoIDE 的工具选项里选择 ESP32 Sketch data upload, 最后选择LittleFS.
+ * 没有这个选项的需要参考以下文档安装ESP32 LittleFS upload tool
+ * https://randomnerdtutorials.com/esp32-littlefs-arduino-ide/
+ * 
+ * 对于PlatformIO 用户, 需要进入platformIO扩展界面, 选择Upload Filesystem Image, 上传项目文件.
+ * ESP8266和ESP32都要用这种方法.
+ * 
  * 用于演示BMP格式图片灰度显示.
  * 
  * @note 食用方法:
@@ -76,14 +95,14 @@ void setup(){
   guy.drawString("Hello Readguy!",10,10); //用此函数将字符串显示到屏幕缓存内
   //guy.print("Hello Readguy!"); //使用这个函数也能显示出字符串, 但是需要提前使用setCursor确定显示坐标
 
-  guy.display(true);   // 快速刷新. 将屏幕缓存内的内容显示到墨水屏幕上
-  //guy.display(false); // 慢速刷新. 
+  guy.display(READGUY_FAST);   // 快速刷新. 将屏幕缓存内的内容显示到墨水屏幕上
+  //guy.display(READGUY_SLOW); // 慢速刷新. 
 
   guy.setCursor(10,30); //设置显示的坐标
 
   guy.print("Hello~"); //或者用print函数在屏幕上打印字符串, 数值, 字符等等... 两种函数都行
 
-  guy.display(false); // 慢速刷新. 慢刷的对比度显著高于快速刷新, 而且可以消除残影
+  guy.display(READGUY_SLOW); // 慢速刷新. 慢刷的对比度显著高于快速刷新, 而且可以消除残影
 
 
   guy.drawString(guy.SDinside()?"SD card OK.":"No SD card!",10,50); //检查readguy是否插入了SD卡
@@ -134,7 +153,7 @@ void setup(){
 
   guy.fillScreen(1);
 
-  guy.display(false); // 慢速刷新. 慢刷的对比度显著高于快速刷新, 而且可以消除残影
+  guy.display(READGUY_SLOW); // 慢速刷新. 慢刷的对比度显著高于快速刷新, 而且可以消除残影
 
   for(int i=1;i<16;i++){ //灰度测试, 循环设置不同灰度
 
@@ -203,7 +222,7 @@ void setup(){
   guy.setFont(&FreeMonoBold9pt7b); //设置文本字体
   guy.setTextColor(0); //设置文本颜色
   guy.fillScreen(1); //用白色清屏.
-  guy.display(false); //慢刷. 注意, 进行慢刷操作之后, 所有之前显示的灰度内容均会被重新刷成纯黑色
+  guy.display(READGUY_SLOW); //慢刷. 注意, 进行慢刷操作之后, 所有之前显示的灰度内容均会被重新刷成纯黑色
   //不管是浅灰色还是深灰色, 进行慢刷之后只有黑白色. 原来的非白色像素(浅灰色,深灰色和黑色等) 会全刷成白色.
   
   guy.drawString("Rotation 0",10,12); //默认旋转方向为0. 实际的默认方向取决于屏幕IC. 大多数屏幕IC是竖屏.
@@ -239,13 +258,13 @@ void setup(){
   guy.setTextColor(1);  //设置文本颜色为白色,因为被反色的屏幕的当前像素颜色以黑色像素为主
   guy.drawString("Wake Up! ~\\(^_^)/~",10,50); //退出睡眠状态
 
-  guy.display(false);  //使用慢刷 来唤醒处于低功耗状态下的屏幕.
+  guy.display(READGUY_SLOW);  //使用慢刷 来唤醒处于低功耗状态下的屏幕.
 
 //                                   ------------------ 6 - 可以利用灰度来达到的一些显示效果 --<<<<<<
   
   guy.fillScreen(1);  //清屏
   
-  guy.display(FILL_WHITE,false); //慢刷清屏. 左侧的FILL_WHITE表示 不写入屏幕缓存, 直接刷全白
+  guy.display(FILL_WHITE,READGUY_SLOW); //慢刷清屏. 左侧的FILL_WHITE表示 不写入屏幕缓存, 直接刷全白
   //可以改为FILL_BLACK来设置写入缓存全黑.
   //以上的方式均不会修改屏幕缓存中的内容. 右侧的false表示全屏慢刷.
 

examples/ex04_wifi/3_build_without_wifi/3_build_without_wifi.ino

@@ -70,8 +70,8 @@ void setup(){
   //guy.setCursor(10,10);        //设置显示的坐标
   //guy.print("Hello Readguy!"); //使用这个函数也能显示出字符串, 但是需要提前使用setCursor确定显示坐标
 
-  guy.display(true);   // 快速刷新. 将屏幕缓存内的内容显示到墨水屏幕上
-  //guy.display(false); // 慢速刷新. 
+  guy.display(READGUY_FAST);   // 快速刷新. 将屏幕缓存内的内容显示到墨水屏幕上
+  //guy.display(READGUY_SLOW); // 慢速刷新. 
 
   //想知道更多内容, 欢迎移步到其他示例.
 }

examples/ex06_Image/ex06_Image.ino

@@ -15,6 +15,29 @@
  * - 运行的会很缓慢, 因为示例的图片文件比较大.
  * 1. 在运行过ex01或者ex02的开发板上 编译烧录本程序.
  * 2. 将该项目data文件夹内的所有文件放置于SD卡的根目录上.
+ * 就是SD卡内放data文件夹内的所有文件, 不能额外套文件夹.
+ * 如果你的SD卡插入电脑上显示为可移动磁盘, 那么双击SD卡目录就要看到这个文件夹里的文件
+ * 
+ * 将根目录下的data文件夹 上传到LittleFS之后运行效果更佳
+ * 或者可以准备一张SD卡,并准备在卡的根目录下放置data文件夹内的文件.
+ * 就是SD卡内放data文件夹内的所有文件, 不能额外套文件夹.
+ * 如果你的SD卡插入电脑上显示为可移动磁盘, 那么双击SD卡目录就要看到这个文件夹里的文件
+ * 
+ * 默认的文件系统为SD卡. 当没有插入SD卡时, 会读取LittleFS文件系统.
+ * 没有条件准备SD卡的, 可以烧录LittleFS文件系统.
+ * 
+ * 对于ESP8266 Arduino 用户, 在项目草图文件夹内新建一个data文件夹, 并放入文件 (示例已提供data文件夹)
+ * 再在 arduinoIDE 的工具选项里选择 ESP8266 LittleFS Data Upload.
+ * 没有这个选项的需要参考以下文档安装ESP8266 Sketch upload tool
+ * https://randomnerdtutorials.com/install-esp8266-nodemcu-littlefs-arduino/
+ * 
+ * 对于ESP32 Arduino 用户, 也要在项目草图文件夹内放一个data文件夹, 并把文件放入其中 (示例已提供data文件夹)
+ * 再在 arduinoIDE 的工具选项里选择 ESP32 Sketch data upload, 最后选择LittleFS.
+ * 没有这个选项的需要参考以下文档安装ESP32 LittleFS upload tool
+ * https://randomnerdtutorials.com/esp32-littlefs-arduino-ide/
+ * 
+ * 对于PlatformIO 用户, 需要进入platformIO扩展界面, 选择Upload Filesystem Image, 上传项目文件.
+ * ESP8266和ESP32都要用这种方法.
  * 
  * {0} 代码食用注意事项:
  * 这一部分的代码很难读, 或者按维莫斯小姐的说法, 很 "抽象" .
@@ -174,13 +197,13 @@ void setup(){
   delay(2000);
 
 
-  guy.display(FILL_WHITE,true); //在保持屏幕缓存不变的时候快速刷新白屏.
+  guy.display(FILL_WHITE,READGUY_FAST); //在保持屏幕缓存不变的时候快速刷新白屏.
   guy.drawImage(sp,0,0,guy.width(),guy.height()); //绘画的画布可以被放大或者缩小到任意宽度和高度.
   //此处的参数调用表示将会在屏幕坐标(0,0)开始显示, 显示的画布宽度缩放到屏幕宽度, 画布高度缩放到屏幕高度.
   guy.display(); //调用display函数刷屏.
   delay(2000);
 
-  guy.display(FILL_WHITE,true); //在保持屏幕缓存不变的时候快速刷新白屏
+  guy.display(FILL_WHITE,READGUY_FAST); //在保持屏幕缓存不变的时候快速刷新白屏
   guy.fillScreen(1); //白屏清屏(清屏幕缓存)
   guy.drawImage(sp,10,10,65,50); //缩放: 缩小到65X50
   guy.display(); //调用display函数刷屏.
@@ -244,7 +267,7 @@ void setup(){
 
   im.filename=BMP_FILE;          //在此直接设置文件路径和文件名.
 
-  guy.display(FILL_WHITE,false); //将屏幕全刷成白屏. 为了即将的图片刷新.
+  guy.display(FILL_WHITE,READGUY_SLOW); //将屏幕全刷成白屏. 为了即将的图片刷新.
   //建议在使用drawImageFile函数之前, 使用慢刷刷白屏, 可以保证显示效果清晰可见.
 
   im.drawImageFile();            //显示BMP格式.图片. im会自动识别文件扩展名并绘制.
@@ -265,7 +288,7 @@ void setup(){
 
   im.background=0;               //设置背景颜色, 0黑1白, 此处设为背景色为黑色.
 
-  guy.display(FILL_WHITE,false); //将屏幕全刷成白屏. 为了即将的图片刷新.
+  guy.display(FILL_WHITE,READGUY_SLOW); //将屏幕全刷成白屏. 为了即将的图片刷新.
 
   im.drawImageFile();            //显示JPG格式.图片. im会自动识别文件扩展名并绘制.
   delay(2000);
@@ -279,7 +302,7 @@ void setup(){
   im.scalex=400.0f/1280.0f;
   im.scaley=300.0f/576.0f;
 
-  guy.display(FILL_WHITE, false);//显示. 此处的功能就是将显示缓存输出到屏幕上
+  guy.display(FILL_WHITE, READGUY_SLOW);//显示. 此处的功能就是将显示缓存输出到屏幕上
 
   im.drawImageFile();            //显示PNG格式.图片. ESP8266可能不会绘制.
   delay(2000);
@@ -308,7 +331,7 @@ void setup(){
   im.exPoolSize=MEM_POOL;                 //设置外部缓存内存大小
   
   guy.setGreyQuality(1);                  //设置灰度模式为默认灰度显示模式
-  guy.display(FILL_WHITE,false);          //将屏幕全刷成白屏. 为了即将显示灰度图.
+  guy.display(FILL_WHITE,READGUY_SLOW);   //将屏幕全刷成白屏. 为了即将显示灰度图.
 
   im.enableFloyd=0;                       //禁用掉抖动算法.
 
@@ -316,7 +339,7 @@ void setup(){
 
   delay(2000);
 
-  guy.display(FILL_WHITE,false);          //将屏幕全刷成白屏. 为了即将显示灰度图.
+  guy.display(FILL_WHITE,READGUY_SLOW);   //将屏幕全刷成白屏. 为了即将显示灰度图.
 
   im.enableFloyd=1;                       // 重新启用抖动算法.
 
@@ -351,7 +374,7 @@ void setup(){
   }
   guy.drawLine(guy.width(),0,0,guy.height(),0);
 
-  guy.display(false);               //刷新屏幕, 显示绘画的线段
+  guy.display(READGUY_SLOW);        //刷新屏幕, 显示绘画的线段
 
   //im.baseFs=&guy.guyFS();         //直接更改im内的数据即可设置绘制参数. 在此处就是设置文件系统.
   im.filename=BMP_FILE;             //在此直接设置文件路径和文件名.