
	*****************************************************

	********************** RISEN3D **********************

	*****************************************************



 The Nesting3DfloorsExample.wad shows, in conjunction with this document, how to construct
 3D floors in Risen3D.

 There are five columns of constructs with the player starting facing the first column.

 IMPORTANT: when using a map editor ensure that vertex merging is disabled else the map
            will be uneditable. This does not affect rendering and, in any case, R3D will
            merge the vertexes internally when building the nodes.


 COLUMN 1

 This shows 2 3D platforms with different depths and different heights.
 The 2 at the back show how each is constructed.

 The construct at the front nearest the player at start up is a composite using exact copies
 of the 2 at the back and then dragging the lines of the one copy over the other.


 COLUMN 2

 This shows how to create a hole in stacked 3D platforms and follows the same method, that is
 dragging exact copies of each line ring for the holes over each other where required in the
 composite stacked platforms. Each platform is shown behind with a hole to demonstrate how a
 hole is constructed. Note the sector numbers used for the lines.


 COLUMN 3

 This shows how to plug something into the hole shown in column 2, in this case a crate.
 Here the 2 platforms and a crate, shown behind the completed front construct are shown.
 Exact copies of these have then been plugged into the hole by dragging their lines to fit.


 COLUMN 4

 This shows how to create a hole in the 2 platforms and the crate. It follows the same logic
 as described in column 2.


 COLUMN 5

 This shows how a second crate plugged into the hole allows a second item to be drawn on top
 of the first crate. In this, the final construct, all textures on lines that are never seen
 and which, therefore, are wasteful to draw have been removed. These textures were only put on
 the lines in the previous steps to allow them to be seen in the map.


 Note the highest number of stacked platforms used here is 3. The limit allowed is 6.

 Five sectors are used to make the final construct. To make it easier to understand the base
 (standard sector) is S0, the top platform uses S1, the next S2, the larger crate S3 and the
 small crate S4. All 52 lines' front sectors used in the final construction use sector 0 (the
 base sector). All the sectors used for the backsectors where 3D lines are employed (i.e.
 S1, S2, S3 and S4) have, and must have, the same settings as S0. This is because, where there
 is a choice, the nodes builder could select any of S0, S1, S2, S3 or S4 to use as the base
 sector. It should be clear that all 52 lines used in the final construct are 3D flats lines
 and that the whole construct is assembled using 3D floors. There are other techniques that
 can be used with 3D floors but these are beyond the scope of this document.

 Sectors 1 to 4 are tagged 1 to 4 in order. This, again, is to make it easier to follow. In
 both cases the sector numbers used and the tag numbers used are purely arbitrary other than
 the relationship of the tag number with the 3D flats sector (in this case S5, S6, S7 and S8)
 that defines the flat texture and light levels to be applied.
 
 G.M.J.	November 2015
 