Application Note ANGS [Issued date August 1, 2011]

Size: px

Start display at page:

Download "Application Note ANGS [Issued date August 1, 2011]"

Sylvia Russell
5 years ago
Views:

GUI Script Application Note ANGS1.00.02 [Issued date August 1, 2011] Making User Keypad User keypad can be made with or without images.

1 GUI Script Application Note ANGS [Issued date August 1, 2011] Making User Keypad User keypad can be made with or without images. Either method, the user has to define widths, characters, heights to the keypad. Without images, basic buttons will be used with selectable color. Our GUI Script example projects use both keypad style, image keypad on 7 example and simple button on 4.3 example. A keypad can have up to 16 tables, each with up to 5 rows (by default), for example, English keypad takes 2 tables for their small and block characters, 2 tables for second language and 1 for numbers. Here we make it easy to change table with the character 0x10-0x14 for table 0-4 respectively. That s why only 16 tables allowed. Start making your own keypad 1. Design your keypad tables Whether you re going to use images for keypad or not, there are 2 rules to make a keypad: Rule 1: Every button must be in a single row. Buttons can have different widths and rows can have different heights, but button are not allowed to be in 2 or more rows!

2 Rule 2: All tables must have the same size. There is no limitation for number of rows in a table, just make every table the same size. If you re using images for keypad, you can provide image for normal state and press state. Images below are from 7 example downloadable from our website. 5 images on the left are used for normal state and 5 images on the right for press state.

3 2. Tables setting There are 2 structures relate to a keypad, the keypad itself and tables. Let s focus on the tables first. Structure below is copied from sw_mod/obj_lib_v3_03.h or later. It contains fields of a table. typedef struct char *bt_txt[kp3_max_row]; //string of character on buttons for each row char *bt_val[kp3_max_row]; //string of character on buttons for each row unsigned short *bt_width[kp3_max_row]; //array of button widths unsigned long *font_color[kp3_max_row]; //font color unsigned long *norm_bt_color[kp3_max_row]; //array of normal button colors unsigned long *pres_bt_color[kp3_max_row]; //array of pressed button colors unsigned short bt_height[kp3_max_row]; //button height unsigned long norm_img_address; //normal image address in case of image keypad used unsigned long pres_img_address; //press image address in case of image keypad used unsigned char row; //number of row, used when var_bt_height set } kp3_tab_t; Example codes below on this section (highlighted in light blue and orange) are copied from app/app_kp.c. They come with 7 example projects. In the example, 5 tables are created (2 English, 2 Thai and 1 number). kp3_tab_t tab[5]; - *bt_txt: Array of text for a row. Use to separate between buttons. For special buttons (such as table change button, backspace or enter), use - instead, their real value will be set in bt_val. Anyway, for keypad with simple buttons, this text will be print on the table, special button needs their words on button. Cap, Shift or any words should be placed here, do not use too long text that doesn t fit the button it belongs to. const char tb_en_t0[] = const char tb_en_t1[] = const char tb_en_t2[] = const char tb_en_t3[] = const char tb_en2_t0[] = const char tb_en2_t1[] = "q w e r t y u i o p -"; "a s d f g h j k l : "z x c v b n m,. / -"; "- - _ -"; "Q W E R T Y U I O P -"; "A S D F G H J K L :

4 const char tb_en2_t2[] = const char tb_en2_t3[] = "Z X C V B N M < >? -"; "- - _ -"; tab[1].bt_txt[0] = (char *)tb_en_t0; tab[1].bt_txt[1] = (char *)tb_en_t1; tab[1].bt_txt[2] = (char *)tb_en_t2; tab[1].bt_txt[3] = (char *)tb_en_t3; tab[2].bt_txt[0] = (char *)tb_en2_t0; tab[2].bt_txt[1] = (char *)tb_en2_t1; tab[2].bt_txt[2] = (char *)tb_en2_t2; tab[2].bt_txt[3] = (char *)tb_en2_t3; - *bt_val: Value for buttons. Use zero for normal buttons that have its real value specified with bt_txt. For special buttons, place their value here. Use 0x1n (n=0-9, A-F) for buttons that perform table change to n th table. const char tb_vx[] = 0,0,0,0,0,0,0,0,0,0,0,0,0}; const char tb_en_v0[] = 0,0,0,0,0,0,0,0,0,0,0x08}; const char tb_en_v2[] = 0,0,0,0,0,0,0,0,0,0,0x0D}; const char tb_en_v3[] = 0x12,0x13,0,0,0x010}; const char tb_en2_v0[] = 0,0,0,0,0,0,0,0,0,0,0x08}; const char tb_en2_v2[] = 0,0,0,0,0,0,0,0,0,0,0x0D}; const char tb_en2_v3[] = 0x11,0x13,0,0,0x010}; tab[1].bt_val[0] = (char *)tb_en_v0; tab[1].bt_val[1] = (char *)tb_vx; tab[1].bt_val[2] = (char *)tb_en_v2; tab[1].bt_val[3] = (char *)tb_en_v3; tab[2].bt_val[0] = (char *)tb_en2_v0; tab[2].bt_val[1] = (char *)tb_vx; tab[2].bt_val[2] = (char *)tb_en2_v2; tab[2].bt_val[3] = (char *)tb_en2_v3; Remark 0x08 = backspace, 0x0D = enter

5 - *bt_width: Width (in pixel) for buttons, close every row with 0. Example (image on the right is not related with code below): const unsigned short tb_en_w02[] = 65,67,66,67,67,67,67,67,67,66,134,0}; const unsigned short tb_en_w1[] = 64,67,67,67,67,67,67,67,67,66,67,67,0}; const unsigned short tb_en_w3[] = 130,134,335,67,134,0}; tab[1].bt_width[0] = (unsigned short *)tb_en_w02; tab[1].bt_width[1] = (unsigned short *)tb_en_w1; tab[1].bt_width[2] = (unsigned short *)tb_en_w02; tab[1].bt_width[3] = (unsigned short *)tb_en_w3; - *font_color: Font color for keypad with simple button only, assign color value in 24bpp, 16bpp or 8bpp depending on the color depth of you project. - *norm_bt_color: Normal button color for keypad with simple button only, assign color value in 24bpp, 16bpp or 8bpp depending on the color depth of you project. - *press_bt_color: Pressed button color for keypad with simple button only, assign color value in 24bpp, 16bpp or 8bpp depending on the color depth of you project.

- bt_height: Height of rows (in pixel). Example (image above is not related with code below): const unsigned short tb_en_h[] = 70,70,70,70}; tab[1].bt_height[0] = tb_en_h[0]; tab[1].

6 - bt_height: Height of rows (in pixel). Example (image above is not related with code below): const unsigned short tb_en_h[] = 70,70,70,70}; tab[1].bt_height[0] = tb_en_h[0]; tab[1].bt_height[1] = tb_en_h[1]; tab[1].bt_height[2] = tb_en_h[2]; tab[1].bt_height[3] = tb_en_h[3]; - norm_img_address: Address of image for normal state, only applied to image keypad, it is usually be assigned to SDRAM address that contain the beginning of image. If GUI Script is used, set it to guiimage[xxx].address. tab[1].norm_img_address = guiimage[32].address; - pres_img_address: Address of image for pressed state, only applied to image keypad, same usage with norm_img_address. tab[1].pres_img_address = guiimage[33].address; - row: Number of rows of the table. tab[0].row = 4;

7 3. Keypad setting After all tables configured, now it comes to the keypad itself. Its structure is in the header file sw_mod/obj_lib_v3_03.h or later as well. typedef struct unsigned char obj_no; //object no unsigned char table; //number of table unsigned short horigin; //horizontal origin unsigned short vorigin; //vertical origin unsigned short hsize; //horizontal size unsigned short vsize; //vertical size unsigned short bt_height; //button height unsigned char gap; //gap between rows and buttons unsigned char row; //number of row unsigned char bt_in_row; //maximum number of buttons in rows unsigned char var_bt_height; //set to 1 for variable row height tables (and also set kp3_tab_t.bt_height) unsigned char use_image_kp; //set to 1 for image keypad (and also set both img_addresses) unsigned long bg_color; //background color unsigned char init_table; //initial table kp3_tab_t *tab_ptr; //address of table array void (*bt_draw)(pos_n_size_t *ps,unsigned long bt_color,unsigned long font_color,char *txt,unsigned char align); } kp3_t; In order to configure keypad, a function named GUIBindCustomKP3Init (from gui_engine/gui_engine_v3.10.h or later) is provided. void GUIBindCustomKP3Init( void (*func)(unsigned char kp_no, unsigned char obj_no, kp3_t *kp)); //set custom_kp_init function In the example, this keypad function is named as kp_init (in app_kp.c). And it s used in AppScrInit (app/app_scr_func.c). void AppScrInit(void) GUIBindCustomKP3Init(kp_init); The instance of kp3 is actually in gui_engine library. Here it s passed as a pointer. Most of the fields of kp3_t are clearly described by its comments. Some fields are described more in detail.

8 -bt_height : Height of buttons, use only in case that all rows on tables have the same height. Unless they are the same, set var_bt_height to 1and bt_height is ignored. -gap : Used for non-image keypad. Set to 0 for image keypad. -row : As tables can have different rows. Set to the most one. -init_table : It s not necessary that the keypad must start with table 0. Set the initial table ID to this field. -*bt_draw : For user button drawing function. Left it unassigned and the default function will be used. kp->obj_no = obj_no; //object no kp->table = 5; //number of table kp->hsize = guiimage[30].hsize; //horizontal size kp->vsize = guiimage[30].vsize; //vertical size kp->horigin = 0; //horizontal origin kp->vorigin = 200; //vertical origin kp->gap = 0; //gap between rows and buttonss kp->row = 5; //number of row kp->bt_in_row = 13; //maximum number of buttons in rows kp->bg_color = TS_COL_BLACK; //background color kp->tab_ptr = tab; //address of table array kp->var_bt_height = 1; kp->use_image_kp = 1; The parameter kp_no is the keypad number that can be 6 or 7 (this is set from script with SCS K 6 or SCS K 7 ), allow the user to have maximum of 2 user keypads in an application. To do that, kp_no must be used to determine which keypad is going to be used on current screen. The code looks like below; void kp_init(unsigned char kp_no,unsigned char obj_no,kp3_t *kp) if (kp_no == 6) //place all settings for the first keypad } else //place all settings for the second keypad } }

BMP file format - Wikipedia

BMP file format - Wikipedia Page 1 of 3 Bitmap file header This block of bytes is at the start of the file and is used to identify the file. A typical application reads this block first to ensure that the file is actually a BMP file