FillAndMove method

Fills the output surface with the specified sample value, starting at the current position and advancing the current position.

Syntax

void retVal = object.FillAndMove(pScratchBuffer, SampVal, cSamples, bDoOver);

Parameters

  • pScratchBuffer [in]
    Type: DXBASESAMPLE

    Pointer to a buffer that can be used by the method. The initial contents of the buffer are ignored, and the contents are undefined when the call returns the buffer. The buffer must be at least [ cSamples*sizeof(DXBASESAMPLE) ] bytes in size. If the surface pixel format is either ARGB32 or PMARGB32, this buffer is not required and pScratchBuffer can be NULL.

  • SampVal [in]
    Type: DXPMSAMPLE

    Alpha-premultiplied color to use for the fill.

  • cSamples [in]
    Type: unsigned long

    Number of samples to fill.

  • bDoOver [in]
    Type: BOOL

    Value that indicates whether to alpha-blend the samples with the existing data or to replace the existing data. If TRUE, the samples are alpha-blended over the current data. If FALSE, the samples replace the current data.

Remarks

This method moves the current position of the pointer object forward along the x-axis by cSamples.

See also

IDXARGBReadWritePtr::FillRect