Contents
1 Introduction 2
1.1 What is
➭
GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2
➭
GUI Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3
➭
GUI Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2 Windows 2
2.1 Window Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2 Update Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.3 Callback Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3 Touch and Input devices 5
4 Driver Support 6
4.1 Hardware Acceleration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.1.1 DRIVER DRAW LINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.1.2 DRIVER FILL FRAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5 Colors 7
5.1 Color Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
5.2 Predefined Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
6 Fonts 10
6.1 FONT 4X6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
6.2 FONT 5X8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
6.3 FONT 5X12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1
6.4 FONT 6X8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
6.5 FONT 6X10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1
6.6 FONT 7X12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2
6.7 FONT 8X8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
6.8 FONT 8X12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2
6.9 FONT 8X14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3
6.10 FONT 10X16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
6.11 FONT 12X16 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.12 FONT 12X20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.13 FONT 16X26 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.14 FONT 22X36 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.15 FONT 24X40 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.16 FONT 32X53 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
7 Functions 19
7.1 Classic Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.1.1 UG Init() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.1.2 UG SelectGUI() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.1.3 UG FontSelect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.1.4 UG FillScre en ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
7.1.5 UG FillFra m e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
1
7.1.6 UG FillRou n d Frame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
7.1.7 UG DrawMesh() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.1.8 UG DrawFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
7.1.9 UG DrawRoundFrame() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7.1.10 UG DrawPixel ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
7.1.11 UG DrawCircl e () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
7.1.12 UG FillCircle() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7.1.13 UG DrawArc() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7.1.14 UG DrawLin e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.1.15 UG PutString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
7.1.16 UG PutChar() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
7.1.17 UG ConsolePutString() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
7.1.18 UG ConsoleSetArea() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
7.1.19 UG ConsoleSetForecolor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
7.1.20 UG ConsoleSetBackcolor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
7.1.21 UG SetForecolor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7.1.22 UG SetBackcolor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7.1.23 UG GetXDim() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7.1.24 UG GetYDim() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7.1.25 UG FontSet HS p a ce( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
7.1.26 UG FontSet VS p a ce( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
7.2 Driver Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
7.2.1 UG DriverRegister() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
7.2.2 UG DriverEnable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7.2.3 UG DriverDisable() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7.3 Window Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.3.1 UG WindowCreate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
7.3.2 UG WindowDelete() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
7.3.3 UG WindowShow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
7.3.4 UG WindowHide() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
7.3.5 UG WindowResize() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.3.6 UG WindowAlert() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
7.3.7 UG WindowSetForeColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
7.3.8 UG WindowSetBackColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.3.9 UG WindowSetTitleTextColor() . . . . . . . . . . . . . . . . . . . . . . . . . 52
7.3.10 UG WindowS et Ti t l eCo lor ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
7.3.11 UG WindowS et Ti t l eIn a ct iveTextColor() . . . . . . . . . . . . . . . . . . . . 54
7.3.12 UG WindowS et Ti t l eIn a ct iveColor() . . . . . . . . . . . . . . . . . . . . . . . 55
7.3.13 UG WindowS et Ti t l eText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
7.3.14 UG WindowS et Ti t l eTextFont() . . . . . . . . . . . . . . . . . . . . . . . . . 57
7.3.15 UG WindowS et Ti t l eTextHSpace() . . . . . . . . . . . . . . . . . . . . . . . . 58
7.3.16 UG WindowS et Ti t l eTextVSpace() . . . . . . . . . . . . . . . . . . . . . . . . 59
7.3.17 UG WindowS et Ti t l eTextAlignment() . . . . . . . . . . . . . . . . . . . . . . 59
7.3.18 UG WindowS et Ti t l eHei g ht() . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
7.3.19 UG WindowS et XS ta r t () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.3.20 UG WindowS et YS ta r t () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
7.3.21 UG WindowS et XEn d ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2
7.3.22 UG WindowS et YEn d ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
7.3.23 UG WindowS et S tyle() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
7.3.24 UG WindowGet ForeColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
7.3.25 UG WindowGet Ba ckColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
7.3.26 UG WindowGet Ti t l eTextColor() . . . . . . . . . . . . . . . . . . . . . . . . 65
7.3.27 UG WindowGet Ti t l eCo lo r( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
7.3.28 UG WindowGet Ti t l eIn a ct iveTextColor() . . . . . . . . . . . . . . . . . . . . 66
7.3.29 UG WindowGet Ti t l eIn a ct iveColor() . . . . . . . . . . . . . . . . . . . . . . 67
7.3.30 UG WindowGet Ti t l eText() . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
7.3.31 UG WindowGet Ti t l eTextFont() . . . . . . . . . . . . . . . . . . . . . . . . . 68
7.3.32 UG WindowGet Ti t l eTextHSpace() . . . . . . . . . . . . . . . . . . . . . . . 68
7.3.33 UG WindowGet Ti t l eTextVSpace() . . . . . . . . . . . . . . . . . . . . . . . 69
7.3.34 UG WindowGet Ti t l eTextAlignment() . . . . . . . . . . . . . . . . . . . . . . 69
7.3.35 UG WindowGet Ti t l eHei g ht() . . . . . . . . . . . . . . . . . . . . . . . . . . 70
7.3.36 UG WindowGet XS t ar t ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
7.3.37 UG WindowGet YS t ar t ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
7.3.38 UG WindowGet XEn d ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.3.39 UG WindowGet YEn d ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
7.3.40 UG WindowGet S tyle() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7.3.41 UG WindowGet Ar ea () . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7.3.42 UG WindowGet In n er Wi d t h ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . 74
7.3.43 UG WindowGet O u te rWi d th ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . 76
7.3.44 UG WindowGet In n er Hei g ht() . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7.3.45 UG WindowGet O u te rHe i ght() . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.4 Button Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.4.1 UG ButtonCr ea t e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.4.2 UG ButtonD el et e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.4.3 UG ButtonS h ow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.4.4 UG ButtonHi d e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.4.5 UG ButtonS et ForeColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
7.4.6 UG ButtonS et Ba ckColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
7.4.7 UG ButtonS et Al t er n at eForeColor() . . . . . . . . . . . . . . . . . . . . . . . 83
7.4.8 UG ButtonS et Al t er n at eB ackColor() . . . . . . . . . . . . . . . . . . . . . . . 8 4
7.4.9 UG ButtonS et Text() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
7.4.10 UG ButtonSetFont() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
7.4.11 UG ButtonSetStyle() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
7.4.12 UG ButtonGetForeColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
7.4.13 UG ButtonGetBackColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
7.4.14 UG ButtonGetAlternateForeColor() . . . . . . . . . . . . . . . . . . . . . . . 87
7.4.15 UG ButtonGetAlternateBackColor() . . . . . . . . . . . . . . . . . . . . . . 88
7.4.16 UG ButtonGetText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.4.17 UG ButtonGetFont() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.4.18 UG ButtonGetStyle() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.5 Textbox Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.5.1 UG TextboxCreate() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.5.2 UG TextboxDelete() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.5.3 UG TextboxShow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
3
7.5.4 UG TextboxHide() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
7.5.5 UG TextboxSetForeColo r ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
7.5.6 UG TextboxSetBackColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3
7.5.7 UG TextboxSetText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
7.5.8 UG TextboxSetFont() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
7.5.9 UG TextboxSetHSpace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
7.5.10 UG TextboxSetVSpace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 6
7.5.11 UG TextboxSetAlignment() . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
7.5.12 UG TextboxGetForeColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
7.5.13 UG TextboxGetBackColor() . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
7.5.14 UG TextboxGetText() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
7.5.15 UG TextboxGetFont() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
7.5.16 UG TextboxGetHSpace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
7.5.17 UG TextboxGetVSpace() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
7.5.18 UG TextboxGetAlignment() . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
7.6 Image Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
7.6.1 UG ImageCreat e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
7.6.2 UG ImageDelet e( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
7.6.3 UG ImageShow() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
7.6.4 UG ImageHide( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
7.6.5 UG ImageSetBM P( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
8 Revision history 108
8.1 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
8.2 Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
4