Boundary Format
From World Wind Wiki
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).
Le pr�sent document pr�sente les formats binaires de ces fichiers ainsi que les documents xml associ�s.
Les types utilis�s sont:
int32 entier sur 32 bits int64 entier sur 64 bits smallint entier sur 16 bits Single 1.5 x 10^-45 .. 3.4 x 10^38 r�el sur 4 octets Double 5.0 x 10^-324 .. 1.7 x 10^308 r�el sur 8 octets Pstring cha�ne : un octet suivi des caract�res
Les altitudes sont importantes, elles permettent de faire � flotter � les chemins au dessus de la surface, sinon ils disparaissent avec le relief.
Format wwb
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 // entr�e 1 single latitude single longitude // entr�e 2 single latitude 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 // fichier wwb 1 (offset wwb 1) PString nom d'un fichier wwb, un octet de longueur suivi des carract�res de la chaine double ouest double sud double est double nord Int64 offset wwb 1 = offset des data dans fichier pkg // fichier wwb 2 (offset wwb 2) PString nom d'un fichier wwb, un octet de longueur suivi des char de la chaine double ouest double sud double est double nord Int64 offset wwb 2 = offset des data dans fichier pkg // fichier wwb 3 (offset wwb 3) ...
format pkg
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).
// fichier wwb 1 (offset wwb 1) int32 nombre d'entrees (lat, long, h) byte nombres d��l�ment par entr�e = 3 (lat, long, h) // entr�e 1 double lat double long smallint h (16 bits) // entr�e 2 double lat double long smallint h (16 bits) ... // fichier wwb 2 (offset wwb 2) int32 nombre d'entrees (lat, long, h) byte nombres d��l�ment par entr�e = 3 (lat, long, h) // entr�e 1 double lat double long smallint h (16 bits) // entr�e 2 double lat double long smallint h (16 bits) ... // fichier wwb 3 ...
Example de fichier xml associ� � un 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>
Le dossier Data\WorldWindow.Earth\monchemin contient un fichier pathlist.pkg et un fichier pathlist.idx qui d�finissent le chemin.
