TOpenCLMatrix.ExtendToComplex Method

Overload List

#	Signature	Description
1	function ExtendToComplex(const Src: TOpenCLMtxVec; Zeros: Boolean): TOpenCLMtxVec;	Extend Vec object to complex calling object.
	└ indexed: function ExtendToComplex(const Src: TOpenCLMtxVec; Zeros: Boolean; SrcIndex: Integer; DstIndex: Integer; Len: Integer): TOpenCLMtxVec;
2	function ExtendToComplex(Zeros: Boolean): TOpenCLMtxVec;	Extends a real object to a complex object.

Overload 1: function ExtendToComplex(const Src: TOpenCLMtxVec; Zeros: Boolean): TOpenCLMtxVec;

Extend Vec object to complex calling object.

#	Name	Type	Description
1	Src	TOpenCLMtxVec	source TOpenCLVector or TOpenCLMatrix
2	Zeros	Boolean

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

Remarks:

If Zeros is true then the calling vector imaginary part is set to zero, otherwise the calling object imaginary part is the same as calling object real part.

Examples

var a,b: clMatrix;
begin
    a.CopyFromArray(2,2, TSingleArray.Create(1,2,3,4));
    b.ExtendToComplex(a,True);
end;

Indexed: function ExtendToComplex(const Src: TOpenCLMtxVec; Zeros: Boolean; SrcIndex: Integer; DstIndex: Integer; Len: Integer): TOpenCLMtxVec;

Converts the source to complex.

#	Name	Type	Description
1	Src	TOpenCLMtxVec	source TOpenCLVector or TOpenCLMatrix
2	Zeros	Boolean
3	SrcIndex	Integer	source start index
4	DstIndex	Integer	destination start index
5	Len	Integer	element count

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

Remarks:

Converts the source to complex by setting the imaginary part to either zero (zeros = True) or same as real (zeros = false). Does not set size of the calling vector. If there is not sufficient space available to store the result an exception will be raised.

Overload 2: function ExtendToComplex(Zeros: Boolean): TOpenCLMtxVec;

Extends a real object to a complex object.

#	Name	Type	Description
1	Zeros	Boolean

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

Remarks:

Extend the calling object to complex vector. After the calling of ExtendToComplex the imaginary part becomes the same as real part if Zeros is false. If Zeros is true the imaginary part is set to zero. The use of the in-place version of the method is discouraged because it requires 3*N copy operations, while the not-in-place version requires only 2*N copy operations.