【AWTK使用經(jīng)驗】加載和釋放外部圖片

AWTK是基于C語言開發(fā)的跨平臺GUI框架?！禔WTK使用經(jīng)驗》系列文章將介紹開發(fā)AWTK過程中一些常見問題與解決方案，例如：如何加載外部資源？如何設(shè)計自定義進(jìn)度條？這些都會在系列文章進(jìn)行解答。

加載指定路徑的圖片資源

AWTK默認(rèn)加載資源方式有兩種，一種是將資源打包到程序中放入Flash，另一種是放在res資源目錄中。假設(shè)現(xiàn)在需要實現(xiàn)一個圖片瀏覽器并移植到 ZTP800示教器 設(shè)備上，該圖片瀏覽器需要加載U盤圖片，此時就要用到AWTK加載外部資源的功能來實現(xiàn)該需求。下面將分為有文件系統(tǒng)和無文件系統(tǒng)兩種情況來介紹此功能。圖1?ZTP800示教器加載U盤圖片效果

1. 有文件系統(tǒng)

在有文件系統(tǒng)時若想加載非AWTK默認(rèn)目錄結(jié)構(gòu)的圖片資源，可以使用：file://?+?圖片所在路徑的形式來加載圖片，并且可以使用C代碼或者xml形式來加載。

1.1 C代碼方式：

widget_t*?image?=?widget_lookup(win,?"image",?TRUE);image_set_image(image, "file:///media/sda1/AWTK.png");

1.2 XML方式：

<window?name="home_page?">??<image?name="image"?x="0"?y="0"?w="50"?h="50"?draw_type="default"?image="file:///media/sda1/AWTK.png"/></window>

2. 無文件系統(tǒng)

若是在沒有文件系統(tǒng)的設(shè)備中加載外部圖片，可以先讀取圖片文件數(shù)據(jù)，再將數(shù)據(jù)作為參數(shù)傳給 assets_manager_add_data()?函數(shù)。該函數(shù)會將數(shù)據(jù)添加到AWTK資源管理器中，添加后就可以通過文件名的形式來顯示圖片了。

下面是一段STM32平臺加載SD卡圖片的示例代碼：

uint8_t?read_buffer[512];int?sdcard_status?=?HAL_SD_ReadBlocks(&sd_handle,?(uint8_t*)?read_buffer,?0,?1,?0xffff);if?(sdcard_status?==?HAL_OK)?{  assets_manager_add_data(assets_manager(),"AWTK",ASSET_TYPE_IMAGE,ASSET_TYPE_IMAGE_PNG,?read_buffer,?size);  image_set_image(image,?"AWTK");}

釋放圖片資源并重新加載

假設(shè)目前實現(xiàn)了圖片瀏覽器并移植到了ZTP800示教器上，但是需要圖片瀏覽器加載的圖片名稱固定不變，而本地圖片數(shù)據(jù)會經(jīng)常發(fā)生改變，這時候就需要在AWTK重新加載并更新圖片到畫面中。

AWTK在加載一張圖片時，會先將圖片緩存到assets_manager資源管理器當(dāng)中，接著再解碼放到image_manager圖片管理器，最后顯示的圖片來自圖片管理器解碼好的圖片，因此對于上面的需求就要手動卸載與重新加載圖片緩存。下圖為ZTP800示教器上的示例程序重新加載圖片前后效果圖：

圖2?示例程序的初始圖

圖2?示例程序的初始圖

1. 卸載圖片緩存

假設(shè)在示例程序中已經(jīng)加載并顯示了一張圖片，并且此時本地圖片文件數(shù)據(jù)發(fā)生了改變，可以按照以下步驟卸載圖片管理器和資源管理器上的圖片緩存。

#define?IMAGE_NAME?"/media/sda1/AWTK.png"?//?圖片名默認(rèn)為assets_manager_load_file加載的路徑
static?ret_t?on_unload_button_click(void*?ctx,?event_t*?e)?{?//?點擊卸載圖片按鈕卸載圖片緩存??bitmap_t?bitmap?=?{0};??widget_t*?win?=?WIDGET(ctx);??widget_t*?image?=?widget_lookup(win,?"image",?TRUE);??
??//?卸載圖片管理器緩存??image_manager_get_bitmap(image_manager(),?IMAGE_NAME,?&bitmap);??image_manager_unload_bitmap(image_manager(),?&bitmap);
??//?卸載資源管理器緩存??assets_manager_clear_cache_ex(assets_manager(),?ASSET_TYPE_IMAGE,?IMAGE_NAME);??widget_invalidate(image,?NULL);?
??return?RET_OK;}

上面代碼中image_manager_unload_bitmap是用于卸載圖片在圖片管理器的緩存卸載緩存成功后會輸出“unload image xxx”的debug信息；assets_manager_clear_cache_ex是用于卸載資源管理器的該圖片緩存。

2. 重新加載圖片緩存

卸載圖片緩存后，可以通過以下步驟再次加載圖片到資源管理器中：

static?ret_t?on_load_button_click(void*?ctx,?event_t*?e)?{?//?點擊加載圖片按鈕重新加載圖片緩存??widget_t*?win?=?WIDGET(ctx);??widget_t*?image?=?widget_lookup(win,?"image",?TRUE);
??//?將新的圖片數(shù)據(jù)添加到資源管理器緩存中??asset_info_t*?img?=?assets_manager_load_file(assets_manager(),?ASSET_TYPE_IMAGE,?IMAGE_NAME);  assets_manager_add(assets_manager(), img);
  image_set_image(image, IMAGE_NAME);
??widget_invalidate(image,?NULL);??
??return?RET_OK;}

上面代碼調(diào)用assets_manager_load_file與assets_manager_add重新加載了一次圖片數(shù)據(jù)到AWTK資源管理器的緩存，此時加載的數(shù)據(jù)是新的圖片數(shù)據(jù)。

后續(xù)在調(diào)用image_set_image以及widget_invalidate刷新圖片控件時會自動將位于資源管理器的緩存解碼并放到圖片管理器當(dāng)中，最后顯示新的圖片數(shù)據(jù)。