pTolemy3D Parameters

pTolemy3D can be configured using a wide range of parameters which includes: data server, initial camera configuration or the initial set of data to be shown. pTolemy3D is mainly designed to be used as an applet, those the required parameters can be configured using the param applet's tag.

  1. Map Server
  2. Layers
  3. Positioning
  4. Coordinate system
  5. JP2 Tiles
  6. Miscellaneous
  7. Plugins
  8. Example configuration: Inside APPLET tag
  9. Example configuration: Inside XML file


Map Server

  • Server: IP of the application server. Put without http and no final slash.
  • nMapDataSvr: Number of map servers.
  • MapDataSvri: IP of the map server i.
  • MServerKeyi: Key of the map server i.
  • MapJp2Storei: List of jp2 data folder on the map server i, separated with comma.
  • MapDemStorei: List of dem data folder on the map server i, separated with comma.

Layers

  • NumLayers: Number of data layers.
  • LayerWidth_i: Size of layer tiles.
  • LayerMIN_i: Layer visibility minimum altitude.
  • LayerMAX_i: Layer visibility maximum altitude.
  • LayerDIVIDER_i: Used to located the level tiles directory inside the server.

Positioning

  • Orientation: Initial position in the format: longitude,latitude,altitude,direction,pitch. Units are: DD,DD,METERS,RADIANS,RADIANS
  • FOLLOWDEM - Enable/Disable camera following globe elevation [0,1].

Coordinate system

  • CenterX: used as a reference to calculate x coordinate of tiles.
  • CenterY: used as a reference to calculate y coordinate of tiles.

JP2 Tiles

  • Area: Used to locate tiles inside the server (tile name formatting).
  • TILECOLOR: Default tile color, when jp2 is not yet downloaded.
  • FlightFrameDelay: JP2 tile downloader delayed when flying in auto-mode.

Miscellaneous

  • BGCOLOR: Background color formatted RGB: [0..255],[0..255],[0..255]
  • HORIZON: Horizon/Atmosphere altitude.
  • TIN: Enable/Disable TIN elevation model
  • SubTextures: Internal texture management behavior.

Plugins

  • NumPlugins: Number of plugins.
  • PluginType_i: Plugin i full class name.
  • PluginParam_i: Plugin i parameters.

Example configuration: Inside APPLET tag

        <applet code="com.sun.opengl.util.JOGLAppletLauncher"
                align="center" width="95%" height="65%"
                id="pTolemy3D" Name="pTolemy3D"
                codebase="./applet/"
                archive="./jogl.jar,./gluegen-rt.jar,./netscape.jar,./ptolemy3d.jar,./ptolemy3d-viewer.jar,./ptolemy3d-plugins.jar" MAYSCRIPT>
            <param name="subapplet.classname" VALUE="org.ptolemy3d.viewer.Ptolemy3DApplet">
            <param name="subapplet.displayname" VALUE="Ptolemy3D Applet">
            <param name="progressbar" value="true">
            <param name="noddraw.check" value="true">
            <param name="noddraw.check.silent" value="true">
            <param name="cache_archive" VALUE="jogl.jar,gluegen-rt.jar,netscape.jar,ptolemy3d.jar,ptolemy3d-viewer.jar,ptolemy3d-plugins.jar">
            <param name="cache_archive_ex" VALUE="jogl.jar;preload,gluegen-rt.jar;preload,netscape.jar;preload,ptolemy3d.jar;preload,ptolemy3d-viewer.jar;preload,ptolemy3d-plugins.jar;preload">

            <param name="Orientation" value="132730000,35010000,1260000,0,-30">
            <param name="CenterX" value="0">
            <param name="CenterY" value="0">
            <param name="DisplayRatio" value="1">

            <param name="Server" value="demo.spatialcloud.com">
            <param name="nMapDataSvr" value="1">
            <param name="MapDataSvr1" value="demo.spatialcloud.com">
            <param name="MapJp2Store1" value="/mnt/shizuoka/">
            <param name="MapDemStore1" value="/mnt/shizuoka/dem/">
            <param name="MUrlAppend1" value="&streamID=class64">
            <param name="MServerKey1" value="">

            <param name="TILECOLOR" value="47,47,86">
            <param name="Area" value="00">
            <param name="HORIZON" value="10000">
            <param name="FlightFrameDelay" value="200">
            <param name="TIN" value="1">
            <param name="FOLLOWDEM" value="0">

            <param name="Units" value="DD">
            <param name="BGCOLOR" value="0,0,0">
            <param name="SubTextures" value="1">

            <param name="NumLayers" value="6">

            <param name="LayerWidth_1" value="52428800">
            <param name="LayerDEM_1" value="9">
            <param name="LayerMIN_1" value="50000">
            <param name="LayerMAX_1" value="10000000">
            <param name="LayerDIVIDER_1" value="0">

            <param name="LayerWidth_2" value="6553600">
            <param name="LayerDEM_2" value="9">
            <param name="LayerMIN_2" value="10000">
            <param name="LayerMAX_2" value="5000000">
            <param name="LayerDIVIDER_2" value="0">

            <param name="LayerWidth_3" value="819200">
            <param name="LayerDEM_3" value="9">
            <param name="LayerMIN_3" value="2000">
            <param name="LayerMAX_3" value="500000">
            <param name="LayerDIVIDER_3" value="0">

            <param name="LayerWidth_4" value="102400">
            <param name="LayerDEM_4" value="9">
            <param name="LayerMIN_4" value="0">
            <param name="LayerMAX_4" value="50000">
            <param name="LayerDIVIDER_4" value="0">

            <param name="LayerWidth_5" value="12800">
            <param name="LayerDEM_5" value="9">
            <param name="LayerMIN_5" value="0">
            <param name="LayerMAX_5" value="10000">
            <param name="LayerDIVIDER_5" value="1000000">

            <param name="LayerWidth_6" value="1600">
            <param name="LayerDEM_6" value="9">
            <param name="LayerMIN_6" value="0">
            <param name="LayerMAX_6" value="2000">
            <param name="LayerDIVIDER_6" value="100000">

            <param name="NumPlugins" value="11">

            <param name="PluginType_1" value="org.ptolemy3d.plugin.POILabelPlugin">
            <param name="PluginParam_1" value="P -status 1 -jspurl /JS3DApi/servlet/JSpoi?&POOL=jsapps&CONDITIONS=&ID_COL=id&ICON_COL=group%5Fid&TEXT_COL=name&GEOM_COL=the%5Fgeom&USER=1&UID_COL=user_id -layer shizuoka_points -iconquerywidth 1000000 -numicons 7 -iconprefix /JetStreamLib/icons/shizuoka/icon_1_ -mindistance 65 -encoding UTF-8 -bgcolor 240:240:240:0 -fontcolor 255:0:0:255 -bordercolor 100:100:250:0 -minalt 0 -maxalt 47200 -position RM -pinpoint 0 ">

            <param name="PluginType_2" value="org.ptolemy3d.plugin.XVRMLPlugin">
            <param name="PluginParam_2" value="P -status 1 -jspurl /JS3DApi/servlet/JSxvrml?POOL=jsapps&USER=1&UID_COL=user_id&CONDITIONS=&ID_COL=id&GEOM_COL=the_geom&XVRML_COL=x3d_id&TF_COL=transform -x3durl /JS3DApi/servlet/JSgetXvrmlObj?STORE=%2Fusr%2Flocal%2Fapache%2Fhtdocs%2FJetStreamLib%2Fx3d%2Fshizuoka%2Fguest%2F&RSLV=%2FJetStreamLib%2Fx3d%2Fshizuoka%2Fguest%2F&NAME=shizuoka_xobj_1_ -layer shizuoka_x3dpt -querywidth 1000000 -displayradius 500000 -maxalt 47200 -minalt 0 -maxobjects 200">

            <param name="PluginType_3" value="org.ptolemy3d.plugin.GisToolPlugin">
            <param name="PluginParam_3" value="1">

            <param name="PluginType_4" value="org.ptolemy3d.plugin.POILabelPlugin">
            <param name="PluginParam_4" value="P -status 0 -jspurl /JS3DApi/servlet/JSpoi?&POOL=jsapps&CONDITIONS=&ID_COL=gid&ICON_COL=icon%5Fid&TEXT_COL=country%5Fj&GEOM_COL=the%5Fgeom -layer world_country -iconquerywidth 30000000 -numicons 1 -iconprefix /JetStreamLib/common/earth/icon/country -mindistance 50 -encoding UTF-8 -bgcolor 108:148:118:0 -fontcolor 240:50:190:255 -bordercolor 83:119:91:0 -minalt 100000 -maxalt 10000000">

            <param name="PluginType_5" value="org.ptolemy3d.plugin.POILabelPlugin">
            <param name="PluginParam_5" value="P -status 0 -jspurl /JS3DApi/servlet/JSpoi?&POOL=jsapps&CONDITIONS=&ID_COL=gid&ICON_COL=icon%5Fid&TEXT_COL=text%5Fj&GEOM_COL=the%5Fgeom -layer world_seas -iconquerywidth 45000000 -numicons 1 -iconprefix /JetStreamLib/common/earth/icon/sea -mindistance 60 -encoding UTF-8 -bgcolor 75:139:255 -fontcolor 10:60:95 -bordercolor 95:159:255 -minalt 100000 -maxalt 10000000">

            <param name="PluginType_6" value="org.ptolemy3d.plugin.POILabelPlugin">
            <param name="PluginParam_6" value="P -status 0 -jspurl /JS3DApi/servlet/JSpoi?&POOL=jsapps&CONDITIONS=&ID_COL=gid&ICON_COL=icon%5Fid&TEXT_COL=text%5Fj&GEOM_COL=the%5Fgeom -layer world_islands -iconquerywidth 45000000 -numicons 1 -iconprefix /JetStreamLib/common/earth/icon/island -mindistance 60 -encoding UTF-8 -bgcolor 250:250:250 -fontcolor 10:60:95 -bordercolor 230:230:240 -minalt 100000 -maxalt 10000000">

            <param name="PluginType_7" value="org.ptolemy3d.plugin.POILabelPlugin">
            <param name="PluginParam_7" value="P -status 0 -jspurl /JS3DApi/servlet/JSpoi?&POOL=jsapps&CONDITIONS=&ID_COL=gid&ICON_COL=icon%5Fid&TEXT_COL=city%5Fj&GEOM_COL=the%5Fgeom -layer world_cities -iconquerywidth 5000000 -numicons 7 -iconprefix /JetStreamLib/common/earth/icon/city -mindistance 70 -encoding UTF-8 -bgcolor 210:210:210 -fontcolor 80:80:80 -bordercolor 230:230:240 -minalt 2000 -maxalt 1000000">

            <param name="PluginType_8" value="org.ptolemy3d.plugin.VectorPlugin">
            <param name="PluginParam_8" value="P -status 0 -jspurl /JS3DApi/servlet/JSvector?&POOL=jsapps&CONDITIONS=&ID_COL=gid&GEOM_COL=the%5Fgeom -layer country_poly -querywidth 40000000 -displaywidth 10000000 -maxalt 10000000 -minalt 50000 -vectorraise 100 -stroke 240:250:30 -linew 2">

            <param name="PluginType_9" value="org.ptolemy3d.plugin.VectorPlugin">
            <param name="PluginParam_9" value="P -status 0 -jspurl /JS3DApi/servlet/JSvector?&POOL=jsapps&CONDITIONS=&ID_COL=gid&GEOM_COL=the%5Fgeom -layer shimodaroad -querywidth 30000 -displaywidth 15000 -maxalt 10000 -vectorraise 2 -stroke 70:220:80 -linew 2 -interpolation 100">

            <param name="PluginType_10" value="org.ptolemy3d.plugin.BuildingPlugin">
            <param name="PluginParam_10" value="0,1,/JS3DApi/servlet/JSbuilding?POOL=jsapps&CONDITIONS=&ID_COL=gid&GEOM_COL=the%5Fgeom&HT_COL=roofht&WALL_ID_COL=wallid,shimodatatemono,30000,15000,10000,8,/JetStreamLib/walls/dm2_">

            <param name="PluginType_11" value="org.ptolemy3d.plugin.HudPlugin">
            <param name="PluginParam_11" value="-hudPrefix1 Center: -hudPrefix2 Streaming%20Speed: -hudPrefix3 Altitude: -hudSuffix3 meters">

        </applet>

Example configuration: Inside XML file

        <entity>
            <Orientation>132730000,35010000,1260000,0,-30</Orientation>
            <CenterX>0</CenterX>
            <CenterY>0</CenterY>
            <DisplayRatio>1</DisplayRatio>

            <Server>demo.spatialcloud.com</Server>
            <nMapDataSvr>1</nMapDataSvr>
            <MapDataSvr1>demo.spatialcloud.com</MapDataSvr1>
            <MapJp2Store1>/mnt/shizuoka/</MapJp2Store1>
            <MapDemStore1>/mnt/shizuoka/dem/</MapDemStore1>
            <MUrlAppend1>&amp;streamID=class64</MUrlAppend1>
            <MServerKey1></MServerKey1>

            <TILECOLOR>47,47,86</TILECOLOR>
            <Area>00</Area>
            <HORIZON>10000</HORIZON>
            <FlightFrameDelay>200</FlightFrameDelay>
            <TIN>1</TIN>
            <FOLLOWDEM>0</FOLLOWDEM>

            <Units>DD</Units>
            <BGCOLOR>0,0,0</BGCOLOR>
            <SubTextures>1</SubTextures>

            <NumLayers>6</NumLayers>

            <LayerWidth_1>52428800</LayerWidth_1>
            <LayerDEM_1>9</LayerDEM_1>
            <LayerMIN_1>50000</LayerMIN_1>
            <LayerMAX_1>10000000</LayerMAX_1>
            <LayerDIVIDER_1>0</LayerDIVIDER_1>

            <LayerWidth_2>6553600</LayerWidth_2>
            <LayerDEM_2>9</LayerDEM_2>
            <LayerMIN_2>10000</LayerMIN_2>
            <LayerMAX_2>5000000</LayerMAX_2>
            <LayerDIVIDER_2>0</LayerDIVIDER_2>

            <LayerWidth_3>819200</LayerWidth_3>
            <LayerDEM_3>9</LayerDEM_3>
            <LayerMIN_3>2000</LayerMIN_3>
            <LayerMAX_3>500000</LayerMAX_3>
            <LayerDIVIDER_3>0</LayerDIVIDER_3>
                        
            <LayerWidth_4>102400</LayerWidth_4>
            <LayerDEM_4>9</LayerDEM_4>
            <LayerMIN_4>0</LayerMIN_4>
            <LayerMAX_4>50000</LayerMAX_4>
            <LayerDIVIDER_4>0</LayerDIVIDER_4>

            <LayerWidth_5>12800</LayerWidth_5>
            <LayerDEM_5>9</LayerDEM_5>
            <LayerMIN_5>0</LayerMIN_5>
            <LayerMAX_5>10000</LayerMAX_5>
            <LayerDIVIDER_5>1000000</LayerDIVIDER_5>

            <LayerWidth_6>1600</LayerWidth_6>
            <LayerDEM_6>9</LayerDEM_6>
            <LayerMIN_6>0</LayerMIN_6>
            <LayerMAX_6>2000</LayerMAX_6>
            <LayerDIVIDER_6>100000</LayerDIVIDER_6>

            <NumPlugins>11</NumPlugins>

            <PluginType_1>org.ptolemy3d.plugin.POILabelPlugin</PluginType_1>
            <PluginParam_1>P -status 1 -jspurl /JS3DApi/servlet/JSpoi?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=id&amp;ICON_COL=group%5Fid&amp;TEXT_COL=name&amp;GEOM_COL=the%5Fgeom&amp;USER=1&amp;UID_COL=user_id -layer shizuoka_points -iconquerywidth 1000000 -numicons 7 -iconprefix /JetStreamLib/icons/shizuoka/icon_1_ -mindistance 65 -encoding UTF-8 -bgcolor 240:240:240:0 -fontcolor 255:0:0:255 -bordercolor 100:100:250:0 -minalt 0 -maxalt 47200 -position RM -pinpoint 0 </PluginParam_1>

            <PluginType_2>org.ptolemy3d.plugin.XVRMLPlugin</PluginType_2>
            <PluginParam_2>P -status 1 -jspurl /JS3DApi/servlet/JSxvrml?POOL=jsapps&amp;USER=1&amp;UID_COL=user_id&amp;CONDITIONS=&amp;ID_COL=id&amp;GEOM_COL=the_geom&amp;XVRML_COL=x3d_id&amp;TF_COL=transform -x3durl /JS3DApi/servlet/JSgetXvrmlObj?STORE=%2Fusr%2Flocal%2Fapache%2Fhtdocs%2FJetStreamLib%2Fx3d%2Fshizuoka%2Fguest%2F&amp;RSLV=%2FJetStreamLib%2Fx3d%2Fshizuoka%2Fguest%2F&amp;NAME=shizuoka_xobj_1_ -layer shizuoka_x3dpt -querywidth 1000000 -displayradius 500000 -maxalt 47200 -minalt 0 -maxobjects 200</PluginParam_2>

            <PluginType_3>org.ptolemy3d.plugin.GisToolPlugin</PluginType_3>
            <PluginParam_3>1</PluginParam_3>

            <PluginType_4>org.ptolemy3d.plugin.POILabelPlugin</PluginType_4>
            <PluginParam_4>P -status 0 -jspurl /JS3DApi/servlet/JSpoi?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;ICON_COL=icon%5Fid&amp;TEXT_COL=country%5Fj&amp;GEOM_COL=the%5Fgeom -layer world_country -iconquerywidth 30000000 -numicons 1 -iconprefix /JetStreamLib/common/earth/icon/country -mindistance 50 -encoding UTF-8 -bgcolor 108:148:118:0 -fontcolor 240:50:190:255 -bordercolor 83:119:91:0 -minalt 100000 -maxalt 10000000</PluginParam_4>

            <PluginType_5>org.ptolemy3d.plugin.POILabelPlugin</PluginType_5>
            <PluginParam_5>P -status 0 -jspurl /JS3DApi/servlet/JSpoi?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;ICON_COL=icon%5Fid&amp;TEXT_COL=text%5Fj&amp;GEOM_COL=the%5Fgeom -layer world_seas -iconquerywidth 45000000 -numicons 1 -iconprefix /JetStreamLib/common/earth/icon/sea -mindistance 60 -encoding UTF-8 -bgcolor 75:139:255 -fontcolor 10:60:95 -bordercolor 95:159:255 -minalt 100000 -maxalt 10000000</PluginParam_5>

            <PluginType_6>org.ptolemy3d.plugin.POILabelPlugin</PluginType_6>
            <PluginParam_6>P -status 0 -jspurl /JS3DApi/servlet/JSpoi?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;ICON_COL=icon%5Fid&amp;TEXT_COL=text%5Fj&amp;GEOM_COL=the%5Fgeom -layer world_islands -iconquerywidth 45000000 -numicons 1 -iconprefix /JetStreamLib/common/earth/icon/island -mindistance 60 -encoding UTF-8 -bgcolor 250:250:250 -fontcolor 10:60:95 -bordercolor 230:230:240 -minalt 100000 -maxalt 10000000</PluginParam_6>

            <PluginType_7>org.ptolemy3d.plugin.POILabelPlugin</PluginType_7>
            <PluginParam_7>P -status 0 -jspurl /JS3DApi/servlet/JSpoi?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;ICON_COL=icon%5Fid&amp;TEXT_COL=city%5Fj&amp;GEOM_COL=the%5Fgeom -layer world_cities -iconquerywidth 5000000 -numicons 7 -iconprefix /JetStreamLib/common/earth/icon/city -mindistance 70 -encoding UTF-8 -bgcolor 210:210:210 -fontcolor 80:80:80 -bordercolor 230:230:240 -minalt 2000 -maxalt 1000000</PluginParam_7>

            <PluginType_8>org.ptolemy3d.plugin.VectorPlugin</PluginType_8>
            <PluginParam_8>P -status 0 -jspurl /JS3DApi/servlet/JSvector?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;GEOM_COL=the%5Fgeom -layer country_poly -querywidth 40000000 -displaywidth 10000000 -maxalt 10000000 -minalt 50000 -vectorraise 100 -stroke 240:250:30 -linew 2</PluginParam_8>

            <PluginType_9>org.ptolemy3d.plugin.VectorPlugin</PluginType_9>
            <PluginParam_9>P -status 0 -jspurl /JS3DApi/servlet/JSvector?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;GEOM_COL=the%5Fgeom -layer shimodaroad -querywidth 30000 -displaywidth 15000 -maxalt 10000 -vectorraise 2 -stroke 70:220:80 -linew 2 -interpolation 100</PluginParam_9>

            <PluginType_10>org.ptolemy3d.plugin.BuildingPlugin</PluginType_10>
            <PluginParam_10>0,1,/JS3DApi/servlet/JSbuilding?POOL=jsapps&amp;CONDITIONS=&amp;ID_COL=gid&amp;GEOM_COL=the%5Fgeom&amp;HT_COL=roofht&amp;WALL_ID_COL=wallid,shimodatatemono,30000,15000,10000,8,/JetStreamLib/walls/dm2_</PluginParam_10>

            <PluginType_11>org.ptolemy3d.plugin.HudPlugin</PluginType_11>
            <PluginParam_11>-hudPrefix1 Center: -hudPrefix2 Streaming%20Speed: -hudPrefix3 Altitude: -hudSuffix3 meters</PluginParam_11>

        </entity>