The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....


Home MathPack Matrix Classes TIntMatrix, TMatrix and TMat3D Methods CopyFrom
See also: CopyFromVec, Clone 

CopyFrom


Unit:SDL_matrix
Class: TMatrix, TIntMatrix
Declaration: [1] procedure CopyFrom (MatSource: TMatrix; SourceColLo, SourceRowLo, SourceColHi, SourceRowHi, DestCol, DestRow: integer); { class TMatrix }
[2] procedure CopyFrom (MatSource: TIntMatrix; SourceColLo, SourceRowLo, SourceColHi, SourceRowHi, DestCol, DestRow: integer); { class TMatrix }
procedure CopyFrom (MatSource: TIntMatrix; SourceColLo, SourceRowLo, SourceColHi, SourceRowHi, DestCol, DestRow: integer); { class TIntMatrix }

The method CopyFrom copies a part of the matrix MatSource into its own data area (self). TMatrix can copy values from both TMatrix and TIntMatrix classes (overloaded versions [1] and [2]).

The region to be copied is specified by the the parameters SourceColLo, SourceRowLo, SourceColHi, and SourceRowHi (see figure below).

The destination area is defined by the parameters DestCol and DestRow. The element [DestCol,DestRow ] is filled by the value of the source matrix at address [SourceColLo,SourceRowLo ] and all other elements are copied to appropriate higher addresses. The figure below shows the copy process.

Hint: SourceColLo (or SourceRowLo, resp.) needs not to be lower than SourceColHi (or SourceRowHi ), since the method CopyFrom automatically allows for the correct copying sequence.

Example: The statement MD.CopyFrom (MS, 10,10,12,12,1,5); copies the elements [10,10] to [12,12] of the matrix to the area [1,5] to [3,7] in the destination matrix .

Last Update: 2011-Jul-11