Boundary Format

From World Wind Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 22:51, 23 March 2005 (edit)
5of0 (Talk | contribs)
(A work in progress)
← Previous diff
Revision as of 00:22, 25 March 2005 (edit) (undo)
5of0 (Talk | contribs)
(Finished translation - somewhat rough, but OK.)
Next diff →
Line 4: Line 4:
The pkg and idx files are used to define the pathlist (in 3D). The pkg and idx files are used to define the pathlist (in 3D).
-Le pr�sent document pr�sente les formats binaires de ces fichiers ainsi que les documents xml associ�s.+This document details the binary formats of these files and thus the associated XML files.
-Les types utilis�s sont: 
- int32 entier sur 32 bits+The types used are:
- int64 entier sur 64 bits+ 
- smallint entier sur 16 bits+ int32 32-bit integer
 + int64 64-bit integer
 + smallint 16-bit integer
- Single 1.5 x 10^-45 .. 3.4 x 10^38 r�el sur 4 octets+ Single 1.5 x 10^-45 .. 3.4 x 10^38 4-byte real number
- Double 5.0 x 10^-324 .. 1.7 x 10^308 r�el sur 8 octets+ Double 5.0 x 10^-324 .. 1.7 x 10^308 8-byte real number
- Pstring cha�ne : un octet suivi des caract�res+ Pstring string : A byte followed by characters
-Les altitudes sont importantes, elles permettent de faire � flotter � les chemins au dessus de la surface, sinon ils disparaissent avec le relief.+The altitudes are important, they allow the paths to float above the terrain, otherwise the disappear within the mountains.
-==Format wwb==+==wwb Format==
-Le fichier commence par un entier sur 32 bits contenant le nombre d�entr�es dans le fichier. La suite est constitu�e de la succession des entr�es constitu�es pour chacune d�entre elles d�une latitude suivie d�une longitude sur un float.+
- int32 nombre de couple (latitude, longitude) dans le fichier+The file begins with a 32-bit integer containing the number of entries in the file. The file continues with a series of entries consisting of a float latitude and float longitude.
 + 
 + int32 number of pairs (latitude, longitude) in the file
- // entr�e 1+ // entry 1
single latitude single latitude
single longitude single longitude
- // entr�e 2+ // entry 2
single latitude single latitude
single longitude single longitude
- 
-==Format IDX== 
-Le fichier commence par le nombre de fichier wwb associ� sur un entier 32 bits. On trouve ensuite les entr�es pour chaque fichier wwb. Chaque entr�e est constitu�e d�une chaine pascal (un octet de longueur suivi des caract�res de la chaine), puis les limites ouest, sud, est et nord du chemin, puis l�offset sur 64 bits des donn�es correspondantes dans le fichier pkg (l�offset pointe sur le nombre d�entr�e (lat, long, h) voir ci dessous. 
- int32 nombre de fichier wwb = nombre de groupe de donnees dans pkg+==IDX Format==
 +The file begins with the number of wwb files associated in a 32-bit integer. Next is an entry for each wwb file. Each entry consists of a string, the west, south, east, and north limits in a double, and a 64-bit integer for the offset of the data in the pkg file.
 + 
 + int32 Number of wwb files = Number of groups in this package
- // fichier wwb 1 (offset wwb 1)+ // wwb file 1 (wwb offset 1)
- PString nom d'un fichier wwb, un octet de longueur suivi des carract�res de la chaine+ PString name of a wwb file, a string
- double ouest+ double west
- double sud+ double south
- double est+ double east
- double nord+ double north
- Int64 offset wwb 1 = offset des data dans fichier pkg+ Int64 offset wwb 1 = offset of data in pkg file
- // fichier wwb 2 (offset wwb 2)+ // wwb file 2 (wwb offset 2)
- PString nom d'un fichier wwb, un octet de longueur suivi des char de la chaine+ PString name of a wwb file, a string
- double ouest+ double west
- double sud+ double south
- double est+ double east
- double nord+ double north
- Int64 offset wwb 2 = offset des data dans fichier pkg+ Int64 offset wwb 1 = offset of data in pkg file
- // fichier wwb 3 (offset wwb 3)+ // wwb file 3 (wwb offset 3)
... ...
-==format pkg==+==pkg format==
-Le fichier contient la liste des entr�es contenant les informations de coordonn�es de chacun des fichier wwb associ�s. Chaque description commence par un entier sur 32 bits indiquant le nombre d�entr�es dans la section, suivi du nombre d��l�ments par entr�e (� priori 3 pour latitude, longitude et altitude). On trouve ensuite la liste des entr�es (lat, long, h).+The file contains a list of the entries containing the coordinates of each of the associated wwb files. Every description starts with a 32-bit number indicating the number of entries in the section, followed by the number of elements per entry (3 for latitude, longitude and altitude). Next are the list of entries (lat, long, h).
- // fichier wwb 1 (offset wwb 1)+ // wwb file 1 (wwb offset 1)
- int32 nombre d'entrees (lat, long, h)+ int32 number of entries (lat, long, h)
- byte nombres d��l�ment par entr�e = 3 (lat, long, h)+ byte number of elements per entry = 3 (lat, long, h)
- // entr�e 1+ // entry 1
double lat double lat
double long double long
smallint h (16 bits) smallint h (16 bits)
- // entr�e 2+ // entry 2
double lat double lat
double long double long
Line 81: Line 83:
... ...
- // fichier wwb 2 (offset wwb 2)+ // wwb file 2 (wwb 2)
- int32 nombre d'entrees (lat, long, h)+ int32 number of entries (lat, long, h)
- byte nombres d��l�ment par entr�e = 3 (lat, long, h)+ byte number of elements per entry = 3 (lat, long, h)
- // entr�e 1+ // entry 1
double lat double lat
double long double long
smallint h (16 bits) smallint h (16 bits)
- // entr�e 2+ // entry 2
double lat double lat
double long double long
Line 98: Line 100:
... ...
- // fichier wwb 3+ // wwb file 3
... ...
-==Example de fichier xml associ� � un pathlist==+==Example of the XML file associated with a pathlist==
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- commentaire --> <!-- commentaire -->
Line 115: Line 117:
</PathList> </PathList>
-Le dossier Data\WorldWindow.Earth\monchemin contient un fichier pathlist.pkg et un fichier pathlist.idx qui d�finissent le chemin.+The folder Data\WorldWindow.Earth\monchemin contains a file pathlist.pkg and a file pathlist.idx that define the path.
[[Category:Data_Formats]] [[Category:Data_Formats]]

Revision as of 00:22, 25 March 2005

Contents

Introduction

The wwb files are used to define boundaries (countries and states), and you can make a pathlist with them using PathListArchiver.exe.

The pkg and idx files are used to define the pathlist (in 3D).

This document details the binary formats of these files and thus the associated XML files.


The types used are:

int32		32-bit integer
int64		64-bit integer
smallint	16-bit integer

Single	1.5 x 10^-45 .. 3.4 x 10^38	4-byte real number
Double	5.0 x 10^-324 .. 1.7 x 10^308	8-byte real number

Pstring	string : A byte followed by characters

The altitudes are important, they allow the paths to float above the terrain, otherwise the disappear within the mountains.

wwb Format

The file begins with a 32-bit integer containing the number of entries in the file. The file continues with a series of entries consisting of a float latitude and float longitude.

int32	number of pairs (latitude, longitude) in the file

// entry 1

single	latitude	
single	longitude

// entry 2

single	latitude	
single	longitude


IDX Format

The file begins with the number of wwb files associated in a 32-bit integer. Next is an entry for each wwb file. Each entry consists of a string, the west, south, east, and north limits in a double, and a 64-bit integer for the offset of the data in the pkg file.

int32	Number of wwb files = Number of groups in this package

// wwb file 1 (wwb offset 1)

PString	name of a wwb file, a string
double	west
double	south
double	east
double	north
Int64	offset wwb 1 = offset of data in pkg file

// wwb file 2 (wwb offset 2)

PString	name of a wwb file, a string
double	west
double	south
double	east
double	north
Int64	offset wwb 1 = offset of data in pkg file

// wwb file 3 (wwb offset 3)
...

pkg format

The file contains a list of the entries containing the coordinates of each of the associated wwb files. Every description starts with a 32-bit number indicating the number of entries in the section, followed by the number of elements per entry (3 for latitude, longitude and altitude). Next are the list of entries (lat, long, h).

// wwb file 1 (wwb offset 1)

int32	number of entries (lat, long, h)
byte	number of elements per entry = 3 (lat, long, h)

// entry 1
double	lat
double	long
smallint	h (16 bits)

// entry 2
double	lat
double	long
smallint	h (16 bits)

...

// wwb file 2  (wwb 2)

int32	number of entries (lat, long, h)
byte	number of elements per entry = 3 (lat, long, h)

// entry 1
double	lat
double	long
smallint	h (16 bits)

// entry 2
double	lat
double	long
smallint	h (16 bits)

...

// wwb file 3
...

Example of the XML file associated with a pathlist

<?xml version="1.0" encoding="UTF-8"?>
<LayerSet Name="" ShowOnlyOneLayer="false" ShowAtStartup="false"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="C:\WorldWind\bin\Debug\Configuration\EarthLayers\LayerSet.xsd">
<PathList ShowAtStartup="true">
<Name>Trail</Name>
<DistanceAboveSurface>1000</DistanceAboveSurface>
<MinDisplayAltitude>0</MinDisplayAltitude>
<MaxDisplayAltitude>6000000</MaxDisplayAltitude>
<PathsDirectory>Data\WorldWindow.Earth\monchemin</PathsDirectory>
<WinColorName>Cyan</WinColorName>
</PathList>

The folder Data\WorldWindow.Earth\monchemin contains a file pathlist.pkg and a file pathlist.idx that define the path.

Personal tools