https://github.com/dreamtowards/vec4j

Outskirts::Vector - Outskirts System vectormath library
https://github.com/dreamtowards/vec4j

Last synced: 9 days ago
JSON representation

Outskirts::Vector - Outskirts System vectormath library

• Host: GitHub
• URL: https://github.com/dreamtowards/vec4j
• Owner: Dreamtowards
• License: mpl-2.0
• Created: 2019-12-19T11:17:50.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2020-03-13T03:21:47.000Z (almost 5 years ago)
• Last Synced: 2024-11-06T15:32:15.649Z (about 2 months ago)
• Language: Java
• Homepage:
• Size: 44.9 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Outskirts::Vector

vector math library in Outskirts System.

## Desi

### Duplicodes

for more higher performance, in this lib, have 3 class(5 places) had duplicated code: Quaternion, Matrix4f(dup from Matrix3f)

1. Matrix4f.rotate() dupfrom: Matrix3f.rotate()

2. Quaternion.toMatrix(Quaternion, Matrix4f) dupfrom: Quaternion.toMatrix(Quaternion, Matrix3f)

3. Quaternion.rotate(float, Vector3f, Quaternion) dupfrom: Quaternion.fromAxisAngle() AND Quaternion.mul()

4. Quaternion.rotate(Quaternion, Matrix3f) dupfrom: Quaternion.toMatrix() AND Matrix3f.mul()

5. Quaternion.rotate(Quaternion, Matrix4f) dupfrom: Quaternion.toMatrix() AND {Matrix4f.mul3x3()}(wrapped)

every those duplicated code-unit had a note that points the duplication is from where src place. and those impl detail is totually warpped, its invisible from external. and those duplicated code's method are been isolation to the bottom, and stay away from mainlly content. those places are totually tooltype method, not mainly content. so hardly or just can't affect mainlly content.

## Performance

### Space

In this lib, ***ONLY 3 SITUATIONS***! will alloc heap memory.

1. `public static final Type = new Type(xxx);` static constant.

2. `if (dest == null) dest = new Type();` in some static method's first two lines's check-new-dest.

3. `throw new ArithmeticException("...");` throwing exception(ArithmeticException only).

No.1 situation are just perform once or zero times from beginning to end.

No.2 situation are dependent you, actually in concept, this 'new' alloc are operation from you, you choose 'null' param just equals choose 'new Type()' param, the lib also can not supports null-dest and requires you take non-null dest param to those methods for not alloc heap in this situation, but the lib supports "null-dest-param as new Dest_Type() param" mainlly is for code looks Clear! that could makes your code more looks better!

No.3 situation are can't be happen in commonly. that just some like divide by zero.

### Time

we are super care the Clear Design. 

bt sometimes, duplicated-code AND dispersion-code inevitable exists for more higher performance.

## Future

the lib will keep never had @Deprecated stuff AND as pleasure as possible.

if necessary, we will make relevant modifications/changes.