C++ Syntax

bool

MKI_EditPointsMatrix(

bool f_fDuplicate )

Multiplies all identified points 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 points shall be multiplied. If Matrix is nullptr, the points will not be modified.

Duplicate

[bool] Determines whether the entities containing the identified points shall be modified themselves 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.