v2.4.0-RC2

v2.4.0-RC2

v2.4.0-RC1

v2.4.0-RC1

v2.3.1

A patch release to fix issues with LFS data, see https://github.com/f3d-app/f3d/releases/tag/v2.3.0 for more info about the content of the 2.3 release.

v2.3.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 unique 😢 sponsor for this release @Ramalama2 ❤️

💡 USD format support

F3D now support USD format! Thanks to a new usd plugin using OpenUSD, you can now open all .usd files.
Many USD features are supported, give it a go!

🖨️ 3MF format support

F3D now support 3MF format! Thanks to our now expanded assimp plugin, your 3D printing data will be visible in F3D!
We also added support for .x files as well.

🌪️ VDB format experimental support

F3D now support VDB format! Thanks to a new experimental vdb plugin relying on VTK and OpenVDB, you can now open all .vdb files, with some limitations.

📝 Complete changelog

For F3D users:

• Added --animation-autoplay option (libf3d: scene.animation.autoplay) to automatically start animation on file load (Thanks @technologeli !)
• Added an experimental vdb plugin in order to read .vdb files using OpenVDB
• Added an usd plugin in order to read .usd files using OpenUSD
• Added .3mf and .x files support in the assimp plugin
• Added a small margin between the model and the grid to avoid potential z-fighting
• Added VTK output to the log when using --verbose=debug for easier debug
• Reworked the alembic plugin to read Texture Coordinates and Normals for .abc files
• Improved the reading of EXR files using multi-threading for better performance when loading HDRIs
• Improved the documentation on https://f3d.app (thanks @Ramalama2 @jspanchu @felixonmars @zhiyuang !)
• Improved general logging in order to make it easier to understand issues with file and options
• Fixed potential crashes when reading assimp plugin file formats
• Fixed --grid-absolute for off-center models (thanks @snoyer !)
• Fixed an issue with thumbnail generation showing the log window
• Fixed many interaction issues on non-Qwerty keyboard layout
• Fixed handling of filenames containing commas (thanks @snoyer !)
• Fixed an issue on Windows where the log window would appear on top of F3D window (thanks @jiangsheng !)
• Fixed crashes with specific .obj file
• Fixed an issue with incorrect return code when using headless mode or incorrect options
• Fixed dependency issue with the headless .deb binary release
• Fixed a crash when using a file with more than 254 bones (Requires OpenGL 4.3)
• Fixed an issue with Unicode filenames on the title bar on Windows
• Fixed an issue where focal point picking would generate error messages (thanks @snoyer !)
• Changed --verbose into a string based option, eg: --verbose=quiet or --verbose=debug. --verbose is still supported.
• Changed --no-render behavior so that it doesn't impact verbosity anymore
• Changed the default configuration file so that translucency support is enabled by default
• Deprecated --quiet, use --verbose=quiet instead
• Deprecated --input, use positional argument instead

For libf3d users:

• Added scene.animation.autoplay option
• Added a f3d::image::saveBuffer API to save an image as a file format in memory
• Fixed the default name of the window (thanks @shaikan !)

For F3D packagers:

• Added a new optional dependency, OpenUSD. Enable with F3D_PLUGIN_BUILD_USD CMake option
• Added a new optional dependency through VTK, OpenVDB. Enable with F3D_PLUGIN_BUILD_VDB CMake option
• Added a new CMake option to control the link against libatomic. Control with F3D_LINUX_LIBRARY_LINK_ATOMIC (Thanks @mzf-guest !)
• Added two new packages to the list, OpenMandriva and Mageia, thanks @papoteur-mga @berolinux

Thanks to all our packagers that help F3D reach a wider audience: AndnoVember @kylosus @kevinsmia1939 @yurivict @bcdarwin @svenstaro @mzf-guest @papoteur-mga @berolinux
Thanks to all our contributors for this release: @technologeli @Ramalama2 @jspanchu @felixonmars @zhiyuang @jiangsheng @snoyer @Meakk @mwestphal

Credits:

Bunny Samurai Skateboarder model from maxpanysh and Mad Kobra
Shangai Bund hdri from Greg Zall
armadillo.vdb: openvdb.org and stanford 3D scanning repository
McUsd_10cm.usdz: CC-NC-BY-SA jasonjgardner and Eric Haines
heartgears.3mf: BSD-2-Clause: Copyright (c) 2018, 3MF Consortium

v2.3.0-RC5

v2.3.0-RC5

v2.3.0-RC4

v2.3.0-RC4

v2.3.0-RC3

v2.3.0-RC3

v2.3.0-RC2

v2.3.0-RC2

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