v2.3.0-RC1

v2.3.0-RC1

v2.2.1

🗣 Join our community:

F3D Community is welcoming to users and developers alike!
Ask questions, gets involved and starts contributing in a beginner-friendly environment .

❤️ Sponsor F3D:

F3D is looking for sponsors!
We have some expanses mainly related to github and web hosting bills, any help to cover the cost would be highly appreciated.
To thank you, we'll offer preferential support and vote on next feature and bugfix as soon as you start sponsoring.

Much love to our few sponsors for this release @Ramalama2 @Da3n0n @melMass ❤️

🏞️ HDRI default and performance

F3D now comes with a default HDRI! It is used to improve default lighting quality.
HDRI performance has already been improved greatly, with no wait time when changing files to visualize
and HDRI cache is being used as much as possible.
You can now turn on/off HDRI lighting and skybox using F and J bindings.

Before/After:

Note: Command line arguments for HDRI have changed, please refer to the complete changelog and the documentation.

🐍 Python API and python wheels

The libf3d python API was completely reworked in order to be more pythonic!
You can easily use libf3d in your own scripts to quickly visualize your datasets.
Create the engine, set the rendering options, load the geometry, and start the interactor or directly write the result in an image!
For example, here is how to load and interact with a model:

import f3d

eng = f3d.Engine(f3d.Window.NATIVE)
eng.options.update({
  "model.scivis.array-name": "Normals",
  "model.scivis.component": 0,
  "ui.bar": True,
  "render.grid.enable": True,
  })

eng.loader.load_geometry("f3d/testing/data/dragon.vtu")
eng.interactor.start()

See the documentation and the tests for more info.

Also, you can now easily install the libf3d using pip with:

pip install f3d

Please test this and let us know if you have any feedback, we always want to improve our python API!

📝 Complete changelog

For F3D users:

• Added a native Apple Silicon release package 🍎
• Added new options hdri-file, hdri-ambient, hdri-skybox to have more control on the HDRI behavior
• Added a default HDRI used when providing no hdri-file
• Added bindings to toggle HDRI ambient lighting (F) and HDRI skybox (J)
• Added bindings to move the camera to standard locations: 1: Front, 3: Right, 7: Top, 9: Isometric
• Added Open CASCADE BRep format to the OCCT plugin.
• Fixed an infamous issue when the Windows thumbnailer always steal the focus
• Fixed an issue with the binary release when opening draco files
• Fixed an issue with matcap textures
• Fixed an issue with HDRI lighting
• Fixed an issue with HDRI lighting when dropping HDRI after a model
• Fixed an issue where invalid option would not show on Windows
• Fixed an issue where previously loaded file would stay visible
• Fixed an issue when loading invalid EXR file as HDRI
• Fixed cheatsheet menu rendering under 'Drop File Instructor'
• Fixed raytracing rendering issues
• Improved cheatsheet menu contrast for any background color
• Improved overall text contrast for any background color
• Improved performance when changing model and using a HDRI
• Improved HDRI cache performance
• Deprecated hdri option

For libf3d users:

• Reworked image API to support many file formats to read (EXR, HDR) and write (PNG, JPG, TIF, BMP)
• Added render.hdri.file, render.hdri.ambient, render.background.skybox options.
• Deprecated render.background.hdri in favor of new options above
• Deprecated previous image API
• Add loader::loadGeometry allowing loading geometry from memory buffers

For developers:

• Added a deprecation framework
• Removed F3D_TESTING_ENABLE_HDRI_TESTS cmake option and merged it with F3D_TESTING_ENABLE_LONG_TIMEOUT_TESTS
• Added a Getting Started guide for beginners developers

For F3D packagers:

• Fixed compatibility with FreeBSD

Thanks to all our packagers that help F3D reach a wider audience: AndnoVember @kylosus @kevinsmia1939 @yurivict @bcdarwin @svenstaro @mzf-guest
Thanks to all our contributors for this release: @lknknm @yurivict @snoyer @Meakk @mwestphal

Credits:
Battle Damaged Sci-fi Helmet - PBR by theblueturtle_, CC BY-NC
Industrial Sunset 02 (Pure Sky), by Jarod Guest and Sergej Majboroda, CC0

v2.2.1-RC2

v2.2.1-RC2

v2.2.1-RC1

v2.2.1-RC1

v2.2.0-RC3

v2.2.0-RC3

v2.2.0

v2.2.0

v2.2.0-RC2

v2.2.0-RC2

v2.2.0-RC1

v2.2.0-RC1

v2.1.0

🗣 Join our community:

F3D Community is welcoming to users and developers alike!
Ask questions, gets involved and starts contributing in a beginner-friendly environment .

❤️ Sponsor F3D:

F3D is looking for sponsors!
We have some expanses mainly related to github and web hosting bills, any help to cover the cost would be highly appreciated.
To thank you, we'll offer preferential support and vote on next feature and bugfix as soon as you start sponsoring.

Much love to our few sponsors @Ramalama2 @Ninroot ❤️

🏃 Animation Rework:

Many new feature for better animation in F3D!
Animation is now real-time based and there are many new animation options:

• --animation-speed-factor to slow, speed and invert time
• --animation-frame-rate to control the frame rate
• --animation-time option to set an animation time to load initially

🎥 Camera options:

Camera options have been improved greatly and now let you set a direction, great to generate screenshot for the same POV of different geometries. Default camera locations have been updated to get a better initial look at the data.
New options are:

• --camera-direction : Set the direction the camera is looking at, to use with --camera-focal-point
• --camera-zoom-factor: Set the initial zoom factor

✨ MatCap:

It is now possible to use MatCap textures to color your model.

🌄 HDRI Improvements:

Setting the HDRI has never been easier, now with .exr support and better caching performance!
Just drop a .hdr or .exr on the F3D window and the HDRI will be loaded!

📝 Complete changelog

For F3D users:

• Reworked Animation support and added many animation related options (see above)
• Added --camera-direction and --camera-zoom-factor and use it in default config file (see above )
• Added --texture-matcap option to load a MatCap texture (see above)
• Added support for opening HDRI background with Drop (see above)
• Added .exr support for HDRI and textures (see above)
• Improved HDRI caching performance (see above)
• Added a EGL headless binary release
• Added typo suggestion when failing to use the right option name
• Added --invert-zoom option (libf3d: interactor.invert-zoom) to invert zoom direction with right-click on mouse (thanks @DeveloperPaul123!)
• Added support for keeping camera position when reloading a file with UP key
• Added a --grid-absolute option (libf3d: render.grid.absolute) to position the grid instead of being below the model
• Added a "Drop Zone" when starting F3D without loading a file
• Added coloring support for STEP files in binary release
• Fixed an issue on Windows where the error window would popup even with --quiet
• Fixed an issue with 16 bit and 32 bit textures with assimp plugin
• Fixed an issue on Windows where errors where not visible
• Fixed an HDRI issue on reload
• Fixed a crash when with the progress bar on reloading a file
• Fixed an issue where certain options from config file would be ignored
• Fixed a crash with many GLTF files when an array does not have a name
• Fixed an issue where dropping a duplicate file would change the loaded file instead of not doing anything
• Fixed an issue when loading an unsupported file
• Fixed an issue with VRML files
• Improved config file for .ply files
• Improved config file regex so that they are case-insensitive
• Improved --up option to support no sign and better validation
• Improved F3D version reporting about itself and VTK (--version)
• Improved documentation, testing, help
• Excluded TIFF format from Windows Thumbnailer
• Changed the automatic camera position to a version more close to the data
• Reduced size of binary release by a factor of two

For developers:

• Added vcpkg support for dependency installation

For F3D packagers:

• Added a F3D_PLUGIN_OCCT_COLORING_SUPPORT CMake variable to control if this feature is compiled, default is ON
• Added SONAME support (thanks @bkmgit!)
• Added a F3D_PLUGINS_INSTALL_DIR CMake variable to control where to install plugins
• Added a new module: F3D_MODULE_EXR that depends on openexr
• Added support to use external cxxopts and external nlohmann-json (thanks @topazus!)
• Fixed a link issue with VTK modules
• Fixed a @loader_path issue on MacOS
• Added support for CMAKE_INSTALL_*DIR variables on installation (thanks @topazus!)
• Added support for building against a EGL enabled VTK
• Fixed a compilation issue with VTK master

Thanks to all our packagers that help F3D reach a wider audience: AndnoVember @kylosus @kevinsmia1939 @yurivict @bcdarwin @svenstaro @mzf-guest
Thanks to all our contributors for this release: DeveloperPaul123 @topazus @bkmgit @snoyer @Meakk @mwestphal

Credits:
Bristleback DOTA Fan-Art by Nikolay_Tsys.
Future Parking HDRI by Sergej Majboroda.
Luxray by Gianmarco.
Bell Park Dawn HDRI by Greg Zaal.

v2.1.0-RC3

v2.1.0-RC3