Javascript/WASM bindings for Nvidia PhysX 5.1.3.
Looking for pre-built binaries / build instructions? See below
There is a very basic hello world example: No fancy graphics, only console output but it should get you started.
The API is very close to the original PhysX C++ API, so you can simply use the official PhysX API documentation
I also use this lib in my engine kool and have a few demos in place:
- Vehicle: Basic vehicle demo with a few obstacles.
- Character: 3rd person character demo on an island.
- Ragdolls: A simple ragdoll demo.
- Joints: A chain running over two gears.
- Collision: The obligatory box (and other shapes) collision physics demo.
However, these are written in kotlin, not javascript.
This library is published as a npm package:
npm i physx-js-webidl
Alternatively you can grab the pre-built binaries (.wasm + support .js) from the dist
directory.
In order to build the library you need a recent version of the emscripten SDK - I'm
using version 3.1.25
.
# Clone this repo
git clone https://github.com/fabmax/physx-js-webidl
# Enter that directory
cd physx-js-webidl
# Download submodule containing the PhysX code
git submodule update --init
# Generate build-scripts
./generate.sh
# Build
./make.sh
To add bindings to additional PhysX interfaces you only have to edit the
PhysXJs.idl
file located in PhysX/physx/source/webidlbindings/src/wasm/
and recompile the library.
# Build the image
docker compose up
# Build Release
docker compose run --rm builder ./make.sh
# Build Profile
docker compose run --rm builder ./make-profile.sh
# Build Debug
docker compose run --rm builder ./make-debug.sh
It is also possible to generate Typescript bindings out of the idl file (apparently broken on recent node version):
npx @milkshakeio/webidl2ts -e -d -n PhysX -i PhysX/physx/source/webidlbindings/src/wasm/PhysXWasm.idl -o dist/physx-js-webidl.wasm.d.ts