Map - Revision history

Acryline at 10:12, 4 March 2015

2015-03-04T10:12:45Z

2014-06-26T19:17:07Z

‎Viewer 2 and later

2014-06-26T19:09:31Z

‎General Configuration

2014-06-26T19:09:19Z

‎Manual regeneration

2014-06-26T19:08:43Z

‎Maptile generation

2014-06-26T18:59:03Z

Add stronger warning about memory leaking with Warp3DImageModule

2013-10-29T09:01:57Z

‎Warp3DImageModule: Amended {Startup] section to [Map] for 0.7.56 onwards

2013-10-29T09:01:24Z

‎MapImageModule: Amended [Startup] section to [map] for 0.7.5 onwards

2013-10-29T09:00:45Z

‎Viewer 1: amended section for map parameters from [Startup] to [Map] as at -00.7.5.

2013-02-24T01:54:23Z

added quicklinks

@@ Line 106: / Line 106: @@
   TilesStoragePath = "maptiles"
-in Robust.ini or StandaloneCommon.ini.  The default, as seen here, is bin/maptiles.
+in Robust.ini or StandaloneCommon.ini.  The default, as seen here, is bin/maptiles.  If you look in this directory, you will see all the generated and uploaded jpg files.
 ==Maptile generation==

@@ Line 130: / Line 130: @@
 See [[Warp3DImageModule]] for some more information.
-=== General Configuration===
+=== General configuration===
 Apart from some specific [[Warp3DImageModule]] parameters, the parameters for controlling the specifics of maptile generation are in the [Map] section of OpenSim.ini.  The parameters need to be documented here, but in the meantime, please see the OpenSim.ini.example file for more details.

@@ Line 134: / Line 134: @@
 === Manual regeneration===
-From OpenSimulator 0.8 onwards, one can also manually force maptile regeneration with the console command
+Normally, one would generate maptiles at startup and/or at regular intervals.  From OpenSimulator 0.8 onwards, one can also manually force maptile regeneration with the console command
   # generate map

@@ Line 109: / Line 109: @@
 ==Maptile generation==
-Even though viewer 1 and viewer 2 and later consume and request maptiles rather differently, the maptile images are still created by common image generation code.  Currently in OpenSimulator there are two map image generation choices.
+Even though viewer 1 and viewer 2 and later consume and request maptiles rather differently, the maptile images are still created by common image generation code.
-===MapImageModule===
+===Generators===
 This is the older map image module.  Set
@@ Line 119: / Line 122: @@
 to use this.
-===Warp3DImageModule===
+====Warp3DImageModule====
 This is a newer image module that produces higher quality map images but leaks memory like it's going out of fashion.  This will be addressed in a future OpenSimulator release (after 0.8).  In the mean time, please use this to generate map tiles once a session, at most (e.g. at startup).  For this module, set
@@ Line 126: / Line 129: @@
 See [[Warp3DImageModule]] for some more information.
 =Code=

@@ Line 122: / Line 122: @@
 This is a newer image module that produces higher quality map images but has been associated with memory leaks in the past (though efforts have and are being made to address this).  For this module, set
-  [Startup]
+  [Map]
   MapImageModule = Warp3DImageModule

@@ Line 24: / Line 24: @@
 For viewer 1, maptiles were generated and stored in the asset service, with the asset UUID recorded in the regionMapTexture column in the regions table by the grid service.  On opening the main map, the viewer would send a MapBlockRequest UDP message requesting the map blocks for a certain range.  The simulator would interpret this message, fetch the appropriate map texture UUIDs by requesting the region information from the grid service (and parcel image if available, though we won't get into that here) and return them to the viewer.  The viewer would then request the textures identified by the UUIDs as required.
-The world map is activated by default for viewer 1 and associated TPVs with the following settings in OpenSimDefaults.ini.
+The world map is activated by default for viewer 1 and associated TPVs with the following settings in OpenSimDefaults.ini and which can be overridden in your own OpenSim.ini.
-  [Startup]
+  [Map]
   WorldMapModule = WorldMap
   MapImageModule = MapImagemodule
@@ Line 32: / Line 32: @@
 You can also set
-  [Startup]
+  [Map]
   GenerateMapTiles = true|false
   MaptileRefresh = <seconds>