Initial commit

Author: noaccessl

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 noaccessl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,30 @@
+# glua-SharpVector
+ A GLua implementation of Vector.
+
+ Featuring rigid optimization & precise calculations due to components being doubles.
+
+## Doc
+ All pivotal details are concisely described/explained in the code.
+
+ All Vector functions are present. `SharpVector()` possesses the same argument overload as `Vector()`.
+
+ Functions compatible with `Vector`:
+ * `SharpVector:SetGModVector( vec )`
+ * `SharpVector:AddGModVector( vec )`
+ * `SharpVector:SubGModVector( vec )`
+ * `SharpVector:MulByGModVector( vec )`
+ * `SharpVector:DivByGModVector( vec )`
+
+ Multiplication by `Matrix` is moved to `SharpVector:MulByMatrix( matrix )`
+
+ Extensions:
+ * `Vector?` `SharpVector:ToGModVector( [vecOut] )`
+ * `SharpVector` `Vector:Sharpened()`
+ * `SharpVector?` `SharpVector:Lerp( sharpvecTarget, fraction[, sharpvecOut] )`
+
+### Features
+ Functions that by design return new vector/angle/color/table as the result have the last argument as the output for the result (where reasonable). (`Cross`, `ToColor`, `ToTable`, `Angle`, `AngleEx`, `Rotate`)
+
+---
+
+### [Performance Test](./perftest/PerfTest.md)

perftest/PerfTest.md

@@ -0,0 +1,89 @@
+## glua-SharpVector: Performance Test
+ Using [gluafuncbudget](https://gist.github.com/noaccessl/2336bb390aca15bc7ba50d2c9d966daa#file-gluafuncbudget-lua)
+
+ CPU: i7-3770
+
+ OS: Windows 10
+
+ Benchmark Code: [sharpvec_perftest.lua](./sharpvec_perftest.lua)
+
+#### LuaJIT 2.1.0-beta3 (x86-64 Branch)
+<details> <summary>Results</summary>
+
+![-](./img/x64/image-0.png)
+
+![-](./img/x64/image-1.png)
+
+![-](./img/x64/image-2.png)
+
+![-](./img/x64/image-3.png)
+
+![-](./img/x64/image-4.png)
+
+![-](./img/x64/image-5.png)
+
+![-](./img/x64/image-6.png)
+
+![-](./img/x64/image-7.png)
+
+![-](./img/x64/image-8.png)
+
+![-](./img/x64/image-9.png)
+
+![-](./img/x64/image-10.png)
+
+![-](./img/x64/image-11.png)
+
+![-](./img/x64/image-12.png)
+</details>
+
+#### LuaJIT 2.0.4
+<details> <summary>Results</summary>
+
+![-](./img/image-0.png)
+
+![-](./img/image-1.png)
+
+![-](./img/image-2.png)
+
+![-](./img/image-3.png)
+
+![-](./img/image-4.png)
+
+![-](./img/image-5.png)
+
+![-](./img/image-6.png)
+
+![-](./img/image-7.png)
+
+![-](./img/image-8.png)
+
+![-](./img/image-9.png)
+
+![-](./img/image-10.png)
+
+![-](./img/image-11.png)
+
+![-](./img/image-12.png)
+</details>
+
+---
+
+ Functions excluded from testing and why:
+ * Functions using metamethods declared in the engine
+	* As internally metamethods from `C` are called, equalizing the execution time with those metamethods
+
+ * `Sub`
+	* As it's the same addition but with negative numbers
+
+ * `Div`
+	* As it's the same multiplication but inverted
+
+ * `LengthSqr`, `Length2D`, `Length2DSqr`, `DistToSqr`, `Distance2D`, `Distance2DSqr`
+	* `Length` & `Distance` must be enough as those ones are obviously cheaper in calculations
+
+ * `ToGModVector` & `Vector:Sharpened`
+	* No twin function
+
+ * `ToColor`
+	* Mostly identical to `Vector:ToColor`