[3.2.5] - 2022-12-09

This minor release provides several fixes and new features in the VR/XR and Physics areas. Platform compatibility was slightly improved as well on OS X and WASM (still experimental):

Framework integration and source code maintenance

• Improved the support of WASM (@pmp-p).
• Improved the MacOS support (@tommo).
• Improved the unit testing & code coverage of Foundation and Engine.
• Various fixes to improve the compatibility of Harfang Studio on Linux.
• CMake Fixes.

VR/XR

• OpenXR:
  • Added the support of OpenXR to Harfang (see OpenXRInit, OpenXRShutdown, OpenXREyeFrameBuffer, OpenXRCreateEyeFrameBuffer, OpenXRGetHeadPose...).
  • Support of the most common features.
  • Support of the hand tracking.
  • Support of the passthrough.
  • Support of the eye gaze tracking.
  • Added the extensions VARJO_QUADVIEWS and COMPOSITION_LAYER_DEPTH to support the Varjo XR-3 headset.
• OpenVR:
  • Fixed Add a function to test if the VR headset is on #34, added a function that tells if the HMD is mounted or not.
  • Fixed Cannot get OpenVR to work in OpenGL #35, added the support for OpenGL and DX12 renderers.

Physics

• Added the support for physics geometries (Bullet and Assetc).
• Added the support for 6DOF physics constraints (see Add6DofConstraint, Remove6DofConstraint).
• Added pre-tick callback to the Physics system (see SetPreTickCallback).
  • The SetPreTickCallback allows the user to define a function that will be automatically invoked by the Physics solver. This function is provided with 2 parameters, the physics system and the delta of time within the current solver step:

    # scene physics
    physics = hg.SceneBullet3Physics()
    physics.SceneCreatePhysicsFromAssets(scene)
    physics_step = hg.time_from_sec_f(1 / 60)
    
    function foo(ph, dt)
        # do physics stuff (AddForce, AddImpulse...) 
    end
    
    physics.SetPreTickCallback(foo)

Misc

• Fixed Cannot handle cursor outside of the main client window #33, added a function to disable/grab mouse cursor (see DisableCursor).
• Fixed incorrect warning message (see Scene::SetObjectModel and Object::IsValid).
• Fixed X11 display retrieval and propagate GFLW backend to parent project.

Rendering

• Added a blending mode: BM_AlphaRGB_AddAlpha (required by Harfang GUI).

Harfang Python

• Packaged Assetc into the bdist wheel and allow it to be called as a function of harfang.bin module.
  • Can be used from the command line:

    python3 -m harfang.bin assetc resources_path -api GL

  • Or as a python module:

    import harfang.bin
    harfang.bin.assetc('resources', '-api', 'GL')