共用方式為

XMStoreColor 函式 (directxpackedvector.h)

  • 發行項

將 XMVECTOR 儲存在 XMCOLOR中。

語法

void XM_CALLCONV XMStoreColor(
  [out] XMCOLOR   *pDestination,
  [in]  FXMVECTOR V
) noexcept;

參數

[out] pDestination

要儲存資料的位址。

[in] V

包含要儲存之資料的向量。 X 包含紅色色板，Y 包含綠色、Z、藍色和 W Alpha 色板。

傳回值

無。

備註

函式會採用向量，將它固定在 0.0f 範圍到 1.0f、將元件轉換成不帶正負號的標準化整數格式、將元件封裝成 32 位整數，並將結果寫入指定的位址。 最重要的元件會寫入整數的第二個最顯著八位，依此類傳。

下列虛擬程式碼示範函式的作業。

XMVector N;

N = saturate(V);
N = scale(N, 255.0f);
N = round(N);

pDestination->c = ((uint32_t)N.w << 24) |
                  ((uint32_t)N.x << 16) |
                  ((uint32_t)N.y << 8) |
                  ((uint32_t)N.z);

針對 Direct3D 10.x 和 Direct3D 11，這會比對採用 float ColorRGBA[4] 參數之函式的元件順序。


 XMVECTOR Yellow = XMVectorSet( 1.0f, 1.0f, 0.0f, 1.0f );

 XMFLOAT4 clrf;
 XMStoreFloat4( &clrf, Yellow );
 pDeviceContext->ClearRenderTargetView( pRTV, (const float*)clrf );

平臺需求

Microsoft Visual Studio 2010 或 Microsoft Visual Studio 2012 搭配 Windows SDK for Windows 8。 支援 Win32 傳統型應用程式、Windows 市集應用程式和 Windows Phone 8 個應用程式。

需求

   
目標平台 Windows
標頭 directxpackedvector.h (包含 DirectXPackedVector.h)

另請參閱

DirectXMath 程式庫向量存放區函式