D3DXLoadSurfaceFromResource 関数
リソースからサーフェスを読み込みます。
構文
HRESULT D3DXLoadSurfaceFromResource(
_In_ LPDIRECT3DSURFACE9 pDestSurface,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const RECT *pDestRect,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_In_ const RECT *pSrcRect,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo
);
パラメーター
-
pDestSurface [in]
-
IDirect3DSurface9 インターフェイスへのポインター。 イメージを受け取る変換先サーフェスを指定します。
-
pDestPalette [in]
-
型: const PALETTEENTRY*
PALETTEENTRY 構造体へのポインター。256 色または NULL のコピー先パレット。
-
pDestRect [in]
-
型: const RECT*
RECT 構造体へのポインター。 対象の四角形が指定されます。 サーフェス全体を指定するには、このパラメーターを NULL に設定します。
-
hSrcModule [in]
-
種類: HMODULE
リソースが配置されているモジュールを処理するか、現在のプロセスの作成に使用されるオペレーティング システムのイメージに関連付けられているモジュールの 場合は NULL を 処理します。
-
pSrcResource [in]
-
型: LPCTSTR
リソース名を指定する文字列へのポインター。 コンパイラ設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。 それ以外の場合、文字列データ型は LPCSTR に解決されます。 「解説」を参照してください。
-
pSrcRect [in]
-
型: const RECT*
RECT 構造体へのポインター。 ソースの四角形が指定されます。 イメージ全体を指定するには、このパラメーターを NULL に設定します。
-
フィルター [入力]
-
種類: DWORD
1 つ以上の組み合わせ D3DX_FILTER 画像のフィルター処理方法を制御します。 このパラメーターにD3DX_DEFAULTを指定することは、D3DX_FILTER_TRIANGLE を指定することと同じです。 |D3DX_FILTER_DITHER。
-
ColorKey [in]
-
種類: D3DCOLOR
透明な黒に置き換える D3DCOLOR 値、またはカラーキーを無効にする場合は 0。 これは、ソース イメージ形式に関係なく、常に 32 ビットの ARGB 色です。 アルファは重要であり、通常は不透明な色キーの場合は FF に設定する必要があります。したがって、不透明な黒の場合、値は0xFF000000と等しくなります。
-
pSrcInfo [in, out]
-
種類: D3DXIMAGE_INFO*
ソース イメージ ファイル内のデータの説明が入力される D3DXIMAGE_INFO 構造体へのポインター( NULL)。
戻り値
種類: HRESULT
関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値には次のいずれかの値を指定できます:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA。
解説
コンパイラ設定によって、関数のバージョンも決定されます。 Unicode が定義されている場合、関数呼び出しは D3DXLoadSurfaceFromResourceW に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXLoadSurfaceFromResourceA に解決されます。
読み込まれるリソースの種類は、RT_BITMAPまたはRT_RCDATAである必要があります。 リソースの種類RT_RCDATAは、ビットマップ以外の形式 (.tga、.jpg、.dds など) を読み込む場合に使用されます。
この関数は、圧縮テクスチャ形式との間の変換を処理します。
レベル 0 以外のサーフェスに書き込む場合、ダーティ四角形は更新されません。 D3DXLoadSurfaceFromFile が呼び出され、サーフェスがまだダーティされていない場合 (通常の使用シナリオではそうはいかない)、アプリケーションはサーフェス上で AddDirtyRect を明示的に呼び出す必要があります。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|
関連項目