L_VecSetBindVerticesMode
#include "lvkrn.h"
L_INT EXT_FUNCTION L_VecSetBindVerticesMode(pVector, nMode)
pVECTORHANDLE pVector; |
/* pointer to a vector handle */ |
L_INT nMode; |
/* binding mode to set */ |
Sets the vertices bind mode for a vector handle. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.
Parameter |
Description |
|
pVector |
Pointer to a vector handle. |
|
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
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.
This function will have no effect in the OpenGL and DirectX engines.
Default mode is VECTOR_BIND_VERTICES.
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_VecGetBindVerticesMode, L_VecSetScale, L_VecSetRotation, L_VecSetTranslation |
Example
/* This example will toggle the bind vertices mode of a vector handle */
void ToggleBindVertices( pVECTORHANDLE pVector )
{
if( L_VecGetBindVerticesMode( pVector ) == VECTOR_BIND_VERTICES )
L_VecSetBindVerticesMode( pVector, VECTOR_UNBIND_VERTICES );
else
L_VecSetBindVerticesMode( pVector, VECTOR_BIND_VERTICES );
}