L_VecConvertPointToUnit

#include "l_bitmap.h"

L_LVKRN_API L_INT L_VecConvertPointToUnit(pVector, ptDst, ptSrc, pUnitToUse)

const pVECTORHANDLE pVector;

/* pointer to a vector handle */

pVECTORPOINT pptDst;

/* pointer to a VECTORPOINT structure */

const pVECTORPOINT pptSrc;

/* pointer to a VECTORPOINT structure */

const pVECTORUNIT pUnitToUse;

/* pointer to a VECTORUNIT structure */

Converts the values from point units to other unit types. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.

Parameter

Description

pVector

Pointer to a vector handle.

ptDst

Pointer to VECTORPOINT structure to be updated with the converted values.

ptSrc

Pointer to VECTORPOINT structure that contains the source values to be converted.

pUnitToUse

Pointer to the VECTORUNIT structure that contains unit types to which the values are converted.

Returns

SUCCESS

The function was successful.

1

An error occurred. Refer to Return Codes.

Comments

To convert values from point units to other unit types, call the L_VecConvertPointFromUnit function.

To change or retrive the currently used unit type in the vector toolkit, call the L_VecSetUnit or L_VecGetUnit function.

Required DLLs and Libraries

LVKRN

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_VecConvertPointFromUnit, L_VecGetUnit, L_VecSetUnit

Topics:

Vector Units

 

Vector Units Conversion

Example

//This example converts values from points unit to Inches unit

L_INT VecConvertPointToUnitExample(pVECTORHANDLE pVector, pVECTORPOINT pPoint)
{
   VECTORPOINT ConvetedPoint; 
   VECTORUNIT VecUnit; 
   L_INT nRet;
   VecUnit.nSize = sizeof(VecUnit); 
   VecUnit.Unit = VECTOR_UNIT_INCHES;  
   
   nRet =L_VecConvertPointToUnit (pVector, pPoint, &ConvetedPoint, &VecUnit);
   if(nRet !=SUCCESS)
      return nRet;
   nRet =L_VecSetUnit(pVector, &VecUnit);
   if(nRet !=SUCCESS)
      return nRet;
   return SUCCESS;
}