25 KiB

Raw Permalink Blame History

[3.2.7] - 2023-08-14

This minor release brings the support for the DOF post process.

Added the support for the depth of field post process (CoC spiral gather method)
- Adds dof_focus_point and dof_focus_length (see ForwardPipelineAAAConfig())
- Available in the AAA rendering pipeline only.
Fix CMake warnings.

[3.2.6] - 2023-06-05

This minor release provides several fixes and brings a functionning API to capture the framebuffer and save it as a picture.

Framework integration and source code maintenance

Fixed the missing DisableCursor on SDL (by @PMP-P).
Fixed Linux Golang module build script.

Rendering

Added the ability to set the pixel center offset for the projection matrix: SetCameraCenterOffset and GetCameraCenterOffset (by @RobEwbank1).
Resolved issue #50 (fix CaptureTexture() for Python / Lua)":
- OLD: uint32_t CaptureTexture(const PipelineResources &resources, const TextureRef &t, Picture &pic)
- NEW: uint32_t CaptureTexture(bgfx::ViewId &view_id, const PipelineResources &resources, const TextureRef &t, const Texture &readback, Picture &pic)
- Fixed Picture Set/Get RGBA: GetPixelRGBA and SetPixelRGBA.
- How does the framebuffer capture work ?
  - In order to grab the framebuffer, create an empty picture: picture = hg.Picture(512, 512, hg.PF_RGBA32)
  - The texture framebuffer is created as in draw to texture
  - Then, set framebuffer to TF_ReadBack: tex_readback = hg.CreateTexture(512, 512, "readback", hg.TF_ReadBack | hg.TF_BlitDestination, hg.TF_RGBA8)
  - When submitting the scene, target the framebuffer: hg.SubmitSceneToPipeline(view_id, scene, hg.IntRect(0, 0, 512, 512), true, pipeline, res, frame_buffer.handle)
  - The capture will be made asynchronously: frame_count_capture, view_id = hg.CaptureTexture(view_id, res, tex_color_ref, tex_readback, picture)
  - Then, only when the current frame counter is greater or equal to frame_count_capture, save the picture: hg.SavePNG(picture, "capture.png")

Misc bug fix

Fixed != color operator.
Brought back the old minmax transform to fix #49.
Removed warning message ("Invalid node instance").
Resolve "Tutorials issues on Linux Ubuntu" (Fixed VertexLayoutPosFloatNormUInt8TexCoord0UInt8).
Studio related fixes
- RBT_Static wasn't saved properly in the scene file.
- Fixed GetAnimableNodePropertyFloat and SetAnimableNodePropertyFloat to handle the camera FOV.

[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 #34, added a function that tells if the HMD is mounted or not.
- Fixed #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 #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')
```

[3.2.4] - 2022-09-27

This minor release provides minor corrections and fixes to specific issues:

Fixed the OpenGL support of the rendering pipeline (see https://github.com/harfang3d/harfang-core-package).
Improved the support of the Go language (see https://pkg.go.dev/github.com/harfang3d/harfang-go).
Improved the Emscripten build.

Framework integration and source code maintenance

Ongoing effort to support the WASM / Emscripten target.
- Added a series of flags improve the compilation to WASM.
- Updated the SDL calls to support the latest inputs/windows system.
- ⚠️ Audio is disabled for now.

Binding / Golang support

Proper package of the Go binding.
Added a mingw build stage for the Windows lib part of HARFANG.
Added a cmake flag HG_BUILD_HARFANG_STATIC to build HAFANG in static mode.
Added a Go directive (based on FabGen merge request https://github.com/ejulien/FABGen/pull/60).
Removed the non-mingw Go build from the Windows target.
Updated cmake to build HARFANG Go as a monolithic lib.
Reinstated the script support (to embed Lua in a Go project).
The support for the OpenVR API was (temporarily) removed.

Toolchain

GLTF importer:
- support for camera and lights (⚠️ experimental)
  - support for point, directional and spot types.
  - support for the diffuse color and intensity (specular is not supported by the GLTF standard).
- Fixed a mislabelled usage.
Assetc: added jpeg to the textures checklist.
Fix #16 (lua53.dll should be lua54.dll).

Binding

Added a constructor to FileFilter.
Fixed the arg out for CollectCollisionEvents to return a NodePairContacts properly.

Physics

Improved the ability of a node to change its collision shape component multiple times during runtime.
Fix #17 Capsule / Cone model fix.

Documentation

Fixed a mention to ViewMode enums in the manual.
Fixed the reference to 3 physics functions in the manual, Bullet3Physics, SyncTransformsFromScene and SyncTransformsToScene.

[3.2.3] - 2022-07-13

This minor release brings several fixes to the rendering, physics, engine, foundation and tools.

Framework integration and source code maintenance

Added a CMake option to force MSVC to use updated __cplusplus macro.
Build fixes for GCC 12.

Toolchain

Added a way to select the input channel from an input texture within a construct when processing textures in Assetc.
Changed BC6H_UF16 into BC6H_SF16 to produce a valid DDS from a HDR file.
Assetc now parses the shaders to check their dependencies for any modification and triggers a rebuild if needed.
Properly quote Luac and Recastc invocations to support space in arguments.

Binding

Fixed ImGuiMouseButton enums (ImGuiMouseButton_Left, ImGuiMouseButton_Right, ImGuiMouseButton_Middle).
Added a SetProbe function to set the radiance and irradiance map to a scene.
⚠️ Deprecated SubmitModelToForwardPipeline.

Engine

Added GetMaterialsWithName.
Added GetFullPathAsset
Added get_log_level, get_log_detailed functions.
Fixed the ray/cone intersection.
Ensure an extension is specified before returning output path from SaveFileDialog.
Fixed the reserved texture units used by the AAA pipeline (see https://dev.harfang3d.com/docs/3.2.3/man.pipelineshader/). As a consequence, the core\ folder will need to be updated if your project is using the Forward or AAA rendering pipelines.
Fixed a nasty issue in forward pipeline texture table.
⚠️ Deprecated UpdateForwardPipelineAO and UT_AmbientOcclusion.

Physics

Fixed #14, Bullet uses half extend for cylinders.

Audio

Fixed #13, properly reset OpenAL source velocity when starting a stereo sound.

Documentation

Fixed a dead link in the API documentation.
URLs updates (Quickstart, Wheel description, Readme file).

[3.2.2] - 2022-06-03

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

⚠️ 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.
🔰 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

[3.2.1] - 2022-04-10

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). ⚠️ 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

[3.2.0] - 2022-02-21

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.

[3.1.1] - 2021-12-31

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.

[3.1.0] - 2021-12-13

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.

[3.0.0] - 2021-10-12

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.
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.

[2.0.111] - 2021-06-21

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.

25 KiB Raw Permalink Blame History

[3.2.7] - 2023-08-14

[3.2.6] - 2023-06-05

Framework integration and source code maintenance

Rendering

Misc bug fix

[3.2.5] - 2022-12-09

Framework integration and source code maintenance

VR/XR

Physics

Misc

Rendering

Harfang Python

[3.2.4] - 2022-09-27

Framework integration and source code maintenance

Binding / Golang support

Toolchain

Binding

Physics

Documentation

[3.2.3] - 2022-07-13

Framework integration and source code maintenance

Toolchain

Binding

Engine

Physics

Audio

Documentation

[3.2.2] - 2022-06-03

Framework integration and source code maintenance

Toolchain

Engine

Rendering

Physics

Documentation

[3.2.1] - 2022-04-10

Source code maintenance

Toolchain

Engine

Rendering

Physics

Documentation

[3.2.0] - 2022-02-21

Source code maintenance

Engine

Rendering

Physics

Documentation

[3.1.1] - 2021-12-31

Engine

Physics

Documentation

[3.1.0] - 2021-12-13

Engine

Physics

Toolchain

Documentation

Misc

[3.0.0] - 2021-10-12

Engine

Toolchain

Documentation

Misc

[2.0.111] - 2021-06-21

25 KiB

Raw Permalink Blame History