LBitmapRgn::SetRgnXForm

#include "ltwrappr.h"

L_INT LBitmapRgn::SetRgnXForm(pXform)

pRGNXFORM pXform;

/* the new region transform */

Sets the region transform to be used by the region functions.

Parameter

Description

pXform

The new region transform to be used by the region functions. Pass NULL to use the default region transformation.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Before calling this function, you must declare an RGNXFORM structure and set its values, which LEADTOOLS uses to translate between device context coordinates and bitmap coordinates. For details about how the structure works refer to the RGNXFORM structure description. For a description of common usage, refer to Translating Coordinates for a Bitmap Region.

The default settings for the region transform are:

the Scalar fields default to 1.

the Offset fields default to 0.

the View Perspective field defaults to the associated class object’s bitmap view perspective.

Required DLLs and Libraries

LTDIS

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

Elements:

LBitmapRgn::GetRgnXForm, Class Members

Topics:

Raster Image Functions: Creating and Using a Region

 

Raster Image Functions: Region Processing

 

Defining and Using a Bitmap Region

Example

For an example, refer to LBitmapRgn::SetRgnPolygon.