Created Recovering Drawings (markdown)

Peter Hutterer 2019-08-23 16:05:00 +10:00
parent 049f62ba52
commit 7fac7bf5a6
1 changed files with 18 additions and 0 deletions

18
Recovering-Drawings.md Normal file

@ -0,0 +1,18 @@
This page is for users that had Tuhi crash **after** a drawing was successfully downloaded. The usual cause for the crash is that the data parsing code does not understand some component (this code is largely reverse-engineered after all).
Where Tuhi crashes before or during downloading a drawing, the drawing will remain on the device and the steps below are not necessary.
A requirement for the below to work is that the parsing bug in Tuhi is fixed, otherwise it will merely crash again.
Tuhi provides a converter tool that convers the raw data received from the device to an SVG drawing. It must be run from the git repository:
```
$ git clone https://github.com/tuhiproject/tuhi
$ cd tuhi
$ ./tools/raw-log-converter --all --tablet-model=spark # use your tablet model here
```
Using `--all` is the sledgehammer approach. It will go through `$XDG_DATA_HOME/tuhi` and search for **any** log file and convert that file to an SVG. All SVGs are placed in the current directory and their name contains a timestamp to make it easier to identify the drawing.
Where the converter is unable to convert the drawing, use `--verbose` to identify the issue better and attach the output to a [bug report](Reporting-Bugs).
Use `raw-log-converter --help` to see more options available.