Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The TDx_DrawSurface::Blt method will perform a bit block transfer.
Z-buffering or alpha blending during blit operations is not yet supported.
This method performs asynchronous blits by default, specify DDBLT_WAIT to request a synchronous blit.
Blits can be performed using source and/or destination color keys and arbitrary shrinking or stretching will be performed if the source and destination rectangles are of differing sizes.
If the method call fails, the OnError event will be triggered with one of the following values:
DDERR_GENERIC
DDERR_INVALIDCLIPLIST
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOALPHAHW
DDERR_NOBLTHW
DDERR_NOCLIPLIST
DDERR_NODDROPSHW
DDERR_NOMIRRORHW
DDERR_NORASTEROPHW
DDERR_NOROTATIONHW
DDERR_NOSTRETCHHW
DDERR_NOZBUFFERHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING
- Parameters
DestRect
The DestRect parameter references a TRect defining the target of the blit on the destination surface.
Set this parameter to NULL to blit to the entire destination surface.
This parameter is defined so that the right and bottom members are exclusive. Thus the right value minus the left value will equal the width, not one less than the width.
SrcSurface
The SrcSurface parameter references the surface that is to be the source for the blit.
SrcRect
The SrcRect parameter references a TRect defining the source rectangle of the blit.
Set this parameter to NULL to blit from the entire source surface.
This parameter is defined so that the right and bottom members are exclusive. Thus the right value minus the left value will equal the width, not one less than the width.
Flags
The Flags parameter defines flags indicating what effect information the blit is to use and from where that information is to be retrieved.
The described effect applies when the flag is set.
-
DDBLT_ASYNC
The blit will be performed asynchronously through the FIFO hardware.
When the FIFO hardware is already full the blit will fail.
DDBLT_COLORFILL
The blit will use the TDDBltFX::FillColor referenced by the BltFX parameter of this method as the color that fills the destination rectangle before the blit occurs.
DDBLT_DDFX
The blit will use the TDDBltFX::FX referenced by the BltFX parameter of this method to specify the blit effects used.
DDBLT_DDROPS
The blit will use the TDDBltFX::DDRops referenced by the BltFX parameter of this method to specify non standard raster operations.
DDBLT_DEPTHFILL
The blit will use the TDDBltFX::FillDepth referenced by the BltFX parameter of this method as the depth value that fills the destination rectangle of the z-buffer surface before the blit occurs.
DDBLT_KEYDEST
The blit will use the destination surface color key for transparency.
DDBLT_KEYDESTOVERRIDE
The blit will use the TDDBltFX::DestColorKey referenced by the BltFX parameter of this method as the destination color key.
DDBLT_KEYSRC
The blit will use the source surface color key for transparency effects.
DDBLT_KEYSRCOVERRIDE
The blit will use the TDDBltFX::SrcColorKey referenced by the BltFX parameter of this method as the source color key.
DDBLT_ROP
The blit will use the TDDBltFX::ROP referenced by the BltFX parameter of this method to define its standard raster operation.
The possible ROP's are detailed in the Win32 API.
DDBLT_ROTATIONANGLE
The blit will use the TDDBltFX::RotationAngle referenced by the BltFX parameteer of this method is to be used as the amount of rotation, in 1/100ths of a degree, applied to the blit.
DDBLT_WAIT
The blit will wait for the blitter to accept the command unless an error other than DDERR_WASSTILLDRAWING occurs.
The BltFx parameter references a TDDBltFX component holding the settings that are to be used when blitting if the corresponding flags are set within the Flags parameter of this method.
- See Also
- Top
TDx_Draw_Library v2.00 Component Reference
|
|
|
[ TDx_DrawSurface::Blt() ] [ next: BltFast() ] [ prev: AddAttachedSurface() ] public:
virtual bool __fastcall Blt( TRect* pDestRect, TDx_DrawSurface* pSrcSurface, TRect* pSrcRect, dword pFlags, TDDBltFX* pBltFx );
TDX_DRAWSURFACE::BLT()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|