動態點陣圖

本節介紹如何使用動態點陣圖。注意，標準點陣圖會被編譯到應用中，因此必須在編譯時提供。點陣圖從PNG等格式的檔案轉換而來，與大小和格式資訊一起以內部格式保存。

此外，還可以在執行時間在RAM中創建點陣圖。這被稱為動態點陣圖。動態點陣圖的使用與編譯到應用中的靜態點陣圖相同。這意味著您可以通過圖像和按鈕等小部件使用動態點陣圖。

動態點陣圖配置

在創建動態點陣圖時，從點陣圖快取分配像素存儲空間。因此，您必須先配置點陣圖快取，然後才能創建動態點陣圖。這是一個不能在TouchGFX Designer或Generator中執行的手動過程。

參見關於點陣圖快取的文章獲取配置說明。

必須定義應用中使用的動態點陣圖的最大數量。該最大值與點陣圖快取位址和大小一起傳遞到TouchGFX。這裡我們配置的是具有最多4張動態點陣圖的點陣圖快取。您可以在應用中的任何檔中執行。如需只執行一次，檔FrontendApplication.cpp是個不錯的選擇：

FrontendApplication.cpp (extract)

#include <gui/common/FrontendApplication.hpp>
#include <touchgfx/Bitmap.hpp>

FrontendApplication::FrontendApplication(Model& m, FrontendHeap& heap)
    : FrontendApplicationBase(m, heap)
{
    // Place cache start address in SDRAM at address 0xC0008000;
    uint16_t* const cacheStartAddr = (uint16_t*)0xC0008000;
    const uint32_t cacheSize = 0x300000; //3 MB, as example
    Bitmap::setCache(cacheStartAddr, cacheSize, 4);
}

如果您使用Windows模擬器，則還必須在此創建點陣圖快取。在Windows上，可以容易地宣告大陣列或使用malloc：

FrontendApplication.cpp (extract)

#include <gui/common/FrontendApplication.hpp>
#include <touchgfx/Bitmap.hpp>

FrontendApplication::FrontendApplication(Model& m, FrontendHeap& heap)
    : FrontendApplicationBase(m, heap)
{
#ifdef SIMULATOR
    const uint32_t cacheSize = 0x300000; //3 MB, as example
    uint16_t* const cacheStartAddr = (uint16_t*)malloc(cacheSize);
    Bitmap::setCache(cacheStartAddr, cacheSize, 4);
#else
    // Place cache start address in SDRAM at address 0xC0008000;
    uint16_t* const cacheStartAddr = (uint16_t*)0xC0008000;
    const uint32_t cacheSize = 0x300000; //3 MB, as example
    Bitmap::setCache(cacheStartAddr, cacheSize, 4);
#endif
}

使用動態點陣圖範例

為了使用動態點陣圖，我們需要一個小部件來顯示它。為此，在視圖（在程式碼中或Designer中）中插入一個圖像小部件：

#include <touchgfx/widgets/Image.hpp>
using namespace touchgfx;
class TemplateView : public View
{
private:
    Image image;
}

此小部件和動態點陣圖的使用過程分為三步：

在點陣圖快取中創建動態點陣圖
清空動態點陣圖使用的存儲空間
將點陣圖分配給小部件

在setupScreen中創建動態點陣圖。這裡我們使用16bpp格式RGB565。如果影像緩衝為24位，則使用RGB888。如需創建透明點陣圖，使用格式ARGB8888。

通過dynamicBitmapGetAddress函數返回動態點陣圖中像素的位址：

#include <touchgfx/Bitmap.hpp>
void TemplateView::setupScreen()
{
    BitmapId bmpId;

    //Create (16bit) dynamic bitmap of size 100x150
    const int width = 100;
    const int height = 150;
    bmpId = Bitmap::dynamicBitmapCreate(100, 150, Bitmap::RGB565);

    //set all pixels white
    if (bmpId != BITMAP_INVALID)
    {
       memset(Bitmap::dynamicBitmapGetAddress(bmpId), 0xFF, width*height*2);
    }

    //Make Image widget show the dynamic bitmap
    image.setBitmap(Bitmap(bmpId));

    //Position image and add to View
    image.setXY(20, 20);
    add(image);
    ...
}

您從點陣圖快取獲得的像素存儲空間未清空，建議立即將其清空或重寫。

如需從檔案載入圖像，可以用載入器程式碼替代對memset的呼叫。參見文章在執行時間載入圖像