Implementation of a compression algorithm, which is lossless in terms of attributes and connectivity with optional quantization for attributes.
The Harry mesh compression algorithm has been presented and accepted at Vision, Modelling and Visualization 2017 in Bonn, Germany. For a reprint and further information, please refer to this page.
This repository also includes independent software that can be used in other projects:
- An (unofficial) reference implementation of the Cut-Border Machine (/cbm/) [Gumhold and Strasser, 1998]
- An implementation of a arithmetic coder and a cumulative frequency table (/arith/) [Moffat, Neal & Witten, 1998]
- A CLI argument parser and progress bar (args.h, progress.h)
- A PLY and OBJ loader with support of polygonal meshes with arbitrary attributes
git clone https://github.com/magcks/harry
cd harry
mkdir build && cd $_
cmake ..
make
- Compress a PLY file losslessly:
./harry in.ply out.hry - Compress a PLY file with 14 bit quantization:
./harry in.ply out.hry -l1 -q14 - Compress an OBJ file with 14 bit quantization for positions and 10 bits for normals:
./harry in.ply out.hry -l0 -q14 -l1 -q10 - Decompress to a PLY file:
./harry in.hry out.ply
Please note that PLY faces will be stored in attribute list 0 and vertices in attribute list 1. OBJ positions will be stored in attribute list 0, followed by texture coordinates and normals for each region.
Note that file formats and decoders with version 0.x are incompatible to each other, if their versions don't match. In future (1.x and greater) it is planned to allow forward and backward compatibility for all minor versions. To decode an old file, please checkout the correct decoder version.
Our program is licensed under the liberal BSD 3-Clause license included as LICENSE.md file.
If you decide to use our code or code based on this project in your application, please make sure to cite our VMV 2017 paper:
@inproceedings{10.2312/vmv.20171266,
title = {{Compression of Non-Manifold Polygonal Meshes Revisited}},
author = {von Buelow, Max and Guthe, Stefan and Goesele, Michael},
booktitle = {Vision, Modeling \& Visualization},
editor = {Hullin, Matthias and Klein, Reinhard and Schultz, Thomas and Yao, Angela},
year = {2017},
month = {sep},
publisher = {The Eurographics Association},
doi = {10.2312/vmv.20171266},
isbn = {978-3-03868-049-9},
location = {Bonn, Germany}
}
For any trouble with building, using or extending this software, please use the project's integrated issue tracker. We'll be happy to help you there or discuss feature requests.