source: subversion/applications/rendering/tilesAtHome_unstable/README @ 10417

Last change on this file since 10417 was 10417, checked in by bobkare, 11 years ago

Applied locale patch from Alfons Andorfer, as well as remove all mentions of InkscapeLocale?

File size: 1.9 KB
Line 
1== What this is about ==
2
3Original Author: Oliver J White (OJW)
4Maintainer: Dirk-Lueder Kreie (Deelkar) Sebastian Spaeth (spaetz)
5
6Purpose: Rendering maps with osmarender for the slippy map osmarender
7         layer, from live OSM data.
8
9On the Wiki: [[Tiles@home]]
10
11
12== Getting Started ==
13
14To use this copy the config template related to your OS to tilesAtHome.conf,
15then edit to set your preferred config options
16the username and password for tiles upload you can set in the file
17authentication.conf, for which a template also exists.
18
19
20== Running the client ==
21
22To start generating tiles from the server queue, run "tilesGen.pl loop".
23CAUTION: if your country uses a comma for decimal separator (like Germany)
24you need to set your decimal separator to "." instead.
25If you don't do this inkscape will complain and generate empty tiles.
26On linux and other unix-like systems this can be accomplished by setting
27i18n=1 in your tilesathome.conf .
28
29If you want to render a specific tile run tilesGen.pl with the xy option
30for example if you want to render the tile number x=2148 y=1332
31(zoom 12 is always the default and cannot be changed) you would run
32./tilesGen.pl xy 2148 1332
33
34To upload tiles use "tilesGen.pl upload" (this is only called automatically
35in loop mode).
36
37
38== Stopping the client ==
39
40The client will stop automatically after completing its job, unless in "loop"
41mode. Loop mode can be exited cleanly simply by creating a file called
42"stopfile.txt" in the tilesAtHome directory. Upon encountering this file the
43client will exit after it completes it's current job.
44
45Running "tilesGen.pl stop" will do this for you.
46
47
48== Troubleshooting ==
49
50Have a look at the OSM wiki:
51http://wiki.openstreetmap.org/index.php/Tiles%40home/Install_Guide
52
53
54== Other sources of information ==
55
56further reading: http://wiki.openstreetmap.org/index.php/Tiles%40home
57
58--
59
60## TODO: add more windows-specific info into this file ##
Note: See TracBrowser for help on using the repository browser.