【例說Arm-2D界面設(shè)計(jì)】片內(nèi)Flash不夠怎么辦？

• 貼圖的各類屬性描述信息：tInfo

• 貼圖的尺寸和位置信息： tRegion

• 貼圖的指針或引用

• 根貼圖的屬性 tInfo.bIsRoot 一定為 true；
• 根貼圖的指針直接指向具體的資源數(shù)組或者現(xiàn)實(shí)緩沖區(qū)

為了解決這一問題，arm-2d 在基類 arm_2d_tile_t 的基礎(chǔ)上派生出了一個(gè)新的類：虛擬資源（Virtual Resource），arm_2d_vres_t——專門用于描述這類無(wú)法直接訪問的圖片資源。其數(shù)據(jù)結(jié)構(gòu)如下：

/*! * \brief a type for virtual resource * * \note the flag tTile.tInfo.bVirtualResource must be true (1) */typedef struct arm_2d_vres_t arm_2d_vres_t;struct arm_2d_vres_t {  /*! base class: tTile */ implement_ex( arm_2d_tile_t, tTile);  /*!  a reference of an user object  */ uintptr_t pTarget;  /*! *  \brief a method to load a specific part of an image *  \param[in] pTarget a reference of an user object  *  \param[in] ptVRES a reference of this virtual resource *  \param[in] ptRegion the target region of the image *  \return intptr_t the address of a resource buffer which holds the content */ intptr_t (*Load)   ( uintptr_t pTarget,  arm_2d_vres_t *ptVRES,  arm_2d_region_t *ptRegion);  /*! *  \brief a method to despose the buffer *  \param[in] pTarget a reference of an user object  *  \param[in] ptVRES a reference of this virtual resource *  \param[in] pBuffer the target buffer */ void (*Depose) ( uintptr_t pTarget,  arm_2d_vres_t *ptVRES,  intptr_t pBuffer );};

【如何使用虛擬資源？】

通過Configuraion Wizard打開圖形配置界面：

假設(shè)你已經(jīng)配置好了其它部分，勾選這里的“Enable the virtual resoure helper service” 選項(xiàng)后保存——至此，我們就為 Display Adapter 0 開啟了其專屬的虛擬資源輔助服務(wù)（Helper Service）。需要強(qiáng)調(diào)的是，每個(gè)Display Adapter 都有自己獨(dú)立的虛擬資源輔助服務(wù)，需要獨(dú)立的打開。

Error: L6218E: Undefined symbol __disp_adapter0_vres_get_asset_address (referred from arm_2d_disp_adapter_0.o).Error: L6218E: Undefined symbol __disp_adapter0_vres_read_memory (referred from arm_2d_disp_adapter_0.o).

不要慌，這是我們有意為之——它提醒我們作為用戶需要提供（實(shí)現(xiàn)）兩個(gè)最基本額接口函數(shù)：

• __disp_adapter0_vres_read_memory()

void __disp_adapter0_vres_read_memory( intptr_t pObj,  void *pBuffer, uintptr_t pAddress, size_t nSizeInByte);

這里：

• pObj 我們可以暫時(shí)忽略

• pBuffer 指向一塊緩沖區(qū)，用于保存我們從外部存儲(chǔ)器中讀取到的內(nèi)容；

• pAddress 保存的是目標(biāo)內(nèi)容在外部存儲(chǔ)器中的地址；

• nSizeInByte 保存的是要讀取的字節(jié)數(shù)

  
  

一般來說，如果我們已經(jīng)事先調(diào)試好了一個(gè)SPI Flash讀取函數(shù)，就可以輕松的實(shí)現(xiàn)這一函數(shù)，比如：

extern void spi_flash_read(void *pBuffer,  uint32_t nAddressInFlash, size_t nSize); void __disp_adapter0_vres_read_memory(intptr_t pObj,  void *pBuffer, uintptr_t pAddress, size_t nSizeInByte){ ARM_2D_UNUSED(pObj); /* it is just a demo, in real application, you can place a function to  * read SPI Flash  */ spi_flash_read(pBuffer, (void * const)pAddress, nSizeInByte);}

• __disp_adapter0_vres_get_asset_address()

uintptr_t __disp_adapter0_vres_get_asset_address( uintptr_t pObj, arm_2d_vres_t *ptVRES);

這里：

• pObj 我們可以暫時(shí)忽略

• ptVRES 指向的是我們的目標(biāo)虛擬資源

在最簡(jiǎn)單的情況下，假設(shè)你的系統(tǒng)只有一背景圖保存在外部SPI Flash中，且地址為 0x00000000，那么這個(gè)函數(shù)就極其簡(jiǎn)單了：

uintptr_t __disp_adapter0_vres_get_asset_address(uintptr_t pObj, arm_2d_vres_t *ptVRES){ ARM_2D_UNUSED(ptVRES); ARM_2D_UNUSED(pObj);  return 0x00000000;}

也許你要問，如果我要處理多個(gè)圖片該怎么辦呢？別著急，后面會(huì)有專門的章節(jié)詳細(xì)介紹。現(xiàn)階段我們先專注于完成一個(gè)最簡(jiǎn)單的例子。

完成了上述準(zhǔn)備工作，再次編譯就應(yīng)該毫無(wú)問題了。

創(chuàng)建自己的虛擬資源：

在要?jiǎng)?chuàng)建虛擬資源的源代碼中加入對(duì) Display Adapter 0 的頭文件引用：

#include "arm_2d_disp_adapter_0.h"

定義一個(gè) arm_2d_vres_t 類型的靜態(tài)變量（或者全局變量），并使用專門的宏 disp_adapter0_impl_vres 來描述資源的顏色和尺寸信息，比如：

static arm_2d_vres_t s_tMyVirtualRes =  disp_adapter0_impl_vres(  ARM_2D_COLOUR_RGB565, // 圖片的顏色格式 320, // 圖片的寬度 256, // 圖片的高度 );

其中，宏disp_adapter0_impl_vres() 是 Display Adapter 0 專用的，以此類推，如果你的虛擬資源要在 Display Adapter 1上使用，則對(duì)應(yīng)的描述宏為 disp_adapter1_impl_vres()。不管如何，它們的原型是一樣的：

disp_adapter0_impl_vres(__COLOUR_FORMAT, __WIDTH, __HEIGHT,...)

這里:

• __COLOUR_FORMAT 是目標(biāo)素材的顏色格式，具體可用的顏色在 arm_2d_type.h 中定義，都以 ARM_2D_COLOUR_ 作為前綴。

• __WIDTH 是目標(biāo)素材的像素寬度

• __HEIGHT是目標(biāo)素材的像素高度

• ... 是一系列可選的參數(shù)，主要用于初始化 arm_2d_vres_t 中的一些特殊成員（比如 pTarget），這個(gè)在隨后的章節(jié)中會(huì)用到。

在上述例子中，我們創(chuàng)建了一個(gè)虛擬資源 s_tMyVirtualRes，由于它是 arm_2d_tile_t 的派生類，因此可以像普通的貼圖那樣在arm-2d的API中作為素材（source tile）和蒙版（mask）來直接使用，比如：

/* 把 虛擬素材 顯示在屏幕上 */arm_2d_tile_copy(   &s_tMyVirtualRes.tTile, /* 素材 */ ptTile, /* 目標(biāo)緩沖區(qū) */ NULL,  ARM_2D_CP_MODE_COPY); 

效果如下：

正如我們前面說過的，虛擬素材（virtual resource）也是貼圖（Tile）的一種，因此，也可以在它的基礎(chǔ)上創(chuàng)建子貼圖（Child Tile），比如：

staticconst arm_2d_tile_t c_tChildImage = { .tRegion = { .tLocation = { .iX = 160, .iY = 128, }, .tSize = { .iWidth = 160, .iHeight = 128, }, }, .tInfo = { .bIsRoot = false, .bDerivedResource = true, }, .ptParent = (arm_2d_tile_t *)&s_tMyVirtualRes.tTile,};

這里：

• bIsRoot為false，清晰的標(biāo)明了 c_tChildImage 的子貼圖身份；

• 創(chuàng)建子貼圖作為素材時(shí)，bDerivedResource一定要設(shè)置為 true，切記切記！

• 這個(gè)例子中，觀察 tLocation和tSize容易發(fā)現(xiàn)：我們實(shí)際上是取了原圖右下角的1/4作為新的素材

修改代碼，將新的素材也拷貝到屏幕上：

/* 把 虛擬素材 顯示在屏幕上 */arm_2d_tile_copy(   &s_tMyVirtualRes.tTile, /* 素材 */ ptTile, /* 目標(biāo)緩沖區(qū) */ NULL,  ARM_2D_CP_MODE_COPY);/* 把 子貼圖 顯示在屏幕上 */arm_2d_tile_copy(   &c_tChildImage, /* 素材 */ ptTile, /* 目標(biāo)緩沖區(qū) */ NULL,  ARM_2D_CP_MODE_COPY);

由于我們?cè)诳截愖淤N圖時(shí)沒有指定要復(fù)制的位置（給了NULL），因此被默認(rèn)放置到了屏幕的左上角，形成了如下的效果：

【我們有多個(gè)圖片該怎么辦？】

uintptr_t __disp_adapter0_vres_get_asset_address( uintptr_t pObj, arm_2d_vres_t *ptVRES)

換句話說，支持多圖片的關(guān)鍵就在于如何使用傳遞進(jìn)來的參數(shù)返回對(duì)應(yīng)圖片在外部存儲(chǔ)器中的地址。

 typedef struct arm_2d_vres_t arm_2d_vres_t;struct arm_2d_vres_t { ... /*!  a reference of an user object  */ uintptr_t pTarget; ...};

無(wú)論我們給它賦任何內(nèi)容，它的值都會(huì)作為第一個(gè)實(shí)參傳遞給接口函數(shù)：

__disp_adapter0_vres_read_memory(intptr_t pObj, …… )

和

__disp_adapter0_vres_get_asset_address(uintptr_t pObj, ……)

也就是這里的 pObj。

至此，對(duì)多圖片的支持實(shí)際上就形成了兩種方式：

• 面向?qū)ο蟮姆绞剑∣OPC）

• 所見即所得的方式

剩下的篇幅，我們將著重介紹“所見即所得”的方法：

static arm_2d_vres_t s_tVRes0 =  disp_adapter0_impl_vres(  ARM_2D_COLOUR_RGB565, 32, 32, .pTarget = <這個(gè)資源在外部存儲(chǔ)器中的地址> ); static arm_2d_vres_t s_tVRes1 =  disp_adapter0_impl_vres(  ARM_2D_COLOUR_RGB565, 32, 32, .pTarget = <這個(gè)資源在外部存儲(chǔ)器中的地址> );...

步驟二：在函數(shù) __disp_adapter0_vres_get_asset_address 里直接將 pObj 的值（也就是 ptVRES->pTarget）的值返回：

uintptr_t __disp_adapter0_vres_get_asset_address(uintptr_t pObj, arm_2d_vres_t *ptVRES){ ARM_2D_UNUSED(ptVRES); return pObj;}