TMtx.ConcatHorz Methods

Summary

Concenates an array of matrices horizontally.

Class
TMtx

Declaration

Function ConcatHorz(DestRow, DestCol: integer; const Src: array of TMtx): TMtx;

Description

Concenate the Src matrices horizontally and store the results in the calling matrix. The DestRow and DestCol parameters indicate the starting position (in the calling matrix) for concenating. An exception is raised, if the calling matrix array bounds are overrun. An exception is raised, if any of the Src matrices Complex or Rows properties do not match.

Declaration

Function ConcatHorz(const Src: array of TMtx): TMtx;

Description

Concenate the Src matrices horizontally and store the results in the calling matrix. The Rows, Cols and Complex properties of the calling matrix are adjusted automatically. An exception is raised if any of the Src matrices Complex or Rows property does not match.

See Also
Concat
ConcatVert

Example 1

      var A,B,C,D,E: TMtx;
      begin
        CreateIt(A,B,C,D);
        CreateIt(E);
        try
          A.Size(2,2);
          B.Size(A);
          E.Size(4,4);
          // overwrite the lower part of the E matrix
          //    with values from A and B
          E.ConcatHorz(2,2[A,B]);
          //E becomes:
          //[E11 E12 E13 E14]
          //[E21 E22 E23 E24]
          //[A11 A12 B11 B12]
          //[A21 A22 B21 B22]
        finally
          FreeIt(E);
          FreeIt(A,B,C,D);
        end;
      end;