L_PntOffsetClipRgn

#include "LtPnt.h"

L_LTPNT_API L_INT L_PntOffsetClipRgn(pPaint, nDX, nDY)

pPAINTHANDLE pPaint;

/* pointer to a paint handle */

L_INT nDX;

/* x-offset */

L_INT nDY;

/* y-offset */

Offsets the paint-clipping region of the device context (DC) and the bitmap.

Parameter

Description

pPaint

Pointer to a paint handle.

nDX

The offset in the horizontal direction.

nDY

The offset in the vertical direction.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The toolkit will perform the necessary transformations to the offset values, using the current painting transformation values set by calling L_PntSetTransformation. Therefore, the user should provide the offset values without any transformations.

Required DLLs and Libraries

LTPNT

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_PntSetClipRgn, L_PntGetClipRgn, L_PntSetTransformation, L_PntGetTransformation

Topics:

DigitalPaint Functions: Region Processing

 

Setting a DigitalPaint Clipping Region

Example

L_INT PntOffsetClipRgnExample(pPAINTHANDLE pPaint)
{
   L_INT nRet;
   HRGN hRgn ;

   /* create some region */
   hRgn = CreateRectRgn ( 0, 0, 100, 100 ) ;

   /* set the painting tools new DC clip region */
   nRet = L_PntSetClipRgn ( pPaint, hRgn) ;
   if(nRet != SUCCESS)
      return nRet;

   /* offset the current painting tools clipping region */
   /*  using the current transformatoin settings */
   nRet = L_PntOffsetClipRgn ( pPaint, 10, 10) ;
   if(nRet != SUCCESS)
      return nRet;

   /* delete the regions */
   DeleteObject ( ( HRGN ) hRgn ) ;
   return SUCCESS;
}