Platform SDK: DirectX

Blitting with Color Keys

[C++]

If you want to use color keys for surfaces when calling the IDirectDrawSurface7::BltFast method, you must set one or both of the DDBLTFAST_SRCCOLORKEY or DDBLTFAST_DESTCOLORKEY flags in the dwTrans parameter.

In order to use colors keys when calling IDirectDrawSurface7:Blt, you pass one or both of the DDBLT_KEYSRC or DDBLT_KEYDEST flags in the dwFlags parameter. Alternatively, you can put the appropriate color values in the ddckDestColorkey and ddckSrcColorkey members of the DDBLTFX structure that is passed to the method through the lpDDBltFx parameter. In this case you must also set the DBLT_KEYSRCOVERRIDE or DDBLT_KEYDESTOVERRIDE flag, or both, in the dwFlags parameter, so that the selected keys are taken from the DDBLTFX structure rather than from the surface properties.

[Visual Basic]

If you want to use color keys for surfaces when calling the DirectDrawSurface7.BltFast method, you must set one or both of the DDBLTFAST_SRCCOLORKEY or DDBLTFAST_DESTCOLORKEY flags in the trans parameter.

In order to use colors keys when calling DirectDrawSurface7:Blt, you pass one or both of the DDBLT_KEYSRC or DDBLT_KEYDEST flags in the flags parameter. Alternatively, you can use the DirectDrawSurface7:BltFx method and put the appropriate color values in the ddckDestColorkey_high, ddckDestColorkey_low, ddckSrcColorkey_high and ddckSrcColorkey_low members of the DDBLTFX structure that is passed to the method through the BltFx parameter. In this case you must also set the DBLT_KEYSRCOVERRIDE or DDBLT_KEYDESTOVERRIDE flag, or both, in the flags parameter, so that the selected keys are taken from the DDBLTFX type rather than from the surface properties.