diff --git a/README.md b/README.md index d2f2e77..c51b8bd 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,24 @@ -![](images/logo_as_path.svg) +![](images/logo.svg) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/InteractiveComputerGraphics/blender-sequence-loader) [![Documentation Status](https://readthedocs.org/projects/blender-sequence-loader/badge/?version=latest)](https://blender-sequence-loader.readthedocs.io/en/latest/?badge=latest) -This is an addon for Blender 4.0+ (might work with 2.8+ but is not extensively tested on less recent versions) that enables loading of file sequences. The addon comes bundled together with [meshio](https://github.com/nschloe/meshio) which enables the loading of geometric data from a multitude of file formats. As stated there, the supported formats are listed in the following. Note that not all of the formats have been tested and some issues may still occur. - -> [Abaqus](http://abaqus.software.polimi.it/v6.14/index.html) (`.inp`), -> ANSYS msh (`.msh`), -> [AVS-UCD](https://lanl.github.io/LaGriT/pages/docs/read_avs.html) (`.avs`), -> [CGNS](https://cgns.github.io/) (`.cgns`), -> [DOLFIN XML](https://manpages.ubuntu.com/manpages/jammy/en/man1/dolfin-convert.1.html) (`.xml`), -> [Exodus](https://nschloe.github.io/meshio/exodus.pdf) (`.e`, `.exo`), -> [FLAC3D](https://www.itascacg.com/software/flac3d) (`.f3grid`), -> [H5M](https://www.mcs.anl.gov/~fathom/moab-docs/h5mmain.html) (`.h5m`), -> [Kratos/MDPA](https://github.com/KratosMultiphysics/Kratos/wiki/Input-data) (`.mdpa`), -> [Medit](https://people.sc.fsu.edu/~jburkardt/data/medit/medit.html) (`.mesh`, `.meshb`), -> [MED/Salome](https://docs.salome-platform.org/latest/dev/MEDCoupling/developer/med-file.html) (`.med`), -> [Nastran](https://help.autodesk.com/view/NSTRN/2019/ENU/?guid=GUID-42B54ACB-FBE3-47CA-B8FE-475E7AD91A00) (bulk data, `.bdf`, `.fem`, `.nas`), -> [Netgen](https://github.com/ngsolve/netgen) (`.vol`, `.vol.gz`), -> [Neuroglancer precomputed format](https://github.com/google/neuroglancer/tree/master/src/neuroglancer/datasource/precomputed#mesh-representation-of-segmented-object-surfaces), -> [Gmsh](https://gmsh.info/doc/texinfo/gmsh.html#File-formats) (format versions 2.2, 4.0, and 4.1, `.msh`), -> [OBJ](https://en.wikipedia.org/wiki/Wavefront_.obj_file) (`.obj`), -> [OFF](https://segeval.cs.princeton.edu/public/off_format.html) (`.off`), -> [PERMAS](https://www.intes.de) (`.post`, `.post.gz`, `.dato`, `.dato.gz`), -> [PLY]() (`.ply`), -> [STL]() (`.stl`), -> [Tecplot .dat](http://paulbourke.net/dataformats/tp/), -> [TetGen .node/.ele](https://wias-berlin.de/software/tetgen/fformats.html), -> [SVG](https://www.w3.org/TR/SVG/) (2D output only) (`.svg`), -> [SU2](https://su2code.github.io/docs_v7/Mesh-File/) (`.su2`), -> [UGRID](https://www.simcenter.msstate.edu/software/documentation/ug_io/3d_grid_file_type_ugrid.html) (`.ugrid`), -> [VTK](https://vtk.org/wp-content/uploads/2015/04/file-formats.pdf) (`.vtk`), -> [VTU](https://vtk.org/Wiki/VTK_XML_Formats) (`.vtu`), -> [WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) ([TIN](https://en.wikipedia.org/wiki/Triangulated_irregular_network)) (`.wkt`), -> [XDMF](https://xdmf.org/index.php/XDMF_Model_and_Format) (`.xdmf`, `.xmf`). - -[fileseq](https://github.com/justinfx/fileseq) is used to identify and load file sequences, while [rich](https://github.com/Textualize/rich) and [python-future](https://github.com/PythonCharmers/python-future) are included to satisfy unmet dependencies of the other packages. - -All data is loaded *just-in-time* when the Blender frame changes, in order to avoid excessive memory consumption. By default, the addon is able to load vertices, lines, triangles and quads. It is also able to automatically extract triangle and quad surface meshes from tetrahedral and hexahedral volume meshes. Scalar and vector attributes on vertices are also imported for visualization purposes. See the following documentation for a brief introduction. +This is an addon for Blender 4.2+ (might work with 2.8+ but is not extensively tested on less recent versions) that enables loading of file sequences. All data is loaded *just-in-time* when the Blender frame changes, in order to avoid excessive memory consumption. By default, the addon is able to load vertices, lines, triangles and quads. It is also able to automatically extract triangle and quad surface meshes from tetrahedral and hexahedral volume meshes. Scalar and vector attributes on vertices are also imported for visualization purposes. + +The addon comes bundled together with [meshio](https://github.com/nschloe/meshio) which enables the loading of geometric data from a multitude of file formats. As stated there, the supported formats are listed in the following. Note that not all of the formats have been tested and some issues may still occur. + +Confirmed to support: + +- `.obj` +- `.ply` +- `.vtk` + - points + - triangles + - quads + - tets (only surface, automatic extraction) + - hex (only surface, automatic extraction) + +It also loads any additional supported data as geometry node attributes that can be used for shading etc.[fileseq](https://github.com/justinfx/fileseq) is used to identify and load file sequences, while [rich](https://github.com/Textualize/rich) and [python-future](https://github.com/PythonCharmers/python-future) are included to satisfy unmet dependencies of the other packages. **DISCLAIMER: This project is still very much under development, so breaking changes may occur at any time!** diff --git a/blender_manifest.toml b/blender_manifest.toml index b54ebff..5d190ea 100644 --- a/blender_manifest.toml +++ b/blender_manifest.toml @@ -3,8 +3,8 @@ schema_version = "1.0.0" # Example of manifest file for a Blender extension # Change the values according to your extension id = "sequence_loader" -version = "0.3.6" -name = "Blender Sequence Loader" +version = "0.3.7" +name = "Sequence Loader" tagline = "Just-in-time loader for meshio-supported mesh file sequences" maintainer = "Stefan Rhys Jeske " # Supported types: "add-on", "theme" @@ -25,7 +25,8 @@ blender_version_min = "4.2.0" # License conforming to https://spdx.org/licenses/ (use "SPDX: prefix) # https://docs.blender.org/manual/en/dev/advanced/extensions/licenses.html license = [ - "SPDX:MIT", + # "SPDX:MIT", + "SPDX:GPL-3.0-or-later", ] # # Optional: required by some licenses. # copyright = [ diff --git a/docs/conf.py b/docs/conf.py index cedad4d..3b2ec6b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -6,10 +6,10 @@ # -- Project information ----------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information -project = 'blender-sequence-loader' +project = 'Sequence Loader' copyright = '2025, InteractiveComputerGraphics' author = 'InteractiveComputerGraphics' -release = '0.3.6' +release = '0.3.7' # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration diff --git a/images/featured.png b/images/featured.png new file mode 100644 index 0000000..f36b539 Binary files /dev/null and b/images/featured.png differ diff --git a/images/featured.svg b/images/featured.svg new file mode 100644 index 0000000..72a49db --- /dev/null +++ b/images/featured.svg @@ -0,0 +1,207 @@ + + + +Sequence Loader.vtk.obj.* diff --git a/images/featured_full.png b/images/featured_full.png new file mode 100644 index 0000000..583ff09 Binary files /dev/null and b/images/featured_full.png differ diff --git a/images/logo.png b/images/logo.png index a15bde8..0adbb5b 100644 Binary files a/images/logo.png and b/images/logo.png differ diff --git a/images/logo.svg b/images/logo.svg index 034927f..d36cb34 100644 --- a/images/logo.svg +++ b/images/logo.svg @@ -1,188 +1,359 @@ + + - - - - image/svg+xml - - - - - - - - .vtk.obj.*Blender Sequence Loader - - - - - - - - - - - - - - - - - + style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:22.5778px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:sans-serif;stroke:#ffffff;stroke-width:1.8;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill" + x="-211.53171" + y="-93.198013" + id="tspan2541">Sequence Loader.vtk.obj.* diff --git a/images/logo_as_path.svg b/images/logo_as_path.svg deleted file mode 100644 index 611f92e..0000000 --- a/images/logo_as_path.svg +++ /dev/null @@ -1,266 +0,0 @@ - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/images/logo_new.svg b/images/logo_new.svg new file mode 100644 index 0000000..6e8d7c7 --- /dev/null +++ b/images/logo_new.svg @@ -0,0 +1,357 @@ + + + +.vtk.obj.*Sequence Loader.vtk.obj.*