ash-simd

128-bit vector primitives for HashLink: simd.hdll on stock hl, vector instructions on ash
https://github.com/rayzor-blade/ash

To install, run:

haxelib install ash-simd 0.1.1 

See using Haxelib in Haxelib documentation for more information.

README.md

ash-simd

128-bit vector primitives for HashLink programs.

  • ash.simd.Vec: one static per primitive, operating memory to memory on 16-byte vectors in hl.Bytes, each named by the bytes and a byte offset (f32x4Add(dst, di, a, ai, b, bi), where di, ai and bi are byte offsets, so consecutive vectors are 16 apart). Types: f32x4, f64x2, i32x4, i16x8, i8x16, u8x16.
  • ash.simd.Float32x4, ash.simd.Int32x4: value types over their own 16-byte hl.Bytes, with operators.

The release's ash-simd-<version>.zip contains native HDLLs for every supported platform. Install it with haxelib install ash-simd-<version>.zip. When a project compiles with -lib ash-simd, extraParams.hxml copies the matching simd.hdll beside the generated .hl file for stock HashLink. Ash uses its built-in primitives and ignores the copied HDLL. Every value-type operator allocates its 16-byte result on stock HashLink. On ash the compiled tiers keep local vector chains in registers. The load, store, add, multiply, greater than and select value helpers are Haxe-inline so the compiled tiers can keep their local vector chains in registers even inside a large caller. A result stored in an object field still allocates; use Vec with reusable slots when a hot loop must update shared vectors without allocating.

Stock HashLink must be able to find the output directory on its native library search path. On Linux, use LD_LIBRARY_PATH=build hl build/main.hl for output build/main.hl, or install simd.hdll in HashLink's library directory.

Build with -lib ash-simd, or -cp pointing at this directory. A source checkout used with -cp does not run extraParams.hxml; copy simd.hdll manually for stock HashLink. A checkout reached through -lib (a haxelib dev link) stages the ash_hdll_simd library from the repository's target/ directory when it has been built, and otherwise warns that stock HashLink will not find simd.hdll; Ash does not need the file. -D ash_simd_require_hdll turns that warning into an error. The API and lane semantics are documented in docs/simd.md of the ash repository.

For a scalar, value-vector, and reusable-slot comparison, compile crates/ash/test/tests/BenchSimdVsScalar.hx from the ash repository with -cp haxelib/ash-simd. Run one mode per process to measure its elapsed time and GC bytes separately.

Contributors
darmie
rayzor
Version
0.1.1
Published
2 weeks ago
License
MIT

All libraries are free

Every month, more than a thousand developers use Haxelib to find, share, and reuse code — and assemble it in powerful new ways. Enjoy Haxe; It is great!

Explore Haxe

Haxe Manual

Haxe Code Cookbook

Haxe API documentation

You can try Haxe in the browser! try.haxe.org

Join us on GitHub!

Haxe is being developed on GitHub. Feel free to contribute or report issues to our projects.

Haxe on GitHub

⌂