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
This commit is contained in:
38
docs/faq.rst
38
docs/faq.rst
@@ -8,6 +8,36 @@ Frequently Asked Questions
|
|||||||
General 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!
|
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
|
you set. It's quite likely you don't need it at all. See the documentation for
|
||||||
the :option:`zoom <-z>` option.
|
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
|
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?
|
How do I use this on CentOS 5?
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|||||||
@@ -86,7 +86,10 @@ Help
|
|||||||
**IF YOU NEED HELP COMPILING OR RUNNING THE OVERVIEWER** feel free to chat with
|
**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
|
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
|
can help you out. Not familiar with IRC? `Use the web client
|
||||||
<http://webchat.freenode.net/?channels=overviewer>`_.
|
<http://webchat.freenode.net/?channels=overviewer>`_. (If there's no response,
|
||||||
|
try a different time of day; we have to sleep sometime)
|
||||||
|
|
||||||
|
Also check our :doc:`Frequently Asked Questions <faq>` page.
|
||||||
|
|
||||||
If you think you've found a bug or other issue, file an issue on our `Issue
|
If you think you've found a bug or other issue, file an issue on our `Issue
|
||||||
Tracker <https://github.com/overviewer/Minecraft-Overviewer/issues>`_. Filing or
|
Tracker <https://github.com/overviewer/Minecraft-Overviewer/issues>`_. Filing or
|
||||||
|
|||||||
@@ -196,7 +196,7 @@ class QuadtreeGen(object):
|
|||||||
curdepth = self._get_cur_depth()
|
curdepth = self._get_cur_depth()
|
||||||
if curdepth != -1:
|
if curdepth != -1:
|
||||||
if self.p > curdepth:
|
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...")
|
logging.warning( "Doing some tile re-arrangements... just a sec...")
|
||||||
for _ in xrange(self.p-curdepth):
|
for _ in xrange(self.p-curdepth):
|
||||||
self._increase_depth()
|
self._increase_depth()
|
||||||
|
|||||||
Reference in New Issue
Block a user