L_LVKRN_API L_INT L_VecGetScale(pVector, pScale)
Gets the current scale values.
Pointer to a vector handle.
Pointer to a VECTORPOINT structure to be updated with the current scale values.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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
This example will show the current scale values, in percentage, in a message box.
L_LTVKRNTEX_API 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;
}