Skip to content

Commit 1c8dfc4

Browse files
Prepare Initial Release (#2)
* change the version number to 0.1.0 * add a project description in the readme * convert logo text to path for more consistent rendering * some more description
1 parent 2fa2c9d commit 1c8dfc4

File tree

3 files changed

+311
-4
lines changed

3 files changed

+311
-4
lines changed

README.md

Lines changed: 44 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,42 @@
1-
![](images/logo.svg)
2-
3-
Loading animation sequences with meshio and fileseq
1+
![](images/logo_as_path.svg)
2+
3+
This is an addon for Blender 3.1+ (might work with 2.8+ but has not been tested) 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.
4+
5+
> [Abaqus](http://abaqus.software.polimi.it/v6.14/index.html) (`.inp`),
6+
> ANSYS msh (`.msh`),
7+
> [AVS-UCD](https://lanl.github.io/LaGriT/pages/docs/read_avs.html) (`.avs`),
8+
> [CGNS](https://cgns.github.io/) (`.cgns`),
9+
> [DOLFIN XML](https://manpages.ubuntu.com/manpages/jammy/en/man1/dolfin-convert.1.html) (`.xml`),
10+
> [Exodus](https://nschloe.github.io/meshio/exodus.pdf) (`.e`, `.exo`),
11+
> [FLAC3D](https://www.itascacg.com/software/flac3d) (`.f3grid`),
12+
> [H5M](https://www.mcs.anl.gov/~fathom/moab-docs/h5mmain.html) (`.h5m`),
13+
> [Kratos/MDPA](https://github.com/KratosMultiphysics/Kratos/wiki/Input-data) (`.mdpa`),
14+
> [Medit](https://people.sc.fsu.edu/~jburkardt/data/medit/medit.html) (`.mesh`, `.meshb`),
15+
> [MED/Salome](https://docs.salome-platform.org/latest/dev/MEDCoupling/developer/med-file.html) (`.med`),
16+
> [Nastran](https://help.autodesk.com/view/NSTRN/2019/ENU/?guid=GUID-42B54ACB-FBE3-47CA-B8FE-475E7AD91A00) (bulk data, `.bdf`, `.fem`, `.nas`),
17+
> [Netgen](https://github.com/ngsolve/netgen) (`.vol`, `.vol.gz`),
18+
> [Neuroglancer precomputed format](https://github.com/google/neuroglancer/tree/master/src/neuroglancer/datasource/precomputed#mesh-representation-of-segmented-object-surfaces),
19+
> [Gmsh](https://gmsh.info/doc/texinfo/gmsh.html#File-formats) (format versions 2.2, 4.0, and 4.1, `.msh`),
20+
> [OBJ](https://en.wikipedia.org/wiki/Wavefront_.obj_file) (`.obj`),
21+
> [OFF](https://segeval.cs.princeton.edu/public/off_format.html) (`.off`),
22+
> [PERMAS](https://www.intes.de) (`.post`, `.post.gz`, `.dato`, `.dato.gz`),
23+
> [PLY](<https://en.wikipedia.org/wiki/PLY_(file_format)>) (`.ply`),
24+
> [STL](<https://en.wikipedia.org/wiki/STL_(file_format)>) (`.stl`),
25+
> [Tecplot .dat](http://paulbourke.net/dataformats/tp/),
26+
> [TetGen .node/.ele](https://wias-berlin.de/software/tetgen/fformats.html),
27+
> [SVG](https://www.w3.org/TR/SVG/) (2D output only) (`.svg`),
28+
> [SU2](https://su2code.github.io/docs_v7/Mesh-File/) (`.su2`),
29+
> [UGRID](https://www.simcenter.msstate.edu/software/documentation/ug_io/3d_grid_file_type_ugrid.html) (`.ugrid`),
30+
> [VTK](https://vtk.org/wp-content/uploads/2015/04/file-formats.pdf) (`.vtk`),
31+
> [VTU](https://vtk.org/Wiki/VTK_XML_Formats) (`.vtu`),
32+
> [WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) ([TIN](https://en.wikipedia.org/wiki/Triangulated_irregular_network)) (`.wkt`),
33+
> [XDMF](https://xdmf.org/index.php/XDMF_Model_and_Format) (`.xdmf`, `.xmf`).
34+
35+
[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.
36+
37+
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.
38+
39+
**DISCLAIMER: This project is still very much under development, so breaking changes may occur at any time!**
440

541
- [1. Installation](#1-installation)
642
- [1.1 Build from source (optional)](#11-build-from-source-optional)
@@ -17,6 +53,7 @@ Loading animation sequences with meshio and fileseq
1753
- [2.3.2 Path Information](#232-path-information)
1854
- [2.3.3 Attributes Settings](#233-attributes-settings)
1955
- [2.3.4 Split Norm per Vertex](#234-split-norm-per-vertex)
56+
- [2.3.5 Advanced Settings](#235-advanced-settings)
2057

2158
## 1. Installation
2259

@@ -133,3 +170,7 @@ We also provide the ability to use a per-vertex vector attribute as custom norma
133170
For more details check the official documentation [here](https://docs.blender.org/manual/en/latest/modeling/meshes/structure.html#modeling-meshes-normals-custom).
134171

135172
Note: the addon does not check if the selected attribute is suitable for normals or not. E.g. if the data type of the attribute is int instead of float, then Blender will simply give a runtime error.
173+
174+
#### 2.3.5 Advanced Settings
175+
176+
TODO

__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "Sequence Loader",
33
"description": "Loader for meshio supported mesh files/ simulation sequences",
44
"author": "Interactive Computer Graphics",
5-
"version": (1, 0),
5+
"version": (0, 1, 0),
66
"blender": (3, 1, 0),
77
"warning": "",
88
"support": "COMMUNITY",

0 commit comments

Comments
 (0)