2019-03-06 13:44:21 +00:00
SimpleGUI Virtual SDK 使用说明
---
## 1. 概述
    为了方便开发者在自己的项目中使用SimpleGUI部署、开发或试开发GUI模块， ，
    SimpleGUI Virtual SDK（ ） ， ， ，
## 2. 基于GCC和Code::Blocks的SDK环境搭建
#### 2.1. 下载Code::Blocks
    请访问[Code::Blocks下载页面](http://www.codeblocks.org/downloads/binaries)下载Code::Blocks集成开发环境的可执行文件， ，
    由于Code::Blocks开发环境本身可以适配多种编译器， ， ， ，
    后续讲解也以此编译器为例。
>
#### 2.2. 部署wxWidgets
    请访问[wxWidgets下载页面](http://www.wxwidgets.org/downloads/)，
2019-04-09 12:38:57 +00:00
>
    截至SimpleGUI最后一次更新， ， ， ，
    为避免开发版本中存在的一些潜在问题， ， ，
2019-03-06 13:44:21 +00:00
    在弹出的列表中下载对应的编译器使用的库， （ ） （ ）
>
>   由于2018年12月10日wxWidgets3.1.2版本更新后， ， ， ， ， ，
>   3.1.1及更早版本的源代码仍然可以直接在Windows下使用TDM-GCC编译。
   下载后， ， ， ， ，
    部署后的目录结构应为：
```
wxWidgets库目录
├─ include
│ ├─ msvc
│ │ └─ wx
│ │ └─ *.h
│ └─ wx
│ ├─ [DIR]
│ └─ *.h
└─ lib
2019-12-26 14:44:47 +00:00
└─ gcc_x86_dll(如果使用64位编译器，
├─ mswu
└─ *.a(库文件)
2019-03-06 13:44:21 +00:00
```
#### 2.3. 配置Code::Blocks下的wxWidgets开发环境
    启动Code::Blocks， （ ） （ ）
>
    在打开的全局变量编辑窗口中， ，
>
    然后将全局变量的根路径、包含路径和库路经分别设置为wxWidgets的根路径include路径和lib路径， ，
>全局变量配置
>
    然后点击“Close”关闭环境变量编辑窗口， ，
### 3. 编译和使用Virtual SDK
#### 3.1. 工程环境结构
    您可以通过Git工具， （ ） ， ， ，
    同步或下载解压SimpleGUI后， ， ：
|目录名|功能|
|:- |:- |
|DemoProc|SimpGUI的演示代码|
|DemoProject|SimpleGUI的演示工程|
|Documents|关于SimpleGUI的一些简要说明文档|
|GUI|SimpleGUI的代码实现部分|
|HMI|SimpleGUI的HMI模型实现部分|
|VirtualSDK|Virtual SDK的工程及源码|
#### 3.2. 编译Virtual SDK工程
2019-04-09 12:38:57 +00:00
   进入VirtualSDK\Project\CodeBlocks目录， ， ， ， ， （ ） ， ， ， ，
2019-03-06 13:44:21 +00:00
    点击工具栏上的编译按钮或按快捷键Ctrl+F9，
    编译完成， ，
>
>
#### 3.3. 配置Virtual SDK
    默认情况下， ， ， ，
   打开Virtual SDK工程， （ ） ， ， ：
|宏定义名|功能|
|:- |:- |
|LCD_COLOR_OBJ_PIX|逻辑有效像素点颜色（前景颜色）|
|LCD_COLOR_OBJ_BKG|逻辑无效像素点颜色（背景颜色）|
|LCD_COLOR_OBJ_GRID|网格颜色|
|PARAM_DEFAULT_PIXEL_NUM_H|横向像素点数量|
|PARAM_DEFAULT_PIXEL_NUM_V|纵向像素点数量|
|PARAM_DEFAULT_PIXEL_WIDTH|屏幕像素单元宽度|
|PARAM_DEFAULT_PIXEL_HEIGHT|屏幕像素单元高度|
    Virtual SDK默认状态下模拟的是黄底黑字的LCD显示屏， ， ：
> - 使用一张目标屏幕的照片， ， ，
>
> - 将颜色的RGBA值分别更新入三个宏定义中， ， ， ，
> - 分别修改PARAM\_DEFAULT\_PIXEL\_NUM\_H和PARAM\_DEFAULT\_PIXEL\_NUM\_V的值为192和64。
> - 修改\GUI\inc\SGUI_Common.h（ ）
> - 重新编译工程。
    重新编译后， ，
>
   上述的宏用于VirtualSDK\Common\src\Common.c（ ） ，
void SetDefaultParameterData(PixelPanelParameter* pstParameter)
{
if(NULL != pstParameter)
{
// Appearance
pstParameter->HorizontalPixelNumber = PARAM_DEFAULT_PIXEL_NUM_H;
pstParameter->VerticalPixelNumber = PARAM_DEFAULT_PIXEL_NUM_V;
pstParameter->PixelUnitWidth = PARAM_DEFAULT_PIXEL_WIDTH;
pstParameter->PixelUnitHeight = PARAM_DEFAULT_PIXEL_HEIGHT;
pstParameter->EdgeWidth = PARAM_DEFAULT_EDGE_WIDTH;
pstParameter->EnableGrid = PARAM_DEFAULT_GRID_DISABLE;
// ScreenColor
pstParameter->PanelColor.RGBA = LCD_COLOR_OBJ_BKG;
pstParameter->PixelColor.RGBA = LCD_COLOR_OBJ_PIX;
pstParameter->EdgeColor.RGBA = LCD_COLOR_OBJ_EDGE;
pstParameter->GridColor.RGBA = LCD_COLOR_OBJ_GRID;
}
}
    此函数将在Virtual SDK启动时配置LCD面板的相关参数， ， ：
pstParameter->EnableGrid = PARAM_DEFAULT_GRID_DISABLE;
修改为：
pstParameter->EnableGrid = PARAM_DEFAULT_GRID_ENABLE;
同时修改屏幕像素尺寸为4或4以上
pstParameter->PixelSize = 4;
重新编译后，效果如下：
>