acedXformSS

C++

int acedXformSS(
    const ads_name ssname, 
    ads_matrix genmat
);

File

acedads.h

Description

Applies a transformation matrix to the specified selection set. If genmat does not do uniform scaling, acedXformSS() returns RTERROR. To do uniform scaling, the elements in the scaling vector [Sx Sy Sz] must all be equal; in matrix notation, M00 = M11 = M22.

Applying a transformation to a selection set is a means of scaling, rotating, or moving the entities in the selection set without using acedCommand(), acedCmd(), or acdbEntMod().

If it succeeds, acedXformSS() returns RTNORM; otherwise, it returns RTERROR. When acedXformSS() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters