L_VecConvertPointToUnit

Summary

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

Syntax

L_LVKRN_API L_INT L_VecConvertPointToUnit(pVector, pptDst, pptSrc, pUnitToUse)

Parameters

const pVECTORHANDLE pVector

Pointer to a vector handle.

pVECTORPOINT pptDst

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

const pVECTORPOINT pptSrc

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

const pVECTORUNIT pUnitToUse

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

Returns

Comments

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

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

Required DLLs and Libraries

• LTVKRN
• 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; 
}