source: subversion/applications/rendering/tilesAtHome/README @ 5334

Last change on this file since 5334 was 5334, checked in by deelkar, 13 years ago

Add section about stopfile.txt

File size: 1.7 KB
Line 
1== What this is about ==
2
3Maintainer: Oliver J White (OJW) / Dirk-Lueder Kreie (Deelkar)
4
5Purpose: Rendering maps with osmarender for the slippy map osmarender
6         layer from live OSM data.
7
8On the Wiki: [[Tiles@home]]
9
10
11== Getting Started ==
12
13To use this copy the correct config template to tilesAtHome.conf then edit
14to set you username and password (both for osm data and for tiles upload)
15
16
17== Running the client ==
18
19to start generating tiles run "tilesGen.pl" CAUTION: if your country uses
20a comma for decimal separator (like Germany) you need to set LANG=C
21beforehand on unix-like systems. If you don't do this inkscape will complain
22and generate empty tiles.
23if you want to render a specific tile run tilesGen.pl with the xy option
24for example if you want to render the tile number x=2148 y=1332
25(zoom 12 is always the default and cannot be changed) you would run
26./tilesGen.pl xy 2148 1332
27
28to upload tiles use "upload.pl"
29
30(might need multiple calls to upload everything, depending on your setup)
31
32== Stopping the client ==
33
34the client will stop automatically after completing its job, unless in "loop"
35mode. This can be exited cleanly simply by creating a file called
36"stopfile.txt" in the tilesAtHome directory. Upon encountering this file the
37client will exit after it completes it's current job.
38
39== Troubleshooting ==
40
41if you get Errors about libGD run tilesGen_noGD.pl instead of tilesGen.pl
42this will be significantly slower, so you might want to investigate how to
43get libgd working with your perl installation.
44
45
46== Other sources of information ==
47
48further reading: http://wiki.openstreetmap.org/index.php/Tiles%40home
49
50--
51
52TODO: add windows-specific info into this file
Note: See TracBrowser for help on using the repository browser.