Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cansik/mesh-sequence-player

A simple mesh sequence player based on open3d.
https://github.com/cansik/mesh-sequence-player

Last synced: 29 days ago
JSON representation

A simple mesh sequence player based on open3d.

Host: GitHub
URL: https://github.com/cansik/mesh-sequence-player
Owner: cansik
License: mit
Created: 2021-04-12T08:54:53.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2022-09-01T12:09:01.000Z (about 2 years ago)
Last Synced: 2024-10-03T12:39:47.157Z (about 2 months ago)
Language: Python
Homepage:
Size: 599 KB
Stars: 33
Watchers: 5
Forks: 4
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Mesh Sequence Player
A simple mesh sequence player based on [open3d](https://github.com/intel-isl/Open3D).

![person](readme/person_square.gif)

It just loads all the mesh files and plays them back. The tool is intended for preview and visualisation purposes only. The software uses multi-processing to load meshes as fast as possible.

### Installation
To install the necessary packages, use the requirements file:

```
pip install git+https://github.com/cansik/[email protected]
```

### Usage
To display a sequence of mesh files just run the following command:

```
mesh-sequence-player folder_to_meshes
```

#### Rendering
It is also possible to render the individual frames into a mp4 file. Currently, only one mesh view will be rendered. If an `output` path is provided, the `no-loop` option is automatically set to `True` and rendering will run with `1000.0 FPS` to render as fast as possible.

```
mesh-sequence-player folder_to_meshes --output render.mp4
```

#### Lazy Loading
To create renderings of very large sequences it is possible to use the `--lazy` parameter to load the geometries every frame instead of all at once. This is only recommended for rendering and not realtime playback.

#### Safe Loading
By default, multi-processing is used to load the geometries. However, it is also possible to load the geometries safe (`--load-safe`) without a transmission format conversion (multi-threaded).

#### Textures
To load obj material files (with textures), it is now possible to use the `--post-process-mesh` command.

#### Help
Here is the full help file.

```
usage: mesh-sequence-player [-h] [-c CONFIG] [--format FORMAT]
[--post-process-mesh] [--fps FPS]
[--bitrate BITRATE] [--no-loop]
[--size width height] [--background r g b]
[--hidden] [--rotate ROTATE] [--output OUTPUT]
[--load-safe] [--lazy] [-p] [--debug]
input

Play mesh sequences directly in python.

positional arguments:
input Path to the mesh files (directory).

optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Configuration file path.
--format FORMAT File format (default *.obj).
--post-process-mesh Enable mesh post-processing (texture loading).
--fps FPS Framerate for playback.
--bitrate BITRATE Bitrate of the rendered mp4.
--no-loop Do not loop the sequence.
--size width height Size of the window.
--background r g b Background color (0-255).
--hidden Hide preview window.
--rotate ROTATE Horizontal axis rotation.
--output OUTPUT Output path to mp4 file. Sets no-loop to True.
--load-safe Load meshes the safe way and with texture (but
slower).
--lazy Load meshes one at a time (render large sequences).
-p, --pointcloud Load pointclouds (*.ply) instead of meshes.
--debug Show debug information.

Args that start with '--' (eg. --format) can also be set in a config file
(specified via -c). Config file syntax allows: key=value, flag=true,
stuff=[a,b,c] (for details, see syntax at https://goo.gl/R74nmi). If an arg is
specified in more than one place, then commandline values override config file
values which override defaults.
```