L_VecGetScale

#include "lvkrn.h"

L_INT EXT_FUNCTION 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 */

void ShowScaleValues( pVECTORHANDLE pVector )
{
   VECTORPOINT scale;            /* Scale values */
   L_TCHAR      szBuffer[ 80 ];   /* Buffer */

   /* Get current scale values */
   L_VecGetScale( pVector, &scale );

   /* Format in a buffer */
   wsprintf( szBuffer, TEXT("%d%%, %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 );
}