LVectorBase::SetScale

#include "ltwrappr.h"

virtual L_INT LVectorBase::SetScale(pScale, pOrigin=NULL, dwFlags=0))

const pVECTORPOINT pScale;

/* pointer to a vector point */

const pVECTORPOINT pOrigin;

/* pointer to a vector point */

L_UINT32 dwFlags;

/* flag that indicates which objects to scale */

Scales all or part of the specified vectored image.

Parameter

Description

pScale

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

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.

dwFlags

Flag that indicates which objects to scale. Possible values are:

 

Value

Meaning

 

0

Scale all objects.

 

VECTOR_FLAGS_SELECTED_ONLY

Scale only the currently selected objects within the vector handle.

 

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Scales all or part of the specified vectored 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 LVectorBase::GetScale.

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 LVectorBase::SetBindVerticesMode.

Note for DirectX:, You cannot select objects or enumerate them.

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:

LVectorBase::GetScale, LVectorBase::SetRotation, LVectorBase::GetRotation, LVectorBase::SetTranslation, LVectorBase::GetTranslation, LVectorBase::SetBindVerticesMode, LVectorBase::GetBindVerticesMode

Topics:

Rotating, Translating, Scaling Vector Images

 

Vector Images: Modifying Vector Object Characteristics

Example

For an example, refer to LVectorBase::EnableAlwaysEndNotification.