L_VecIs3D

Summary

Determines whether or not the specified vector handle contains 3D objects.

Syntax

L_LVKRN_API L_BOOL L_VecIs3D(pVector)

Parameters

const pVECTORHANDLE pVector

Pointer to a vector handle. The referenced vector will be checked for the presence of 3D objects.

Returns

Comments

Call this function to determine whether or not the given vector handle contains any 3D objects.

A vector handle is considered to be "3D" if it has one or more objects stretching within the Z-axis.

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_VecLoadFile

Example

This example will determine whether the given vector handle is 2D or 3D.

L_LTVKRNTEX_API L_INT VecIs3DExample(pVECTORHANDLE pVector) 
{ 
   /* Check if 3D */ 
   if( L_VecIs3D( pVector ) ) 
      MessageBox( NULL, TEXT("Vector is 3D"), TEXT("Test"), MB_OK ); 
   else 
      MessageBox( NULL, TEXT("Vector is 2D"), TEXT("Test"), MB_OK ); 
 
   return SUCCESS; 
}