All Versions
7
Latest Version
Avg Release Cycle
58 days
Latest Release
777 days ago

Changelog History

  • v3.2.2 Changes

    June 03, 2022

    ๐Ÿš€ This minor release brings several fixes, a better implementation of the AAA rendering pipeline including probe reprojection and a more stable screen space raytracer. ๐Ÿ‘Œ Improvements were made in the usability area, for Python development, as HARFANG will now output warnings as much as possible when users are calling for invalid API operations. ๐Ÿง The Python build script was worked out to make the wheel available on Pypi for Linux OSes.

    ๐Ÿšง Framework integration and source code maintenance

    • ๐Ÿ‘Œ Improved the Python source package creation, to allow a pip install from the source package and address this issue.
      • The following development packages are necessary to rebuild Harfang:
      • ubuntu: uuid-dev, libreadline-dev, libxml2-dev, libgtk-3-dev
      • centos/fedora: uuid-devel, readline-devel, libxml2-devel, gtk3-devel
      • See languages/hg_python/pip/setup.py.
    • ๐Ÿ‘ Allowed the tools to be called from a Python script.
    • ๐Ÿ‘ Allowed the tools to be called from a Lua script.
    • โšก๏ธ External libraries update.
    • Moved mikktspace and stb_image to extern.
    • ๐Ÿ›  Fixed the License URL, removed a useless URL indirection.
    • โœ‚ Removed the external libraries samples and tests from source package.
    • ๐Ÿฑ Removed AssetsSource from assets.h.

    Toolchain

    • Fixed Assetc to prevent it from processing invalid geometries.
    • GLTF importer:
      • Better management of geometry instances
      • Improved material translation.
    • Sanitized the filenames when outputting files from the FBX and GLTF converters.
    • FBX converter now exports materials as PBR by default.
    • Assimp converter now exports materials as PBR by default.
    • GLTF exporter:
      • Added a filter_disabled_node options to avoid exporting node.
      • Fixed several bugs.

    Engine

    • โš  :warning: Multiplication and maths API fixes:
      • Removed vec * mat multiplications.
      • Swapped row/column in the API to match the correct mathematical order.
      • Removed mixed Vec4/Vec3 operations as the result was ambiguous.
    • โž• Added a binding for Vec3 on CubicInterpolate.
    • :beginner: Introduced a defensive programming approach in HARFANG Python, assuming the programmer is learning the API by trial and error:
      • This is done using the debug log method so it can be completely deactivated when working on C++ projects.
      • Demote most errors to warning. Errors are now strictly reserved for conditions from which a program written using HG cannot recover by itself/is not aware of.
    • ๐Ÿ›  Fixed the AddQuad method in the model builder. Added an helper method to quickly build common vertex configurations, see MakeVertex.
    • ๐Ÿ‘ Animations support:
      • Code cleanup to support the animation editor cleanup.
      • Remove duplicate keys from animation track when calling SortAnimTrackKeys.
      • Added a function to quantize scene animation.
      • Additional scene animation APIs.
      • Added the support of camera fov animations.
    • ๐Ÿšฆ Text input callback is now a signal, see TextInputSignal.
    • โž• Added a size field to ListDir output.

    Rendering

    • โž• Added a sharpen post-process.
    • โž• Added functions for orthographic projection to clip and screen space. See ProjectOrthoToClipSpace, ProjectOrthoToScreenSpace.
    • โž• Added functions for orthographic unprojection. See UnprojectOrthoFromClipSpace, UnprojectOrthoFromScreenSpace.
    • Implemented a light probe reprojection in the Forward and AAA pipelines.
    • ๐Ÿ›  Fixed the orientation of the cubemap in the probe generation.

    Physics

    • Load/save scene collision components.
    • โž• Added a missing cone collision component creation.
    • Setup physics for instantiated nodes.
    • ๐Ÿ›  Fixed a bug with local transformation for single collision shape nodes.

    ๐Ÿ“š Documentation

    • Documented the coordinates system.
    • ๐Ÿ“š Doxygen documentation update
  • v3.2.1 Changes

    April 10, 2022

    ๐Ÿš€ This minor release brings both code and submodules maintenance, several fixes in the toolchain, in the scenegraph and physics interchange and in the rendering pipeline.

    ๐Ÿšง Source code maintenance

    • โšก๏ธ Updated GLFW (3.3.6).
    • โšก๏ธ Updated BGFX to the latest version.
    • โšก๏ธ Updated OpenAL (v.1.6.10b).
    • โšก๏ธ Updated OpenVR (v1.16.8).
    • ๐Ÿ›  Fixed the debug build with Visual Studio Build Tools 2022.
    • ๐Ÿ›  Fixed the installation of PDB files.
    • โšก๏ธ CMake misc. fixes and updates.

    Toolchain

    • ๐Ÿ›  FBX Importer: changed the unit of command line argument max smoothing angle to degrees and fixed the internal vertex/tangent computation.
    • ๐Ÿ GLTF Importer: improved the way non-Windows-compliant filenames are handled.

    Engine

    • ๐Ÿ›  Fixed an issue in the Wavefront OBJ export that flipped the model on the X axis.
    • ๐Ÿ‘Œ Improve the error message issued by OpenAssets in case of missing file.
    • ๐Ÿ›  Fixed a crash when parsing a corrupted .HPS file.
    • โž• Added hg::Picture::SaveBC7 and hg::Picture::SaveBC6H functions.
    • Switched to a time limit based resource queue processing
    • Return the size on disk of a folder
    • Implemented a ComputeNodeWorldMatrix to compute a node world matrix on the fly (ComputeWorld, GetWorld, SetWorld). :warning: This function is slow but useful when scene matrices are not yet up-to-date
    • ๐Ÿ‘Œ Improved the way unicode paths are handled on Windows
    • ๐Ÿ‘ Preliminary support for scene properties animation (AmbientColor, FogNear, FogFar, FogColor) while preserving the legacy file format.
    • โž• Add an LSSF_Silent scene flag, add many boolean flags to silence errors in the rendering IO.
    • ๐Ÿ‘ฎ Allow 32 bit indices in geometries (In the future we might introduce a force 16 bit indice flag if required).
    • Validate index and vertex buffer handles when creating geometries.
    • Flag instantiated nodes as NF_InstanceDisabled if the host node is disabled.
    • โž• Added file filter descriptions to the file selector dialogs (OpenFileDialog, SaveFileDialog).

    Rendering

    • Added a depth only pass to render shadow maps (DEPTH_ONLY=1).
    • Set a higher probe resolution by default (from 64 to 512, using the --glossScale 20 --glossBias 0 parameters sent to CMFT).
    • Load/save AAA config (LoadForwardPipelineAAAConfigFromFile, LoadForwardPipelineAAAConfigFromAssets, SaveForwardPipelineAAAConfigToFile)
    • Tweaked the default light values (default_shadow_bias set to 0.0001, pssm_split of a the linear light set to 200m).
    • Switched the jitter sequence to Halton (2,3).
    • Added a function to retrieve the size of the OpenVR framebuffers
    • Added a RGBA32 pixel format to improve the performance when playing a video stream.

    Physics

    • ๐Ÿ›  Fixed an issue in synchronizing state from scene to kinematic body

    ๐Ÿ“š Documentation

    • โž• Added an explanation of why using integer representation for time is important.
    • Documented the profiler API.
    • โž• Added a HARFANG logo in the Doxygen documentation
  • v3.2.0 Changes

    February 21, 2022

    ๐Ÿš€ This minor release brings several fixes, performance improvements and new features to the rendering, physics and audio APIs.

    ๐Ÿšง Source code maintenance

    • ๐Ÿšš Cleanup sources, remove spurious hg namespace specifiers and run clang format on affected sources.
    • โšก๏ธ Updated the GLFW CMake to improve the resolution of the library path on Linux.
    • โšก๏ธ Updated ImGui to v1.87.

    Engine

    • Implement model load queuing (see ProcessModelLoadQueue, ProcessLoadQueues, LSSF_QueueTextureLoads, LSSF_QueueModelLoad).
    • ๐Ÿ‘Œ Support replay and streaming of OGG files (see LoadOGGSoundFile, LoadOGGSoundAsset, StreamOGGFileStereo, StreamOGGAssetStereo, StreamOGGFileSpatialized, StreamOGGAssetSpatialized).
    • โž• Added a Mat4 copy constructor.
    • โž• Added missing declarations for LoadImage* functions.
    • โž• Added a flag to prevent changing the current camera when loading a scene, if the current camera points to a valid node (see LSSF_DoNotChangeCurrentCameraIfValid).
    • โž• Added an is_file field to the structure returned by GetFileInfo.
    • ๐Ÿšš Simplify scene binary loader, removed versioning code:
      • Removed unused members from the RigidBody_ struct.
      • Reduced memory footprint of RigidBody_ to 6 bytes.
    • ๐ŸŽ Performance improvements on multiple scene loading (through instances).
    • โž• Added a profiling API (see BeginProfilerSection, EndProfilerSection, EndProfilerFrame, CaptureProfilerFrame, PrintProfilerFrame).
    • โž• Added a Videostream plugin interface (see MakeVideoStreamer).
    • ๐Ÿ›  Fixed scene animation garbage collection.
    • ๐Ÿ›  Fixed a bug with Unicode support in assetc.
    • ๐Ÿ›  Fixed an issue with trailing slashes on Linux in the assetc command line.

    Rendering

    • Fixed an issue in the viewport computation when upscaling half buffers in the AAA rendering pipeline.
    • Added a z_thickness param to the AAA rendering pipeline.
    • Added a series of cubemap render functions.
    • Implemented and documented all supported pipeline program features.

    Physics

    • ๐Ÿ†• New functions to lock translations and rotations in a more consistent way with the Bullet API:
      • NodeSetLinearLockAxes, NodeSetAngularLockAxes replaced by NodeSetLinearFactor, NodeSetAngularFactor.
      • NodeGetLinearLockAxes, NodeGetAngularLockAxes replaced by NodeGetLinearFactor, NodeGetAngularFactor.
    • โž• Added AddTorque/AddTorqueImpulse to physics API:
      • NodeAddTorque, NodeAddTorqueImpulse
    • ๐Ÿ‘€ Simplified the physics collision/contact query code, unified collision query API for NodeCollideWorld and StepSimulation (see CollectCollisionEvents).
    • Implemented NodeTeleport in Bullet physics.
    • ๐Ÿ‘Œ Improved the transform synchronization logic, set node world transform using the fast scene path (see SyncTransformsFromScene, SyncTransformsToScene).
    • โž• Added proper motion interpolation in Bullet physics synchronize to scene.
    • โž• Added missing functions to create all supported collision shape types.

    ๐Ÿ“š Documentation

    • โž• Added a missing reference to the requirements page in the main index.
    • ๐Ÿ‘Œ Improved the LoadSceneXXX functions documentation.
    • ๐Ÿ›  Fixed both Lua and Python code snippets.
    • ๐Ÿ‘Œ Improved the clarity of functions using bitflags by adding support for constants group in the documentation generator.
    • โšก๏ธ Update of ownership and views manual pages.
  • v3.1.1 Changes

    December 31, 2021

    ๐Ÿš€ This minor release brings several fixes, mainly in the Bullet Physics API.

    Engine

    • โž• Added a missing texture render target flag (TF_RenderTarget).
    • โž• Added SetSourceStreamTimecode() to the audio API.

    Physics

    • โšก๏ธ Updated the Physics unit tests.
    • ๐Ÿ›  Fixed an issue in the Kinematic physics matrix.
    • SetRigidBodyAngularDamping() now takes a float instead of a Vec3.

    ๐Ÿ“š Documentation

    • ๐Ÿ›  Fixed several typos in the documentation.
  • v3.1.0 Changes

    December 13, 2021

    ๐Ÿš€ This minor release brings several improvements and fixes, mainly in the Bullet Physics API.

    Engine

    • โž• Added new HLS colorspace functions.
    • ๐Ÿ‘Œ Improved CreateInstanceFromFile/CreateInstanceFromAssets by returning a boolean to inform the caller that the hosted scene could be instantiated.
    • ๐Ÿ›  Fixed various bindings (CreateInstanceFromFile, CreateInstanceFromAssets, GetColorTexture, GetDepthTexture, GetTextures)
    • โž• Added a function to center a window (GLFW).
    • โž• Added the support for Windows refresh callback (GLFW).
    • Bind read back and blit destination texture flags.
    • Simplify the frame buffer API store less content in Harfang objects.
    • โž• Added fog to render data.
    • Validate AAA forward pipeline and associated post processes.
    • ๐Ÿ›  Fixed an issue where setting up the imgui font destroyed the cursors.
    • Added time_from_xxx_d functions and fixed a precision issue with time_from_string

    Physics

    • ๐Ÿ›  Fixed the initial transform setup code of Bullet rigid bodies.
    • ๐Ÿ”„ Changed the sync kinematic and dynamic mechanisme.
    • โž• Added ResetWorld, DisableDeactivation, add a way to lock axes.
    • โž• Added a getter/setter for rolling friction.
    • โž• Added a raycast functions to return all collisions found between two points.
    • ๐Ÿ›  Fixed a raycast issue with geometry hierarchy.
    • โž• Added the support for multi collision shapes with matrices

    Toolchain

    • Assetc cleanup error messages, do not output unless truly reporting on an error.
    • Assetc will now delete the outputs for deleted inputs. A flag was added to opt-out from this mechanism (-no_clean_removed_inputs).
    • Assetc will now delete the previous compiled lua scripts if a compilation error arises.
    • ๐Ÿ›  Assimp importer: fixed a mention to the wrong converter.
    • ๐Ÿ”€ Assimp importer: added a -merge-mesh option.
    • โšก๏ธ Assimp importer: updated to Assimp v5.1.2.
    • ๐Ÿ›  GLTF importer: fixed the import in case of many instances.
    • ๐Ÿ›  Fixed the toolchain integrity check.

    ๐Ÿ“š Documentation

    • ๐Ÿ“š Documentation improvements and cleanup.
    • ๐Ÿ›  Fixed a typo in GetTextures documentation filename.
    • ๐Ÿ›  Fixed the reference to SceneBullet3Physics in the man Physics page.
    • โž• Added a man.Requirements page.
    • ๐Ÿ‘Œ Improved the Pypi wheel description ('Quickstart' was lacking a download URL).

    Misc

    • โšก๏ธ Updated the license.
    • ๐Ÿ›  Fixed some cppcheck issues.
  • v3.0.0 Changes

    October 12, 2021

    ๐Ÿš€ This major release mainly replaces Newton Dynamics with Bullet Dynamics for physics and improves interoperability between supported languages.

    Engine

    • โž• Add diffuse and specular intensity to lights.
    • ๐ŸŽ Performance and filtering improvements of the AAA rendering pipeline.
    • Replace Newton Dynamics with Bullet 3 Dynamics, SceneBullet3Physics uses the same API as SceneNewtonPhysics.
    • โž• Add SceneBullet3Physics.NodeWake to wake a sleeping body.
    • Implement restitution and friction in rigid bodies.
    • ๐Ÿ‘ Provide support for value transfer between Lua VMs when calling Get/Set/Call on SceneLuaVM.
    • Implement full value transfer between Python and Lua VMs.
    • Implement Call on SceneLuaVM.
    • 0๏ธโƒฃ Light default specular value is now (1.0, 1.0, 1.0).
    • ๐Ÿ‘Œ Support for specular color in core light models (point, spot, linear) in the PBR shader. This is not compliant with a strict definition of a PBR Pipeline, but this approach tends to be a consensus in the industry (Blender, Redshift, ...) and is artist-friendly.
    • โž• Add Joystick support (Joystick, JoystickState, ReadJoystick, GetJoystickNames, GetJoystickDeviceNames).
    • ๐Ÿ‘Œ Improve OpenAsset and LoadResourceMeta performance.
    • ๐Ÿ‘Œ Improve Vertices.End performance by removing systematic default validation.
    • Rename x_aspect_ratio parameter to fov_axis_is_horizontal in SceneSubmitToForwardRenderPipeline.
    • SetView2D and SetViewPerspective now takes x,y,w,h instead of w,h.
    • ๐Ÿ›  Fix redundant loads of texture meta JSON when loading materials.
    • ๐Ÿ›  Fix ImGui Enter/Return key distinction.
    • ๐Ÿ›  Fix broken linear texture filtering.
    • ๐Ÿ›  Fix GLFW window system not sending window signals and breaking IsWindowOpen as a consequence.
    • ๐Ÿ›  Fix spurious error message when opening asset with several asset folders registered.

    Toolchain

    • ๐Ÿ†• New AssImp converter.
    • GLTF Importer: Add occlusion texture if no metal/roughness texture is declared in a source material.
    • FBX, GLTF importer: Fix on the importation of animations in some specific rotations situations.

    ๐Ÿ“š Documentation

    • Quickstart page improvements.
    • Index class members in the search index.

    Misc

    • โšก๏ธ Update STB Truetype.
    • โšก๏ธ Update STB Vorbis.
    • โšก๏ธ Update STB Image.
    • โšก๏ธ Update STB Image Write.
    • โšก๏ธ Update bgfx.
    • โšก๏ธ Update bimg.
    • โšก๏ธ Update tiny process.
  • v2.0.111 Changes

    June 21, 2021

    ๐Ÿš€ This release is a rewrite of the Harfang API toward a data-oriented approach. ๐ŸŽ As a developer, you will find that many of the old classes are now gone and replaced by function calls that you string together in order to implement complex functionalities. The improved API provides greater flexibility and delivers higher performance than the Harfang 1.x API. ๐Ÿš€ Of major interest in this first release of Harfang 2.x are the new resource/asset pipeline (see Resources & Assets) as well as the new AAA renderer beta enabling screen-space global illumation with correct approximation of both the radiance and irradiance terms of the PBR equation.

    NOTE:

    ๐Ÿšง The AAA rendering pipeline is currently a WORK IN PROGRESS and has important issues to address.