From 82864a1622c668410beeae716dbcca8c8deed7ca Mon Sep 17 00:00:00 2001 From: Andrew Brown Date: Thu, 24 Nov 2011 23:30:33 -0500 Subject: [PATCH] added an faq entry on copying tiles to another destionation also added a link to the faq under help on the index page also clarified the faq entry about adding new features or changing texture packs also fixed a typo --- docs/faq.rst | 38 ++++++++++++++++++++++++++++++++++--- docs/index.rst | 5 ++++- overviewer_core/quadtree.py | 2 +- 3 files changed, 40 insertions(+), 5 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index 213d1d9..a034821 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -8,6 +8,36 @@ Frequently Asked Questions General Questions ================= +When my map expands, I see remnants of another zoom level +--------------------------------------------------------- + +When your map expands ("Your map seems to have expanded beyond its previous +bounds") you may see tiles at a zoom level that shouldn't be there, usually +around the borders. This is probably not a bug, but is typically caused by +copying the map tiles from their render destination to another location (such as +a web server). + +When you're copying the rendered map, you need to be sure files that *don't* +exist in the source are *deleted* in the destination. + +Explanation: When Overviewer re-arranges tiles for another zoom level, it moves +some tiles tiles at a particular zoom level and placed them at a higher zoom +level. The tiles that used to be at that zoom level should no longer exist +there, but if you're copying tiles, there is no mechanism to *delete* those +files at the destination. + +If that explanation doesn't make full sense, then just know that you must do one +of the following: + +* Render the tiles directly to the destination + +* Copy the tiles from the render destination in a way that deletes extra files, + such as using ``rsync`` with ``--delete`` + +* Erase and re-copy the files at the final destination when the map expands. + Map expansions double the width and height of the map, so you will eventually + hit a map size that is unlikely to need another level. + The full map doesn't display even when fully zoomed out! -------------------------------------------------------- @@ -16,11 +46,13 @@ commandline or in settings.py? If so, try removing it, or increasing the value you set. It's quite likely you don't need it at all. See the documentation for the :option:`zoom <-z>` option. -You've added a few feature, but it's not showing up on my map! --------------------------------------------------------------- +You've added a few feature or changed textures, but it's not showing up on my map! +---------------------------------------------------------------------------------- Some new features will only show up in newly-rendered areas. Use the -:option:`--forcerender` option to update the entire map. +:option:`--forcerender` option to update the entire map. If you have a really +large map and don't want to re-render everything, take a look at +the :option:`--stochastic-render` option. How do I use this on CentOS 5? ------------------------------ diff --git a/docs/index.rst b/docs/index.rst index b471a14..853f5e4 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -86,7 +86,10 @@ Help **IF YOU NEED HELP COMPILING OR RUNNING THE OVERVIEWER** feel free to chat with us live in IRC: #overviewer on Freenode. There's usually someone on there that can help you out. Not familiar with IRC? `Use the web client -`_. +`_. (If there's no response, +try a different time of day; we have to sleep sometime) + +Also check our :doc:`Frequently Asked Questions ` page. If you think you've found a bug or other issue, file an issue on our `Issue Tracker `_. Filing or diff --git a/overviewer_core/quadtree.py b/overviewer_core/quadtree.py index a8da76d..5f2aa27 100644 --- a/overviewer_core/quadtree.py +++ b/overviewer_core/quadtree.py @@ -196,7 +196,7 @@ class QuadtreeGen(object): curdepth = self._get_cur_depth() if curdepth != -1: if self.p > curdepth: - logging.warning("Your map seemes to have expanded beyond its previous bounds.") + logging.warning("Your map seems to have expanded beyond its previous bounds.") logging.warning( "Doing some tile re-arrangements... just a sec...") for _ in xrange(self.p-curdepth): self._increase_depth()