AcDbEntity::transformSubentPathsBy

C++

ACDBCORE2D_PORT ADESK_SEALED_VIRTUAL Acad::ErrorStatus transformSubentPathsBy(
    const AcDbFullSubentPathArray& paths, 
    const AcGeMatrix3d& xform
);

Description

Applies a geometric transformation to one or more subentities on an object.

This function provides a means by which AutoCAD and ObjectARX applications can ask the entity to apply a transformation matrix (xform) to one or more of its subentities.

Implementation of this method is optional. Restrictions on what types of transformations are supported are up to the implementer of the entity class.

This function must apply the transformation matrix xform to the subentities and change the entity's state to reflect the transformation. It is completely up to the implementer as to how to apply the transformation. It is also up to the implementer to decide what, if any, restrictions will be placed on the type of transformations supported. If any restrictions are desired, then it's up to the implementation of this function to enforce them.

Return values for error conditions are completely up to the implementer of this function. However, if the error is caused by a non-uniformly scaling or non-orthogonal matrix, then to be consistent with other entities that have this restriction, it is recommended that Acad::eCannotScaleNonUniformly be returned.

Note If this method is not overridden, then AutoCAD commands such as MOVE, ROTATE, SCALE, etc. will have no effect on subentities of this class.

Returns Acad::eOk if successful. The default implementation of this method returns Acad::eNotApplicable. Other return values for errors are implementation-dependent.

Parameters

Links

AcDbEntity