elevdump

Uit 3Dwiki

Een elevdump is een bestand dat informatie over het terrein van een wereld bevat. Samen met een atdump (instellingen) en een propdump (objecten) vormt dit een volledige backup van een wereld.

[bewerken] Formaat

Het elevdump-bestand is een tekstbestand dat begint met een regel met het versienummer. Active Worlds versie 3.6 gebruikt het formaat elevdump versie 1.

elevdump version 1

Na deze regel komt informatie over het terrein.

[bewerken] elevdump versie 1

Het terrein van een wereld is ingedeeld in pages (Engels: [1]). Een page is een groot vierkant stuk van de wereld van 128 bij 128 cellen. Pages zijn genummerd in x- en z-richting, page (0, 0) ligt in het midden van de wereld en loopt dus van 0 tot 64 in alle richtingen (noord, zuid, oost, west).

Elke page is verder onderverdeeld in één of meer nodes. Een node is een vierkant stuk van de wereld met een grootte die minimaal 8 bij 8 en maximaal 128 bij 128 cellen is.

Gegevens over het terrein worden opgeslagen per node: voor elke cel is er de hoogte en de texture van het terrein op dat punt. Als een node plat is (alle cellen van een node hebben dezelfde hoogte), dan wordt deze hoogte maar één keer opgeslagen. Is dit niet zo, dan wordt voor elke cel apart de hoogte opgeslagen. Hetzelfde geldt als alle cellen van een node dezelfde texture hebben.

Elke regel in de elevdump beschrijft het terrein van één node. Elke regel bestaat uit een reeks gehele getallen, gescheiden door spaties. Hieronder is met voorbeelden uitgewerkt hoe dit precies in elkaar zit.

0 0 32 64 8 1 1 0 0

onderdeel	betekenis
0	x-coördinaat van de page waar de node in ligt: 0 geeft hier aan dat het om de page gaat die van 64E tot 64W loopt
0	z-coördinaat van de page waar de node in ligt: 0 geeft hier aan dat het om de page gaat die van 64S tot 64N loopt
32	x-coördinaat van de zuidoost-hoek van de node, relatief aan de page: 32 betekent dat de node begint op 32 cellen naar het westen vanaf 64E, ofwel 32E
64	z-coördinaat van de zuidoost-hoek van de node, relatief aan de page: 64 betekent dat de node begint op 64 cellen naar het noorden vanaf 64S, ofwel 0N
8	de grootte van de node, van de rand van de node tot het midden: 8 betekent dat de node 16 bij 16 cellen is
1	het aantal textures dat er voor deze node zijn opgeslagen: 1 betekent dat alle cellen van de node dezelfde texture hebben en er dus maar één texture volgt
1	het aantal hoogtes dat er voor deze node zijn opgeslagen: 1 betekent dat de node plat is en er dus maar één hoogte volgt
0 0	achterelkaar eerst de texture(s) en dan de hoogte(s) (in cm) van alle cellen van de node: in dit geval maar één van beiden

Deze regel beschrijft dus het terrein van het vierkant van 32E tot 16E en 0N tot 16N. Alle cellen in dit gebied hebben dezelfde texture (#0) en dezelfde hoogte (0 cm).

Als niet alle cellen van een node dezelfde texture of hoogte hebben, dan volgen er voor elke cel van de node achterelkaar de textures en de hoogtes, dit ziet er bijvoorbeeld zo uit:

0 0 56 64 4 64 64 0 0 0 0 0 0 130 196 0 0 0 0 0 0 195 194 0 0 (...)

De eerste zeven getallen werken weer hetzelfde als bij het vorige voorbeeld, alleen zijn er nu meerdere (64) textures en meerdere (64) hoogtes voor deze node. Dit betekent dat er na de eerste zeven getallen eerst 64 textures-nummers volgen en daarna nog 64 hoogtes (de regel is hierboven niet volledige getoond). Aangezien dit een node is van 8 bij 8 cellen, is dit dus inderdaad precies één texture en één hoogte voor elke cel van de node (8 x 8 = 64).

Voor de volgorde van de textures geldt dat het eerste getal voor de zuidoost-hoek van de node is (in dit geval dus 0N 8E). Het volgende getal is voor de cel hier ten westen van (0N 7E) en zo verder, tot de westelijke grens van de node bereikt is bij het achtste getal (0N 0W). Het getal daarna, het negende getal, is dan voor (1N 8E), en de volgende voor (1N 7E), etc.

Als alle 64 textures geweest zijn, geldt dezelfde volgorde nog een keer voor de hoogtes.

Het is ook mogelijk om maar één texture, maar wel voor elke cel apart een hoogte te hebben. Andersom kan ook.

[bewerken] Zie ook

• Terrein
• Uitleg over terrein voor de SDK (Engels)