L_VecSetScale

#include "ltvkrn.h"

L_LTVKRN_API L_INT L_VecSetScale(pVector, pScale, pObject, pOrigin, dwFlags)

Scales all or part of the specified vectored image.

Parameters

pVECTORHANDLE pVector

Pointer to a vector handle.

const pVECTORPOINT pScale

Pointer to a VECTORPOINT structure that contains the scale values for each axis. The translation values are in logical units.

pVECTOROBJECT pObject

Pointer to a VECTOROBJECT structure that references the object to scale. If this parameter is not NULL, only the specified object will be scaled. If this parameter is NULL, the objects to scale are determined by dwFlags.

const pVECTORPOINT pOrigin

Pointer to a VECTORPOINT structure that contains the scale center. If pObject is not NULL, scaling occurs around this point. If pOrigin is NULL, the scale center is the accumulative center of the objects to be rotated.

L_UINT32 dwFlags

Flag that indicates which objects to scale. This flag is valid only if pObject is NULL. If pObject is not NULL, this parameter is ignored. Possible values are:

Value Meaning
0 Scale all objects.
VECTOR_FLAGS_SELECTED_ONLY Scale only the currently selected objects within the vector handle.

Returns

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

Comments

Scales all or part of the specified vector image based on the scale values in pScale.

pScale contains a scale value for each axis. 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 scale values may be retrieved using L_VecGetScale.

Note: When you scale a certain object, it may or may not effect other unselected objects sharing vertices with the selected object. This depends on the current bind-vertices mode set by L_VecSetBindVerticesMode.

You should call L_VecApplyTransformation to make the new scaling part of the vector image, if you do not your changes will not be saved.

Required DLLs and Libraries

See Also

Functions

Example

This example will set the scale factor of all objects in a vector handle to 200%.

L_LTVKRNTEX_API L_INT VecSetScaleExample(pVECTORHANDLE pVector) 
{ 
   VECTORPOINT scale; 
 
   scale.x = 2.0F; 
   scale.y = 2.0F; 
   scale.z = 2.0F; 
 
   /* Set new scale values. Note that we will scale around the center of the drawing */ 
   return L_VecSetScale( pVector, &scale, NULL, NULL, 0L ); 
} 

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Vector C API Help