https://github.com/pseudomanifold/polyhedron-3d-vertex-colours-plugin

An inkscape plugin for visualizing 3D polyhedra with vertex colours
https://github.com/pseudomanifold/polyhedron-3d-vertex-colours-plugin

inkscape inkscape-extension polyhedra svg wavefront-obj

Last synced: 29 days ago
JSON representation

An inkscape plugin for visualizing 3D polyhedra with vertex colours

• Host: GitHub
• URL: https://github.com/pseudomanifold/polyhedron-3d-vertex-colours-plugin
• Owner: Pseudomanifold
• License: other
• Created: 2017-11-09T17:16:16.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2018-03-05T21:15:49.000Z (almost 7 years ago)
• Last Synced: 2024-11-06T22:08:32.657Z (3 months ago)
• Topics: inkscape, inkscape-extension, polyhedra, svg, wavefront-obj
• Language: Python
• Size: 1.46 MB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# An Inkscape plugin for rendering 3D polyhedra with vertex colours

This plugin for the great [Inkscape vector graphics

program](https://inkscape.org) permits rendering 3D

polyhedra and meshes in [Wavefront OBJ

format](https://en.wikipedia.org/wiki/Wavefront_.obj_file). It is based

on a [similar

plugin](https://gitlab.com/inkscape/inkscape/blob/master/share/extensions/polyhedron_3d.py)

but offers the possibility to use *vertex colours* that are included in

the mesh. This makes the plugin suitable when additional information

such as vertex quality or

[curvature](https://en.wikipedia.org/wiki/Curvature) have to be

visualized.

The plugin was originally developed to obtain publication-quality vector

graphics for my dissertation. Please refer to [this blog

post](http://bastian.rieck.me/blog/posts/2018/3d_polyhedra) for more

details.

# Installation instructions

* Clone this repository

* Create the path `$HOME/.config/inkscape/extensions` if it does not

  already exist

* Close Inkscape

* Copy the files `polyhedron_3d_vertex_colours.py` and `polyhedron_3d_vertex_colours.inx` into this directory

* Reopen Inkscape

* Enjoy your new plugin, which you can find under *Extensions–Render*

For more information about installing extensions, please refer to the

[official Inkscape wiki](https://inkscape.org/en/gallery/%3Dextension).

# Usage

Call the plugin from the *Extensions* menu in Inkscape. A dialog should

pop up that permits you to enter information about the mesh:

![Main dialog window of the plugin](/Screenshots/Dialog.png?raw=true "Main dialog window of the plugin")

You can set different viewing options, such as the camera position,

including some transformations, and other styles as well—these are

taken as-is from the original plugin. It may be useful to experiment

with different settings for the stroke width of the input mesh, in

particular when mesh scales are small.

This is how the example data files should look like:

![A torus](/Screenshots/Torus.png?raw=true "A torus")

![Winged Victory](/Screenshots/Winged_Victory.png?raw=true "Winged Victory")

# Dependencies

The plugin is written in Python. Please install the following packages

using your package manager or `pip`, for example.

- `numpy`

- `python-lxml`

# License

Following the license conditions of the original plugin, this plugin

is also licensed under the GPL Version 2. Please see the file

[LICENSE.md](LICENSE.md) for more information.