TMtx.ConcatVert Method

Overload List

#	Signature	Description
1	function ConcatVert(const Src: TMtxArray): TMtx;	Concenates an array of matrices vertically.
2	function ConcatVert(DestRow: Integer; DestCol: Integer; const Src: TMtxArray): TMtx;	Concenate the Src matrices vertically and store the results in calling matrix.

Overload 1: function ConcatVert(const Src: TMtxArray): TMtx;

Concenates an array of matrices vertically.

#	Name	Type	Description
1	Src	TMtxArray

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

Remarks:

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

Examples

var A,B,C,D,E: TMtx;
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;

See Also: TMtx.Concat, TMtx.ConcatHorz

Overload 2: function ConcatVert(DestRow: Integer; DestCol: Integer; const Src: TMtxArray): TMtx;

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

#	Name	Type
1	DestRow	Integer
2	DestCol	Integer
3	Src	TMtxArray

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 Complex or Cols properties do not match.