Overload List
| # | Signature | Description |
|---|---|---|
| 1 | function FixAngle: TMtxVec; | Sets angle in [-2Pi,2Pi]. |
| └ indexed: function FixAngle(Index: Integer; Len: Integer): TMtxVec; | ||
| 2 | function FixAngle(const Src: TMtxVec): TMtxVec; | Sets angle in [-2Pi,2Pi] for all Src elements. |
| └ indexed: function FixAngle(const Src: TMtxVec; SrcIndex: Integer; Index: Integer; Len: Integer): TMtxVec; |
Overload 1: function FixAngle: TMtxVec;
Sets angle in [-2Pi,2Pi].
Result: stored in self (calling object), returns self for chaining
Returns: ThetaRad within [-2Pi,2Pi] interval.
Calling this function prior to passing the value to trigonometric functions can significantly improve numerical accuracy. For arguments larger than 10000, the computation of sine/cosine is speeded up by about 10x for SSE2/SSE3. The performance gains for classic FPU math are also significant. The cost of this function call is approx 30% of the cost of the sine function.
It is important to mention that the sine/cosine appear within many other functions especially complex versions of trigonometric functions. FixAngle method is never used implicitely within TMtxVec methods. To achieve maximum performance make sure that the arguments passed to complex trigonometric functions are "small" or scaled down.
Note
The vector must be real.
Indexed: function FixAngle(Index: Integer; Len: Integer): TMtxVec;
FixAngle for calling object complex elements [Index]..[Index+Len-1] in-place.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Index | Integer | start index |
| 2 | Len | Integer | element count |
Result: stored in self (calling object), returns self for chaining
An exception is raised if calling object Vector.Complex property is True or if array borders are overrun/underrun.
Overload 2: function FixAngle(const Src: TMtxVec): TMtxVec;
Sets angle in [-2Pi,2Pi] for all Src elements.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Src | TMtxVec |
Result: stored in self (calling object), returns self for chaining
Store the results in the calling object. Size and Vector.Complex properties of the calling vector are set implicitly to match the Src object.
Indexed: function FixAngle(const Src: TMtxVec; SrcIndex: Integer; Index: Integer; Len: Integer): TMtxVec;
Sets angle in [-2Pi,2Pi] for Src elements [SrcIndex]..[SrcIndex+Len-1].
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Src | TMtxVec | |
| 2 | SrcIndex | Integer | source start index |
| 3 | Index | Integer | start index |
| 4 | Len | Integer | element count |
Result: stored in self (calling object), returns self for chaining
Store the results in the calling object elements [Index]..[Index+Len-1]. Size and Vector.Complex properties of the calling object must be set explicitly. An exception is raised if Vector.ConditionCheck is True and array borders are overrun.