Platform SDK: DirectX

Flipping Overlay Surfaces

[C++]

Like other types of surfaces, you can create overlay flipping chains. After creating a flipping chain of overlays, call the IDirectDrawSurface7::Flip method to flip between them. For more information, see Flipping Surfaces.

Software decoders displaying video with overlay surfaces can use the DDFLIP_ODD and DDFLIP_EVEN flags when calling the Flip method to use features that reduce motion artifacts. If the driver supports odd-even flipping, the DDCAPS2_CANFLIPODDEVEN flag will be set in the DDCAPS structure after retrieving driver capabilities. If DDCAPS2_CANFLIPODDEVEN is set, you can include the DDOVER_BOB flag when calling the IDirectDrawSurface7::UpdateOverlay method to inform the driver that you want it to use the "Bob" algorithm to minimize motion artifacts. Later, when you call Flip with the DDFLIP_ODD or DDFLIP_EVEN flag, the driver will automatically adjust the overlay source rectangle to compensate for jittering artifacts.

[Visual Basic]

Like other types of surfaces, you can create overlay flipping chains. After creating a flipping chain of overlays, call the DirectDrawSurface7.Flip method to flip between them. For more information, see Flipping Surfaces.

Software decoders displaying video with overlay surfaces can use the DDFLIP_ODD and DDFLIP_EVEN flags when calling the Flip method to use features that reduce motion artifacts. If the driver supports odd-even flipping, the DDCAPS2_CANFLIPODDEVEN flag will be set in the DDCAPS type after retrieving driver capabilities. If DDCAPS2_CANFLIPODDEVEN is set, you can include the DDOVER_BOB flag when calling the DirectDrawSurface7.UpdateOverlay method to inform the driver that you want it to use the "Bob" algorithm to minimize motion artifacts. Later, when you call Flip with the DDFLIP_ODD or DDFLIP_EVEN flag, the driver will automatically adjust the overlay source rectangle to compensate for jittering artifacts.

If the driver doesn't set the DDCAPS2_CANFLIPODDEVEN flag when you retrieve hardware capabilities, UpdateOverlay will fail if you specify the DDOVER_BOB flag.

For more information about the Bob algorithm, see Solutions to Common Video Artifacts.