From 4816711c179aa8c3c5f682d5b62b71b5fe99fe16 Mon Sep 17 00:00:00 2001 From: Matthias Kolja Miehl Date: Thu, 13 Oct 2016 00:28:53 +0200 Subject: [PATCH] readme: add missing information --- README.mkd | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ window.png | Bin 0 -> 6310 bytes 2 files changed, 49 insertions(+) create mode 100644 window.png diff --git a/README.mkd b/README.mkd index 82e85b1..5db37a8 100644 --- a/README.mkd +++ b/README.mkd @@ -3,6 +3,52 @@ simple Python script for generating an analogue clock timer template given two circle diameters and the number of hours on the dial +## What it does + +It simplifies the creation of geometrically accurate timer designs by providing you with a template that marks all relevant positions. To generate the template, you have to provide the circle diameters of day and hour circles as well as the number of hours on the dial---probably 12 or 24. If you then execute the script, you will get something like this: + +![example window](window.png "example window") + + +### Key Features + +* *Freely customizable design* +The template can be tailored to your exact needs. Merely set the diameters for the day and hour circles as well as the number of overall hour circles on the dial. + +* *Additional half-hour markings* +Drawing a 24 hour timer will result in a total of 48 markings (24 for each hour and another 24 for each half-hour) providing you with additional positional information. + +* *Vector output* +The output is automatically saved to a vector file format, currently a postscript document. + +* *High precision* +In order to position elements with high accuracy, a large integer scaling factor can be chosen to create a larger image with higher resolution. + + +## Getting started + +Install the necessary modules and run the script: + + # sudo apt-get install python-tk python-sympy + + $ ./timer_template.py + +It requires Python v2.7 or later. + +In order to modify the default settings, open the script and change the variable values listed in the section called *settings*. + + +## Contributing + +This script currently provides minimal functionality and is suitable for production use. Have a look at the [open issues][issues] for ideas on how to contribute. Furthermore, if you have a neat idea for a new feature or some other improvement, I am looking forward to recieving a pull request from you: + +1. [Fork it][fork] +2. Create your feature branch: `git checkout -b my-new-feature` +3. Commit all your changes: `git commit -am 'add some feature'` +4. Push to your feature branch: `git push origin my-new-feature` +5. Submit a [pull request][pr] + + ## License **GNU General Public License v3.0** @@ -18,5 +64,8 @@ You can get the newest version from the [project's website][project-website]. +[issues]: https://github.com/makomi/timer_template/issues +[fork]: https://help.github.com/articles/fork-a-repo/ +[pr]: https://help.github.com/articles/creating-a-pull-request/ [license-file]: LICENSE [project-website]: http://github.com/makomi/timer_template/ diff --git a/window.png b/window.png new file mode 100644 index 0000000000000000000000000000000000000000..a48f4661af7c484dbf8637b66548e22d96e3c4d1 GIT binary patch literal 6310 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 literal 0 HcmV?d00001