共用方式為

CMTranslateColors 函式 (icm.h)

  • 發行項

使用色彩轉換，將色彩陣列從來源 色彩空間 轉譯為目的地色彩空間。

語法

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

參數

hcmTransform

指定要使用的色彩轉換。

lpaInputColors

指向要轉譯的 COLOR 結構陣列。

nColors

指定陣列中元素的數目。

ctInput

指定輸入的色彩類型。

lpaOutputColors

指向要放置翻譯 COLOR 結構的數位的緩衝區。

ctOutput

指定輸出色彩類型。

傳回值

如果此函式成功，則傳回值為TRUE。

如果此函式失敗，則傳回值為 FALSE。 CMM 應該呼叫 SetLastError ，將最後一個錯誤設定為 Winerror.h 中定義的有效錯誤值。

備註

匯出此函式需要每個 CMM。

如果輸入和輸出色彩類型與色彩轉換不相容，此函式應該會失敗。

請注意，此函式必須支援就地翻譯。 也就是說，每當輸出的記憶體使用量小於或等於輸入的記憶體使用量時，即使來源和目的地緩衝區相同，此函式也必須能夠轉譯位圖色彩。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h

另請參閱