ScaleEntities Method (ISketchManager)

ScaleEntities Method (ISketchManager) | Send Feedback
See Also

BasePointX
  x coordinate of the base point (see Remarks)

BasePointY
  y coordinate of the base point (see Remarks)

BasePointZ
  z coordinate of the base point (see Remarks)

ScaleFactor
  Factor by which to scale the entities (see Remarks)

EntityTypeLongArray
  Array of longs of the types of entities to scale as defined dsObjectType_e

EntitiesArray
  Array of objects of the entities to scale

Scales the specified entities while keeping their proportions the same.

# Syntax

Visual Basic |
--- | ---
    Sub ScaleEntities( _
       ByVal BasePointX As System.Double, _
       ByVal BasePointY As System.Double, _
       ByVal BasePointZ As System.Double, _
       ByVal ScaleFactor As System.Double, _
       ByVal EntityTypeLongArray As System.Object, _
       ByVal EntitiesArray As System.Object _
    )

C# |
--- | ---
    void ScaleEntities(
       System.double BasePointX,
       System.double BasePointY,
       System.double BasePointZ,
       System.double ScaleFactor,
       System.object EntityTypeLongArray,
       System.object EntitiesArray
    )

JavaScript |
--- | ---
    ScaleEntities(
       BasePointX : Number,
       BasePointY : Number,
       BasePointZ : Number,
       ScaleFactor : Number,
       EntityTypeLongArray : Array,
       EntitiesArray : Array
    )

COM native C++ |
--- | ---
    HRESULT ScaleEntities(
       DOUBLE BasePointX,
       DOUBLE BasePointY,
       DOUBLE BasePointZ,
       DOUBLE ScaleFactor,
       VARIANT EntityTypeLongArray,
       VARIANT EntitiesArray
    )

C++ |
--- | ---
    DSRESULT ScaleEntities(
       double BasePointX,
       double BasePointY,
       double BasePointZ,
       double ScaleFactor,
       const dsLongArray& EntityTypeLongArray,
       const dsObjectPtrArray& EntitiesArray
    )

#### Parameters

BasePointX
  x coordinate of the base point (see Remarks)
BasePointY
  y coordinate of the base point (see Remarks)
BasePointZ
  z coordinate of the base point (see Remarks)
ScaleFactor
  Factor by which to scale the entities (see Remarks)
EntityTypeLongArray
  Array of longs of the types of entities to scale as defined dsObjectType_e
EntitiesArray
  Array of objects of the entities to scale

# Remarks

The base point, if located on any of the specified entities, holds its original position during scaling, while all other points move by the same relative values in the direction of the x axis, y axis, and optional z axis. You can also select a point not on an existing entity as the base point. In this case, the distance from the base point to all other points making up the entity change by the same scale factor.

A scaling factor... | Causes the entities to be...
larger than 1 | enlarged by this factor.
between 0 and 1 | reduced by this factor.

For example, the scaling factor of 3 enlarges the specified entities three times, while a scaling factor of 0.25 reduces the entities to a quarter of their original size.

# See Also

####

ISketchManager Interface
ISketchManager Members
ISketchManager::CopyEntities Method
ISketchManager::MirrorEntities Method
ISketchManager::PatternCircular Method
ISketchManager::PatternLinear Method
ISketchManager::RotateEntities Method
ISelectionManager::GetSelectedObject Method
ISketchManager::ExtendEntities Method
ISketchManager::GetEntities Method
ISketchManager::MoveEntities Method
ISketchManager::StretchEntities Method
ISketchManager::TrimEntities Method
ISketchManager::ChamferEntities Method
ISketchManager::FilletEntities Method

# Availability

DraftSight V1R1.3