Pre Merge pull request !10 from 独角戏/Develope

CMakeLists.txt

@@ -1,86 +0,0 @@
-cmake_minimum_required(VERSION 3.10)
-
-project(simple_gui_demo)
-
-set(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)
-set(CMAKE_INSTALL_RPATH "$ORIGIN")
-
-# For compiler
-# Default use MinGW-w64
-set(CMAKE_C_COMPILER "gcc")
-set(CMAKE_CXX_COMPILER "g++")
-# SDL2 library path.
-set(SDL_DIR D:/Works/dev/libs/SDL/SDL2-2.28.3/x86_64-w64-mingw32)
-set(SDL_LIB ${SDL_DIR}/lib)
-set(SDL_BIN ${SDL_DIR}/bin)
-
-if(NOT CMAKE_BUILD_TYPE)
-    set(CMAKE_BUILD_TYPE Release CACHE STRING "Choose the type of build." FORCE)
-endif()
-
-if(CMAKE_BUILD_TYPE STREQUAL "Debug")
-    add_compile_options(-g -O0)  # 调试模式：启用调试信息，禁用优化
-    set(CEF_LIB ${CEF_DIR}/Debug)
-elseif(CMAKE_BUILD_TYPE STREQUAL "Release")
-    add_compile_options(-O3)     # 发布模式：启用最高优化
-    set(CEF_LIB ${CEF_DIR}/Release)
-elseif(CMAKE_BUILD_TYPE STREQUAL "RelWithDebInfo")
-    add_compile_options(-O2 -g)  # 发布模式，但包含调试信息'
-    set(CEF_LIB ${CEF_DIR}/Release)
-elseif(CMAKE_BUILD_TYPE STREQUAL "MinSizeRel")
-    add_compile_options(-Os)     # 优化生成的文件大小
-    set(CEF_LIB ${CEF_DIR}/Release)
-endif()
-
-# C++11
-set(CMAKE_CXX_STANDARD 11)
-
-# Header search path.
-include_directories(${SDL_DIR}/include/SDL2)
-include_directories(${CMAKE_SOURCE_DIR}/GUI/inc)
-include_directories(${CMAKE_SOURCE_DIR}/HMI/inc)
-include_directories(${CMAKE_SOURCE_DIR}/Simulator/inc)
-include_directories(${CMAKE_SOURCE_DIR}/DemoProc/inc)
-
-# Global marco
-add_definitions(-DSDL_MAIN_HANDLED)
-if(USE_CHS_TEXT)
-    include_directories(${CMAKE_SOURCE_DIR}/Library/inc)
-    link_directories(${CMAKE_SOURCE_DIR}/Library/lib64)
-	add_definitions(-D_SIMPLE_GUI_DEMO_INNER_CHS_)
-#   add_definitions(-D_SIMPLE_GUI_ENCODE_TEXT_)
-endif()
-
-# Library search path.
-link_directories(${SDL_LIB})
-
-# Demo source files.
-aux_source_directory(DemoProc DEMO_SRC_LIST)
-
-# SimpleGUI library source.
-file(GLOB_RECURSE GUI_LIB_SRC_LIST "GUI/src/*.c")
-# Static GUI library.
-add_library(simplegui STATIC ${GUI_LIB_SRC_LIST})
-# SimpleGUI HMI library source.
-file(GLOB_RECURSE HMI_LIB_SRC_LIST "HMI/src/*.c")
-# Static HMI library.
-add_library(simplegui_hmi STATIC ${HMI_LIB_SRC_LIST})
-# SimpleGUI demo source.
-file(GLOB_RECURSE DEMO_SRC_LIST "DemoProc/src/*.c")
-
-# Other application source
-file(GLOB_RECURSE APP_SRC_LIST "Simulator/src/*.cpp")
-
-# Execution file target.
-add_executable(simple_gui_demo ${APP_SRC_LIST} ${DEMO_SRC_LIST})
-
-# Append linkage.
-target_link_libraries(simple_gui_demo libSDL2.dll.a)
-target_link_libraries(simple_gui_demo simplegui)
-target_link_libraries(simple_gui_demo simplegui_hmi)
-if(USE_CHS_TEXT)
-    target_link_libraries(simple_gui_demo libiconv64.a)
-endif()
-
-# Copy runtime needed.
-file(COPY ${SDL_BIN}/SDL2.dll DESTINATION ${CMAKE_BINARY_DIR})

DemoProc/inc/Resource.h

@@ -5,11 +5,8 @@
 #ifndef _SIMPLE_GUI_DEMO_INNER_CHS_
 #include "DemoResource_ASCII.h"
 #else
-#ifdef _SIMPLE_GUI_ENCODE_TEXT_
+//#include "DemoResource_GB2312.h"
 #include "DemoResource_UTF8.h"
-#else
-#include "DemoResource_GB2312.h"    
-#endif // _SIMPLE_GUI_ENCODE_TEXT_
 #endif
 
 extern const SGUI_FONT_RES GB2312_FZXS12;

Documents/01-快速开始SimpleGUI.md

@@ -21,32 +21,17 @@
 ## 2. 编译和使用模拟器  
 #### 2.1. 什么是模拟器  
   SimpleGUI使用SDL2构建了一个简单的模拟环境，除可以演示、预览SimpleGUI外，还可以作为脱离硬件平台进行图形界面开发的辅助工具使用。配合SimpleGUI的低耦合性接移植口定义，使用模拟器开发的用户界面处理源码，几乎额可以无缝的移植到预期的硬件平台上。  
-  在初次接触SimpleGUI时，您可能尚未选定或准备好相应的硬件平台。鉴于这种情况，您可以从模拟器环境开始，初步了解SimpleGUI的显示效果以及代码架构。  
+  在初次接触SimpleGUI时，您可能尚未选定或准备好相应的硬件平台。鉴于这种情况，您可以从VirtualSDK开始，初步了解SimpleGUI的显示效果以及代码架构。  
   
-#### 2.2. 使用CMake快速完成模拟器的编译  
+#### 2.2. 编译模拟器环境  
-  在使用CMake编译模拟器示例之前，需要先修改一下CMakeLists.txt文件，找到SDL_DIR变量，将变量的值修改为SDL库的实际路径。
+  SimpleGUI的模拟器工程使用CodeBlocks组织，进入Simulator目录，打开Simulator.cbp工程文件，如果用户下载的是nosetup（绿色版）的Code::Blocks，需要手动建立关联才能直接用双击的方式打开cbp文件，否则，用户只能先打开Code::Blocks，然后从Code::Blocks中执行打开操作以打开工程文件。  
-``` text
-set(SDL_DIR D:/Works/dev/libs/SDL/SDL2-2.28.3/x86_64-w64-mingw32)
-```
-> 将D:/Works/dev/libs/SDL/SDL2-2.28.3/x86_64-w64-mingw32修改为SDL2库的实际部署路径。
-
-  然后在当前仓库目录下创建一个新文件夹build，然后再build目录中打开控制台，然后执行以下命令：
-``` cmd
-cmake.exe ../CMakeLists.txt -B ./ -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Debug -DUSE_CHS_TEXT=True
-```
-> - 要正常再控制台中使用CMake，需要将CMake添加到系统的PATH环境变量中。
-> - USE_CHS_TEXT=True参数是启用中文演示资源，如果不添加此项目，演示程序将使用英文显示。
-
-#### 2.3. 使用Codeblocks打开模拟器环境  
-  SimpleGUI的模拟器也提供了基于Code::Blocks的图形化IDE环境，可以方便的进行调试、断点跟踪等等。
-  进入Simulator目录，打开Simulator.cbp工程文件，如果用户下载的是nosetup（绿色版）的Code::Blocks，需要手动建立关联才能直接用双击的方式打开cbp文件，否则，用户只能先打开Code::Blocks，然后从Code::Blocks中执行打开操作以打开工程文件。  
   点击工具栏上的编译按钮或按快捷键Ctrl+F9，开始编译模拟环境演示工程。  
 ![01-编译工程](images/01/01.png)
 
   编译完成，显示无错误和警告，现在点击工具栏上的运行按钮或按快捷键Ctrl+F10就可以看到模拟环境的运行效果了。  
 ![02-运行效果](images/01/02.png)
   
-#### 2.4. 模拟不同型号和外观的屏幕效果  
+#### 3.3. 模拟不同型号和外观的屏幕效果  
   默认情况下，模拟器中虚拟显示屏幕的配色方案为黄底黑字的LCD点阵显示屏，为最大程度上模拟真实情况下的视觉效果，方便创建和调试GUI元素，VirtualSDK的LCD面板可以通过修改配置定义修改颜色和尺寸。  
   打开模拟器工程，修改Simulator\inc\simulator_conf.h文件，这里这里是针对模拟器屏幕参数的宏定义，意义如下：  
 ```c++  

README.md

@@ -4,7 +4,7 @@
 
 #### 简介
 
-SimpleGUI是一款针对单色显示屏设计的GUI绘图接口库。
+SimpleGUI是一款针对单色显示屏设计的GUI接口库。
 
 > ![SimpleGUI在SSD1306主控制器的OLED显示屏上的显示效果](Images/Perview.png "SimpleGUI在SSD1306主控制器的OLED显示屏上的显示效果")
 
@@ -57,9 +57,6 @@ SimpleGUI发布已经有很长时间了，在发布后很多人都来询问一
 | 06 VirtualSDK概述       | https://www.bilibili.com/video/av87713369/   |
 | 07 基于VirtualSDK的GUI开发 | https://www.bilibili.com/video/BV1qz4y12771/ |
 
-#### 补充说明
- - 2025-02-07：QQ群里很多人都会问wxWidgets环境部署的相关问题，确实，部署这个图形库在下载选型时就面临各种大坑，使用的GCC版本、位模式、开发库还是运行库……一步错步步错，所以我更新了模拟器，使用SDL2编译，需要注意的事项少了很多。至于当时为什么选用wxWidgets开发，是因为最初是想把这模拟器当作一个辅助软件来设计的，可以模拟屏幕，可以截图，甚至还可以通过贴图的形式模拟某些设备面板，但是实际使用下来，我预想的共能用上的不多，反而拉高了使用门槛，所以弃用。
-
 #### 参与讨论
 
 如果您有意参与SimpleGUI的讨论与改进，可以在以下地方留言：