In This Topic ▼

L_VecSetBindVerticesMode

Summary

Sets the vertices bind mode for a vector handle. This function is available in the LEADTOOLS Vector Imaging Toolkit.

Syntax

#include "ltvkrn.h"

L_LVKRN_API L_INT L_VecSetBindVerticesMode(pVector, nMode)

Parameters

pVECTORHANDLE pVector

Pointer to a vector handle.

L_INT nMode

The vertices binding mode. Possible values are:

Value	Meaning
VECTOR_BIND_VERTICES	Vertices are bound. If changes occur to an object, all other objects sharing vertices with that object will be changed too.
VECTOR_UNBIND_VERTICES	Vertices are not bound. If changes occur to an object, Other objects sharing vertices with that object will not be effected.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function sets a value that determines whether or not the vertices of an object are bound to each other.

If VECTOR_BIND_VERTICES mode is selected, objects share vertices. Therefore, if one object changes, other objects sharing vertices with that object will change too.

If VECTOR_UNBIND_VERTICES mode is selected, objects have their own individual vertices. Therefore, if one object changes, no other objects will be effected.

Default mode is VECTOR_BIND_VERTICES.

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.

Example

This example will toggle the bind vertices mode of a vector handle.

L_INT VecSetBindVerticesModeExample(pVECTORHANDLE pVector) 
{ 
   if( L_VecGetBindVerticesMode( pVector ) == VECTOR_BIND_VERTICES ) 
      L_VecSetBindVerticesMode( pVector, VECTOR_UNBIND_VERTICES ); 
   else 
      L_VecSetBindVerticesMode( pVector, VECTOR_BIND_VERTICES ); 
 
   return SUCCESS; 
}