TMtxInt::BlockInit Method

Overload List

#SignatureDescription
1void BlockInit();Initializes block processing.
2void BlockInit(TMtxVecBase *Src);
3void BlockInit(int ABlockSize);Initializes block processing.
4void BlockInit(TMtxVecBase *Src, int ABlockSize);Initializes block processing.

Overload 1: void BlockInit();

Initializes block processing.

Remarks:

Initializes block processing. Because the size of the CPU cache is limited, significant performance gains can be obtained by splitting long vectors in to a series of short ones, which can all fit in the CPU cache entirely. The BlockInit method is to be used together with TMtxInt::BlockNext and TMtxInt::BlockEnd methods to initialize a block processing while loop. BlockInit will call TMtxInt::SetSubRange to obtain subrange of the data in TVec. The TMtxInt::Length of the subranged vector is determined by the global Math387::MtxVecBlockSize variable declared in Math387 unit. Default value of MtxVecBlockSize is preset to 800 vector elements for double precision and 1600 elements for single precision. BlockInit supports nested calls and from witihin a blocked while loop you can call procedures and functions which are also blocked. If you use block processing, typical performance gains will range from 2 to a maximum of 6. Block processing can not be used, or it is difficult to apply, in cases where vector elements are not independent of each other. The block processing while loop must be written like this:

a.BlockInit;
while not A.BlockEnd do
begin
  // .... user defined function
a.BlockNext;
end;
See Also: TMtxInt::BlockNext, TMtxInt::BlockEnd
Declared in Dew::Math::TMtxVecBase · Dew.Math/MtxVecBase.h · Cross-compiler

Overload 2: void BlockInit(TMtxVecBase *Src);

#NameTypeDescription
1SrcTMtxVecBase *
Declared in Dew::Math::TMtxVecBase · Dew.Math/MtxVecBase.h · Cross-compiler

Overload 3: void BlockInit(int ABlockSize);

Initializes block processing.

#NameTypeDescription
1ABlockSizeint
Declared in Dew::Math::TMtxVecBase · Dew.Math/MtxVecBase.h · Cross-compiler

Overload 4: void BlockInit(TMtxVecBase *Src, int ABlockSize);

Initializes block processing.

#NameTypeDescription
1SrcTMtxVecBase *
2ABlockSizeint
Remarks:

Block processing can be applied on possibly already subranged Src object. Src may not be freed or go out of scope until block processing loop has finished. There would be no error raised other than AV.

Declared in Dew::Math::TMtxVecBase · Dew.Math/MtxVecBase.h · Cross-compiler