MKI_EditIdentMatrix (Entity Editing) Changed in Version 2019.0

C++ Syntax

bool

MKI_EditIdentMatrix(

 MKI_CONST_MATRIX_PTR f_pMatrix,

 __int32 f_nScaleMode,

 bool f_fDuplicate );

Multiplies all identified entities with the given matrix. This will only work if the current command forced a multi-entity identification.

Multi-entity identification is forced by using point types whose names begin with MKI_POINT_ID_MULTI (but not with MKI_POINT_ID_MULTIPOINT). For a complete list of point types, see MKI_POINT_*.

This procedure may only be called inside a MKI_UndoInitProcess and MKI_UndoFinishProcess bracket.

Parameters

Matrix

[MKI_CONST_MATRIX_PTR] Matrix with which all identified entities shall be multiplied. If Matrix is nullptr, the entities will not be modified.

ScaleMode New in Version 2013.0

[__int32] Determines if dimension texts sizes, line widths, and line type length factors shall be scaled according to the matrix or not. A bit-wise OR combination of the following values (see MKI_DISPLAYMODE_*):

MKI_DISPLAYMODE_DEFAULT

MKI_DISPLAYMODE_SCALED_WIDTH

MKI_DISPLAYMODE_SCALED_LENGTH

MKI_DISPLAYMODE_SCALED_DIMTEXT

Duplicate

[bool] Determines whether the entities themselves shall be modified or a copy of them. This is equivalent to the "Duplicate" function in the serving application.

Return Value

Returns true if successful. If false is returned, this is usually due to insufficient memory, especially if Duplicate is true.