emWin 5.24 用户参考手册

5星 · 超过95%的资源需积分: 10 178 浏览量更新于2024-07-23 1 收藏 11.56MB PDF 举报

ucgui emWin 5.24 使用手册 ucgui emWin 5.24 是一款图形用户界面（Graphic User Interface，GUI）解决方案，主要应用于嵌入式系统和微控制器领域。该手册提供了 emWin 5.24 的使用指南和参考指南，涵盖了从安装到高级编程的所有方面。一、emWin 简介 emWin 是 SEGGER Microcontroller GmbH & Co. KG 公司开发的一款图形库和 GUI 解决方案，旨在为嵌入式系统和微控制器提供高效、灵活和可定制的用户界面解决方案。emWin 支持多种平台，包括 ARM、ColdFire、PowerPC 等，并提供了广泛的 API 接口和开发工具。二、emWin 5.24 的新功能 emWin 5.24 是 emWin 系列的最新版本，带来了许多新的功能和改进。包括： * 支持高分辨率显示屏幕 * 提高了图形渲染速度和性能 * 新增了多种图形控件和组件 * 改进了 GUI 编辑器和开发工具三、emWin 5.24 的安装和配置 emWin 5.24 的安装和配置过程包括以下步骤： * 安装 emWin 软件包 * 配置开发环境 * 设置图形驱动和显示参数 * 编译和链接 emWin 库四、emWin 5.24 的编程指南 emWin 5.24 提供了广泛的 API 接口和开发工具，允许开发者创建高效、灵活和可定制的用户界面。包括： * 图形控件和组件的使用 * 事件处理和回调函数 * 图形渲染和动画效果 * 数据绑定和验证五、emWin 5.24 的应用场景 emWin 5.24 广泛应用于嵌入式系统和微控制器领域，包括： * 工业自动化和控制系统 * 医疗器械和医疗信息系统 * 消费电子产品和家电 * 汽车电子和车联网系统六、emWin 5.24 的优势 emWin 5.24 的优势包括： * 高效的图形渲染和性能 * 灵活和可定制的用户界面 * 广泛的平台支持和兼容性 * 优秀的开发工具和文档支持七、结语 emWin 5.24 是一款功能强大和灵活的图形用户界面解决方案，适用于嵌入式系统和微控制器领域。通过本手册，开发者可以快速掌握 emWin 5.24 的使用和编程，并创建高效、灵活和可定制的用户界面。

3.5.2.1 Modifying WinMain .................................................................................. 62

3.5.2.2 Example application................................................................................. 63

3.5.3 Integration into the embOS Simulation....................................................... 64

3.5.3.1 WinMain................................................................................................. 64

3.5.3.2 Target program (main) ............................................................................ 66

3.5.4 GUI simulation API .................................................................................. 67

4 Viewer............................................................................................................................71

4.1 Using the viewer ..................................................................................... 72

4.1.1 Using the simulation and the viewer .......................................................... 72

4.1.2 Using the viewer with virtual pages ........................................................... 73

4.1.3 Always on top......................................................................................... 73

4.1.4 Open further windows of the display output ................................................ 73

4.1.5 Zooming ................................................................................................ 74

4.1.6 Copy the output to the clipboard ............................................................... 74

4.1.7 Using the viewer with multiple displays ...................................................... 75

4.1.8 Using the viewer with multiple layers ......................................................... 75

5 Displaying Text ..............................................................................................................77

5.1 Basic routines......................................................................................... 78

5.2 Text API................................................................................................. 79

5.3 Routines to display text............................................................................ 80

5.4 Selecting text drawing modes ................................................................... 87

5.5 Selecting text alignment........................................................................... 89

5.6 Setting the current text position................................................................ 91

5.7 Retrieving the current text position............................................................ 92

5.8 Routines to clear a window or parts of it..................................................... 92

6 Displaying Values ..........................................................................................................93

6.1 Value API............................................................................................... 94

6.2 Displaying decimal values......................................................................... 95

6.3 Displaying floating point values ................................................................. 99

6.4 Displaying binary values..........................................................................102

6.5 Displaying hexadecimal values.................................................................103

6.6 Version of emWin...................................................................................104

7 2-D Graphic Library......................................................................................................105

7.1 Graphic API ...........................................................................................106

7.1.1 Drawing related functions........................................................................109

7.1.2 Basic drawing routines............................................................................111

7.1.3 Alpha blending.......................................................................................117

7.1.4 Drawing bitmaps....................................................................................120

7.1.5 Drawing streamed bitmaps......................................................................122

7.1.6 Drawing lines.........................................................................................132

7.1.7 Drawing polygons...................................................................................135

7.1.8 Drawing circles ......................................................................................139

7.1.9 Drawing ellipses.....................................................................................140

7.1.10 Drawing arcs .........................................................................................141

7.1.11 Drawing graphs .....................................................................................142

7.1.12 Drawing pie charts .................................................................................143

7.1.13 Saving and restoring the GUI-context .......................................................144

8 Displaying bitmap files .................................................................................................145

8.1 BMP file support.....................................................................................146

8.1.1 Supported formats .................................................................................146

8.1.2 BMP file API...........................................................................................146

8.2 JPEG file support....................................................................................153

8.2.1 Supported JPEG compression methods ......................................................153

8.2.2 Converting a JPEG file to C source ............................................................153

8.2.3 Displaying JPEG files .............................................................................. 153

8.2.4 Memory usage ...................................................................................... 154

8.2.5 Progressive JPEG files ............................................................................ 154

8.2.6 JPEG file API ......................................................................................... 154

8.3 GIF file support ..................................................................................... 158

8.3.1 Converting a GIF file to C source ............................................................. 158

8.3.2 Displaying GIF files ................................................................................ 158

8.3.3 Memory usage ...................................................................................... 158

8.3.4 GIF file API ........................................................................................... 158

8.4 PNG file support .................................................................................... 166

8.4.1 Converting a PNG file to C source ............................................................ 166

8.4.2 Displaying PNG files ............................................................................... 166

8.4.3 Memory usage ...................................................................................... 166

8.4.4 PNG file API .......................................................................................... 166

8.5 Getting data with the ...Ex() functions...................................................... 170

9 Bitmap Converter.........................................................................................................173

9.1 What it does ......................................................................................... 174

9.2 Loading a bitmap................................................................................... 174

9.2.1 Supported input file formats.................................................................... 174

9.2.2 Loading from a file................................................................................. 174

9.2.3 Using the clipboard ................................................................................ 175

9.3 Color conversion.................................................................................... 175

9.4 Using a custom palette........................................................................... 176

9.4.1 Saving a palette file ............................................................................... 176

9.4.2 Palette file format.................................................................................. 176

9.4.3 Palette files for fixed palette modes.......................................................... 176

9.4.4 Converting a bitmap .............................................................................. 177

9.5 Generating C files from bitmaps............................................................... 177

9.5.1 Supported bitmap formats ...................................................................... 177

9.5.2 Palette information ................................................................................ 178

9.5.3 Transparency ........................................................................................ 178

9.5.4 Alpha blending ...................................................................................... 178

9.5.5 Selecting the best format........................................................................ 179

9.5.6 Saving the file....................................................................................... 180

9.6 Generating C stream files ....................................................................... 181

9.7 Compressed bitmaps.............................................................................. 181

9.8 Creating animated sprites / cursors.......................................................... 182

9.9 Command line usage.............................................................................. 184

9.9.1 Format for commands ............................................................................ 184

9.9.2 Valid command line options..................................................................... 184

9.10 Example of a converted bitmap ............................................................... 186

10 Fonts..........................................................................................................................189

10.1 Introduction.......................................................................................... 190

10.2 Font types ............................................................................................ 190

10.3 Font formats ......................................................................................... 192

10.3.1 C file format ......................................................................................... 192

10.3.2 System Independent Font (SIF) format..................................................... 192

10.3.3 External Bitmap Font (XBF) format .......................................................... 193

10.3.4 iType font engine support ....................................................................... 194

10.3.5 TrueType Font (TTF) format .................................................................... 195

10.4 Converting a TTF file to C source ............................................................. 196

10.5 Declaring custom fonts........................................................................... 196

10.6 Selecting a font ..................................................................................... 196

10.7 Font API............................................................................................... 197

10.8 C file related font functions ..................................................................... 198

10.9 ’SIF’ file related font functions................................................................. 199

10.10 ’TTF’ file related font functions................................................................. 201

10.11 ’XBF’ file related font functions ................................................................ 205

10.12 Common font-related functions ................................................................207

10.13 Character sets .......................................................................................211

10.13.1 ASCII ...................................................................................................211

10.13.2 ISO 8859-1 Western Latin character set....................................................211

10.13.3 Unicode ................................................................................................213

10.14 Font Converter.......................................................................................214

10.14.1 Adding fonts..........................................................................................214

10.15 Standard fonts.......................................................................................214

10.15.1 Font identifier naming convention.............................................................215

10.15.2 Font file naming convention.....................................................................215

10.15.3 Measurement, ROM-size and character set of fonts .....................................216

10.15.4 Proportional fonts...................................................................................217

10.15.4.1 Overview ..............................................................................................217

10.15.4.2 Measurement, ROM size and used files......................................................217

10.15.4.3 Characters ............................................................................................219

10.15.5 Proportional fonts, framed.......................................................................226

10.15.5.1 Overview ..............................................................................................226

10.15.5.2 Measurement, ROM size and used files......................................................226

10.15.5.3 Characters ............................................................................................226

10.15.6 Monospaced fonts ..................................................................................226

10.15.6.1 Overview ..............................................................................................226

10.15.6.2 Measurement, ROM size and used files......................................................227

10.15.6.3 Characters ............................................................................................228

10.15.7 Digit fonts (proportional).........................................................................233

10.15.7.1 Overview ..............................................................................................233

10.15.7.2 Measurement, ROM size and used files......................................................233

10.15.7.3 Characters ............................................................................................233

10.15.8 Digit fonts (monospaced) ........................................................................235

10.15.8.1 Overview ..............................................................................................235

10.15.8.2 Measurement, ROM size and used files......................................................235

10.15.8.3 Characters ............................................................................................235

11 Font Converter...........................................................................................................237

11.1 Requirements ........................................................................................238

11.2 Using the Font Converter.........................................................................239

11.2.1 Creating an emWin font file from a Windows font .......................................239

11.2.2 Font generation options dialog .................................................................241

11.2.2.1 Type of font to generate..........................................................................241

11.2.2.2 Encoding...............................................................................................242

11.2.2.3 Antialiasing ...........................................................................................242

11.2.3 Font Dialog............................................................................................242

11.2.3.1 Font, Font Style, and Size .......................................................................243

11.2.3.2 Script ...................................................................................................243

11.2.3.3 Unit of Size ...........................................................................................243

11.2.4 User Interface........................................................................................243

11.2.4.1 Selecting the current character ................................................................243

11.2.4.2 Toggling character status ........................................................................243

11.2.4.3 Selecting pixels......................................................................................244

11.2.4.4 Modifying character bits ..........................................................................244

11.2.4.5 Operations ............................................................................................244

11.2.4.6 Modifying the viewing mode ....................................................................245

11.3 Options.................................................................................................245

11.3.1 Saving the font ......................................................................................247

11.3.1.1 Creating a C file .....................................................................................247

11.3.1.2 Creating a System Independent Font (SIF) ................................................247

11.3.1.3 Creating an External Binary Font (XBF) .....................................................247

11.3.2 Modifying an existing C font file................................................................248

11.3.3 Merging fonts with existing C font files ......................................................249

11.4 Pattern files...........................................................................................250

11.4.1 Creating pattern files using Notepad .........................................................250

11.4.2 Creating pattern files using the Font Converter...........................................250

11.4.3 Enabling characters using a pattern file .................................................... 250

11.5 Supported output modes ........................................................................ 251

11.5.1 Standard mode ..................................................................................... 251

11.5.2 Antialiased modes.................................................................................. 251

11.6 Command line options............................................................................ 252

11.6.1 Table of commands................................................................................ 252

11.6.2 Execution examples ............................................................................... 253

11.7 Font Examples ...................................................................................... 254

11.7.1 Resulting C code, standard mode............................................................. 254

11.8 Resulting C code, 2 bpp antialiased mode ................................................. 255

11.9 Resulting C code, 4 bpp antialiased mode ................................................. 256

11.10 Resulting C code, extended mode ............................................................ 257

12 Movies........................................................................................................................259

12.1 Introduction.......................................................................................... 260

12.2 Requirements........................................................................................ 260

12.3 Creating JPEG files with FFmpeg.exe ........................................................ 260

12.4 Creating an EMF file............................................................................... 261

12.5 Modifying the conversion result ............................................................... 262

12.6 Using JPEG2Movie.................................................................................. 262

12.7 Movies API............................................................................................ 263

13 Colors.........................................................................................................................269

13.1 Predefined colors................................................................................... 270

13.2 The color bar test routine ....................................................................... 270

13.3 Fixed palette modes............................................................................... 271

13.4 Detailed fixed palette mode description .................................................... 273

13.5 Application defined color conversion......................................................... 284

13.6 Custom palette mode ............................................................................. 285

13.7 Gamma correction ................................................................................. 285

13.8 Color API.............................................................................................. 286

13.8.1 Basic functions ...................................................................................... 286

13.8.2 Conversion functions.............................................................................. 288

14 Memory Devices ........................................................................................................291

14.1 Using Memory Devices: Illustration .......................................................... 292

14.2 Supported color depth (bpp) ................................................................... 293

14.3 Memory Devices and the Window Manager................................................ 293

14.4 Memory Devices and multiple layers......................................................... 293

14.5 Memory requirements ............................................................................ 294

14.6 Performance ......................................................................................... 294

14.7 Basic functions ...................................................................................... 295

14.8 In order to be able to use Memory Devices................................................ 295

14.9 Multi layer / multi display configuration .................................................... 295

14.10 Configuration options ............................................................................. 295

14.11 Memory Device API................................................................................ 296

14.11.1 Basic functions ...................................................................................... 298

14.11.2 Banding Memory Device ......................................................................... 315

14.11.3 Auto device object ................................................................................. 316

14.11.4 Measurement device object..................................................................... 318

14.11.5 Animation functions ............................................................................... 320

14.11.6 Animation functions (Window Manager required)........................................ 321

14.11.7 Blending and Blurring functions ............................................................... 324

14.11.8 Blurring and Blending functions (Window Manager required)........................ 327

15 Execution Model: Single Task / Multitask ..................................................................331

15.1 Supported execution models ................................................................... 332

15.2 Single task system (superloop)................................................................ 332

15.2.1 Description ........................................................................................... 332

15.2.2 Superloop example (without emWin) ........................................................332

15.2.3 Advantages ...........................................................................................332

15.2.4 Disadvantages .......................................................................................332

15.2.5 Using emWin .........................................................................................333

15.2.6 Superloop example (with emWin).............................................................333

15.3 Multitask system: one task calling emWin..................................................333

15.3.1 Description............................................................................................333

15.3.2 Advantages ...........................................................................................333

15.3.3 Disadvantages .......................................................................................333

15.3.4 Using emWin .........................................................................................334

15.4 Multitask system: multiple tasks calling emWin ..........................................334

15.4.1 Description............................................................................................334

15.4.2 Advantages ...........................................................................................334

15.4.3 Disadvantages .......................................................................................334

15.4.4 Using emWin .........................................................................................334

15.4.5 Recommendations..................................................................................335

15.4.6 Example ...............................................................................................335

15.5 Configuration functions for multitasking support.........................................335

15.6 Configuration macros for multitasking support ...........................................337

15.7 Kernel interface API................................................................................339

15.8 Examples ..............................................................................................341

16 The Window Manager (WM)......................................................................................343

16.1 Description of terms ...............................................................................344

16.2 Callback mechanism, invalidation, rendering and keyboard input ..................345

16.2.1 Rendering without callbacks.....................................................................345

16.2.2 Rendering using callbacks .......................................................................346

16.2.3 Overwriting callback functions..................................................................346

16.2.4 Background window redrawing and callback...............................................347

16.2.5 Invalidation...........................................................................................348

16.2.6 Rendering of transparent windows............................................................348

16.2.7 Automatic use of Memory Devices ............................................................348

16.2.8 Automatic use of multiple frame buffers ....................................................349

16.2.9 Automatic use of display driver cache .......................................................349

16.2.10 Keyboard input ......................................................................................349

16.3 Motion support.......................................................................................349

16.3.1 Enabling motion support of the WM ..........................................................349

16.3.2 Basic motion support for a window ...........................................................349

16.3.2.1 Using creation flags ................................................................................349

16.3.2.2 Using API function..................................................................................350

16.3.3 Advanced motion support........................................................................350

16.3.3.1 WM_MOTION message and WM_MOTION_INFO..........................................350

16.3.4 Motion support for circular moves.............................................................351

16.4 ToolTips................................................................................................351

16.4.1 How they work.......................................................................................351

16.4.2 Creating ToolTips ...................................................................................351

16.4.2.1 Creating ToolTips for dialog items.............................................................352

16.4.2.2 Creating ToolTips for simple windows........................................................352

16.5 Messages ..............................................................................................353

16.5.1 Message structure ..................................................................................353

16.5.2 List of messages ....................................................................................354

16.5.3 System-defined messages.......................................................................355

16.5.4 Pointer input device (PID) messages.........................................................358

16.5.5 System-defined notification codes ............................................................362

16.5.6 Application-defined messages ..................................................................362

16.6 Configuration options..............................................................................363

16.7 WM API.................................................................................................364

16.7.1 Using the WM API functions.....................................................................366

16.7.2 WM API: Basic functions..........................................................................367

16.7.3 WM API: Motion support..........................................................................397

16.7.4 WM API: ToolTip related functions ............................................................400

剩余1161页未读，继续阅读

SCL3917

粉丝: 10
资源: 25

emWin 5.24 用户参考手册

ucgui emWin VC最新版 5.24

emwin ucgui函数手册

ucgui官网的5.24版本

基于stm32的ucgui移植手册

ucgui使用字库芯片

ucgui版本: 3.90

ucgui_font工具

Emwin的BUTTON显示汉字

ucgui3.98下载

ucgui 外部flash汉字

最新资源