a. BREW 支持哪些圖像格式？
適用版本： 1.0, 1.1, 2.0
BREW 支持顏色深度達(dá)到運(yùn)行設(shè)備上提供的值的任何 BMP 文件。 BREW 目前尚不支持 GIF 和 JPEG 圖像。 有些設(shè)備可以支持 GIF 和 JPEG 圖像，請(qǐng)參閱設(shè)備數(shù)據(jù)表來查看 OEM 是否提供了支持以上格式或其它格式圖像的擴(kuò)展。 BREW SDK® 1.1 以上版本都支持 PNG 格式和 BREW Compressed Image (BCI) 格式。 SDK 2.0 以上版本都支持 IDIB。 使用 IDIB 將免除您調(diào)用 CONVERTBMP 的工作，從而提高屏幕更新速度。 BREW SDK® 2.1 以上版本將支持 WBMP 格式。
在 BREW SDK® 1.0 中，模擬器只能模擬 1 位、4 位和 8 位顏色深度的 BMP。 SDK 1.1 增加了對(duì) 2 位顏色深度 BMP 的模擬器支持；2.0 SDK 增加了對(duì) 16 位顏色深度 BMP 圖像的模擬器支持。
b. 如何生成 2 位圖像？
適用版本： 1.0, 1.1, 2.0
2.0 SDK 中包含的 2 Bit Tool可以進(jìn)行 2 位位圖和 4 位位圖之間的轉(zhuǎn)換。 要構(gòu)建采用灰度顯示的手持設(shè)備使用的 2 位位圖，可以使用 MS Paint 從調(diào)色板中選擇白色、黑色、淡灰和深灰條目（通常為第一行和第二行的前兩種顏色）來構(gòu)建位圖。 并將其保存為 16 色圖像，然后使用 2Bit Tool 將其轉(zhuǎn)換為 2 位位圖。
c. 彩色和單色電話上的透明色是什么？
適用版本： 1.0, 1.1, 2.0
BREW 1.x 中紫色為彩色設(shè)備的透明色，白色是單色和 4 級(jí)灰度設(shè)備上的透明色。
BREW 2.0 以上版本中，可以通過 IBITMAP_SetTransparencyColor 更改透明色。 CONVERTBMP 可以將透明色初始化為兼容舊版本 BREW 的透明色（即紫色和白色）。 但通過其它方式獲得的位圖圖像則沒有固定的透明色。
d. 如何使用內(nèi)存中的位圖創(chuàng)建 IIMAGE 對(duì)象？
適用版本： 1.0, 1.1, 2.0
使用 ISHELL 接口 ISHELL_LoadResImage（用于資源）和 ISHELL_LoadImage（用于文件）完成作為資源或從文件中加載位圖。 但是，有時(shí)可能必須從內(nèi)存中初始化 IIMAGE 對(duì)象 - 例如顯示前修改位圖的內(nèi)容時(shí)，或者不先將數(shù)據(jù)緩存到文件而通過套接字連接檢索圖像時(shí)。
在必須用內(nèi)存中的位圖初始化 IIMAGE 對(duì)象的情況下，應(yīng)該使用 IIMAGE 接口 IIMAGE_SetStream。 下面的代碼示例說明了這種技術(shù)。它通過調(diào)用 ISHELL_GetHandler 獲得 BMP 圖像處理程序的 Class ID，然后創(chuàng)建一個(gè) MemAStream 對(duì)象并將其用作內(nèi)存中位圖的流。 注意：本例中的圖像格式是 Windows BMP，“pMe->pBmpData”指向 Windows 文件格式 BMP 的開始 (BITMAPFILEHEADER)。
代碼示例：
AEECLSID cls;
IImage *pIImage = NULL;
IMemAStream *pMemStream = NULL;
// 決定 BMP處理程序函數(shù)的類 ID，然后
// 創(chuàng)建此 BREW 類的實(shí)例
cls = ISHELL_GetHandler(pMe->a.m_pIShell, HTYPE_VIEWER, "image/bmp");
if (cls) {
ISHELL_CreateInstance(pMe->a.m_pIShell, cls, (void **)(&pIImage));
}
if (pMe->pBmpData) {
ISHELL_CreateInstance(pMe->a.m_pIShell, AEECLSID_MEMASTREAM, (void **)(&pMemStream));
if (pMemStream) {
//創(chuàng)建 MEMSTREAM 后將其作為內(nèi)存中的位圖的流。
IMEMASTREAM_Set(pMemStream, pMe->pBmpData, sizeof(pMe->pBmpData), 0, 0);
IIMAGE_SetStream(pIImage, (IAStream*)pMemStream);
// 現(xiàn)在以正常方式使用您的 IIMAGE 方法
IIMAGE_Draw(pIImage, ..., ...);
IDISPLAY_UpdateEx(pMe->a.m_pIDisplay, TRUE);
}
}
e. 如何從文件或資源文件加載圖像？
通過使用 ISHELL 接口 ISHELL_LoadResImage（用于資源）或 ISHELL_LoadImage（用于文件），后跟 IIMAGE_Draw，很容易從文件或資源中加載和繪制圖像。本文演示了使用 ISHELL 和 IIMAGE 接口加載和顯示位圖所需的基本步驟。
從資源中顯示圖像的步驟：
1. 創(chuàng)建位圖。
2. 將其添加到資源編輯器中。
3. 在資源編輯器中編譯 .bar 和 .h 文件。
4. 將 .h 文件添加到您的項(xiàng)目中。
5. 使用 ISHELL_LoadResImage 加載圖像。
6. 如果加載操作返回非空值，這說明加載操作已啟動(dòng)，指向圖像的指針已返
回。這并不表示圖像加載已完成。要了解圖像操作的完成時(shí)間，您需要使
用 IIMAGE_Notify() 回調(diào)。
7. 圖像加載完成時(shí)，就會(huì)觸發(fā)回調(diào)。
8. 在回調(diào)過程中，使用 IIMAGE_Draw() 顯示圖像。
9. 使用 IDISPLAY_Update() 更新屏幕。
10. 釋放 IImage 指針。
從文件中顯示圖像的步驟：
1. 使用 ISHELL_LoadImage 從文件中加載圖像。
2. 如果加載操作返回非空值，這說明加載操作已啟動(dòng)，指向圖像的指針已返
回。這并不表示圖像加載已完成。要了解圖像操作的完成時(shí)間，您需要使
用 IIMAGE_Notify() 回調(diào)。
3. 圖像加載完成時(shí)，就會(huì)觸發(fā)回調(diào)。
4. 在回調(diào)過程中，使用 IIMAGE_Draw() 顯示圖像。
5. 使用 IDISPLAY_Update() 更新屏幕。
6. 釋放 IImage 指針。
代碼示例：
typedef struct mystruct
{
AEEApplet a;
IImage *m_pImage;
......
}MyData;
enum ResType
{
LOAD_RES_FROM_FILE,
LOAD_RES_FROM_RES
};
#define MY_RES_FILE "myres.bar"
#define MY_IMAGE_FILE "myimg.bmp"
// Load and display a bitmap from a resource and file
int MyDisplayResImage(MyData *pMe, ResType rType)
{
AEEDeviceInfo dm;
if (!pMe)
Return EFAILED;
if (rType == LOAD_RES_FROM_RES)
{
// Load image from Resources
pMe->m_pImage = ISHELL_LoadResImage (
pMe->a.m_pIShell,
MY_RES_FILE,
IDB_MY_COLOR_BITMAP);
}
else // LOAD_RES_FROM_FILE
{
pMe->m_pImage = ISHELL_LoadImage(pMe->a.m_pIShell,
MY_IMAGE_FILE);
}
if (pMe->m_pImage) {
IIMAGE_Notify(pMe->m_pImage, DrawRoutineCB,
(void *)pMe);
}
else
{
return EFAILED; // Failed to load image
}
return SUCCESS;
}
// Notify Callback
void DrawRoutineCB(void *pUser, IImage *pImage,
AEEImageInfo *pi, int nErr)
{
MyData *pMe = (MyData *)pUser;
if( !pMe || !(pMe->m_pImage)
return; // image pointer is NULL
if (nErr == AEE_SUCCESS)
{
// Draw image at 0,0 coordinates
IIMAGE_Draw(pMe->m_pImage, 0, 0);
// Update the screen
IDISPLAY_Update(pMe->a.m_pIDisplay);
// Free the IIMAGE object
IIMAGE_Release(pMe->m_pImage );
}
}
注意：回調(diào)（通過 IIMAGE_Notify() 進(jìn)行）之前，不得釋放 IImage 接口。在應(yīng)用程序需要在回調(diào)文件之前釋放接口的情況下，建議改設(shè)會(huì)表明應(yīng)該在回調(diào)（上例中的 DrawRoutineCB）中釋放接口的布爾標(biāo)記。
f. 我用 ISHELL_LoadResImage() 加載圖像并調(diào)用 IIMAGE_Draw() 后為什么看不到屏幕圖像？
加載圖像為異步操作。ISHELL_ LoadResImage() 操作返回時(shí)，圖像未完全加載，可能無法成功繪制。
返回圖像加載的非空值時(shí)，說明加載操作已啟動(dòng)，指向圖像的指針已返回。這并不表示加載操作已完成。要了解加載操作的完成時(shí)間，用戶應(yīng)使用 IIMAGE_Notify()回調(diào)。該回調(diào)會(huì)在圖像成功加載并準(zhǔn)備繪制到屏幕上時(shí)觸發(fā)。此時(shí)，用戶應(yīng)使用 IIMAGE_Draw() 在屏幕上顯示圖像。
從文件或資源正確加載和繪制圖像的示例如下：
從資源中顯示圖像的步驟：
1. 創(chuàng)建位圖。
2. 將其添加到資源編輯器中。
3. 在資源編輯器中編譯 .bar 和 .h 文件。
4. 將 .h 文件添加到您的項(xiàng)目中。
5. 使用 ISHELL_LoadResImage 加載圖像。
6. 如果加載操作返回非空值，這說明加載操作已啟動(dòng)，指向圖像的指針已返
回。這并不表示圖像加載已完成。要了解圖像操作的完成時(shí)間，您需要使
用 IIMAGE_Notify() 回調(diào)。
7. 圖像加載完成時(shí)，就會(huì)觸發(fā)回調(diào)。
8. 在回調(diào)過程中，使用 IIMAGE_ Draw() 顯示圖像。
9. 使用 IDISPLAY_Update() 更新屏幕。
10. 釋放 IImage 指針。
從文件中顯示圖像的步驟：
1. 使用 ISHELL_LoadImage 從文件中加載圖像。
2. 如果加載操作返回非空值，這說明加載操作已啟動(dòng)，指向圖像的指針已返
回。這并不表示圖像加載已完成。要了解圖像操作的完成時(shí)間，您需要使
用 IIMAGE_Notify() 回調(diào)。
3. 圖像加載完成時(shí)，就會(huì)觸發(fā)回調(diào)。
4. 在回調(diào)過程中，使用 IIMAGE_ Draw() 顯示圖像。
5. 使用 IDISPLAY_Update() 更新屏幕。
6. 釋放 IImage 指針。
代碼示例：
typedef struct mystruct
{
AEEApplet a;
IImage *m_pImage;
......
}MyData;
enum ResType
{
LOAD_RES_FROM_FILE,
LOAD_RES_FROM_RES
};
#define MY_RES_FILE "myres.bar"
#define MY_IMAGE_FILE "myimg.bmp"
// Load and display a bitmap from a resource and file
int MyDisplayResImage(MyData *pMe, ResType rType)
{
AEEDeviceInfo dm;
if (!pMe)
Return EFAILED;
if (rType == LOAD_RES_FROM_RES)
{
// Load image from Resources
pMe->m_pImage = ISHELL_LoadResImage (
pMe->a.m_pIShell,
MY_RES_FILE,
IDB_MY_COLOR_BITMAP);
}
else // LOAD_RES_FROM_FILE
{
pMe->m_pImage = ISHELL_LoadImage(pMe->a.m_pIShell,
MY_IMAGE_FILE);
}
if (pMe->m_pImage) {
IIMAGE_Notify(pMe->m_pImage, DrawRoutineCB,
(void *)pMe);
}
else
{
return EFAILED; // Failed to load image
}
return SUCCESS;
}
// Notify Callback
void DrawRoutineCB(void *pUser, IImage *pImage,
AEEImageInfo *pi, int nErr)
{
MyData *pMe = (MyData *)pUser;
if( !pMe || !(pMe->m_pImage)
return; // image pointer is NULL
if (nErr == AEE_SUCCESS)
{
// Draw image at 0,0 coordinates
IIMAGE_Draw(pMe->m_pImage, 0, 0);
// Update the screen
IDISPLAY_Update(pMe->a.m_pIDisplay);
// Free the IIMAGE object
IIMAGE_Release(pMe->m_pImage );
}
}
注意：回調(diào)（通過 IIMAGE_Notify() 進(jìn)行）之前，不得釋放 IImage 接口。在應(yīng)用程序需要在回調(diào)文件之前釋放接口的情況下，建議改設(shè)會(huì)表明應(yīng)該在回調(diào)（上例中的 DrawRoutineCB）中釋放接口的布爾標(biāo)記。
g. BREW 是否支持動(dòng)畫？
適用版本： 1.0, 1.1, 2.0
BREW SDK® 版本 1.0 支持動(dòng)畫 BMP。 這是通過并列放置所有幀并使用帶 IPARM-CXFRAME 標(biāo)記的 IIMAGE_SetParm 指定每幀的寬度實(shí)現(xiàn)的。 請(qǐng)參閱 Examples 目錄中的 IIMAGE 示例。
BREW SDK® 版本 1.1 增加了對(duì) BREW Compressed Image (BCI) 動(dòng)畫的支持。 BCI 文件包含一個(gè)或多個(gè)壓縮的小圖像，每個(gè)圖像都有一個(gè)以毫秒指定的持續(xù)時(shí)間。 持續(xù)時(shí)間表示每一幅圖像被該系列下一幅圖像取代之前可顯示的時(shí)間。 您可以使用 BREW SDK® 版本 1.1 隨附的 BCI 編輯工具來創(chuàng)建 BCI 文件。 有關(guān)詳細(xì)信息，請(qǐng)參閱 SDK 隨附的“使用 BREW Compressed Image 編輯工具”文檔。
BREW 當(dāng)前不支持 PNG 和 MNG 格式的動(dòng)畫。
h. 為什么一段時(shí)間后所有動(dòng)畫都會(huì)變慢？
適用版本： 1.0, 1.1, 2.0
大多數(shù) OEM 都使用了睡眠計(jì)時(shí)器。 它控制設(shè)備在何時(shí)進(jìn)入睡眠狀態(tài)。 如果在 OEM 指定的時(shí)間段內(nèi)無按鍵活動(dòng)，手持設(shè)備將進(jìn)入睡眠狀態(tài)。 設(shè)備處于睡眠狀態(tài)時(shí)幀速率將大大降低。 按下任意鍵將喚醒設(shè)備并恢復(fù)到以前的幀速率。
在 BREW 2.0 中，應(yīng)用程序可選擇是否要進(jìn)入睡眠狀態(tài)。 如果在應(yīng)用程序收到 EVT_APP_NO_SLEEP 事件時(shí)返回 TRUE，應(yīng)用程序?qū)⒉粫?huì)進(jìn)入睡眠狀態(tài)。 例如：
case EVT_APP_NO_SLEEP:
//不要睡眠
return TRUE;
i. 是否可以獲取/操縱設(shè)備的調(diào)色板信息？
適用版本： 1.0, 1.1, 2.0
不可以。調(diào)色板由生產(chǎn)商進(jìn)行硬編碼，隨設(shè)備不同而有異。
j. 是否可以直接修改顯示緩沖區(qū)？
適用版本： 1.0, 1.1, 2.0
BREW 1.x 無法訪問這些緩沖區(qū)，而且顯示數(shù)據(jù)使用生產(chǎn)商的專有格式存儲(chǔ)。
從 BREW 2.0 開始，如果位圖的像素布局兼容 BREW 設(shè)備無關(guān)位圖規(guī)格，則這些位圖會(huì)支持 IDIB 接口。 也可以通過 IDIB 結(jié)構(gòu)的 pBmp 成員訪問像素緩沖區(qū)。 要確定位圖是否支持 IDIB 以及要獲取 IDIB 指針，可以使用 Class ID 為 AEECLSID_DIB 的 IBITMAP_QueryInterface 函數(shù)。
k. 是否可以進(jìn)行后臺(tái)渲染？
適用版本： 1.0, 1.1, 2.0
可以使用 IDISPLAY_Set/GetDestination 或 IGRAPHICS_Set/GetDestination 進(jìn)行后臺(tái)渲染。 BREW 1.2 以上版本將提供這些函數(shù)。
不提供 1.2 BREW SDK®。 要使用 BREW 1.2 功能，可以使用 2.0 SDK 開發(fā)面向 BREW 1.2 的應(yīng)用程序。 您應(yīng)該注意不要使用 1.2 版本中不支持的 2.0 版本的功能。 此功能列表編寫在 FAQ 文檔目標(biāo)設(shè)備安裝了 BREW SDK® 1.2，但我找不到 BREW 1.2 SDK。 我應(yīng)該使用什么 SDK 開發(fā) BREW 應(yīng)用程序？中。
雖然文檔中含有 IGRAPHICS_EnableDoubleBuffer API，但它不受任何 BREW 版本的支持。
l. 如何繪制特定顏色的線段？
適用版本： 1.0, 1.1, 2.0
IDISPLAY_DrawHLine() 和 IDISPLAY_DrawVLine() 始終繪制黑色線段。 因此，將 CLR_USER_LINE 設(shè)置為所需顏色，然后調(diào)用 IDISPLAY_DrawHLine() 或 IDISPLAY_DrawVLine() 會(huì)變無效。
這兩個(gè) IDISPLAY 宏的定義如下。 要繪制除黑色外的顏色的線段，請(qǐng)使用宏定義中所含的代碼并更改為所需填充顏色。
#define IDISPLAY_DrawHLine(p,x,y,len) \
{AEERect rc;SETAEERECT(&rc,(x),(y),(len),1); IDISPLAY_FillRect((p),&rc, RGB_BLACK);}
#define IDISPLAY_DrawVLine(p,x,y,len) \
{AEERect rc;SETAEERECT(&rc,(x),(y),1,(len)); IDISPLAY_FillRect((p),&rc, RGB_BLACK);}
m. 如何確定在電話上顯示應(yīng)用程序名的字符限制？
適用版本： 1.0, 1.1, 2.0
不同的電話具有不同的顯示特性，因此對(duì)此問題沒有唯一答案。 您可以通過比較應(yīng)用程序名的寬度和顯示寬度來確定應(yīng)用程序名是否適合電話顯示。
使用 IDISPLAY_MeasureText() 確定應(yīng)用程序名字符串的像素寬度。 使用 ISHELL_GetDeviceInfo() 確定屏幕的像素寬度。
n. 如何將圖像保存到電話的墻紙目錄？
適用版本： 1.0, 1.1, 2.0
雖然當(dāng)前版本的 SDK 不包含墻紙 API，但有些 OEM 通過共享內(nèi)容目錄來支持將圖像保存到本地 UI 的墻紙目錄中。
您可以使用以下代碼片斷來創(chuàng)建/下載圖像到共享目錄：
// 請(qǐng)注意，為了使這個(gè)代碼起作用，應(yīng)用程序必須
//在 MIF 文件中有"Access to Shared Directory（使用共享目錄）" 和 "File（文件）" 的權(quán)限。
STRCAT( filename, AEE_SHARED_DIR );
STRCAT( filename, "/" );
STRCAT( filename, "test.gif" );
IFILEMGR_OpenFile( m_pIFileMgr, filename, _OFM_CREATE );
AEE_SHARED_DIR 由 OEM 定義并映射到各設(shè)備的特定共享目錄路徑。 如果 OEM 支持將圖像保存至墻紙目錄，則保存在 AEE_SHARED_DIR 中的圖像會(huì)顯示在本地 UI 的墻紙目錄中。 要查看特定手持設(shè)備是否支持通過共享目錄保存墻紙圖像及支持的圖像類型，請(qǐng)參閱手持設(shè)備的設(shè)備數(shù)據(jù)表。
目前還沒有 BREW API 可以用于將特定圖像設(shè)為手持設(shè)備墻紙。 這必須要通過本地 UI 才能完成。
o. 使用 IDISPLAY_BitBlt() 繪制位圖時(shí)為什么會(huì)收到內(nèi)存錯(cuò)誤，如“memheap.c 0696”？
適用版本： 1.0, 1.1, 2.0
請(qǐng)確保釋放 CONVERTBMP 分配的內(nèi)存。 檢查 CONVERTBMP 的最后一個(gè)布爾型參數(shù)。 如果為 True，則重新分配已完成，必須使用 SYSFREE 來釋放內(nèi)存。
例如：
pBmp = CONVERTBMP (pDataBytes, &imageInfo, &bVal);
IDISPLAY_BitBlt (pIDisplay, xDest, yDest, cxDest, cyDest, pBmp,
xSrc, ySrc, dwRopCode);
IDISPLAY_Update (pIDisplay);
if(bVal) //僅在完成重新分配時(shí)釋放
SYSFREE (pBmp);
請(qǐng)參閱 API 參考文檔中的 CONVERTBMP 助手函數(shù)說明。 若需示例代碼，可以參閱 IDisplay 用法示例。
p. 為什么 Emulator 上顯示的顏色比預(yù)期少？
適用版本： 1.0, 1.1, 2.0
如果您在 2.0 模擬器上顯示 16 位圖像時(shí)，圖像的分辨率較低，請(qǐng)使用 Device Configurator 檢查設(shè)備屬性并將顏色深度設(shè)置為 16 位。 如果圖像分辨率仍然很差（相對(duì) 8 位或 16 位而言），請(qǐng)檢查您是否使用 IIMAGE_SetParm() 函數(shù)為要顯示的圖像設(shè)置了不正確的參數(shù)。
q. 為什么有些 PNG 圖像不能正確顯示？
適用版本： 1.0, 1.1, 2.0
在 BREW 中使用 PNG 圖像需要注意兩個(gè)問題。
1) 版本 1.0、1.1 和 2.0 不支持 Alpha 通道，但 3.0 SDK 版本應(yīng)該會(huì)支持。
2) BREW 只會(huì)選擇文件中的第一種透明色對(duì) PNG 進(jìn)行透明處理。 所有其它顏色都會(huì)顯示。 請(qǐng)檢查文件以確保您創(chuàng)建文件時(shí)只使用了一種透明顏色。
r. 為什么創(chuàng)建 PNG 圖像使用的內(nèi)存大小遠(yuǎn)遠(yuǎn)大于圖像的實(shí)際大小？
BREW 應(yīng)用程序使用 ISHELL_LoadResData 加載 PNG 圖像時(shí)，需要大量的額外空間來解碼圖像。 例如，要加載 217 字節(jié)的 PNG 圖像需要 45,177 字節(jié)空間