STemWin 5.28：LCD开发图形界面库用户指南

4星 · 超过85%的资源需积分: 50 98 浏览量更新于2024-07-21 收藏 13.04MB PDF 举报

"STemWin 5.28是一款由SEGGER Microcontroller GmbH & Co. KG提供的图形用户界面（GUI）图形库，专为LCD开发设计。这款产品是emWin系列的最新版本，文档编号为UM03001，修订版为1，发布日期为2015年2月10日。它提供了一个强大的用户参考指南，帮助开发者高效地进行嵌入式系统的图形界面设计与实现。 emWin V5.28是一个功能丰富的图形库，其主要特性包括高度定制化的用户界面、多任务支持、广泛的设备兼容性以及高效的性能。它支持各种尺寸和类型的LCD显示屏，允许开发者创建直观的图形界面，用于控制和显示数据，广泛应用于嵌入式系统如微控制器平台。用户指南详细介绍了如何利用emWin构建用户界面，涵盖了图形对象创建、布局管理、事件处理、动画效果、触摸屏支持等方面的内容。此外，文档还强调了版权问题，明确指出未经书面许可，不得随意复制或修改PDF文件中的内容。作为一款开源工具，STemWin 5.28旨在提高开发效率并简化复杂的设计过程。然而，由于技术更新和性能优化的需求，某些规格可能会有所变动，用户需确保使用的是最新版本以获取最佳体验。尽管如此，SEGGER Microcontroller GmbH & Co. KG不对文档中的错误或遗漏承担责任，并且提供的产品和服务不附带任何明示或默示的保证，包括适销性和特定用途的适合性。 STemWin 5.28是嵌入式系统开发者在设计LCD应用时不可或缺的开发工具，提供了丰富的功能和强大的灵活性，但同时也需要注意遵循版权规定，确保合法使用。"

UM03001 User & Reference Guide for emWin V5.28 ©

1997 - 2015 SEGGER Microcontroller GmbH & Co. KG

EMBEDDED SOFTWARE

(Middleware)

emWin

Graphics software and GUI

emWin is designed to provide an effi-

cient, processor- and display control-

ler-independent graphical user

interface (GUI) for any application that

operates with a graphical display.

embOS

Real Time Operating System

embOS is an RTOS designed to offer

the benefits of a complete multitasking

system for hard real time applications

with minimal resources.

embOS/IP

TCP/IP stack

embOS/IP a high-performance TCP/IP

stack that has been optimized for

speed, versatility and a small memory

footprint.

emFile

File system

emFile is an embedded file system with

FAT12, FAT16 and FAT32 support. Vari-

ous Device drivers, e.g. for NAND and

NOR flashes, SD/MMC and Compact-

Flash cards, are available.

USB-Stack

USB device/host stack

A USB stack designed to work on any

embedded system with a USB control-

ler. Bulk communication and most stan-

dard device classes are supported.

SEGGER TOOLS

Flasher

Flash programmer

Flash Programming tool primarily for micro con-

trollers.

J-Link

JTAG emulator for ARM cores

USB driven JTAG interface for ARM cores.

J-Trace

JTAG emulator with trace

USB driven JTAG interface for ARM cores with

Trace memory. supporting the ARM ETM (Embed-

ded Trace Macrocell).

J-Link / J-Trace Related Software

Add-on software to be used with SEGGER’s indus-

try standard JTAG emulator, this includes flash

programming software and flash breakpoints.

Table 0.1:

SEGGER Microcontroller GmbH & Co. KG develops

and distributes software development tools and ANSI C

software components (middleware) for embedded sys-

tems in several industries such as telecom, medical

technology, consumer electronics, automotive industry

and industrial automation.

SEGGER’s intention is to cut software development time

for embedded applications by offering compact flexible and easy to use middleware,

allowing developers to concentrate on their application.

Our most popular products are emWin, a universal graphic software package for embed-

ded applications, and embOS, a small yet efficient real-time kernel. emWin, written

entirely in ANSI C, can easily be used on any CPU and most any display. It is comple-

mented by the available PC tools: Bitmap Converter, Font Converter, Simulator and

Viewer. embOS supports most 8/16/32-bit CPUs. Its small memory footprint makes it

suitable for single-chip applications.

Apart from its main focus on software tools, SEGGER develops and produces programming

tools for flash micro controllers, as well as J-Link, a JTAG emulator to assist in develop-

ment, debugging and production, which has rapidly become the industry standard for

debug access to ARM cores.

Corporate Office:

http://www. segger.com

United States Office:

http://www.segger-us.com

1 Introduction to emWin....................................................................................................33

1.1 Purpose of this document .........................................................................33

1.2 Requirements..........................................................................................33

1.2.1 Target system (hardware) ........................................................................33

1.2.2 Development environment (compiler).........................................................34

1.3 Features.................................................................................................34

1.4 Examples and demos ...............................................................................35

1.5 Starter kits .............................................................................................35

1.6 Screen and coordinates ............................................................................36

1.7 How to connect the display to the microcontroller ........................................36

1.8 Data types..............................................................................................37

2 Getting Started...............................................................................................................39

2.1 Recommended project structure ................................................................40

2.2 Subdirectories.........................................................................................40

2.2.1 Include directories ...................................................................................40

2.3 Adding emWin to the target program .........................................................41

2.4 Creating a library.....................................................................................41

2.4.1 Adapting the library batch files to a different system ....................................42

2.5 C files to include in the project ..................................................................44

2.6 Configuring emWin ..................................................................................45

2.7 Initializing emWin....................................................................................46

2.8 Using emWin with target hardware ............................................................47

2.9 The "Hello world" example program ...........................................................48

3 Simulation ......................................................................................................................49

3.1 Using the simulation ................................................................................50

3.1.1 Rotating and mirroring the screen..............................................................50

3.1.2 Using the simulation with the trial version of emWin.....................................50

3.1.2.1 Directory structure...................................................................................50

3.1.2.2 Visual C++ workspace..............................................................................51

3.1.2.3 Compiling the demo program ....................................................................51

3.1.2.4 Compiling the samples .............................................................................51

3.1.3 Using the simulation with the emWin source................................................52

3.1.3.1 Directory structure...................................................................................52

3.1.3.2 Visual C++ workspace..............................................................................53

3.1.3.3 Compiling the application..........................................................................53

3.1.4 Advanced features of the simulation...........................................................53

3.1.4.1 Pause and Resume ..................................................................................53

3.1.4.2 View system info .....................................................................................54

3.1.4.3 Copy to clipboard ....................................................................................54

3.2 Device simulation ....................................................................................55

3.2.1 Generated frame view..............................................................................56

3.2.2 Custom bitmap view ................................................................................56

3.2.3 Window view...........................................................................................57

3.3 Device simulation API...............................................................................58

3.4 Hardkey simulation..................................................................................63

3.4.1 Hardkey simulation API ............................................................................64

3.5 Integrating the emWin simulation into an existing simulation.........................67

3.5.1 Directory structure...................................................................................67

Table of Contents

3.5.2 Using the simulation library ...................................................................... 67

3.5.2.1 Modifying WinMain .................................................................................. 67

3.5.2.2 Example application................................................................................. 68

3.5.3 Integration into the embOS Simulation....................................................... 69

3.5.3.1 WinMain................................................................................................. 69

3.5.3.2 Target program (main) ............................................................................ 70

3.5.4 GUI simulation API .................................................................................. 71

4 Viewer............................................................................................................................75

4.1 Using the viewer ..................................................................................... 76

4.1.1 Using the simulation and the viewer .......................................................... 76

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

4.1.3 Always on top......................................................................................... 77

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

4.1.5 Zooming ................................................................................................ 78

4.1.6 Copy the output to the clipboard ............................................................... 78

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

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

5 emWinSPY.....................................................................................................................81

5.1 Introduction ........................................................................................... 82

5.1.1 Requirements ......................................................................................... 82

5.1.2 Availability ............................................................................................. 82

5.2 Starting the emWinSPY server... ............................................................... 82

5.2.1 ...in the simulation environment................................................................ 82

5.2.2 ...on the target hardware ......................................................................... 82

5.2.3 GUI_SPY_X_StartServer........................................................................... 82

5.3 The emWinSPY viewer ............................................................................. 83

5.3.1 The screen ............................................................................................. 83

5.3.1.1 Status area ............................................................................................ 83

5.3.1.2 History area ........................................................................................... 84

5.3.1.3 Windows area......................................................................................... 85

5.3.1.4 Input area.............................................................................................. 86

5.3.2 Connecting to target................................................................................ 86

5.3.3 Configuration options............................................................................... 87

5.3.4 Taking a screenshot from the target .......................................................... 87

5.4 emWinSPY API........................................................................................ 88

6 Displaying Text ..............................................................................................................91

6.1 Basic routines......................................................................................... 92

6.2 Drawing modes....................................................................................... 92

6.3 Position ................................................................................................. 93

6.4 Text API................................................................................................. 94

6.4.1 Displaying text........................................................................................ 95

6.4.2 Drawing modes......................................................................................102

6.4.3 Alignment .............................................................................................103

6.4.4 Position ................................................................................................104

7 Displaying Values ........................................................................................................105

7.1 Value API..............................................................................................106

7.1.1 Displaying decimal values........................................................................106

7.1.2 Displaying floating point values ................................................................110

7.1.3 Displaying binary values..........................................................................112

7.1.4 Displaying hexadecimal values.................................................................113

7.1.5 Version of emWin...................................................................................114

8 2-D Graphic Library......................................................................................................115

8.1 Graphic API ...........................................................................................116

8.1.1 Drawing related functions........................................................................119

8.1.2 Basic drawing routines ........................................................................... 122

8.1.3 Alpha blending ...................................................................................... 128

8.1.4 Drawing bitmaps ................................................................................... 131

8.1.5 Drawing streamed bitmaps ..................................................................... 133

8.1.6 Drawing lines ........................................................................................ 142

8.1.7 Drawing polygons .................................................................................. 146

8.1.8 Drawing circles...................................................................................... 150

8.1.9 Drawing ellipses .................................................................................... 151

8.1.10 Drawing arcs......................................................................................... 152

8.1.11 Drawing graphs..................................................................................... 153

8.1.12 Drawing pie charts................................................................................. 154

8.1.13 Saving and restoring the GUI-context....................................................... 155

8.1.14 Info about screen changes ...................................................................... 155

8.1.15 Avoiding tearing effects.......................................................................... 158

9 Displaying bitmap files .................................................................................................159

9.1 BMP file support .................................................................................... 160

9.1.1 Supported formats................................................................................. 160

9.1.2 BMP API ............................................................................................... 160

9.2 JPEG file support ................................................................................... 166

9.2.1 Supported JPEG compression methods ..................................................... 166

9.2.2 Converting a JPEG file to C source............................................................ 166

9.2.3 Displaying JPEG files .............................................................................. 166

9.2.4 Memory usage ...................................................................................... 167

9.2.5 Progressive JPEG files ............................................................................ 167

9.2.6 JPEG API .............................................................................................. 167

9.3 GIF file support ..................................................................................... 172

9.3.1 Converting a GIF file to C source ............................................................. 172

9.3.2 Displaying GIF files ................................................................................ 172

9.3.3 Memory usage ...................................................................................... 172

9.3.4 GIF API ................................................................................................ 172

9.4 PNG file support .................................................................................... 181

9.4.1 Converting a PNG file to C source ............................................................ 181

9.4.2 Displaying PNG files ............................................................................... 181

9.4.3 Memory usage ...................................................................................... 181

9.4.4 PNG API ............................................................................................... 181

9.5 Getting data with the ...Ex() functions...................................................... 185

10 Bitmap Converter.......................................................................................................187

10.1 What it does ......................................................................................... 188

10.2 Loading a bitmap................................................................................... 188

10.2.1 Supported input file formats.................................................................... 188

10.2.2 Loading from a file................................................................................. 188

10.2.3 Using the clipboard ................................................................................ 189

10.3 Color conversion.................................................................................... 189

10.4 Dithering.............................................................................................. 190

10.5 Using a custom palette........................................................................... 190

10.5.1 Saving a palette file ............................................................................... 191

10.5.2 Palette file format.................................................................................. 191

10.5.3 Palette files for fixed palette modes.......................................................... 191

10.5.4 Converting a bitmap .............................................................................. 191

10.6 Generating C files from bitmaps............................................................... 191

10.6.1 Supported bitmap formats ...................................................................... 192

10.6.2 Palette information ................................................................................ 192

10.6.3 Transparency ........................................................................................ 193

10.6.4 Alpha blending ...................................................................................... 193

10.6.5 Selecting the best format........................................................................ 194

10.6.6 Saving the file....................................................................................... 195

10.7 Generating C stream files ....................................................................... 196

10.8 Compressed bitmaps.............................................................................. 197

10.9 Creating animated sprites / cursors ..........................................................197

10.10 Command line usage ..............................................................................199

10.10.1 Format for commands.............................................................................199

10.10.2 Command line options ............................................................................199

10.11 Example of a converted bitmap ................................................................201

11 Fonts..........................................................................................................................205

11.1 Introduction ..........................................................................................206

11.2 Font types.............................................................................................206

11.3 Font formats..........................................................................................208

11.3.1 C file format ..........................................................................................208

11.3.2 System Independent Font (SIF) format .....................................................208

11.3.3 External Bitmap Font (XBF) format ...........................................................209

11.3.4 iType font engine support........................................................................210

11.3.5 TrueType Font (TTF) format.....................................................................211

11.4 Converting a TTF file to C source..............................................................212

11.5 Declaring custom fonts ...........................................................................212

11.6 Selecting a font......................................................................................212

11.7 Font API................................................................................................213

11.7.1 C file related font functions......................................................................213

11.7.2 ’SIF’ file related font functions..................................................................215

11.7.3 ’TTF’ file related font functions .................................................................216

11.7.4 ’XBF’ file related font functions.................................................................219

11.7.5 Common font-related functions ................................................................221

11.8 Character sets .......................................................................................226

11.8.1 ASCII ...................................................................................................226

11.8.2 ISO 8859-1 Western Latin character set....................................................226

11.8.3 Unicode ................................................................................................228

11.9 Font Converter.......................................................................................229

11.9.1 Adding fonts..........................................................................................229

11.10 Standard fonts.......................................................................................230

11.10.1 Font identifier naming convention.............................................................230

11.10.2 Font file naming convention.....................................................................231

11.10.3 Measurement, ROM-size and character set of fonts .....................................231

11.10.4 Proportional fonts...................................................................................232

11.10.4.1 Overview ..............................................................................................232

11.10.4.2 Font details ...........................................................................................232

11.10.4.3 Characters ............................................................................................234

11.10.5 Proportional fonts, framed.......................................................................241

11.10.5.1 Overview ..............................................................................................241

11.10.5.2 Font details ...........................................................................................241

11.10.5.3 Characters ............................................................................................241

11.10.6 Monospaced fonts ..................................................................................242

11.10.6.1 Overview ..............................................................................................242

11.10.6.2 Font details ...........................................................................................242

11.10.6.3 Characters ............................................................................................243

11.10.7 Digit fonts (proportional).........................................................................249

11.10.7.1 Overview ..............................................................................................249

11.10.7.2 Font details ...........................................................................................249

11.10.7.3 Characters ............................................................................................249

11.10.8 Digit fonts (monospaced) ........................................................................251

11.10.8.1 Overview ..............................................................................................251

11.10.8.2 Font details ...........................................................................................251

11.10.8.3 Characters ............................................................................................251

12 Font Converter...........................................................................................................253

12.1 Requirements ........................................................................................254

12.2 Creating an emWin font file from a Windows font .......................................255

12.3 Font generation options dialog .................................................................257

12.3.1 Type of font to generate..........................................................................257

剩余1236页未读，继续阅读

liu_louis

粉丝: 2
资源: 21

STemWin 5.28：LCD开发图形界面库用户指南

STM32驱动LCD屏幕

tm1638.规格书

uc266.com-20090406-03.rar

neo4j权威指南-图数据库-大数据时代的新利器.pdf

n个通达信同步联动利器v2.0.rar

ionic2——开发利器之Visual Studio Code 常用快捷键

善工利器 程序员管理范式 pdf

adb uiautomator xml 解析, 脚本开发必备利器 模拟器/真机通用

Web开发利器Webstorm导入多个文件夹或者项目

模糊测试——强制发掘安全漏洞的利器 pdf

最新资源

善工利器程序员管理范式 pdf

adb uiautomator xml 解析, 脚本开发必备利器模拟器/真机通用