Supported Browsers Home   
SrcTransBltBuf Previous   
UnlockBuffer Next   
GA_bufferFuncs Up   

StretchBltBuf

Copies pixels from one buffer into the currently active buffer while stretching or shrinking to fit the destination

Declaration

void GA_bufferFuncs::StretchBltBuf(
    GA_buf *buf,
    N_int32 srcLeft,
    N_int32 srcTop,
    N_int32 srcWidth,
    N_int32 srcHeight,
    N_int32 dstLeft,
    N_int32 dstTop,
    N_int32 dstWidth,
    N_int32 dstHeight,
    N_int32 doClip,
    N_int32 clipLeft,
    N_int32 clipTop,
    N_int32 clipRight,
    N_int32 clipBottom,
    N_int32 mix)

Prototype In

snap/graphics.h

Parameters

buf

SNAP buffer to blit to the active surface

srcLeft

Left coordinate of the source rectangle to copy

srcTop

Top coordinate of the source rectangle to copy

srcWidth

Width of the source rectangle in pixels

srcHeight

Height of the source rectangle in scanlines

dstLeft

Left coordinate of destination

dstTop

Top coordinate of destination

dstWidth

Width of the destination rectangle in pixels

dstHeight

Height of the destination rectangle in scanlines

doClip

True if the blit should be clipped

clipLeft

Left coordinate of clip rectangle

clipTop

Top coordinate of clip rectangle

clipRight

Right coordinate of clip rectangle

clipBottom

Bottom coordinate of clip rectangle

mix

Mix code for the copy (GA_mixCodesType)

 

Description

This function copies a rectangular region of source buffer to the currently active buffer with either stretching or shrinking. This routine will copy the rectangular region of from (srcLeft, srcTop, srcLeft+srcWidth-1, srcTop+srcHeight-1) in the source buffer to (dstLeft, dstTop, dstLeft+dstWidth-1, dstTop+dstHeight-1) in the active buffer. Note that the source and destination rectangle dimensions may be different in, which is the case for doing a copy with bitmap stretching or shrinking.

If the doClip parameter is true, then the output of the stretch function will be clipped against the passed in destination clip rectangle.

See Also

BitBltBuf, BitBltPattBuf, BitBltColorPattBuf, SrcTransBltBuf, DstTransBltBuf, BitBltPlaneMaskedBuf, BitBltFxBuf, DrawRectBuf

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com