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%%, %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; }