Warp3DImageModule

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (RenderMinHeight, RenderMaxHeight from source code settings)
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Improved rendering of the OpenSim.ini map tiles is possible by using
+
[[Image:Warp3DImageModule-Example-OpenVue.jpg|256px|thumb|Example Warp3DImageModule map cell - OpenVue]]
"Warp3DImageModule" for the MapImageModule for any region server. The
+
[[Image:Warp3DImageModule-Example-OpenVCE.jpg|256px|thumb|Example Warp3DImageModule map cell - OpenVCE]]
Warp3dRender engine is included in the standard OpenSim build (from
+
[[Image:Comparemap3dmodule.png|256px|thumb|Comparative Map - Arya on FrancoGrid]]
version 0.7.1).
+
 
 +
'''Note: Unfortunately, warp maptile generation has been leaking very large amounts of memory and that is still the case at the present time (February 2014).  If you want to use this option, we strongly recommend that you only generate the image once at startup per simulator session.'''
 +
 
 +
Improved rendering of the OpenSim.ini map tiles is possible by using "Warp3DImageModule" (rather than the default "MapImageModule") for the MapImageModule for any region server. The Warp3dRender engine is included in the standard OpenSimulator build (from version 0.7.1).
  
 
  Include in OpenSim.ini [Startup] section:
 
  Include in OpenSim.ini [Startup] section:
Line 9: Line 12:
 
  DrawPrimOnMapTile = true
 
  DrawPrimOnMapTile = true
  
Then use requests of this form for each of your regions...
+
Optional settings to remove skyboxes or underwater items is to add these:
  
  http://regionserver:port/index.php?method=regionImageUUID
+
RenderMinHeight = -100 ; ranges from -100 upwards
 +
RenderMaxHeight = 4096  ; ranges from 100 to 4096 max.
 +
 
 +
 
 +
 
 +
You can use URL requests of this form for each of your regions...
 +
 
 +
http://regionserver:port/index.php?method=regionImageUUID
  
 
Get the region UUID for each region you want to get the map tile
 
Get the region UUID for each region you want to get the map tile
Line 17: Line 27:
 
using for that (usually the port for the first region in that
 
using for that (usually the port for the first region in that
 
instance). Note its NOT the Robust port if you are using a grid, its
 
instance). Note its NOT the Robust port if you are using a grid, its
the region server port. Then add the UUID directly with all hyphens
+
the region server port. Then add the UUID directly (with all hyphens
removed won the end of the URL root.
+
removed) on the end of the URL root.
  
 
* An example served live from the Openvue Grid is http://virtual.aiai.ed.ac.uk:9000/index.php?method=regionImage9c8b6f8f81784a6992dc9feba4646e6b
 
* An example served live from the Openvue Grid is http://virtual.aiai.ed.ac.uk:9000/index.php?method=regionImage9c8b6f8f81784a6992dc9feba4646e6b
  
 
* A combination to show a grid map is at http://virtual.aiai.ed.ac.uk:8002/resources/map.html
 
* A combination to show a grid map is at http://virtual.aiai.ed.ac.uk:8002/resources/map.html
 +
 +
The map cells are served at a resolution of 256x256.

Latest revision as of 10:31, 18 July 2019

Example Warp3DImageModule map cell - OpenVue
Example Warp3DImageModule map cell - OpenVCE
Comparative Map - Arya on FrancoGrid

Note: Unfortunately, warp maptile generation has been leaking very large amounts of memory and that is still the case at the present time (February 2014). If you want to use this option, we strongly recommend that you only generate the image once at startup per simulator session.

Improved rendering of the OpenSim.ini map tiles is possible by using "Warp3DImageModule" (rather than the default "MapImageModule") for the MapImageModule for any region server. The Warp3dRender engine is included in the standard OpenSimulator build (from version 0.7.1).

Include in OpenSim.ini [Startup] section:
MapImageModule = Warp3DImageModule
TextureOnMapTile = true
DrawPrimOnMapTile = true

Optional settings to remove skyboxes or underwater items is to add these:

RenderMinHeight = -100  ; ranges from -100 upwards RenderMaxHeight = 4096  ; ranges from 100 to 4096 max.


You can use URL requests of this form for each of your regions...

http://regionserver:port/index.php?method=regionImageUUID

Get the region UUID for each region you want to get the map tile for... then use the Opensim.exe running host name and port you are using for that (usually the port for the first region in that instance). Note its NOT the Robust port if you are using a grid, its the region server port. Then add the UUID directly (with all hyphens removed) on the end of the URL root.

The map cells are served at a resolution of 256x256.

Personal tools
General
About This Wiki