From 7fac7bf5a62098016a8d85f49ee398d0966c7b00 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Fri, 23 Aug 2019 16:05:00 +1000 Subject: [PATCH] Created Recovering Drawings (markdown) --- Recovering-Drawings.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 Recovering-Drawings.md diff --git a/Recovering-Drawings.md b/Recovering-Drawings.md new file mode 100644 index 0000000..488a3fd --- /dev/null +++ b/Recovering-Drawings.md @@ -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. \ No newline at end of file