SWGANH Wiki - User contributions [en]

TRN (FileFormat)

2010-05-24T03:18:58Z

Powerking:

{{PageHeader|FileFormat|TRN}}
='''File Header'''=

The general map parameters, as well as flora parameters are defined here

<pre>
4A 3A 5C 73 77 67 5C 63 75 72 72 65 6E 74 5C 64 61 74 61 5C J..swg.current.data.
73 6B 75 2E 30 5C 73 79 73 2E 73 68 61 72 65 64 5C 62 75 69 sku.0.sys.shared.bui
6C 74 5C 67 61 6D 65 5C 74 65 72 72 61 69 6E 5C 64 61 6E 74 lt.game.terrain.dant
6F 6F 69 6E 65 2E 74 72 6E 00 00 00 80 46 00 00 00 41 02 00 ooine.trn....F...A..
00 00 01 00 00 00 CD CC CC BD 00 00 00 40 77 74 65 72 5F 64 ..............wter.d
61 6E 74 5F 6C 61 6B 65 00 00 30 04 46 00 00 00 00 00 00 00 ant.lake..0.F.......
43 00 00 00 41 00 00 00 40 00 00 00 00 00 00 00 00 00 00 80 C...A...............
42 00 00 80 40 00 00 00 3F 00 00 00 00 00 00 00 00 00 00 F0 B...................
41 00 00 80 3F 00 00 00 00 00 00 00 00 00 00 00 43 00 00 00 A...............C...
44 00 00 00 42 00 00 00 41 00 00 00 00 D...B...A....
</pre>

='''TGEN''' - Terrain Generator =
<pre>
The rules in the terrain generation system are also referred to as affectors,and
are organized into layers. Boundaries refer to terrain designer- or artist-defined
regions of virtual terrain for which the desired rules have effect. Filters refer
to conditions to be considered when applying affectors. Layers can be arranged
in a hierarchy with a parent-child or tree-leaf relationship. Examples of boundaries
include circles, rectangles, and polygons. Examples of filters include filtering
by slope, height, shader, direction and fractal. Examples of affectors include
those that affect height, color, shader, flora, and radial flora. Boundaries, filters
and layers are described in greater detail below.

The terrain generation system also includes families, which refer to groups of
assets such as textures, geometry or even algorithms. Families can include children
with weights. This could involve choosing an asset by selecting a one weighted child.
For example, this could allow the users to choose a "grass" family for a region, but
when the terrain system generates the grass family, it can choose one of the children
of the grass family, which results in the rendering of a single grass shader.

Examples of families include shader families, blend families, flora families,
radial flora families, and fractal families. Shader families refer to grouping
shaders for placing textures. Blend families refer to grouping shaders for selecting
alpha blend masks. Flora families refer to grouping geometry for selecting flora.
Radial flora families refer to grouping shaders for placing radial flora.
Fractal families refer to grouping fractals for reuse within different rules.
</pre>

Terrain generator (form name : TGEN)
There are 6 different sections.

<pre>
- The Shader family (SGRP)
- The Flora family (FRGP)
- The Radial Flora family (RGRP)
- The Environment family (EGRP)
- The Fractal family (MGRP)
- The Layers family (LYRS)
</pre>

=='''SGRP''' - Shader Family Group==

Shader families refer to grouping shaders for placing textures

It's sub-divied into multiple surface families (SFAM).

Each one of them declare mutliple shaders using a surface file.

SGRP has x children (SFAM), SFAM has x children (Shaders)

'''Family break-down:'''
<pre>
53 46 41 4D 00 00 00 55 22 00 00 00 73 6E 6F 77 5F 6D 74 6E SFAM...U....snow.mtn
73 70 65 61 6B 00 61 62 73 74 72 61 63 74 2F 74 65 72 72 61 speak.abstract.terra
69 6E 5F 73 75 72 66 61 63 65 2F 73 6E 6F 77 2E 69 66 66 00 in.surface.snow.iff.
FF FF 00 00 00 00 40 00 00 80 3F 01 00 00 00 ...............

(int) Family ID (This ID is user by the layers to select this family)
(String) File Name
(byte)(byte)(byte) unk ?Color?
(float) unk
(float) unk
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
73 6E 6F 77 5F 6D 74 6E 73 70 65 61 6B 00 00 00 80 3F snow.mtnspeak.....

(string) Shader Name
(float) unk
</pre>

=='''FGRP''' - Flora Family Group==

Flora families refer to grouping geometry -apt files- for selecting flora. (Select flora group properties, including flora family data)

Each one of them decalre one flora group using multiple appearance files.

FGRP has x children (FFAM), FFAM has x children (Appearance Files)

'''Family break-down:'''
<pre>
46 46 41 4D 00 00 00 9D 01 00 00 00 66 65 72 6E 73 00 FF 80 FFAM........ferns...
40 00 00 80 3F 00 00 00 00 02 00 00 00 .............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
70 74 63 68 5F 65 6E 64 72 5F 66 72 73 74 5F 63 6C 75 73 74 ptch.endr.frst.clust
65 72 5F 61 31 2E 61 70 74 00 00 00 80 3F 00 00 00 00 0A D7 er.a1.apt...........
23 3C CD CC CC 3D 01 00 00 00 01 00 00 00 00 00 40 3F 00 00 ....................
20 40 ..

(String) Appearance File Name
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(int) ukn
(float) ukn
(float) ukn
</pre>

=='''RGRP''' - Radial Flora Family Group==
Radial flora families refer to grouping shaders for placing radial flora.

'''Family break-down:'''
<pre>
52 46 41 4D 00 00 01 06 01 00 00 00 67 72 61 73 73 79 20 70 RFAM........grassy.p
6C 61 69 6E 73 00 FF FF 00 00 00 80 3F 04 00 00 00 lains............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
(String) Shader Name (dds file)
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(?) ukn
TODO..
</pre>

=='''EGRP''' - Environment Family Group==

Declares the environement

EGRP has x children (EFAM)

'''Child break-down:'''
<pre>
01 00 00 00 6D 61 69 6E 5F 62 61 73 65 00 FF FF 00 00 00 80 3F ....main.base........

(int) Environment ID (This ID is user by the layers to select this environment)
(String) Environment Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
</pre>

=='''MGRP''' - Fractal Family Group==

Fractal families refer to grouping fractals for reuse within different rules.
It's sub-divied into multiple groups (MFAM).
Each one of them declare a labelled fractal.

MGRP has x children (MFAM)

'''Child break-down:'''
<pre>
4D 46 41 4D 44 41 54 41 00 00 00 1C 01 00 00 00 41 66 66 65 MFAMDATA........Affe
63 74 6F 72 48 65 69 67 68 74 46 72 61 63 74 61 6C 5F 31 00 ctorHeightFractal.1.
46 4F 52 4D 00 00 00 4C 4D 46 52 43 46 4F 52 4D 00 00 00 40 FORM...LMFRCFORM....
30 30 30 31 44 41 54 41 00 00 00 34 00 00 00 00 00 00 00 00 0001DATA...4........
00 00 00 3F 00 00 00 00 33 33 33 3F 02 00 00 00 00 00 80 40 ........333.........
00 00 00 3F 0A D7 23 3C 0A D7 23 3C 00 00 00 00 00 00 00 00 ....................
00 00 00 00

(int) Fractal ID (This ID is user by the layers to select this family)
(String) Fractal Label

MFRC FORM [...] DATA, byte count

(int) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(?) ukn
(int) ukn
</pre>

=='''LYRS''' - Layers==

=== Layers & Affectors ===

Basically the role of layers is to affect the data contained in the different families.
They can contain any number of other sub-layers. Their order is important.

[[Image:trn_layers.jpg]]

A layer deals with the families trough Affectors. There are different types of them, each one has it's own role.
Can have Affector for texturing, flora, areas...

<pre>
Boundaries, filters, and affectors can be defined in layers and sublayers,
such that a single location in the terrain can have multiple terrain rules.
A layer without boundaries (or filters) is "unbounded," and can affect as much
as the entire landscape. A layer with a boundary allows the affectors in the
layer and sublayers to be applied to the region specified by the boundary.
</pre>

=='''Affectors'''==

<pre>
46 4F 52 4D 00 00 00 70 41 46 53 43 46 4F 52 4D 00 00 00 64 FORM...pAFSCFORM...d
30 30 30 34 46 4F 52 4D 00 00 00 3C 49 48 44 52 46 4F 52 4D 0004FORM....IHDRFORM
00 00 00 30 30 30 30 31 44 41 54 41 00 00 00 24 01 00 00 00 ...00001DATA........
41 66 66 65 63 74 6F 72 46 6C 6F 72 61 43 6F 6C 6C 69 64 61 AffectorFloraCollida
62 6C 65 43 6F 6E 73 74 61 6E 74 00 44 41 54 41 00 00 00 14 bleConstant.DATA....
05 00 00 00 01 00 00 00 00 00 00 00 01 00 00 00 00 00 80 3F ....................
</pre>
Note: Every Affector has an IHDR child wich is holding the user-custom name of the affector (here AffectorFloraCollidableConstant).

The 4 bytes Before the name is a Bool wich enable/disable the affector.

The affector-specific data is conatined After the IHDR in the last DATA form, it always starts with a byte counter.

{| class="wikitable" align="center"
|+ '''Boundaries'''
|-
||'''BREC'''||Boundary Rectangle||Delimits a rectangle using 4 float: X1, Y1, X2, Y2 (Select rectangle boundary rule properties, including feathering distance, boundary left/right and near/far coords and local water table height, shader and sahder size.)
<pre>
00 00 7A 44 00 00 7A 44 00 00 AF 44
00 00 AF 44 00 00 00 00 00 00 80 3F

(float) X1
(float) Y1
(float) X2
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BCIR'''||Boundary Circle||Delimits a circle using 3 float: Xo, Yo, Radius (Select circle boundary rule properties, including feathering distance, boundary center coords, and boundary radius.)
<pre>
00 00 48 43 00 00 48 43 00 00 48 43
01 00 00 00 CD CC CC 3D

(float) X
(float) Y
(float) Radius
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BPOL'''||Boundary Polygon||Delimits a n-sided closed polygon area using 2 floats (Xo,Yo) for each point. (Select polygon boundary rule properties, includibng feathering distance and including local water table height, shader and shader size.)
<pre>
Water Area example

04 00 00 00 00 00 00 00 00 00 00 00 00 00 15 C3 00 00 00 00 ....................
00 00 15 C3 00 00 15 C3 00 00 00 00 00 00 15 C3 03 00 00 00 ....................
00 00 48 42 01 00 00 00 00 00 20 C1 00 00 00 40 77 74 65 72 ..HB............wter
5F 73 70 65 63 00 .spec.

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Fethering Type
(float) Shore smoothness (0 is vertical, 50 looks normal. I don't know what scale mesurement is used)
(int) Bool Water On/Off
(float) Water Height
(float) Water Shader Size (Common size = 2)
(string) Water Shader (wter_spec = Look in the file header??)
</pre>

|-
||'''BPLN'''||Boundary PolyLine||Delimits a n-sided line area using 2 floats (Xo,Yo) for each point and a float for the width. (Select polyline boundary rule properties, including feathering distance and width.)
<pre>
08 00 00 00 00 00 80 3E 00 00 00 3F 00 00 00 00 00 00 74 41
00 00 0C C1 00 00 E8 41 00 00 0C C1 00 00 50 42 00 00 78 C1
00 80 85 42 00 00 D8 C1 00 80 91 42 00 00 12 C2 00 00 93 42
00 00 41 C2 00 00 94 42 01 00 00 00 00 00 80 3F 00 00 20 41

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Feathering Type
(float) Feathering Amount
(float) Line Width
</pre>
|-
|}

Note: '''Boundaries can have a special footer allowing them to behave as a water area.'''(TODO)

{| class="wikitable" align="center"
|+ '''Filters'''
|-
||'''FDIR'''||Filter Direction||Select filter direction rule properties, including feathering distance, and min and max angle settings for filter setting to have effect.
|-
||'''FFRA'''||Filter Fractal||Delimits an area generated by a 2d fractal on the ground. (Select filter fractal rule properties incuding fractal family, low and high fractal settings and feathering distance.)
|-
||'''FHGT'''||Filter Height||Select filter height rule properties, including feathering, distance, filter low height, and filter high height.
|-
||'''FSLP'''||Filter Slope||Select filter slope rule properties, including feathering distance, filter min angle, and filter max angle.
<pre>
00 00 00 00 00 00 C8 41 01 00 00 00 CD CC 8C

(float) Minimum Angle
(float) Maximum Angle
(int) Type?
(byte) ?
(byte) ?
(byte) ?
Note the 3 last bytes may be a color.
</pre>
|-
|}

{| class="wikitable"
|+ '''Texture / Shaders Affectors'''
|-
||'''ASCN'''||Affector Shader Constant||Affect a shader using the family_id and the shader_id this family. (Select rule shader and family and feathering parameters.)
|-
||'''ASRP'''||Affector Shader Replace||Replace a shader with another shader (Select rule shader replace families, including source family (the family to be replaced), destination family (the family to replace with), and feathering parameters.)
|-
||'''ACCN'''||Affector Color Constant||Select color for rule.
|-
||'''FSHD'''||Filter Shader||Select filter shader rule properties, including shader family.
|-
|}

{| class="wikitable"
|+ '''Terrain Affectors'''
|-
||'''AHCN'''||Affector Height Constant||Raises or lowers the ground using float for delta and float(scalar?) for slope-smooting. (Select terrain height value for rule.)
<pre>
01 00 00 00 00 00 C8 C2

(int) ukn
(float) Final Height
</pre>
|-
||'''AHFR'''||Affector Height Fractal||Raises or lowers the ground irregulary using a fractal type from the Fractal Family. Float for delta and float(scalar?) (Select terrain height value for rule for fractal family.)
<pre>
50 41 52 4D 00 00 00 0C 02 00 00 00 00 00 00 00 00 00 48 C2

(String) PARAM
(int) Byte Count
(int) Index of a Fractal Family in MGRP -non regular-
(?) ukn
(float) Height Delta, can be negative
</pre>
|-
||'''AHTR'''||Affector Height Terrace||Select terrace height and flat ratio values for rule.
|-
|}

{| class="wikitable"
|+ '''Flora Affectors'''
|-
||'''AFSC'''||Affector Flora Static Collidable||Sets the amount of collidable flora. (Select to add/remove flora, specify flora type and set flora density for static collidable flora.)
<pre>
05 00 00 00 01 00 00 00 00 00 00 00
01 00 00 00 00 00 80 3F

(int) Index of a family in FGRP -not regular-
(int) ukn
(?) ukn
(int) ukn
(float) Feathering
</pre>
|-
||'''AFSN'''||Affector Flora Static Non-Collidable||Sets the amount of Non-collidable flora. (Select to add/remove flora, specify flora type and set flora density for static non-collidable flora.)
|-
||'''AFDN'''||Affector Flora Dynamic Near||I don't know much about those yet. Seems like they change the near/far radial displaying. They're often coupled to the flora affectors, for instance when cleaning an area for a city. (Select to add/remove flora, specify flora type and set flora destiny for dynamic near flora.)
|-
||'''AFDF'''||Affector Flora Dynamic Far|| (Select to add/remove flora, specify flora type and set flora density for dynamic far flora.)
|-
|}

{| class="wikitable"
|+ '''Unknown'''
|-
||'''AENV'''||Environment||Select enviroment group rule properties.
|-

||'''AEXC'''||Affector Exclude||This one shows up on the Patent App.
|-
||'''AROA'''||Affector Road||Select road rule properties, including width, shader, feathering height distance, and feathering shader distance.
|-
||'''ARIV'''||Affector River||Select river rule properties, including width, trench depth, flow velocity, bank and bottom shaders, water shader, water depth, water width, feathering distance.
|-
||'''ACRF'''||Affector Color Ramp Fractal||Select rule family and color ramp.
|-
||'''ACRH'''||Affector Color Ramp Height||Select rule color ramp and height low/high values.
|-
|}

== Example ==

<pre>

1. Layer

a. AffectorHeightConstant, 10

b. AffectorShaderConstant, Rock

2. Layer

a. BoundaryCircle, x=500, y=500, r=500, feather=InOut

b. AffectorHeightConstant, 0

c. AffectorShaderConstant, Mud

d. Layer

i. FilterHeightmin=13,max=17

ii. AffectorColorConstant, BLACK

3. Layer

a. BoundaryRectangle, min=-500, -500, max=500, 500

b. AffectorFloraStaticCollidableConstant, Conifer

c. AffectorFloraDynamicNearConstant, Dead grass

</pre>
'''Description'''
<pre>
Using the example rules listed above, the corresponding rule
description can perform the following:

1. Set the height of the terrain everywhere to 10 meters(1a) and assign the rock shader(1b).

2. Then, in a 500 meter circle(2a) originating from coordinates (500, 500),
gradually decrease the height from 10 meters to 0 meters(2b), place the mud shader(2c),
and create a black band where the height of the terrain at a given sample point is between 13 and 17 meters.(2d, 2di, 2dii)

3. Finally, in a rectangle(3a) from coordinates (-500, -500) to (500, 500), place
conifer trees(3b) and dead grass(3c) within the rectangle.
</pre>

TRN (FileFormat)

2010-05-23T05:46:11Z

Powerking:

{{PageHeader|FileFormat|TRN}}
='''File Header'''=

The general map parameters, as well as flora parameters are defined here

<pre>
4A 3A 5C 73 77 67 5C 63 75 72 72 65 6E 74 5C 64 61 74 61 5C J..swg.current.data.
73 6B 75 2E 30 5C 73 79 73 2E 73 68 61 72 65 64 5C 62 75 69 sku.0.sys.shared.bui
6C 74 5C 67 61 6D 65 5C 74 65 72 72 61 69 6E 5C 64 61 6E 74 lt.game.terrain.dant
6F 6F 69 6E 65 2E 74 72 6E 00 00 00 80 46 00 00 00 41 02 00 ooine.trn....F...A..
00 00 01 00 00 00 CD CC CC BD 00 00 00 40 77 74 65 72 5F 64 ..............wter.d
61 6E 74 5F 6C 61 6B 65 00 00 30 04 46 00 00 00 00 00 00 00 ant.lake..0.F.......
43 00 00 00 41 00 00 00 40 00 00 00 00 00 00 00 00 00 00 80 C...A...............
42 00 00 80 40 00 00 00 3F 00 00 00 00 00 00 00 00 00 00 F0 B...................
41 00 00 80 3F 00 00 00 00 00 00 00 00 00 00 00 43 00 00 00 A...............C...
44 00 00 00 42 00 00 00 41 00 00 00 00 D...B...A....
</pre>

='''TGEN''' - Terrain Generator =
<pre>
The rules in the terrain generation system are also referred to as affectors,and
are organized into layers. Boundaries refer to terrain designer- or artist-defined
regions of virtual terrain for which the desired rules have effect. Filters refer
to conditions to be considered when applying affectors. Layers can be arranged
in a hierarchy with a parent-child or tree-leaf relationship. Examples of boundaries
include circles, rectangles, and polygons. Examples of filters include filtering
by slope, height, shader, direction and fractal. Examples of affectors include
those that affect height, color, shader, flora, and radial flora. Boundaries, filters
and layers are described in greater detail below.

The terrain generation system also includes families, which refer to groups of
assets such as textures, geometry or even algorithms. Families can include children
with weights. This could involve choosing an asset by selecting a one weighted child.
For example, this could allow the users to choose a "grass" family for a region, but
when the terrain system generates the grass family, it can choose one of the children
of the grass family, which results in the rendering of a single grass shader.

Examples of families include shader families, blend families, flora families,
radial flora families, and fractal families. Shader families refer to grouping
shaders for placing textures. Blend families refer to grouping shaders for selecting
alpha blend masks. Flora families refer to grouping geometry for selecting flora.
Radial flora families refer to grouping shaders for placing radial flora.
Fractal families refer to grouping fractals for reuse within different rules.
</pre>

Terrain generator (form name : TGEN)
There are 6 different sections.

<pre>
- The Shader family (SGRP)
- The Flora family (FRGP)
- The Radial Flora family (RGRP)
- The Environment family (EGRP)
- The Fractal family (MGRP)
- The Layers family (LYRS)
</pre>

=='''SGRP''' - Shader Family Group==

Shader families refer to grouping shaders for placing textures

It's sub-divied into multiple surface families (SFAM).

Each one of them declare mutliple shaders using a surface file.

SGRP has x children (SFAM), SFAM has x children (Shaders)

'''Family break-down:'''
<pre>
53 46 41 4D 00 00 00 55 22 00 00 00 73 6E 6F 77 5F 6D 74 6E SFAM...U....snow.mtn
73 70 65 61 6B 00 61 62 73 74 72 61 63 74 2F 74 65 72 72 61 speak.abstract.terra
69 6E 5F 73 75 72 66 61 63 65 2F 73 6E 6F 77 2E 69 66 66 00 in.surface.snow.iff.
FF FF 00 00 00 00 40 00 00 80 3F 01 00 00 00 ...............

(int) Family ID (This ID is user by the layers to select this family)
(String) File Name
(byte)(byte)(byte) unk ?Color?
(float) unk
(float) unk
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
73 6E 6F 77 5F 6D 74 6E 73 70 65 61 6B 00 00 00 80 3F snow.mtnspeak.....

(string) Shader Name
(float) unk
</pre>

=='''FGRP''' - Flora Family Group==

Flora families refer to grouping geometry -apt files- for selecting flora. (Select flora group properties, including flora family data)

Each one of them decalre one flora group using multiple appearance files.

FGRP has x children (FFAM), FFAM has x children (Appearance Files)

'''Family break-down:'''
<pre>
46 46 41 4D 00 00 00 9D 01 00 00 00 66 65 72 6E 73 00 FF 80 FFAM........ferns...
40 00 00 80 3F 00 00 00 00 02 00 00 00 .............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
70 74 63 68 5F 65 6E 64 72 5F 66 72 73 74 5F 63 6C 75 73 74 ptch.endr.frst.clust
65 72 5F 61 31 2E 61 70 74 00 00 00 80 3F 00 00 00 00 0A D7 er.a1.apt...........
23 3C CD CC CC 3D 01 00 00 00 01 00 00 00 00 00 40 3F 00 00 ....................
20 40 ..

(String) Appearance File Name
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(int) ukn
(float) ukn
(float) ukn
</pre>

=='''RGRP''' - Radial Flora Family Group==
Radial flora families refer to grouping shaders for placing radial flora.

'''Family break-down:'''
<pre>
52 46 41 4D 00 00 01 06 01 00 00 00 67 72 61 73 73 79 20 70 RFAM........grassy.p
6C 61 69 6E 73 00 FF FF 00 00 00 80 3F 04 00 00 00 lains............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
(String) Shader Name (dds file)
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(?) ukn
TODO..
</pre>

=='''EGRP''' - Environment Family Group==

Declares the environement

EGRP has x children (EFAM)

'''Child break-down:'''
<pre>
01 00 00 00 6D 61 69 6E 5F 62 61 73 65 00 FF FF 00 00 00 80 3F ....main.base........

(int) Environment ID (This ID is user by the layers to select this environment)
(String) Environment Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
</pre>

=='''MGRP''' - Fractal Family Group==

Fractal families refer to grouping fractals for reuse within different rules.
It's sub-divied into multiple groups (MFAM).
Each one of them declare a labelled fractal.

MGRP has x children (MFAM)

'''Child break-down:'''
<pre>
4D 46 41 4D 44 41 54 41 00 00 00 1C 01 00 00 00 41 66 66 65 MFAMDATA........Affe
63 74 6F 72 48 65 69 67 68 74 46 72 61 63 74 61 6C 5F 31 00 ctorHeightFractal.1.
46 4F 52 4D 00 00 00 4C 4D 46 52 43 46 4F 52 4D 00 00 00 40 FORM...LMFRCFORM....
30 30 30 31 44 41 54 41 00 00 00 34 00 00 00 00 00 00 00 00 0001DATA...4........
00 00 00 3F 00 00 00 00 33 33 33 3F 02 00 00 00 00 00 80 40 ........333.........
00 00 00 3F 0A D7 23 3C 0A D7 23 3C 00 00 00 00 00 00 00 00 ....................
00 00 00 00

(int) Fractal ID (This ID is user by the layers to select this family)
(String) Fractal Label

MFRC FORM [...] DATA, byte count

(int) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(?) ukn
(int) ukn
</pre>

=='''LYRS''' - Layers==

=== Layers & Affectors ===

Basically the role of layers is to affect the data contained in the different families.
They can contain any number of other sub-layers. Their order is important.

[[Image:trn_layers.jpg]]

A layer deals with the families trough Affectors. There are different types of them, each one has it's own role.
Can have Affector for texturing, flora, areas...

<pre>
Boundaries, filters, and affectors can be defined in layers and sublayers,
such that a single location in the terrain can have multiple terrain rules.
A layer without boundaries (or filters) is "unbounded," and can affect as much
as the entire landscape. A layer with a boundary allows the affectors in the
layer and sublayers to be applied to the region specified by the boundary.
</pre>

=='''Affectors'''==

<pre>
46 4F 52 4D 00 00 00 70 41 46 53 43 46 4F 52 4D 00 00 00 64 FORM...pAFSCFORM...d
30 30 30 34 46 4F 52 4D 00 00 00 3C 49 48 44 52 46 4F 52 4D 0004FORM....IHDRFORM
00 00 00 30 30 30 30 31 44 41 54 41 00 00 00 24 01 00 00 00 ...00001DATA........
41 66 66 65 63 74 6F 72 46 6C 6F 72 61 43 6F 6C 6C 69 64 61 AffectorFloraCollida
62 6C 65 43 6F 6E 73 74 61 6E 74 00 44 41 54 41 00 00 00 14 bleConstant.DATA....
05 00 00 00 01 00 00 00 00 00 00 00 01 00 00 00 00 00 80 3F ....................
</pre>
Note: Every Affector has an IHDR child wich is holding the user-custom name of the affector (here AffectorFloraCollidableConstant).

The 4 bytes Before the name is a Bool wich enable/disable the affector.

The affector-specific data is conatined After the IHDR in the last DATA form, it always starts with a byte counter.

{| class="wikitable" align="center"
|+ '''Boundaries'''
|-
||'''BREC'''||Boundary Rectangle||Delimits a rectangle using 4 float: X1, Y1, X2, Y2 (Select rectangle boundary rule properties, including feathering distance, boundary left/right and near/far coords and local water table height, shader and sahder size.)
<pre>
00 00 7A 44 00 00 7A 44 00 00 AF 44
00 00 AF 44 00 00 00 00 00 00 80 3F

(float) X1
(float) Y1
(float) X2
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BCIR'''||Boundary Circle||Delimits a circle using 3 float: Xo, Yo, Radius (Select circle boundary rule properties, including feathering distance, boundary center coords, and boundary radius.)
<pre>
00 00 48 43 00 00 48 43 00 00 48 43
01 00 00 00 CD CC CC 3D

(float) X
(float) Y
(float) Radius
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BPOL'''||Boundary Polygon||Delimits a n-sided closed polygon area using 2 floats (Xo,Yo) for each point. (Select polygon boundary rule properties, includibng feathering distance and including local water table height, shader and shader size.)
<pre>
Water Area example

04 00 00 00 00 00 00 00 00 00 00 00 00 00 15 C3 00 00 00 00 ....................
00 00 15 C3 00 00 15 C3 00 00 00 00 00 00 15 C3 03 00 00 00 ....................
00 00 48 42 01 00 00 00 00 00 20 C1 00 00 00 40 77 74 65 72 ..HB............wter
5F 73 70 65 63 00 .spec.

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Fethering Type
(float) Shore smoothness (0 is vertical, 50 looks normal. I don't know what scale mesurement is used)
(int) Bool Water On/Off
(float) Water Height
(float) Water Shader Size (Common size = 2)
(string) Water Shader (wter_spec = Look in the file header??)
</pre>

|-
||'''BPLN'''||Boundary PolyLine||Delimits a n-sided line area using 2 floats (Xo,Yo) for each point and a float for the width. (Select polyline boundary rule properties, including feathering distance and width.)
<pre>
08 00 00 00 00 00 80 3E 00 00 00 3F 00 00 00 00 00 00 74 41
00 00 0C C1 00 00 E8 41 00 00 0C C1 00 00 50 42 00 00 78 C1
00 80 85 42 00 00 D8 C1 00 80 91 42 00 00 12 C2 00 00 93 42
00 00 41 C2 00 00 94 42 01 00 00 00 00 00 80 3F 00 00 20 41

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Feathering Type
(float) Feathering Amount
(float) Line Width
</pre>
|-
|}

Note: '''Boundaries can have a special footer allowing them to behave as a water area.'''(TODO)

{| class="wikitable" align="center"
|+ '''Filters'''
|-
||'''FDIR'''||Filter Direction||Select filter direction rule properties, including feathering distance, and min and max angle settings for filter setting to have effect.
|-
||'''FFRA'''||Filter Fractal||Delimits an area generated by a 2d fractal on the ground. (Select filter fractal rule properties incuding fractal family, low and high fractal settings and feathering distance.)
|-
||'''FHGT'''||Filter Height||Select filter height rule properties, including feathering, distance, filter low height, and filter high height.
|-
||'''FSLP'''||Filter Slope||Select filter slope rule properties, including feathering distance, filter min angle, and filter max angle.
<pre>
00 00 00 00 00 00 C8 41 01 00 00 00 CD CC 8C

(float) Minimum Angle
(float) Maximum Angle
(int) Type?
(byte) ?
(byte) ?
(byte) ?
Note the 3 last bytes may be a color.
</pre>
|-
|}

{| class="wikitable"
|+ '''Texture / Shaders Affectors'''
|-
||'''ASCN'''||Affector Shader Constant||Affect a shader using the family_id and the shader_id this family. (Select rule shader and family and feathering parameters.)
|-
||'''ASCR'''||Affector Shader Replace||Replace a shader with another shader (Select rule shader replace families, including source family (the family to be replaced), destination family (the family to replace with), and feathering parameters.)
|-
||'''ACCN'''||Affector Color Constant||Select color for rule.
|-
||'''FSHD'''||Filter Shader||Select filter shader rule properties, including shader family.
|-
|}

{| class="wikitable"
|+ '''Terrain Affectors'''
|-
||'''AHCN'''||Affector Height Constant||Raises or lowers the ground using float for delta and float(scalar?) for slope-smooting. (Select terrain height value for rule.)
<pre>
01 00 00 00 00 00 C8 C2

(int) ukn
(float) Final Height
</pre>
|-
||'''AHFR'''||Affector Height Fractal||Raises or lowers the ground irregulary using a fractal type from the Fractal Family. Float for delta and float(scalar?) (Select terrain height value for rule for fractal family.)
<pre>
50 41 52 4D 00 00 00 0C 02 00 00 00 00 00 00 00 00 00 48 C2

(String) PARAM
(int) Byte Count
(int) Index of a Fractal Family in MGRP -non regular-
(?) ukn
(float) Height Delta, can be negative
</pre>
|-
||'''AHTR'''||Affector Height Terrace||Select terrace height and flat ratio values for rule.
|-
|}

{| class="wikitable"
|+ '''Flora Affectors'''
|-
||'''AFSC'''||Affector Flora Static Collidable||Sets the amount of collidable flora. (Select to add/remove flora, specify flora type and set flora density for static collidable flora.)
<pre>
05 00 00 00 01 00 00 00 00 00 00 00
01 00 00 00 00 00 80 3F

(int) Index of a family in FGRP -not regular-
(int) ukn
(?) ukn
(int) ukn
(float) Feathering
</pre>
|-
||'''AFSN'''||Affector Flora Static Non-Collidable||Sets the amount of Non-collidable flora. (Select to add/remove flora, specify flora type and set flora density for static non-collidable flora.)
|-
||'''AFDN'''||Affector Flora Dynamic Near||I don't know much about those yet. Seems like they change the near/far radial displaying. They're often coupled to the flora affectors, for instance when cleaning an area for a city. (Select to add/remove flora, specify flora type and set flora destiny for dynamic near flora.)
|-
||'''AFDF'''||Affector Flora Dynamic Far|| (Select to add/remove flora, specify flora type and set flora density for dynamic far flora.)
|-
|}

{| class="wikitable"
|+ '''Unknown'''
|-
||'''AENV'''||Environment||Select enviroment group rule properties.
|-

||'''AEXC'''||Affector Exclude||This one shows up on the Patent App.
|-
||'''AROA'''||Affector Road||Select road rule properties, including width, shader, feathering height distance, and feathering shader distance.
|-
||'''ARIV'''||Affector River||Select river rule properties, including width, trench depth, flow velocity, bank and bottom shaders, water shader, water depth, water width, feathering distance.
|-
||'''ACRF'''||Affector Color Ramp Fractal||Select rule family and color ramp.
|-
||'''ACRH'''||Affector Color Ramp Height||Select rule color ramp and height low/high values.
|-
|}

== Example ==

<pre>

1. Layer

a. AffectorHeightConstant, 10

b. AffectorShaderConstant, Rock

2. Layer

a. BoundaryCircle, x=500, y=500, r=500, feather=InOut

b. AffectorHeightConstant, 0

c. AffectorShaderConstant, Mud

d. Layer

i. FilterHeightmin=13,max=17

ii. AffectorColorConstant, BLACK

3. Layer

a. BoundaryRectangle, min=-500, -500, max=500, 500

b. AffectorFloraStaticCollidableConstant, Conifer

c. AffectorFloraDynamicNearConstant, Dead grass

</pre>
'''Description'''
<pre>
Using the example rules listed above, the corresponding rule
description can perform the following:

1. Set the height of the terrain everywhere to 10 meters(1a) and assign the rock shader(1b).

2. Then, in a 500 meter circle(2a) originating from coordinates (500, 500),
gradually decrease the height from 10 meters to 0 meters(2b), place the mud shader(2c),
and create a black band where the height of the terrain at a given sample point is between 13 and 17 meters.(2d, 2di, 2dii)

3. Finally, in a rectangle(3a) from coordinates (-500, -500) to (500, 500), place
conifer trees(3b) and dead grass(3c) within the rectangle.
</pre>

TRN (FileFormat)

2010-05-22T04:23:22Z

Powerking:

{{PageHeader|FileFormat|TRN}}
='''File Header'''=

The general map parameters, as well as flora parameters are defined here

<pre>
4A 3A 5C 73 77 67 5C 63 75 72 72 65 6E 74 5C 64 61 74 61 5C J..swg.current.data.
73 6B 75 2E 30 5C 73 79 73 2E 73 68 61 72 65 64 5C 62 75 69 sku.0.sys.shared.bui
6C 74 5C 67 61 6D 65 5C 74 65 72 72 61 69 6E 5C 64 61 6E 74 lt.game.terrain.dant
6F 6F 69 6E 65 2E 74 72 6E 00 00 00 80 46 00 00 00 41 02 00 ooine.trn....F...A..
00 00 01 00 00 00 CD CC CC BD 00 00 00 40 77 74 65 72 5F 64 ..............wter.d
61 6E 74 5F 6C 61 6B 65 00 00 30 04 46 00 00 00 00 00 00 00 ant.lake..0.F.......
43 00 00 00 41 00 00 00 40 00 00 00 00 00 00 00 00 00 00 80 C...A...............
42 00 00 80 40 00 00 00 3F 00 00 00 00 00 00 00 00 00 00 F0 B...................
41 00 00 80 3F 00 00 00 00 00 00 00 00 00 00 00 43 00 00 00 A...............C...
44 00 00 00 42 00 00 00 41 00 00 00 00 D...B...A....
</pre>

='''TGEN''' - Terrain Generator =
<pre>
The rules in the terrain generation system are also referred to as affectors,and
are organized into layers. Boundaries refer to terrain designer- or artist-defined
regions of virtual terrain for which the desired rules have effect. Filters refer
to conditions to be considered when applying affectors. Layers can be arranged
in a hierarchy with a parent-child or tree-leaf relationship. Examples of boundaries
include circles, rectangles, and polygons. Examples of filters include filtering
by slope, height, shader, direction and fractal. Examples of affectors include
those that affect height, color, shader, flora, and radial flora. Boundaries, filters
and layers are described in greater detail below.

The terrain generation system also includes families, which refer to groups of
assets such as textures, geometry or even algorithms. Families can include children
with weights. This could involve choosing an asset by selecting a one weighted child.
For example, this could allow the users to choose a "grass" family for a region, but
when the terrain system generates the grass family, it can choose one of the children
of the grass family, which results in the rendering of a single grass shader.

Examples of families include shader families, blend families, flora families,
radial flora families, and fractal families. Shader families refer to grouping
shaders for placing textures. Blend families refer to grouping shaders for selecting
alpha blend masks. Flora families refer to grouping geometry for selecting flora.
Radial flora families refer to grouping shaders for placing radial flora.
Fractal families refer to grouping fractals for reuse within different rules.
</pre>

Terrain generator (form name : TGEN)
There are 6 different sections.

<pre>
- The Shader family (SGRP)
- The Flora family (FRGP)
- The Radial Flora family (RGRP)
- The Environment family (EGRP)
- The Fractal family (MGRP)
- The Layers family (LYRS)
</pre>

=='''SGRP''' - Shader Family Group==

Shader families refer to grouping shaders for placing textures

It's sub-divied into multiple surface families (SFAM).

Each one of them declare mutliple shaders using a surface file.

SGRP has x children (SFAM), SFAM has x children (Shaders)

'''Family break-down:'''
<pre>
53 46 41 4D 00 00 00 55 22 00 00 00 73 6E 6F 77 5F 6D 74 6E SFAM...U....snow.mtn
73 70 65 61 6B 00 61 62 73 74 72 61 63 74 2F 74 65 72 72 61 speak.abstract.terra
69 6E 5F 73 75 72 66 61 63 65 2F 73 6E 6F 77 2E 69 66 66 00 in.surface.snow.iff.
FF FF 00 00 00 00 40 00 00 80 3F 01 00 00 00 ...............

(int) Family ID (This ID is user by the layers to select this family)
(String) File Name
(byte)(byte)(byte) unk ?Color?
(float) unk
(float) unk
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
73 6E 6F 77 5F 6D 74 6E 73 70 65 61 6B 00 00 00 80 3F snow.mtnspeak.....

(string) Shader Name
(float) unk
</pre>

=='''FGRP''' - Flora Family Group==

Flora families refer to grouping geometry -apt files- for selecting flora. (Select flora group properties, including flora family data)

Each one of them decalre one flora group using multiple appearance files.

FGRP has x children (FFAM), FFAM has x children (Appearance Files)

'''Family break-down:'''
<pre>
46 46 41 4D 00 00 00 9D 01 00 00 00 66 65 72 6E 73 00 FF 80 FFAM........ferns...
40 00 00 80 3F 00 00 00 00 02 00 00 00 .............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
70 74 63 68 5F 65 6E 64 72 5F 66 72 73 74 5F 63 6C 75 73 74 ptch.endr.frst.clust
65 72 5F 61 31 2E 61 70 74 00 00 00 80 3F 00 00 00 00 0A D7 er.a1.apt...........
23 3C CD CC CC 3D 01 00 00 00 01 00 00 00 00 00 40 3F 00 00 ....................
20 40 ..

(String) Appearance File Name
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(int) ukn
(float) ukn
(float) ukn
</pre>

=='''RGRP''' - Radial Flora Family Group==
Radial flora families refer to grouping shaders for placing radial flora.

'''Family break-down:'''
<pre>
52 46 41 4D 00 00 01 06 01 00 00 00 67 72 61 73 73 79 20 70 RFAM........grassy.p
6C 61 69 6E 73 00 FF FF 00 00 00 80 3F 04 00 00 00 lains............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
(String) Shader Name (dds file)
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(?) ukn
TODO..
</pre>

=='''EGRP''' - Environment Family Group==

Declares the environement

EGRP has x children (EFAM)

'''Child break-down:'''
<pre>
01 00 00 00 6D 61 69 6E 5F 62 61 73 65 00 FF FF 00 00 00 80 3F ....main.base........

(int) Environment ID (This ID is user by the layers to select this environment)
(String) Environment Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
</pre>

=='''MGRP''' - Fractal Family Group==

Fractal families refer to grouping fractals for reuse within different rules.
It's sub-divied into multiple groups (MFAM).
Each one of them declare a labelled fractal.

MGRP has x children (MFAM)

'''Child break-down:'''
<pre>
4D 46 41 4D 44 41 54 41 00 00 00 1C 01 00 00 00 41 66 66 65 MFAMDATA........Affe
63 74 6F 72 48 65 69 67 68 74 46 72 61 63 74 61 6C 5F 31 00 ctorHeightFractal.1.
46 4F 52 4D 00 00 00 4C 4D 46 52 43 46 4F 52 4D 00 00 00 40 FORM...LMFRCFORM....
30 30 30 31 44 41 54 41 00 00 00 34 00 00 00 00 00 00 00 00 0001DATA...4........
00 00 00 3F 00 00 00 00 33 33 33 3F 02 00 00 00 00 00 80 40 ........333.........
00 00 00 3F 0A D7 23 3C 0A D7 23 3C 00 00 00 00 00 00 00 00 ....................
00 00 00 00

(int) Fractal ID (This ID is user by the layers to select this family)
(String) Fractal Label

MFRC FORM [...] DATA, byte count

(int) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(?) ukn
(int) ukn
</pre>

=='''LYRS''' - Layers==

=== Layers & Affectors ===

Basically the role of layers is to affect the data contained in the different families.
They can contain any number of other sub-layers. Their order is important.

[[Image:trn_layers.jpg]]

A layer deals with the families trough Affectors. There are different types of them, each one has it's own role.
Can have Affector for texturing, flora, areas...

<pre>
Boundaries, filters, and affectors can be defined in layers and sublayers,
such that a single location in the terrain can have multiple terrain rules.
A layer without boundaries (or filters) is "unbounded," and can affect as much
as the entire landscape. A layer with a boundary allows the affectors in the
layer and sublayers to be applied to the region specified by the boundary.
</pre>

=='''Affectors'''==

<pre>
46 4F 52 4D 00 00 00 70 41 46 53 43 46 4F 52 4D 00 00 00 64 FORM...pAFSCFORM...d
30 30 30 34 46 4F 52 4D 00 00 00 3C 49 48 44 52 46 4F 52 4D 0004FORM....IHDRFORM
00 00 00 30 30 30 30 31 44 41 54 41 00 00 00 24 01 00 00 00 ...00001DATA........
41 66 66 65 63 74 6F 72 46 6C 6F 72 61 43 6F 6C 6C 69 64 61 AffectorFloraCollida
62 6C 65 43 6F 6E 73 74 61 6E 74 00 44 41 54 41 00 00 00 14 bleConstant.DATA....
05 00 00 00 01 00 00 00 00 00 00 00 01 00 00 00 00 00 80 3F ....................
</pre>
Note: Every Affector has an IHDR child wich is holding the user-custom name of the affector (here AffectorFloraCollidableConstant).

The 4 bytes Before the name is a Bool wich enable/disable the affector.

The affector-specific data is conatined After the IHDR in the last DATA form, it always starts with a byte counter.

{| class="wikitable" align="center"
|+ '''Boundaries'''
|-
||'''BREC'''||Boundary Rectangle||Delimits a rectangle using 4 float: X1, Y1, X2, Y2 (Select rectangle boundary rule properties, including feathering distance, boundary left/right and near/far coords and local water table height, shader and sahder size.)
<pre>
00 00 7A 44 00 00 7A 44 00 00 AF 44
00 00 AF 44 00 00 00 00 00 00 80 3F

(float) X1
(float) Y1
(float) X2
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BCIR'''||Boundary Circle||Delimits a circle using 3 float: Xo, Yo, Radius (Select circle boundary rule properties, including feathering distance, boundary center coords, and boundary radius.)
<pre>
00 00 48 43 00 00 48 43 00 00 48 43
01 00 00 00 CD CC CC 3D

(float) X
(float) Y
(float) Radius
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BPOL'''||Boundary Polygon||Delimits a n-sided closed polygon area using 2 floats (Xo,Yo) for each point. (Select polygon boundary rule properties, includibng feathering distance and including local water table height, shader and shader size.)
<pre>
Water Area example

04 00 00 00 00 00 00 00 00 00 00 00 00 00 15 C3 00 00 00 00 ....................
00 00 15 C3 00 00 15 C3 00 00 00 00 00 00 15 C3 03 00 00 00 ....................
00 00 48 42 01 00 00 00 00 00 20 C1 00 00 00 40 77 74 65 72 ..HB............wter
5F 73 70 65 63 00 .spec.

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Fethering Type
(float) Shore smoothness (0 is vertical, 50 looks normal. I don't know what scale mesurement is used)
(int) Bool Water On/Off
(float) Water Height
(float) Water Shader Size (Common size = 2)
(string) Water Shader (wter_spec = Look in the file header??)
</pre>

|-
||'''BPLN'''||Boundary PolyLine||Delimits a n-sided line area using 2 floats (Xo,Yo) for each point and a float for the width. (Select polyline boundary rule properties, including feathering distance and width.)
<pre>
08 00 00 00 00 00 80 3E 00 00 00 3F 00 00 00 00 00 00 74 41
00 00 0C C1 00 00 E8 41 00 00 0C C1 00 00 50 42 00 00 78 C1
00 80 85 42 00 00 D8 C1 00 80 91 42 00 00 12 C2 00 00 93 42
00 00 41 C2 00 00 94 42 01 00 00 00 00 00 80 3F 00 00 20 41

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Feathering Type
(float) Feathering Amount
(float) Line Width
</pre>
|-
|}

Note: '''Boundaries can have a special footer allowing them to behave as a water area.'''(TODO)

{| class="wikitable" align="center"
|+ '''Filters'''
|-
||'''FDIR'''||Filter Direction||Select filter direction rule properties, including feathering distance, and min and max angle settings for filter setting to have effect.
|-
||'''FFRA'''||Filter Fractal||Delimits an area generated by a 2d fractal on the ground. (Select filter fractal rule properties incuding fractal family, low and high fractal settings and feathering distance.)
|-
||'''FHGT'''||Filter Height||Select filter height rule properties, including feathering, distance, filter low height, and filter high height.
|-
||'''FSLP'''||Filter Slope||Select filter slope rule properties, including feathering distance, filter min angle, and filter max angle.
<pre>
00 00 00 00 00 00 C8 41 01 00 00 00 CD CC 8C

(float) Minimum Angle
(float) Maximum Angle
(int) Type?
(byte) ?
(byte) ?
(byte) ?
Note the 3 last bytes may be a color.
</pre>
|-
|}

{| class="wikitable"
|+ '''Texture / Shaders Affectors'''
|-
||'''ASCN'''||Affector Shader Constant||Affect a shader using the family_id and the shader_id this family. (Select rule shader and family and feathering parameters.)
|-
||'''ASCR'''||Affector Shader Replace||Replace a shader with another shader (Select rule shader replace families, including source family (the family to be replaced), destination family (the family to replace with), and feathering parameters.)
|-
||'''ACCN'''||Affector Color Constant||Select color for rule.
|-
||'''FSHD'''||Filter Shader||Select filter shader rule properties, including shader family.
|-
|}

{| class="wikitable"
|+ '''Terrain Affectors'''
|-
||'''AHCN'''||Affector Height Constant||Raises or lowers the ground using float for delta and float(scalar?) for slope-smooting. (Select terrain height value for rule.)
<pre>
01 00 00 00 00 00 C8 C2

(int) ukn
(float) Final Height
</pre>
|-
||'''AHFR'''||Affector Height Fractal||Raises or lowers the ground irregulary using a fractal type from the Fractal Family. Float for delta and float(scalar?) (Select terrain height value for rule for fractal family.)
<pre>
50 41 52 4D 00 00 00 0C 02 00 00 00 00 00 00 00 00 00 48 C2

(String) PARAM
(int) Byte Count
(int) Index of a Fractal Family in MGRP -non regular-
(?) ukn
(float) Height Delta, can be negative
</pre>
|-
||'''AHFT'''||Affector Height Terrace||Select terrace height and flat ratio values for rule.
|-
|}

{| class="wikitable"
|+ '''Flora Affectors'''
|-
||'''AFSC'''||Affector Flora Static Collidable||Sets the amount of collidable flora. (Select to add/remove flora, specify flora type and set flora density for static collidable flora.)
<pre>
05 00 00 00 01 00 00 00 00 00 00 00
01 00 00 00 00 00 80 3F

(int) Index of a family in FGRP -not regular-
(int) ukn
(?) ukn
(int) ukn
(float) Feathering
</pre>
|-
||'''AFSN'''||Affector Flora Static Non-Collidable||Sets the amount of Non-collidable flora. (Select to add/remove flora, specify flora type and set flora density for static non-collidable flora.)
|-
||'''AFDN'''||Affector Flora Dynamic Near||I don't know much about those yet. Seems like they change the near/far radial displaying. They're often coupled to the flora affectors, for instance when cleaning an area for a city. (Select to add/remove flora, specify flora type and set flora destiny for dynamic near flora.)
|-
||'''AFDF'''||Affector Flora Dynamic Far|| (Select to add/remove flora, specify flora type and set flora density for dynamic far flora.)
|-
|}

{| class="wikitable"
|+ '''Unknown'''
|-
||'''AENV'''||Environment||Select enviroment group rule properties.
|-

||'''AEXC'''||Affector Exclude||This one shows up on the Patent App.
|-
||'''AROA'''||Affector Road||Select road rule properties, including width, shader, feathering height distance, and feathering shader distance.
|-
||'''ARIV'''||Affector River||Select river rule properties, including width, trench depth, flow velocity, bank and bottom shaders, water shader, water depth, water width, feathering distance.
|-
||'''ACRF'''||Affector Color Ramp Fractal||Select rule family and color ramp.
|-
||'''ACRH'''||Affector Color Ramp Height||Select rule color ramp and height low/high values.
|-
|}

== Example ==

<pre>

1. Layer

a. AffectorHeightConstant, 10

b. AffectorShaderConstant, Rock

2. Layer

a. BoundaryCircle, x=500, y=500, r=500, feather=InOut

b. AffectorHeightConstant, 0

c. AffectorShaderConstant, Mud

d. Layer

i. FilterHeightmin=13,max=17

ii. AffectorColorConstant, BLACK

3. Layer

a. BoundaryRectangle, min=-500, -500, max=500, 500

b. AffectorFloraStaticCollidableConstant, Conifer

c. AffectorFloraDynamicNearConstant, Dead grass

</pre>
'''Description'''
<pre>
Using the example rules listed above, the corresponding rule
description can perform the following:

1. Set the height of the terrain everywhere to 10 meters(1a) and assign the rock shader(1b).

2. Then, in a 500 meter circle(2a) originating from coordinates (500, 500),
gradually decrease the height from 10 meters to 0 meters(2b), place the mud shader(2c),
and create a black band where the height of the terrain at a given sample point is between 13 and 17 meters.(2d, 2di, 2dii)

3. Finally, in a rectangle(3a) from coordinates (-500, -500) to (500, 500), place
conifer trees(3b) and dead grass(3c) within the rectangle.
</pre>

TRN (FileFormat)

2010-05-22T03:13:42Z

Powerking:

{{PageHeader|FileFormat|TRN}}
='''File Header'''=

The general map parameters, as well as flora parameters are defined here

<pre>
4A 3A 5C 73 77 67 5C 63 75 72 72 65 6E 74 5C 64 61 74 61 5C J..swg.current.data.
73 6B 75 2E 30 5C 73 79 73 2E 73 68 61 72 65 64 5C 62 75 69 sku.0.sys.shared.bui
6C 74 5C 67 61 6D 65 5C 74 65 72 72 61 69 6E 5C 64 61 6E 74 lt.game.terrain.dant
6F 6F 69 6E 65 2E 74 72 6E 00 00 00 80 46 00 00 00 41 02 00 ooine.trn....F...A..
00 00 01 00 00 00 CD CC CC BD 00 00 00 40 77 74 65 72 5F 64 ..............wter.d
61 6E 74 5F 6C 61 6B 65 00 00 30 04 46 00 00 00 00 00 00 00 ant.lake..0.F.......
43 00 00 00 41 00 00 00 40 00 00 00 00 00 00 00 00 00 00 80 C...A...............
42 00 00 80 40 00 00 00 3F 00 00 00 00 00 00 00 00 00 00 F0 B...................
41 00 00 80 3F 00 00 00 00 00 00 00 00 00 00 00 43 00 00 00 A...............C...
44 00 00 00 42 00 00 00 41 00 00 00 00 D...B...A....
</pre>

='''TGEN''' - Terrain Generator =
<pre>
The rules in the terrain generation system are also referred to as affectors,and
are organized into layers. Boundaries refer to terrain designer- or artist-defined
regions of virtual terrain for which the desired rules have effect. Filters refer
to conditions to be considered when applying affectors. Layers can be arranged
in a hierarchy with a parent-child or tree-leaf relationship. Examples of boundaries
include circles, rectangles, and polygons. Examples of filters include filtering
by slope, height, shader, direction and fractal. Examples of affectors include
those that affect height, color, shader, flora, and radial flora. Boundaries, filters
and layers are described in greater detail below.

The terrain generation system also includes families, which refer to groups of
assets such as textures, geometry or even algorithms. Families can include children
with weights. This could involve choosing an asset by selecting a one weighted child.
For example, this could allow the users to choose a "grass" family for a region, but
when the terrain system generates the grass family, it can choose one of the children
of the grass family, which results in the rendering of a single grass shader.

Examples of families include shader families, blend families, flora families,
radial flora families, and fractal families. Shader families refer to grouping
shaders for placing textures. Blend families refer to grouping shaders for selecting
alpha blend masks. Flora families refer to grouping geometry for selecting flora.
Radial flora families refer to grouping shaders for placing radial flora.
Fractal families refer to grouping fractals for reuse within different rules.
</pre>

Terrain generator (form name : TGEN)
There are 6 different sections.

<pre>
- The Shader family (SGRP)
- The Flora family (FRGP)
- The Radial Flora family (RGRP)
- The Environment family (EGRP)
- The Fractal family (MGRP)
- The Layers family (LYRS)
</pre>

=='''SGRP''' - Shader Family Group==

Shader families refer to grouping shaders for placing textures

It's sub-divied into multiple surface families (SFAM).

Each one of them declare mutliple shaders using a surface file.

SGRP has x children (SFAM), SFAM has x children (Shaders)

'''Family break-down:'''
<pre>
53 46 41 4D 00 00 00 55 22 00 00 00 73 6E 6F 77 5F 6D 74 6E SFAM...U....snow.mtn
73 70 65 61 6B 00 61 62 73 74 72 61 63 74 2F 74 65 72 72 61 speak.abstract.terra
69 6E 5F 73 75 72 66 61 63 65 2F 73 6E 6F 77 2E 69 66 66 00 in.surface.snow.iff.
FF FF 00 00 00 00 40 00 00 80 3F 01 00 00 00 ...............

(int) Family ID (This ID is user by the layers to select this family)
(String) File Name
(byte)(byte)(byte) unk ?Color?
(float) unk
(float) unk
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
73 6E 6F 77 5F 6D 74 6E 73 70 65 61 6B 00 00 00 80 3F snow.mtnspeak.....

(string) Shader Name
(float) unk
</pre>

=='''FGRP''' - Flora Family Group==

Flora families refer to grouping geometry -apt files- for selecting flora. (Select flora group properties, including flora family data)

Each one of them decalre one flora group using multiple appearance files.

FGRP has x children (FFAM), FFAM has x children (Appearance Files)

'''Family break-down:'''
<pre>
46 46 41 4D 00 00 00 9D 01 00 00 00 66 65 72 6E 73 00 FF 80 FFAM........ferns...
40 00 00 80 3F 00 00 00 00 02 00 00 00 .............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
70 74 63 68 5F 65 6E 64 72 5F 66 72 73 74 5F 63 6C 75 73 74 ptch.endr.frst.clust
65 72 5F 61 31 2E 61 70 74 00 00 00 80 3F 00 00 00 00 0A D7 er.a1.apt...........
23 3C CD CC CC 3D 01 00 00 00 01 00 00 00 00 00 40 3F 00 00 ....................
20 40 ..

(String) Appearance File Name
(float) ukn
(?) ukn
(float) ukn
(float) ukn
(int) ukn
(int) ukn
(float) ukn
(float) ukn
</pre>

=='''RGRP''' - Radial Flora Family Group==
Radial flora families refer to grouping shaders for placing radial flora.

'''Family break-down:'''
<pre>
52 46 41 4D 00 00 01 06 01 00 00 00 67 72 61 73 73 79 20 70 RFAM........grassy.p
6C 61 69 6E 73 00 FF FF 00 00 00 80 3F 04 00 00 00 lains............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
(String) Shader Name (dds file)
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(?) ukn
TODO..
</pre>

=='''EGRP''' - Environment Family Group==

Declares the environement

EGRP has x children (EFAM)

'''Child break-down:'''
<pre>
01 00 00 00 6D 61 69 6E 5F 62 61 73 65 00 FF FF 00 00 00 80 3F ....main.base........

(int) Environment ID (This ID is user by the layers to select this environment)
(String) Environment Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
</pre>

=='''MGRP''' - Fractal Family Group==

Fractal families refer to grouping fractals for reuse within different rules.
It's sub-divied into multiple groups (MFAM).
Each one of them declare a labelled fractal.

MGRP has x children (MFAM)

'''Child break-down:'''
<pre>
4D 46 41 4D 44 41 54 41 00 00 00 1C 01 00 00 00 41 66 66 65 MFAMDATA........Affe
63 74 6F 72 48 65 69 67 68 74 46 72 61 63 74 61 6C 5F 31 00 ctorHeightFractal.1.
46 4F 52 4D 00 00 00 4C 4D 46 52 43 46 4F 52 4D 00 00 00 40 FORM...LMFRCFORM....
30 30 30 31 44 41 54 41 00 00 00 34 00 00 00 00 00 00 00 00 0001DATA...4........
00 00 00 3F 00 00 00 00 33 33 33 3F 02 00 00 00 00 00 80 40 ........333.........
00 00 00 3F 0A D7 23 3C 0A D7 23 3C 00 00 00 00 00 00 00 00 ....................
00 00 00 00

(int) Fractal ID (This ID is user by the layers to select this family)
(String) Fractal Label

MFRC FORM [...] DATA, byte count

(int) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(?) ukn
(int) ukn
</pre>

=='''LYRS''' - Layers==

=== Layers & Affectors ===

Basically the role of layers is to affect the data contained in the different families.
They can contain any number of other sub-layers. Their order is important.

[[Image:trn_layers.jpg]]

A layer deals with the families trough Affectors. There are different types of them, each one has it's own role.
Can have Affector for texturing, flora, areas...

<pre>
Boundaries, filters, and affectors can be defined in layers and sublayers,
such that a single location in the terrain can have multiple terrain rules.
A layer without boundaries (or filters) is "unbounded," and can affect as much
as the entire landscape. A layer with a boundary allows the affectors in the
layer and sublayers to be applied to the region specified by the boundary.
</pre>

=='''Affectors'''==

<pre>
46 4F 52 4D 00 00 00 70 41 46 53 43 46 4F 52 4D 00 00 00 64 FORM...pAFSCFORM...d
30 30 30 34 46 4F 52 4D 00 00 00 3C 49 48 44 52 46 4F 52 4D 0004FORM....IHDRFORM
00 00 00 30 30 30 30 31 44 41 54 41 00 00 00 24 01 00 00 00 ...00001DATA........
41 66 66 65 63 74 6F 72 46 6C 6F 72 61 43 6F 6C 6C 69 64 61 AffectorFloraCollida
62 6C 65 43 6F 6E 73 74 61 6E 74 00 44 41 54 41 00 00 00 14 bleConstant.DATA....
05 00 00 00 01 00 00 00 00 00 00 00 01 00 00 00 00 00 80 3F ....................
</pre>
Note: Every Affector has an IHDR child wich is holding the user-custom name of the affector (here AffectorFloraCollidableConstant).

The 4 bytes Before the name is a Bool wich enable/disable the affector.

The affector-specific data is conatined After the IHDR in the last DATA form, it always starts with a byte counter.

{| class="wikitable" align="center"
|+ '''Boundaries'''
|-
||'''BREC'''||Boundary Rectangle||Delimits a rectangle using 4 float: X1, Y1, X2, Y2 (Select rectangle boundary rule properties, including feathering distance, boundary left/right and near/far coords and local water table height, shader and sahder size.)
<pre>
00 00 7A 44 00 00 7A 44 00 00 AF 44
00 00 AF 44 00 00 00 00 00 00 80 3F

(float) X1
(float) Y1
(float) X2
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BCIR'''||Boundary Circle||Delimits a circle using 3 float: Xo, Yo, Radius (Select circle boundary rule properties, including feathering distance, boundary center coords, and boundary radius.)
<pre>
00 00 48 43 00 00 48 43 00 00 48 43
01 00 00 00 CD CC CC 3D

(float) X
(float) Y
(float) Radius
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BPOL'''||Boundary Polygon||Delimits a n-sided closed polygon area using 2 floats (Xo,Yo) for each point. (Select polygon boundary rule properties, includibng feathering distance and including local water table height, shader and shader size.)
<pre>
Water Area example

04 00 00 00 00 00 00 00 00 00 00 00 00 00 15 C3 00 00 00 00 ....................
00 00 15 C3 00 00 15 C3 00 00 00 00 00 00 15 C3 03 00 00 00 ....................
00 00 48 42 01 00 00 00 00 00 20 C1 00 00 00 40 77 74 65 72 ..HB............wter
5F 73 70 65 63 00 .spec.

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Fethering Type
(float) Shore smoothness (0 is vertical, 50 looks normal. I don't know what scale mesurement is used)
(int) Bool Water On/Off
(float) Water Height
(float) Water Shader Size (Common size = 2)
(string) Water Shader (wter_spec = Look in the file header??)
</pre>

|-
||'''BPLN'''||Boundary PolyLine||Delimits a n-sided line area using 2 floats (Xo,Yo) for each point and a float for the width. (Select polyline boundary rule properties, including feathering distance and width.)
<pre>
08 00 00 00 00 00 80 3E 00 00 00 3F 00 00 00 00 00 00 74 41
00 00 0C C1 00 00 E8 41 00 00 0C C1 00 00 50 42 00 00 78 C1
00 80 85 42 00 00 D8 C1 00 80 91 42 00 00 12 C2 00 00 93 42
00 00 41 C2 00 00 94 42 01 00 00 00 00 00 80 3F 00 00 20 41

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Feathering Type
(float) Feathering Amount
(float) Line Width
</pre>
|-
|}

Note: '''Boundaries can have a special footer allowing them to behave as a water area.'''(TODO)

{| class="wikitable" align="center"
|+ '''Filters'''
|-
||'''FDIR'''||Filter Direction||Select filter direction rule properties, including feathering distance, and min and max angle settings for filter setting to have effect.
|-
||'''FFRA'''||Filter Fractal||Delimits an area generated by a 2d fractal on the ground. (Select filter fractal rule properties incuding fractal family, low and high fractal settings and feathering distance.)
|-
||'''FHGT'''||Filter Height||Select filter height rule properties, including feathering, distance, filter low height, and filter high height.
|-
||'''FSLP'''||Filter Slope||Select filter slope rule properties, including feathering distance, filter min angle, and filter max angle.
<pre>
00 00 00 00 00 00 C8 41 01 00 00 00 CD CC 8C

(float) Minimum Angle
(float) Maximum Angle
(int) Type?
(byte) ?
(byte) ?
(byte) ?
Note the 3 last bytes may be a color.
</pre>
|-
|}

{| class="wikitable"
|+ '''Texture / Shaders Affectors'''
|-
||'''ASCN'''||Affector Shader Constant||Affect a shader using the family_id and the shader_id this family. (Select rule shader and family and feathering parameters.)
|-
||'''ASCR'''||Affector Shader Replace||Replace a shader with another shader (Select rule shader replace families, including source family (the family to be replaced), destination family (the family to replace with), and feathering parameters.)
|-
||'''ACCN'''||Affector Color Constant||Select color for rule.
|-
||'''FSHD'''||Filter Shader||Select filter shader rule properties, including shader family.
|-
|}

{| class="wikitable"
|+ '''Terrain Affectors'''
|-
||'''AHCN'''||Affector Height Constant||Raises or lowers the ground using float for delta and float(scalar?) for slope-smooting. (Select terrain height value for rule.)
<pre>
01 00 00 00 00 00 C8 C2

(int) ukn
(float) Final Height
</pre>
|-
||'''AHFR'''||Affector Height Fractal||Raises or lowers the ground irregulary using a fractal type from the Fractal Family. Float for delta and float(scalar?) (Select terrain height value for rule for fractal family.)
<pre>
50 41 52 4D 00 00 00 0C 02 00 00 00 00 00 00 00 00 00 48 C2

(String) PARAM
(int) Byte Count
(int) Index of a Fractal Family in MGRP -non regular-
(?) ukn
(float) Height Delta, can be negative
</pre>
|-
||'''AHFT'''||Affector Height Terrace||Select terrace height and flat ratio values for rule.
|-
|}

{| class="wikitable"
|+ '''Flora Affectors'''
|-
||'''AFSC'''||Affector Flora Static Collidable||Sets the amount of collidable flora. (Select to add/remove flora, specify flora type and set flora density for static collidable flora.)
<pre>
05 00 00 00 01 00 00 00 00 00 00 00
01 00 00 00 00 00 80 3F

(int) Index of a family in FGRP -not regular-
(int) ukn
(?) ukn
(int) ukn
(float) Feathering
</pre>
|-
||'''AFSN'''||Affector Flora Static Non-Collidable||Sets the amount of Non-collidable flora. (Select to add/remove flora, specify flora type and set flora density for static non-collidable flora.)
|-
||'''AFDN'''||Affector Flora Dynamic Near||I don't know much about those yet. Seems like they change the near/far radial displaying. They're often coupled to the flora affectors, for instance when cleaning an area for a city. (Select to add/remove flora, specify flora type and set flora destiny for dynamic near flora.)
|-
||'''AFDF'''||Affector Flora Dynamic Far|| (Select to add/remove flora, specify flora type and set flora density for dynamic far flora.)
|-
|}

{| class="wikitable"
|+ '''Unknown'''
|-
||'''AENV'''||Environment||Select enviroment group rule properties.
|-

||'''AEXC'''||Affector Exclude||This one shows up on the Patent App.
|-
||'''AROA'''||Affector Road||Select road rule properties, including width, shader, feathering height distance, and feathering shader distance.
|-
||'''ARIV'''||Affector River||Select river rule properties, including width, trench depth, flow velocity, bank and bottom shaders, water shader, water depth, water width, feathering distance.
|-
||'''ACRF'''||Affector Color Ramp Fractal||Select rule family and color ramp.
|-
||'''ACRH'''||Affector Color Ramp Height||Select rule color ramp and height low/high values.
|-
|}

== Example ==

<pre>

1. Layer

a. AffectorHeightConstant, 10

b. AffectorShaderConstant, Rock

2. Layer

a. BoundaryCircle, x=500, y=500, r=500, feather=InOut

b. AffectorHeightConstant, 0

c. AffectorShaderConstant, Mud

d. Layer

i. FilterHeightmin=13,max=17

ii. AffectorColorConstant, BLACK

3. Layer

a. BoundaryRectangle, min=-500, -500, max=500, 500

b. AffectorFloraStaticCollidableConstant, Conifer

c. AffectorFloraDynamicNearConstant, Dead grass

</pre>
'''Description'''
<pre>
Using the example rules listed above, the corresponding rule
description can perform the following:

1. Set the height of the terrain everywhere to 10 meters(1a) and assign the rock shader(1b).

2. Then, in a 500 meter circle(2a) originating from coordinates (500, 500),
gradually decrease the height from 10 meters to 0 meters(2b), place the mud shader(2c),
and create a black band where the height of the terrain at a given sample point is between 13 and 17 meters.(2d, 2di, 2dii)

3. Finally, in a rectangle(3a) from coordinates (-500, -500) to (500, 500), place
conifer trees(3b) and dead grass(3c) within the rectangle.
</pre>

TRN (FileFormat)

2010-05-22T02:05:57Z

Powerking:

{{PageHeader|FileFormat|TRN}}
='''File Header'''=

The general map parameters, as well as flora parameters are defined here

<pre>
4A 3A 5C 73 77 67 5C 63 75 72 72 65 6E 74 5C 64 61 74 61 5C J..swg.current.data.
73 6B 75 2E 30 5C 73 79 73 2E 73 68 61 72 65 64 5C 62 75 69 sku.0.sys.shared.bui
6C 74 5C 67 61 6D 65 5C 74 65 72 72 61 69 6E 5C 64 61 6E 74 lt.game.terrain.dant
6F 6F 69 6E 65 2E 74 72 6E 00 00 00 80 46 00 00 00 41 02 00 ooine.trn....F...A..
00 00 01 00 00 00 CD CC CC BD 00 00 00 40 77 74 65 72 5F 64 ..............wter.d
61 6E 74 5F 6C 61 6B 65 00 00 30 04 46 00 00 00 00 00 00 00 ant.lake..0.F.......
43 00 00 00 41 00 00 00 40 00 00 00 00 00 00 00 00 00 00 80 C...A...............
42 00 00 80 40 00 00 00 3F 00 00 00 00 00 00 00 00 00 00 F0 B...................
41 00 00 80 3F 00 00 00 00 00 00 00 00 00 00 00 43 00 00 00 A...............C...
44 00 00 00 42 00 00 00 41 00 00 00 00 D...B...A....
</pre>

='''TGEN''' - Terrain Generator =
<pre>
The rules in the terrain generation system are also referred to as affectors,and
are organized into layers. Boundaries refer to terrain designer- or artist-defined
regions of virtual terrain for which the desired rules have effect. Filters refer
to conditions to be considered when applying affectors. Layers can be arranged
in a hierarchy with a parent-child or tree-leaf relationship. Examples of boundaries
include circles, rectangles, and polygons. Examples of filters include filtering
by slope, height, shader, direction and fractal. Examples of affectors include
those that affect height, color, shader, flora, and radial flora. Boundaries, filters
and layers are described in greater detail below.

The terrain generation system also includes families, which refer to groups of
assets such as textures, geometry or even algorithms. Families can include children
with weights. This could involve choosing an asset by selecting a one weighted child.
For example, this could allow the users to choose a "grass" family for a region, but
when the terrain system generates the grass family, it can choose one of the children
of the grass family, which results in the rendering of a single grass shader.

Examples of families include shader families, blend families, flora families,
radial flora families, and fractal families. Shader families refer to grouping
shaders for placing textures. Blend families refer to grouping shaders for selecting
alpha blend masks. Flora families refer to grouping geometry for selecting flora.
Radial flora families refer to grouping shaders for placing radial flora.
Fractal families refer to grouping fractals for reuse within different rules.
</pre>

Terrain generator (form name : TGEN)
There are 6 different sections.

<pre>
- The Shader family (SGRP)
- The Flora family (FRGP)
- The Radial Flora family (RGRP)
- The Environment family (EGRP)
- The Fractal family (MGRP)
- The Layers family (LYRS)
</pre>

=='''SGRP''' - Shader Family Group==

Shader families refer to grouping shaders for placing textures

It's sub-divied into multiple surface families (SFAM).

Each one of them declare mutliple shaders using a surface file.

SGRP has x children (SFAM), SFAM has x children (Shaders)

'''Family break-down:'''
<pre>
53 46 41 4D 00 00 00 55 22 00 00 00 73 6E 6F 77 5F 6D 74 6E SFAM...U....snow.mtn
73 70 65 61 6B 00 61 62 73 74 72 61 63 74 2F 74 65 72 72 61 speak.abstract.terra
69 6E 5F 73 75 72 66 61 63 65 2F 73 6E 6F 77 2E 69 66 66 00 in.surface.snow.iff.
FF FF 00 00 00 00 40 00 00 80 3F 01 00 00 00 ...............

(int) Family ID (This ID is user by the layers to select this family)
(String) File Name
(byte)(byte)(byte) unk ?Color?
(float) unk
(float) unk
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
73 6E 6F 77 5F 6D 74 6E 73 70 65 61 6B 00 00 00 80 3F snow.mtnspeak.....

(string) Shader Name
(float) unk
</pre>

=='''FGRP''' - Flora Family Group==

Flora families refer to grouping geometry -apt files- for selecting flora. (Select flora group properties, including flora family data)

Each one of them decalre one flora group using multiple appearance files.

FGRP has x children (FFAM), FFAM has x children (Appearance Files)

'''Family break-down:'''
<pre>
46 46 41 4D 00 00 00 9D 01 00 00 00 66 65 72 6E 73 00 FF 80 FFAM........ferns...
40 00 00 80 3F 00 00 00 00 02 00 00 00 .............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
70 74 63 68 5F 65 6E 64 72 5F 66 72 73 74 5F 63 6C 75 73 74 ptch.endr.frst.clust
65 72 5F 61 31 2E 61 70 74 00 00 00 80 3F 00 00 00 00 0A D7 er.a1.apt...........
23 3C CD CC CC 3D 01 00 00 00 01 00 00 00 00 00 40 3F 00 00 ....................
20 40 ..

(String) Appearance File Name
(float) ukn
(?) ukn
(float) ukn
(float) ukn
(int) ukn
(int) ukn
(float) ukn
(float) ukn
</pre>

=='''RGRP''' - Radial Flora Family Group==
Radial flora families refer to grouping shaders for placing radial flora.

'''Family break-down:'''
<pre>
52 46 41 4D 00 00 01 06 01 00 00 00 67 72 61 73 73 79 20 70 RFAM........grassy.p
6C 61 69 6E 73 00 FF FF 00 00 00 80 3F 04 00 00 00 lains............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
(String) Shader Name (dds file)
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(?) ukn
TODO..
</pre>

=='''EGRP''' - Environment Family Group==

Declares the environement

EGRP has x children (EFAM)

'''Child break-down:'''
<pre>
01 00 00 00 6D 61 69 6E 5F 62 61 73 65 00 FF FF 00 00 00 80 3F ....main.base........

(int) Environment ID (This ID is user by the layers to select this environment)
(String) Environment Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
</pre>

=='''MGRP''' - Fractal Family Group==

Fractal families refer to grouping fractals for reuse within different rules.
It's sub-divied into multiple groups (MFAM).
Each one of them declare a labelled fractal.

MGRP has x children (MFAM)

'''Child break-down:'''
<pre>
4D 46 41 4D 44 41 54 41 00 00 00 1C 01 00 00 00 41 66 66 65 MFAMDATA........Affe
63 74 6F 72 48 65 69 67 68 74 46 72 61 63 74 61 6C 5F 31 00 ctorHeightFractal.1.
46 4F 52 4D 00 00 00 4C 4D 46 52 43 46 4F 52 4D 00 00 00 40 FORM...LMFRCFORM....
30 30 30 31 44 41 54 41 00 00 00 34 00 00 00 00 00 00 00 00 0001DATA...4........
00 00 00 3F 00 00 00 00 33 33 33 3F 02 00 00 00 00 00 80 40 ........333.........
00 00 00 3F 0A D7 23 3C 0A D7 23 3C 00 00 00 00 00 00 00 00 ....................
00 00 00 00

(int) Fractal ID (This ID is user by the layers to select this family)
(String) Fractal Label

MFRC FORM [...] DATA, byte count

(int) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(?) ukn
(int) ukn
</pre>

=='''LYRS''' - Layers==

=== Layers & Affectors ===

Basically the role of layers is to affect the data contained in the different families.
They can contain any number of other sub-layers. Their order is important.

[[Image:trn_layers.jpg]]

A layer deals with the families trough Affectors. There are different types of them, each one has it's own role.
Can have Affector for texturing, flora, areas...

<pre>
Boundaries, filters, and affectors can be defined in layers and sublayers,
such that a single location in the terrain can have multiple terrain rules.
A layer without boundaries (or filters) is "unbounded," and can affect as much
as the entire landscape. A layer with a boundary allows the affectors in the
layer and sublayers to be applied to the region specified by the boundary.
</pre>

=='''Affectors'''==

<pre>
46 4F 52 4D 00 00 00 70 41 46 53 43 46 4F 52 4D 00 00 00 64 FORM...pAFSCFORM...d
30 30 30 34 46 4F 52 4D 00 00 00 3C 49 48 44 52 46 4F 52 4D 0004FORM....IHDRFORM
00 00 00 30 30 30 30 31 44 41 54 41 00 00 00 24 01 00 00 00 ...00001DATA........
41 66 66 65 63 74 6F 72 46 6C 6F 72 61 43 6F 6C 6C 69 64 61 AffectorFloraCollida
62 6C 65 43 6F 6E 73 74 61 6E 74 00 44 41 54 41 00 00 00 14 bleConstant.DATA....
05 00 00 00 01 00 00 00 00 00 00 00 01 00 00 00 00 00 80 3F ....................
</pre>
Note: Every Affector has an IHDR child wich is holding the user-custom name of the affector (here AffectorFloraCollidableConstant).

The 4 bytes Before the name is a Bool wich enable/disable the affector.

The affector-specific data is conatined After the IHDR in the last DATA form, it always starts with a byte counter.

{| class="wikitable" align="center"
|+ '''Boundaries'''
|-
||'''BREC'''||Boundary Rectangle||Delimits a rectangle using 4 float: X1, Y1, X2, Y2 (Select rectangle boundary rule properties, including feathering distance, boundary left/right and near/far coords and local water table height, shader and sahder size.)
<pre>
00 00 7A 44 00 00 7A 44 00 00 AF 44
00 00 AF 44 00 00 00 00 00 00 80 3F

(float) X1
(float) Y1
(float) X2
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BCIR'''||Boundary Circle||Delimits a circle using 3 float: Xo, Yo, Radius (Select circle boundary rule properties, including feathering distance, boundary center coords, and boundary radius.)
<pre>
00 00 48 43 00 00 48 43 00 00 48 43
01 00 00 00 CD CC CC 3D

(float) X
(float) Y
(float) Radius
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BPOL'''||Boundary Polygon||Delimits a n-sided closed polygon area using 2 floats (Xo,Yo) for each point. (Select polygon boundary rule properties, includibng feathering distance and including local water table height, shader and shader size.)
<pre>
Water Area example

04 00 00 00 00 00 00 00 00 00 00 00 00 00 15 C3 00 00 00 00 ....................
00 00 15 C3 00 00 15 C3 00 00 00 00 00 00 15 C3 03 00 00 00 ....................
00 00 48 42 01 00 00 00 00 00 20 C1 00 00 00 40 77 74 65 72 ..HB............wter
5F 73 70 65 63 00 .spec.

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Fethering Type
(float) Shore smoothness (0 is vertical, 50 looks normal. I don't know what scale mesurement is used)
(int) Bool Water On/Off
(float) Water Height
(float) Water Shader Size (Common size = 2)
(string) Water Shader (wter_spec = Look in the file header??)
</pre>

|-
||'''BPLN'''||Boundary PolyLine||Delimits a n-sided line area using 2 floats (Xo,Yo) for each point and a float for the width. (Select polyline boundary rule properties, including feathering distance and width.)
<pre>
08 00 00 00 00 00 80 3E 00 00 00 3F 00 00 00 00 00 00 74 41
00 00 0C C1 00 00 E8 41 00 00 0C C1 00 00 50 42 00 00 78 C1
00 80 85 42 00 00 D8 C1 00 80 91 42 00 00 12 C2 00 00 93 42
00 00 41 C2 00 00 94 42 01 00 00 00 00 00 80 3F 00 00 20 41

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Feathering Type
(float) Feathering Amount
(float) Line Width
</pre>
|-
|}

Note: '''Boundaries can have a special footer allowing them to behave as a water area.'''(TODO)

{| class="wikitable" align="center"
|+ '''Filters'''
|-
||'''FDIR'''||Filter Direction||Select filter direction rule properties, including feathering distance, and min and max angle settings for filter setting to have effect.
|-
||'''FFRA'''||Filter Fractal||Delimits an area generated by a 2d fractal on the ground. (Select filter fractal rule properties incuding fractal family, low and high fractal settings and feathering distance.)
|-
||'''FHGT'''||Filter Height||Select filter height rule properties, including feathering, distance, filter low height, and filter high height.
|-
||'''FSLP'''||Filter Slope||Select filter slope rule properties, including feathering distance, filter min angle, and filter max angle.
<pre>
00 00 00 00 00 00 C8 41 01 00 00 00 CD CC 8C

(float) Minimum Angle
(float) Maximum Angle
(int) Type?
(byte) ?
(byte) ?
(byte) ?
Note the 3 last bytes may be a color.
</pre>
|-
|}

{| class="wikitable"
|+ '''Texture / Shaders Affectors'''
|-
||'''ASCN'''||Affector Shader Constant||Affect a shader using the family_id and the shader_id this family. (Select rule shader and family and feathering parameters.)
|-
||'''ASCR'''||Affector Shader Replace||Replace a shader with another shader (Select rule shader replace families, including source family (the family to be replaced), destination family (the family to replace with), and feathering parameters.)
|-
||'''ACCN'''||Affector Color Constant||Select color for rule.
|-
||'''FSHD'''||Filter Shader||Select filter shader rule properties, including shader family.
|-
|}

{| class="wikitable"
|+ '''Terrain Affectors'''
|-
||'''AHCN'''||Affector Height Constant||Raises or lowers the ground using float for delta and float(scalar?) for slope-smooting. (Select terrain height value for rule.)
<pre>
01 00 00 00 00 00 C8 C2

(int) ukn
(float) Final Height
</pre>
|-
||'''AHFR'''||Affector Height Fractal||Raises or lowers the ground irregulary using a fractal type from the Fractal Family. Float for delta and float(scalar?) (Select terrain height value for rule for fractal family.)
<pre>
50 41 52 4D 00 00 00 0C 02 00 00 00 00 00 00 00 00 00 48 C2

(String) PARAM
(int) Byte Count
(int) Index of a Fractal Family in MGRP -non regular-
(?) ukn
(float) Height Delta, can be negative
</pre>
|-
||'''AHFT'''||Affector Height Terrace||Select terrace height and flat ratio values for rule.
|-
|}

{| class="wikitable"
|+ '''Flora Affectors'''
|-
||'''AFSC'''||Affector Flora Static Collidable||Sets the amount of collidable flora. (Select to add/remove flora, specify flora type and set flora density for static collidable flora.)
<pre>
05 00 00 00 01 00 00 00 00 00 00 00
01 00 00 00 00 00 80 3F

(int) Index of a family in FGRP -not regular-
(int) ukn
(?) ukn
(int) ukn
(float) Feathering
</pre>
|-
||'''AFSN'''||Affector Flora Static Non-Collidable||Sets the amount of Non-collidable flora. (Select to add/remove flora, specify flora type and set flora density for static non-collidable flora.)
|-
||'''AFDN'''||Affector Flora Dynamic Near||I don't know much about those yet. Seems like they change the near/far radial displaying. They're often coupled to the flora affectors, for instance when cleaning an area for a city. (Select to add/remove flora, specify flora type and set flora destiny for dynamic near flora.)
|-
||'''AFDF'''||Affector Flora Dynamic Far|| (Select to add/remove flora, specify flora type and set flora density for dynamic far flora.)
|-
|}

{| class="wikitable"
|+ '''Unknown'''
|-
||'''AENV'''||Environment||Select enviroment group rule properties.
|-

||'''AEXC'''||Affector Exclude||This one shows up on the Patent App.
|-
||'''AROA'''||Affector Road||Select road rule properties, including width, shader, feathering height distance, and feathering shader distance.
|-
||'''ARIV'''||Affector River||Select river rule properties, including width, trench depth, flow velocity, bank and bottom shaders, water shader, water depth, water width, feathering distance.
|-
||'''ACRF'''||Affector Color Ramp Fractal||Select rule family and color ramp.
|-
||'''ACRH'''||Affector Color Ramp Height||Select rule color ramp and height low/high values.
|-
|}

== Example ==

<pre>

1. Layer

a. AffectorHeightConstant, 10

b. AffectorShaderConstant, Rock

2. Layer

a. BoundaryCircle, x=500, y=500, r=500, feather=InOut

b. AffectorHeightConstant, 0

c. AffectorShaderConstant, Mud

d. Layer

i. FilterHeightmin=13,max=17

ii. AffectorColorConstant, BLACK

3. Layer

a. BoundaryRectangle, min=-500, -500, max=500, 500

b. AffectorFloraStaticCollidableConstant, Conifer

c. AffectorFloraDynamicNearConstant, Dead grass

</pre>
'''Description'''
<pre>
Using the example rules listed above, the corresponding rule
description can perform the following:

1. Set the height of the terrain everywhere to 10 meters(1a) and assign the rock shader(1b).

2. Then, in a 500 meter circle(2a) originating from coordinates (500, 500),
gradually decrease the height from 10 meters to 0 meters(2b), place the mud shader(2c),
and create a black band where the height of the terrain at a given sample point is between 13 and 17 meters.(2d, 2di, 2dii)

3. Finally, in a rectangle(3a) from coordinates (-500, -500) to (500, 500), place
conifer trees(3b) and dead grass(3c) within the rectangle.
</pre>

TRN (FileFormat)

2010-05-22T01:16:39Z

Powerking:

{{PageHeader|FileFormat|TRN}}
='''File Header'''=

The general map parameters, as well as flora parameters are defined here

<pre>
4A 3A 5C 73 77 67 5C 63 75 72 72 65 6E 74 5C 64 61 74 61 5C J..swg.current.data.
73 6B 75 2E 30 5C 73 79 73 2E 73 68 61 72 65 64 5C 62 75 69 sku.0.sys.shared.bui
6C 74 5C 67 61 6D 65 5C 74 65 72 72 61 69 6E 5C 64 61 6E 74 lt.game.terrain.dant
6F 6F 69 6E 65 2E 74 72 6E 00 00 00 80 46 00 00 00 41 02 00 ooine.trn....F...A..
00 00 01 00 00 00 CD CC CC BD 00 00 00 40 77 74 65 72 5F 64 ..............wter.d
61 6E 74 5F 6C 61 6B 65 00 00 30 04 46 00 00 00 00 00 00 00 ant.lake..0.F.......
43 00 00 00 41 00 00 00 40 00 00 00 00 00 00 00 00 00 00 80 C...A...............
42 00 00 80 40 00 00 00 3F 00 00 00 00 00 00 00 00 00 00 F0 B...................
41 00 00 80 3F 00 00 00 00 00 00 00 00 00 00 00 43 00 00 00 A...............C...
44 00 00 00 42 00 00 00 41 00 00 00 00 D...B...A....
</pre>

='''TGEN''' - Terrain Generator =
<pre>
The rules in the terrain generation system are also referred to as affectors,and
are organized into layers. Boundaries refer to terrain designer- or artist-defined
regions of virtual terrain for which the desired rules have effect. Filters refer
to conditions to be considered when applying affectors. Layers can be arranged
in a hierarchy with a parent-child or tree-leaf relationship. Examples of boundaries
include circles, rectangles, and polygons. Examples of filters include filtering
by slope, height, shader, direction and fractal. Examples of affectors include
those that affect height, color, shader, flora, and radial flora. Boundaries, filters
and layers are described in greater detail below.

The terrain generation system also includes families, which refer to groups of
assets such as textures, geometry or even algorithms. Families can include children
with weights. This could involve choosing an asset by selecting a one weighted child.
For example, this could allow the users to choose a "grass" family for a region, but
when the terrain system generates the grass family, it can choose one of the children
of the grass family, which results in the rendering of a single grass shader.

Examples of families include shader families, blend families, flora families,
radial flora families, and fractal families. Shader families refer to grouping
shaders for placing textures. Blend families refer to grouping shaders for selecting
alpha blend masks. Flora families refer to grouping geometry for selecting flora.
Radial flora families refer to grouping shaders for placing radial flora.
Fractal families refer to grouping fractals for reuse within different rules.
</pre>

Terrain generator (form name : TGEN)
There are 6 different sections.

<pre>
- The Shader family (SGRP)
- The Flora family (FRGP)
- The Radial Flora family (RGRP)
- The Environment family (EGRP)
- The Fractal family (MGRP)
- The Layers family (LYRS)
</pre>

=='''SGRP''' - Shader Family Group==

Shader families refer to grouping shaders for placing textures

It's sub-divied into multiple surface families (SFAM).

Each one of them declare mutliple shaders using a surface file.

SGRP has x children (SFAM), SFAM has x children (Shaders)

'''Family break-down:'''
<pre>
53 46 41 4D 00 00 00 55 22 00 00 00 73 6E 6F 77 5F 6D 74 6E SFAM...U....snow.mtn
73 70 65 61 6B 00 61 62 73 74 72 61 63 74 2F 74 65 72 72 61 speak.abstract.terra
69 6E 5F 73 75 72 66 61 63 65 2F 73 6E 6F 77 2E 69 66 66 00 in.surface.snow.iff.
FF FF 00 00 00 00 40 00 00 80 3F 01 00 00 00 ...............

(int) Family ID (This ID is user by the layers to select this family)
(String) File Name
(byte)(byte)(byte) unk ?Color?
(float) unk
(float) unk
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
73 6E 6F 77 5F 6D 74 6E 73 70 65 61 6B 00 00 00 80 3F snow.mtnspeak.....

(string) Shader Name
(float) unk
</pre>

=='''FGRP''' - Flora Family Group==

Flora families refer to grouping geometry -apt files- for selecting flora. (Select flora group properties, including flora family data)

Each one of them decalre one flora group using multiple appearance files.

FGRP has x children (FFAM), FFAM has x children (Appearance Files)

'''Family break-down:'''
<pre>
46 46 41 4D 00 00 00 9D 01 00 00 00 66 65 72 6E 73 00 FF 80 FFAM........ferns...
40 00 00 80 3F 00 00 00 00 02 00 00 00 .............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
70 74 63 68 5F 65 6E 64 72 5F 66 72 73 74 5F 63 6C 75 73 74 ptch.endr.frst.clust
65 72 5F 61 31 2E 61 70 74 00 00 00 80 3F 00 00 00 00 0A D7 er.a1.apt...........
23 3C CD CC CC 3D 01 00 00 00 01 00 00 00 00 00 40 3F 00 00 ....................
20 40 ..

(String) Appearance File Name
(float) ukn
(?) ukn
(float) ukn
(float) ukn
(int) ukn
(int) ukn
(float) ukn
(float) ukn
</pre>

=='''RGRP''' - Radial Flora Family Group==
Radial flora families refer to grouping shaders for placing radial flora.

'''Family break-down:'''
<pre>
52 46 41 4D 00 00 01 06 01 00 00 00 67 72 61 73 73 79 20 70 RFAM........grassy.p
6C 61 69 6E 73 00 FF FF 00 00 00 80 3F 04 00 00 00 lains............

(int) Family ID (This ID is user by the layers to select this family)
(String) Family Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
(int) Child Count
</pre>

'''Child break-down:'''
<pre>
(String) Shader Name (dds file)
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(int) ukn
(?) ukn
TODO..
</pre>

=='''EGRP''' - Environment Family Group==

Declares the environement

EGRP has x children (EFAM)

'''Child break-down:'''
<pre>
01 00 00 00 6D 61 69 6E 5F 62 61 73 65 00 FF FF 00 00 00 80 3F ....main.base........

(int) Environment ID (This ID is user by the layers to select this environment)
(String) Environment Name
(byte)(byte)(byte) ukn ?Color?
(float) ukn
</pre>

=='''MGRP''' - Fractal Family Group==

Fractal families refer to grouping fractals for reuse within different rules.
It's sub-divied into multiple groups (MFAM).
Each one of them declare a labelled fractal.

MGRP has x children (MFAM)

'''Child break-down:'''
<pre>
4D 46 41 4D 44 41 54 41 00 00 00 1C 01 00 00 00 41 66 66 65 MFAMDATA........Affe
63 74 6F 72 48 65 69 67 68 74 46 72 61 63 74 61 6C 5F 31 00 ctorHeightFractal.1.
46 4F 52 4D 00 00 00 4C 4D 46 52 43 46 4F 52 4D 00 00 00 40 FORM...LMFRCFORM....
30 30 30 31 44 41 54 41 00 00 00 34 00 00 00 00 00 00 00 00 0001DATA...4........
00 00 00 3F 00 00 00 00 33 33 33 3F 02 00 00 00 00 00 80 40 ........333.........
00 00 00 3F 0A D7 23 3C 0A D7 23 3C 00 00 00 00 00 00 00 00 ....................
00 00 00 00

(int) Fractal ID (This ID is user by the layers to select this family)
(String) Fractal Label

MFRC FORM [...] DATA, byte count

(int) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(int) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(float) ukn
(?) ukn
(int) ukn
</pre>

=='''LYRS''' - Layers==

=== Layers & Affectors ===

Basically the role of layers is to affect the data contained in the different families.
They can contain any number of other sub-layers. Their order is important.

[[Image:trn_layers.jpg]]

A layer deals with the families trough Affectors. There are different types of them, each one has it's own role.
Can have Affector for texturing, flora, areas...

<pre>
Boundaries, filters, and affectors can be defined in layers and sublayers,
such that a single location in the terrain can have multiple terrain rules.
A layer without boundaries (or filters) is "unbounded," and can affect as much
as the entire landscape. A layer with a boundary allows the affectors in the
layer and sublayers to be applied to the region specified by the boundary.
</pre>

=='''Affectors'''==

<pre>
46 4F 52 4D 00 00 00 70 41 46 53 43 46 4F 52 4D 00 00 00 64 FORM...pAFSCFORM...d
30 30 30 34 46 4F 52 4D 00 00 00 3C 49 48 44 52 46 4F 52 4D 0004FORM....IHDRFORM
00 00 00 30 30 30 30 31 44 41 54 41 00 00 00 24 01 00 00 00 ...00001DATA........
41 66 66 65 63 74 6F 72 46 6C 6F 72 61 43 6F 6C 6C 69 64 61 AffectorFloraCollida
62 6C 65 43 6F 6E 73 74 61 6E 74 00 44 41 54 41 00 00 00 14 bleConstant.DATA....
05 00 00 00 01 00 00 00 00 00 00 00 01 00 00 00 00 00 80 3F ....................
</pre>
Note: Every Affector has an IHDR child wich is holding the user-custom name of the affector (here AffectorFloraCollidableConstant).

The 4 bytes Before the name is a Bool wich enable/disable the affector.

The affector-specific data is conatined After the IHDR in the last DATA form, it always starts with a byte counter.

{| class="wikitable" align="center"
|+ '''Boundaries'''
|-
||'''BREC'''||Boundary Rectangle||Delimits a rectangle using 4 float: X1, Y1, X2, Y2 (Select rectangle boundary rule properties, including feathering distance, boundary left/right and near/far coords and local water table height, shader and sahder size.)
<pre>
00 00 7A 44 00 00 7A 44 00 00 AF 44
00 00 AF 44 00 00 00 00 00 00 80 3F

(float) X1
(float) Y1
(float) X2
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BCIR'''||Boundary Circle||Delimits a circle using 3 float: Xo, Yo, Radius (Select circle boundary rule properties, including feathering distance, boundary center coords, and boundary radius.)
<pre>
00 00 48 43 00 00 48 43 00 00 48 43
01 00 00 00 CD CC CC 3D

(float) X
(float) Y
(float) Radius
(float) Y2
(int) Feathering Type
(float) Feathering Amount
</pre>
|-
||'''BPOL'''||Boundary Polygon||Delimits a n-sided closed polygon area using 2 floats (Xo,Yo) for each point. (Select polygon boundary rule properties, includibng feathering distance and including local water table height, shader and shader size.)
<pre>
Water Area example

04 00 00 00 00 00 00 00 00 00 00 00 00 00 15 C3 00 00 00 00 ....................
00 00 15 C3 00 00 15 C3 00 00 00 00 00 00 15 C3 03 00 00 00 ....................
00 00 48 42 01 00 00 00 00 00 20 C1 00 00 00 40 77 74 65 72 ..HB............wter
5F 73 70 65 63 00 .spec.

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Fethering Type
(float) Shore smoothness (0 is vertical, 50 looks normal. I don't know what scale mesurement is used)
(int) Bool Water On/Off
(float) Water Height
(float) Water Shader Size (Common size = 2)
(string) Water Shader (wter_spec = Look in the file header??)
</pre>

|-
||'''BPLN'''||Boundary PolyLine||Delimits a n-sided line area using 2 floats (Xo,Yo) for each point and a float for the width. (Select polyline boundary rule properties, including feathering distance and width.)
<pre>
08 00 00 00 00 00 80 3E 00 00 00 3F 00 00 00 00 00 00 74 41
00 00 0C C1 00 00 E8 41 00 00 0C C1 00 00 50 42 00 00 78 C1
00 80 85 42 00 00 D8 C1 00 80 91 42 00 00 12 C2 00 00 93 42
00 00 41 C2 00 00 94 42 01 00 00 00 00 00 80 3F 00 00 20 41

(int) Point Count

- List -----------
(float) X
(float) Y
------------------

(int) Feathering Type
(float) Feathering Amount
(float) Line Width
</pre>
|-
|}

Note: '''Boundaries can have a special footer allowing them to behave as a water area.'''(TODO)

{| class="wikitable" align="center"
|+ '''Filters'''
|-
||'''????'''||Filter Direction||Select filter direction rule properties, including feathering distance, and min and max angle settings for filter setting to have effect.
|-
||'''FFRA'''||Filter Fractal||Delimits an area generated by a 2d fractal on the ground. (Select filter fractal rule properties incuding fractal family, low and high fractal settings and feathering distance.)
|-
||'''FHGT'''||Filter Height||Select filter height rule properties, including feathering, distance, filter low height, and filter high height.
|-
||'''FSLP'''||Filter Slope||Select filter slope rule properties, including feathering distance, filter min angle, and filter max angle.
<pre>
00 00 00 00 00 00 C8 41 01 00 00 00 CD CC 8C

(float) Minimum Angle
(float) Maximum Angle
(int) Type?
(byte) ?
(byte) ?
(byte) ?
Note the 3 last bytes may be a color.
</pre>
|-
|}

{| class="wikitable"
|+ '''Texture / Shaders Affectors'''
|-
||'''ASCN'''||Affector Shader Constant||Affect a shader using the family_id and the shader_id this family. (Select rule shader and family and feathering parameters.)
|-
||'''ASCR'''||Affector Shader Replace||Replace a shader with another shader (Select rule shader replace families, including source family (the family to be replaced), destination family (the family to replace with), and feathering parameters.)
|-
||'''ACCN'''||Affector Color Constant||Select color for rule.
|-
||'''FSHD'''||Filter Shader||Select filter shader rule properties, including shader family.
|-
|}

{| class="wikitable"
|+ '''Terrain Affectors'''
|-
||'''AHCN'''||Affector Height Constant||Raises or lowers the ground using float for delta and float(scalar?) for slope-smooting. (Select terrain height value for rule.)
<pre>
01 00 00 00 00 00 C8 C2

(int) ukn
(float) Final Height
</pre>
|-
||'''AHFR'''||Affector Height Fractal||Raises or lowers the ground irregulary using a fractal type from the Fractal Family. Float for delta and float(scalar?) (Select terrain height value for rule for fractal family.)
<pre>
50 41 52 4D 00 00 00 0C 02 00 00 00 00 00 00 00 00 00 48 C2

(String) PARAM
(int) Byte Count
(int) Index of a Fractal Family in MGRP -non regular-
(?) ukn
(float) Height Delta, can be negative
</pre>
|-
||'''AHFT'''||Affector Height Terrace||Select terrace height and flat ratio values for rule.
|-
|}

{| class="wikitable"
|+ '''Flora Affectors'''
|-
||'''AFSC'''||Affector Flora Static Collidable||Sets the amount of collidable flora. (Select to add/remove flora, specify flora type and set flora density for static collidable flora.)
<pre>
05 00 00 00 01 00 00 00 00 00 00 00
01 00 00 00 00 00 80 3F

(int) Index of a family in FGRP -not regular-
(int) ukn
(?) ukn
(int) ukn
(float) Feathering
</pre>
|-
||'''AFSN'''||Affector Flora Static Non-Collidable||Sets the amount of Non-collidable flora. (Select to add/remove flora, specify flora type and set flora density for static non-collidable flora.)
|-
||'''AFDN'''||Affector Flora Dynamic Near||I don't know much about those yet. Seems like they change the near/far radial displaying. They're often coupled to the flora affectors, for instance when cleaning an area for a city. (Select to add/remove flora, specify flora type and set flora destiny for dynamic near flora.)
|-
||'''AFDF'''||Affector Flora Dynamic Far|| (Select to add/remove flora, specify flora type and set flora density for dynamic far flora.)
|-
|}

{| class="wikitable"
|+ '''Unknown'''
|-
||'''AENV'''||Environment||Select enviroment group rule properties.
|-

||'''AEXC'''||Affector Exclude||This one shows up on the Patent App.
|-
||'''AROA'''||Affector Road||Select road rule properties, including width, shader, feathering height distance, and feathering shader distance.
|-
||'''ARIV'''||Affector River||Select river rule properties, including width, trench depth, flow velocity, bank and bottom shaders, water shader, water depth, water width, feathering distance.
|-
||'''ACRF'''||Affector Color Ramp Fractal||Select rule family and color ramp.
|-
||'''ACRH'''||Affector Color Ramp Height||Select rule color ramp and height low/high values.
|-
|}

== Example ==

<pre>

1. Layer

a. AffectorHeightConstant, 10

b. AffectorShaderConstant, Rock

2. Layer

a. BoundaryCircle, x=500, y=500, r=500, feather=InOut

b. AffectorHeightConstant, 0

c. AffectorShaderConstant, Mud

d. Layer

i. FilterHeightmin=13,max=17

ii. AffectorColorConstant, BLACK

3. Layer

a. BoundaryRectangle, min=-500, -500, max=500, 500

b. AffectorFloraStaticCollidableConstant, Conifer

c. AffectorFloraDynamicNearConstant, Dead grass

</pre>
'''Description'''
<pre>
Using the example rules listed above, the corresponding rule
description can perform the following:

1. Set the height of the terrain everywhere to 10 meters(1a) and assign the rock shader(1b).

2. Then, in a 500 meter circle(2a) originating from coordinates (500, 500),
gradually decrease the height from 10 meters to 0 meters(2b), place the mud shader(2c),
and create a black band where the height of the terrain at a given sample point is between 13 and 17 meters.(2d, 2di, 2dii)

3. Finally, in a rectangle(3a) from coordinates (-500, -500) to (500, 500), place
conifer trees(3b) and dead grass(3c) within the rectangle.
</pre>

Creature Factor (Game Mechanics)

2010-03-05T01:35:23Z

Powerking:

{{PageCleanup}}
{{PageHeader|Game Mechanics|Mechanics Category}}

{| border="0" width="100%" cellpadding=6
|-

|valign=top|

{| border="0" width="100%" cellpadding=6
|-
|valign=top|
== Description ==
Template (Game Messages)
|valign=top|

== Related Tags ==

{| align="center"
|-
||{{D50%}}
|-
||{{GameMechanics}}
|-
||
Completion Guide -

* 0% - No substantive information available on game feature
* 25% - page has been started but not completed
* 50% - page is as complete as possible with the currently available information but probably needs more research done on the subject matter
* 75% - page is probably complete but needs to be reviewed for accuracy of the page content and to make sure that no information is missing about the game feature
* 100% - page has been reviewed and compared against enough sources to the extent that there is reasonable confidence that the game feature is completely documented.
|}
|}

== Game Mechanics ==

The creature factor is a value assigned to each creature based on its current challenge level. These values are used in the calculation of trapping experience, harvesting experience as well as harvesting yields. A creature level can be an integer or float depending on if it is an adult or baby. Baby creatures spawn as a fractional amount of their adult cl and as a result, this value carries over into the creature factor as a decimal. The amount of difference between the previous creature factor level and next nearest whole number creature factor level is what the creature factor will be for the baby. Creator Factors cap at 2000 somewhere between challenge level 80 and 95. Beyond CL 95, creatures presumably gain no further bonuses to their harvest yield or scouting experience amount.

Note: much of this chart was improvised using known trapping and harvest exp values and then predicting reasonable incrementation. 

The equation that the ANH core will use will be something along the order of:

Creature Factor = 0.1322(Challenge Level)^2 + 9.6078(Challenge Level) - 28.103 
Baby Creature Factor = (Adult Creature Factor)/2 

With modifiers to ensure that it never goes beyond 2000. Some of the lower values are also modified as such:

{| align="center"
|-
||
{| class="anhsmalltable"
|- align="center" style="background-color:#ffffcc;"
|width="100px"|'''Challenge Levels'''||'''Experience'''
|----
|1
|7
|----
|2
|16
|----
|3
|23
|----
|4
|27
|----
|5
|34
|----
|6
|42
|----
|7
|50
|----
|8
|59
|}
|}

==Source References==

{{SourceReferences
| SourcePage01 =
| OriginalPageLink01 =
| SourcePage02 =
| OriginalPageLink02 =
| SourcePage03 =
| OriginalPageLink03 =
| SourcePage04 =
| OriginalPageLink04 =
| SourcePage05 =
| OriginalPageLink05 =
| SourcePage06 =
| OriginalPageLink06 =
| SourcePage07 =
| OriginalPageLink07 =
| SourcePage08 =
| OriginalPageLink08 =
| SourcePage09 =
| OriginalPageLink09 =
| SourcePage10 =
| OriginalPageLink10 =
| SourcePage11 =
| OriginalPageLink11 =
| SourcePage12 =
| OriginalPageLink12 =
| SourcePage13 =
| OriginalPageLink13 =
| SourcePage14 =
| OriginalPageLink14 =
| SourcePage15 =
| OriginalPageLink15 =
| SourcePage16 =
| OriginalPageLink16 =
| SourcePage17 =
| OriginalPageLink17 =
| SourcePage18 =
| OriginalPageLink18 =
| SourcePage19 =
| OriginalPageLink19 =
| SourcePage20 =
| OriginalPageLink20 =
}}

Using Forage (Game Mechanics)

2010-03-01T05:03:34Z

Powerking: /* Formulas */

{{PageCleanup}}
{{PageHeader|Game Mechanics|Mechanics Category}}

{| border="0" width="100%" cellpadding=6
|-
|valign=top|
=Navigation=
{| align="center" width="280px"
|-
||
{{Auction (Mess)}}
{{Banking (Mess)}}
{{Combat (Mess)}}
{{Crafting (Mess)}}
{{Creatures / Pets / Mounts (Mess)}}
{{General Shared Messages (Mess)}}
{{Dungeons (Mess)}}
{{GCW (Mess)}}
{{Games (Mess)}}
{{Healing (Mess)}}
{{JTL (Mess)}}
{{Logout Event (Mess)}}
{{Items and Objects (Mess)}}
{{Force Sensitive / Jedi (Mess)}}
{{Player Interactions (Mess)}}
{{Player Structures (Mess)}}
{{Player Cities (Mess)}}
{{Quests / Missions (Mess)}}
{{Resources (Mess)}}
{{Skills (Mess)}}
{{Stat Migration (Mess)}}
{{Travel (Mess)}}
{{Tutorials (Mess)}}
{{Unknown (Mess)}}
{{Using Innate Species Ability (Mess)}}
{{Waypoint / Datapad (Mess)}}
|}

|valign=top|

{| border="0" width="100%" cellpadding=6
|-
|valign=top|
== Description ==
Template (Game Messages)
|valign=top|

== Related Tags ==

{| align="center"
|-
||{{D50%}}
|-
||{{GameMechanics}}
|-
|}
|}

= Game Mechanics =

'''Using Forage'''

Foraging must be done outside and can only be initiated while not moving. Forage zones are pockets made 20 meters from the next one. In these pockets, a player may forage for goods and when successful, the pocket is depleted. If the player wishes to gain more foraged items they will have to move to the next pocket to forage. Players can begin forage through using the /forage command. After this is done, a 10 second period will elapse before they receive a notification of the event's success or failure. When you get the "There is nothing to forage in this area." message, you must move at least 20m off to get a new area. These pockets will regenerate over time.

Each "area" has 4 forage slots. You can only have 4 successful forage attempts in an area. Multiple items collected during a forage success do not count against the forage attempts as each forage attempt is counted seperately. Once you hit the 4th success that area is dry. The area will regenerate items at a rate of roughly 1 per 5min. So if you say get 4 successes in a row, you will not get a success for another 2mins or so.

Forage success increases as the player gains more forage skill. At master scout, the forage success is higher and the the number of items the player is supposed to receive is increased to a maximum of 3 in a single forage. Items are chosen randomly although fishing bait seems to be rather commonly obtained. Successes include discards (items not added to inventory because the inventory is full) and multiple-item forages (which count as one success.) Your failure rate doubles (no matter what planet you're on) when you're around cities or structures (player or NPC).

Foraging skill also plays a role in determining the unit amount of fishing bait is recovered during a forage attempt. Scouts with survival one can forage bait units between 1 -2 where as master rangers can recover units between 4-5.

== Formulas ==

'''Forage Success Rate'''

The Formula created by Powerking for use in the ANH core is as follows:

Chance of success = sqrt(Skill Modifier)/20 + 0.15

Chance of success in town municipal zone = (sqrt(Skill Modifier)/20 + 0.15)/2

'''Bait Recovered'''

Only the min and max range is known for bait recovered. The rest will have to be extrapolated. I propose we issue bait ranges as follows:

* Foraging Mod 0-25: 1-2 units
* Foraging Mod 26-50: 2-3 units
* Foraging Mod 51-75: 3-4 units
* Foraging Mod 75-100: 4-5 units

'''Forage Area Regeneration Rate'''

1 item regenerates every 5 minutes into the forage pool for that 20 meter radius

'''Maximum items:'''

* 1 Item at Foraging Mod +5 
* 2 Items at Foraging Mod +25 
* 3 Items at Foraging Mod +50
* Rare items at Ranger: Foraging +55 (not implemented)

'''Multiple Item Forage Odds'''

These are the odds of a multiple item forage occuring when a player is successful in their forage attempt. These odds will assume that the behavior observed on multi-item forages is attributed to differences between starting planets and advanced planets.

{| border = 1
|-
||Planet Type
||Odds
|-
||Starting Planet
||1:33
|-
||Advanced Planet
||1:20
|}

Starting planets consist of the worlds:

* Rori
* Corellia
* Talus
* Tatooine
* Naboo

Advanced planets consist of the worlds:

* Lok
* Endor
* Dantooine
* Dathomir
* Yavin IV

==Source References==

{{SourceReferences
| SourcePage01 =
| OriginalPageLink01 =
| SourcePage02 =
| OriginalPageLink02 =
| SourcePage03 =
| OriginalPageLink03 =
| SourcePage04 =
| OriginalPageLink04 =
| SourcePage05 =
| OriginalPageLink05 =
| SourcePage06 =
| OriginalPageLink06 =
| SourcePage07 =
| OriginalPageLink07 =
| SourcePage08 =
| OriginalPageLink08 =
| SourcePage09 =
| OriginalPageLink09 =
| SourcePage10 =
| OriginalPageLink10 =
| SourcePage11 =
| OriginalPageLink11 =
| SourcePage12 =
| OriginalPageLink12 =
| SourcePage13 =
| OriginalPageLink13 =
| SourcePage14 =
| OriginalPageLink14 =
| SourcePage15 =
| OriginalPageLink15 =
| SourcePage16 =
| OriginalPageLink16 =
| SourcePage17 =
| OriginalPageLink17 =
| SourcePage18 =
| OriginalPageLink18 =
| SourcePage19 =
| OriginalPageLink19 =
| SourcePage20 =
| OriginalPageLink20 =
}}