public:
     virtual bool __fastcall Flip( TDx_DrawSurface* pSurfaceTargetOverride, dword pFlags );

• Description
• Parameters
• See Also

If you would like to submit additions or improvements to this page, click: admin@bcb-tools.com.

The TDx_DrawSurface::Flip method will cause the next surface in a flip chain to become the DDSCAPS_FRONTBUFFER surface.

The current DDSCAPS_FRONTBUFFER surface becomes a back buffer and moves to the back of the flip chain.

This method may only be called for surfaces with DDSCAPS_FLIP and DDSCAPS_FRONTBUFFER set.

Flips are automatically synchronized with the vertical blank.

If the method call fails, the OnError event will be triggered with one of the following values:
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOFLIPHW
DDERR_NOTFLIPPABLE
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

SurfaceTargetOverride
The SurfaceTargetOverride parameter references a target surface for the flip.
Set this parameter to NULL to cycle through the surfaces using the normal attachment order.

Flags
The Flags parameter defines flags indicating flip options.
The described effect applies when the flag is set.

DDFLIP_DONOTWAIT
Continue with application execution immediately after the flip is attempted without waiting for a return value indicating a successful flip.

DDFLIP_EVEN
The surface being flipped to contains the even field of a video signal.
Mutually exclusive with DDFLIP_ODD.

DDFLIP_INTERVAL2
A flip is to occur only every second VSYNC.
Requires the DDCAPS2_FLIPINTERVAL capability.

DDFLIP_INTERVAL3
A flip is to occur only every third VSYNC.
Requires the DDCAPS2_FLIPINTERVAL capability.

DDFLIP_INTERVAL4
A flip is to occur only every fourth VSYNC.
Requires the DDCAPS2_FLIPINTERVAL capability.

DDFLIP_NOVSYNC
The flip will occur as close as possible to the next scan line, regardless of VSYNC timing.
Requires the DDCAPS2_FLIPNOVSYNC capability.
Using this flag allows flips to be performed faster than the monitor refresh rate but may cause artifacts.

DDFLIP_ODD
The surface being flipped to contains the odd field of a video signal.
Mutually exclusive with DDFLIP_EVEN.

DDFLIP_WAIT
The flip will wait until it can be set up or an error other than DDERR_WASSTILLDRAWING occurs.
This is the default flip behaviour, use DDFLIP_DONOTWAIT to override.

TDx_DrawSurface
TDx_DrawSurface::OnSurfaceLost()