TMtxByte.ConcatVert Method

Overload List

#SignatureDescription
1function ConcatVert(const Src: TMtxInt[]): TMtxInt;Concenates an array of matrices vertically.
2function ConcatVert(DestRow: Integer; DestCol: Integer; const Src: TMtxInt[]): TMtxInt;Concenate the Src matrices vertically and store the results in calling matrix.

Overload 1: function ConcatVert(const Src: TMtxInt[]): TMtxInt;

Concenates an array of matrices vertically.

#NameTypeDescription
1SrcTMtxInt[]

Result: stored in self (calling object), returns self for chaining

Remarks:

Concenate the Src matrices vertically and store the results in calling matrix. The TMtxInt.Rows, TMtxInt.Cols and TMtxVecInt.IntPrecision properties of the calling matrix are adjusted automatically. An exception is raised, if any of the Src matrices IntPrecision or Cols properties do not match.

Examples
var A,B,C,D,E: TMtxInt;
begin
    CreateIt(A,B,C,D);
    CreateIt(E);
    try
        A.Size(1,2);
        B.Size(A);
        E.Size(4,4);
        // overwrite the lower part of the E matrix
        // with values from A and B
        E.ConcatVert(2,2,[A,B]);
        // E becomes:
        //[E11 E12 E13 E14]
        //[E21 E22 E23 E24]
        //[A11 A12 E33 E34]
        //[B11 B12 E43 E44]
    finally
        FreeIt(E);
        FreeIt(A,B,C,D);
    end;
end;

Overload 2: function ConcatVert(DestRow: Integer; DestCol: Integer; const Src: TMtxInt[]): TMtxInt;

Concenate the Src matrices vertically and store the results in calling matrix.

#NameTypeDescription
1DestRowInteger
2DestColInteger
3SrcTMtxInt[]

Result: stored in self (calling object), returns self for chaining

Remarks:

The DestRow and DestCol parameters indicate the starting position (in the calling matrix) for concatenating. An exception is raised, if the calling matrix array bounds are overrun. An exception is raised, if any of the Src matrices IntPrecision or Cols properties do not match.