This is a fork from physx-rs, using the same methodology for binding generation. Check out the physx-sys and related presentation for more information.

Getting started

As of right now, no libraries are shipped as they'd be > 200 MB in total. Soon~ I hope to have prebuilt binaries + generated files as Github releases. However, building everything locally should be easy: the provided justfile contains a build command. This should run all codegen, followed by building the native libraries and copying them to the repository root.

Basic usage

main :: proc() {
    using physx

    foundation := create_foundation_ext()
    dispatcher := default_cpu_dispatcher_create(
        1,
        nil,
        physx.DefaultCpuDispatcherWaitForWorkMode.WaitForWork,
        0,
    )

    physics := create_physics_ext(foundation)

scene_desc := scene_desc_new(tolerances_scale_new(1.0, 10.0))
    scene_desc.gravity = vec3_new_3(0.0, -9.81, 0.0)
    scene_desc.cpuDispatcher = dispatcher
    scene_desc.filterShader = get_default_simulation_filter_shader()
    scene := physics_create_scene_mut(physics, scene_desc)
    defer {
        scene_release_mut(scene)
        physics_release_mut(physics)
        default_cpu_dispatcher_release_mut(dispatcher)
        foundation_release_mut(foundation)
    }

    run(physics, scene)
}

Examples

Ball

A simple example to showcase how to use physx-sys. It can be run with odin run examples/ball.odin -file.

Simulated 100 timesteps in 8.161109 ms.
Heights over time (x=time, dt=100ms)

                  o

                   o

                    o                   ooooooo
                                      oo       ooo
                     o               o            o
                                   oo              o
                                  o                 o
                      o          o                   o
                                o                     o
                       o       o                       o
                                                        o           ooooooo
                        o     o                          o        oo       oo
                             o                                  oo           oo
                            o                             o    o               o    ooooooooo
                         o o                               o oo                 oooo         ooooooo

There's also a graphical equivalent using raylib: odin run examples/ball_raylib.odin -file.

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Note that the PhysX C++ SDK has its own BSD 3 license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.