L_VecGetScale

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecGetScale(pVector, pScale)

const pVECTORHANDLE pVector;

pointer to a vector handle

pVECTORPOINT pScale;

pointer to a vector point

Gets the current scale values.

Parameter

Description

pVector

Pointer to a vector handle.

pScale

Pointer to a VECTORPOINT structure to be updated with the current scale values.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The scale values retrieved are those set using L_VecSetScale, with pObject set to NULL and dwFlags set to 0L.

A scale value of 1.0 represents a scale factor of 100%; a scale value of 0.5 represents a scale factor of 50%; a scale value of 2.0 represents a scale factor of 200%, etc.

The default scale values are 1.0, 1.0, and 1.0 for the X, Y, and Z axes.

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_VecSetScale, L_VecSetRotation, L_VecGetRotation, L_VecSetTranslation, L_VecGetTranslation, L_VecSetBindVerticesMode, L_VecGetBindVerticesMode

Example

This example will show the current scale values, in percentage, in a message box.,

L_INT VecGetScaleExample( pVECTORHANDLE pVector ) 
{ 
   L_INT nRet; 
   VECTORPOINT scale;            /* Scale values */ 
   L_TCHAR     szBuffer[ 80 ];   /* Buffer */ 
   /* Get current scale values */ 
   nRet = L_VecGetScale( pVector, &scale ); 
   if(nRet != SUCCESS) 
      return nRet; 
   /* Format in a buffer */ 
   wsprintf( szBuffer, TEXT("%d, %d%%"), 
   (L_INT) ( scale.x * 100.0 ), 
   (L_INT) ( scale.y * 100.0 ), 
   (L_INT) ( scale.z * 100.0 ) ); 
   /* Show a message box */ 
   MessageBox( NULL, szBuffer, TEXT("Scale factors"), 0 ); 
   return SUCCESS; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Vector C API Help